mongodb/TODO

TODO
====

Bson
----
+ implement deprecated types (were left out)
+ convert from/to json
+ tie regex type to type in regex library
+ Read instance for Documents that can read its Show representation

MongoDB
-------
+ Support the new query flag: https://jira.mongodb.org/browse/SERVER-2020
+ Support MapReduce 1.8 version
+ When one connection in a pool fails, close all other since they will likely fail too
+ on insert/update: reject keys that start with "$" or "."
+ dereference dbref
+ functions for every command, eg.
	- findAndModify
	- reIndex (http://www.mongodb.org/display/DOCS/Indexes#Indexes-ReIndex)
	- createIndex attributes: background, min, max
	- createIndex Order [Asc, Dec, Geo2d]
	- getIndexInfo
	- logout
	- collectionsInfo
	- databasesInfo
	- getProfileInfo
+ Query attribute: timeout
+ Update If Current (http://www.mongodb.org/display/DOCS/Atomic+Operations)
+ Upon client exit, send killCursors for all open cursors, otherwise server will keep them open for 10 minutes and keep NoCursorTimeout cursors open for hours.
+ Upon cursor finalize (garbage collect) send killCursor even if you have to create a new connection, because server keeps cursors open for 10 minutes (or more).
+ Query option Exhaust
+ Reconnect on replica set primary stepdown, so no exception raised to user
+ Reconnect on query ioerror re-query, so no exception raised to user. Can't be done for writes because it is not safe to re-execute a write.
+ tailable cursor support
  - only close cursor when cursorID is 0
  - have to create loop that sleeps and retries
  - lazy list support
+ GridFS

Tests - none currently

Misc
----
+ javascript DSL
+ update tutorial to match new python one
+ custom types (see python examples)

Questions:
- In Mongo shell, db.foo.totalSize fetches storageSize of each index but does not use it

Notes:
- Remember that in the new version of MongoDB (>= 1.6), "ok" field can be a number (0 or 1) or boolean (False or True). Use 'true1' function defined in Database.MongoDB.Util
- A cursor will die on the server if not accessed (by any connection) within past 10 minutes (unless NoCursorTimeout option set). Accessing a dead (or non-existent) cursor raises a CursorNotFoundFailure.
- Unsafe to shrink pool and close connections because map/reduce temp tables that were created on the connection will get deleted. Note, other connections can access a map/reduce temp table as long as the original connection is still alive. Also, other connections can access cursors created on other connections, even if those die. Cursors will be deleted on server only if idle for more than 10 minutes. Accessing a deleted cursor returns an error.
TODO 2010-01-07 04:36:21 +00:00			`TODO`
			`====`

Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`Bson`
TODO 2010-01-07 04:36:21 +00:00			`----`
Slight redesign: pipelining with writeMode instead of exclusive access with getLastError 2010-06-21 15:06:20 +00:00			`+ implement deprecated types (were left out)`
TODO 2010-01-18 16:25:02 +00:00			`+ convert from/to json`
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`+ tie regex type to type in regex library`
			`+ Read instance for Documents that can read its Show representation`
BSON: fix unexported data constructor 2010-01-11 03:22:02 +00:00
			`MongoDB`
			`-------`
Make Database.MongoDB.Connection compatible on Windows by not using PortID's UnixSocket constructor unless compiling on Unix 2011-02-22 15:31:54 +00:00			`+ Support the new query flag: https://jira.mongodb.org/browse/SERVER-2020`
Single param Network instance. NetworkIO instance of IO that yields Internet so user does not have to supply it 2010-12-27 05:23:02 +00:00			`+ Support MapReduce 1.8 version`
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`+ When one connection in a pool fails, close all other since they will likely fail too`
			`+ on insert/update: reject keys that start with "$" or "."`
			`+ dereference dbref`
			`+ functions for every command, eg.`
			`- findAndModify`
			`- reIndex (http://www.mongodb.org/display/DOCS/Indexes#Indexes-ReIndex)`
			`- createIndex attributes: background, min, max`
			`- createIndex Order [Asc, Dec, Geo2d]`
			`- getIndexInfo`
			`- logout`
			`- collectionsInfo`
			`- databasesInfo`
			`- getProfileInfo`
			`+ Query attribute: timeout`
			`+ Update If Current (http://www.mongodb.org/display/DOCS/Atomic+Operations)`
			`+ Upon client exit, send killCursors for all open cursors, otherwise server will keep them open for 10 minutes and keep NoCursorTimeout cursors open for hours.`
			`+ Upon cursor finalize (garbage collect) send killCursor even if you have to create a new connection, because server keeps cursors open for 10 minutes (or more).`
			`+ Query option Exhaust`
			`+ Reconnect on replica set primary stepdown, so no exception raised to user`
			`+ Reconnect on query ioerror re-query, so no exception raised to user. Can't be done for writes because it is not safe to re-execute a write.`
TODO 2010-01-18 16:25:02 +00:00			`+ tailable cursor support`
			`- only close cursor when cursorID is 0`
			`- have to create loop that sleeps and retries`
			`- lazy list support`
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`+ GridFS`
TODO 2010-01-13 13:14:44 +00:00
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`Tests - none currently`
change BsonDoc representation to maintain order Turns out that order is sometimes important for BSON documents. Case in point, "mapreduce" has to be the first field for the map/reduce command. To accomidate this we'll switch from using 'Map' to using a tuple-list (eg '[(L8.ByteString, BsonValue)]'). Luckily most code that was using toBsonDoc doesn't need to change. While at it, 'Convertible' is not adding much value, and was causing ambiguities making it less usefull (was requiring explicit type hints more then it should have). Thus we are switching to our own conversion typeclasses. 2010-03-08 12:57:20 +00:00
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`Misc`
			`----`
			`+ javascript DSL`
			`+ update tutorial to match new python one`
change BsonDoc representation to maintain order Turns out that order is sometimes important for BSON documents. Case in point, "mapreduce" has to be the first field for the map/reduce command. To accomidate this we'll switch from using 'Map' to using a tuple-list (eg '[(L8.ByteString, BsonValue)]'). Luckily most code that was using toBsonDoc doesn't need to change. While at it, 'Convertible' is not adding much value, and was causing ambiguities making it less usefull (was requiring explicit type hints more then it should have). Thus we are switching to our own conversion typeclasses. 2010-03-08 12:57:20 +00:00			`+ custom types (see python examples)`
See V0.5.0-Redesign.md for description of changes in this commit 2010-06-15 03:14:40 +00:00
			`Questions:`
			`- In Mongo shell, db.foo.totalSize fetches storageSize of each index but does not use it`

			`Notes:`
			`- Remember that in the new version of MongoDB (>= 1.6), "ok" field can be a number (0 or 1) or boolean (False or True). Use 'true1' function defined in Database.MongoDB.Util`
Connection pooling and some refactoring 2010-10-27 20:13:23 +00:00			`- A cursor will die on the server if not accessed (by any connection) within past 10 minutes (unless NoCursorTimeout option set). Accessing a dead (or non-existent) cursor raises a CursorNotFoundFailure.`
			`- Unsafe to shrink pool and close connections because map/reduce temp tables that were created on the connection will get deleted. Note, other connections can access a map/reduce temp table as long as the original connection is still alive. Also, other connections can access cursors created on other connections, even if those die. Cursors will be deleted on server only if idle for more than 10 minutes. Accessing a deleted cursor returns an error.`