mongo_dart 0.10.2 copy "mongo_dart: ^0.10.2" to clipboard
mongo_dart: ^0.10.2 copied to clipboard

MongoDB driver, implemented in pure Dart. All CRUD operations, aggregation pipeline and more!

Changelog #

0.10.2 #

0.10.1 #

  • X509 Authentication
  • LegacyUuid class. It allows to manage Binary Subtype 3 Bson types (Uuid Old). The class holds the value in the storing format, some helpers are available for converting back an forth this value based on the known algorithms: java Legacy, C# legacy and Python.

0.10.0 #

Updated Bson, Mongo_dart_query and Uuid dependencies, this leads to a series of Breaking changes. Please, see the respective github pages for details, here a recap of the most noticeable:

  • BSON classes are mainly used for internal use. See the Bson github site for more details
    • BsonRegexp now it is normally not needed, use RegExp instead.
    • BsonNull is not needed, you can use null directly.
    • A new JsCode class has been created, it is no more needed the use of BsonCode.
    • a DbRef class has been created. The old version was storing DbPointer and DbRef the same way. Now they are separated as in Bson specification. If you have old data, please consider this change.
  • Uuid dependency has been updated and you have to consider that the UuidValue class has been slightly changed. The .fromString constructure must be used mainly instead of the default one. Check the Uuid package github site for details.

0.9.4 #

  • Example for admin command
  • Fix for listDatabases() method for new releases

0.9.3 #

  • Fix on ConnectionPool
  • Test for SetWindowFields (inherited from mongo_dart_query)

0.9.2 #

  • Added extra data parameter to GridIn class

0.9.1 #

  • Added a delete() method to GridOut class
  • Added a toFile() method to GridOut class (allows to write safely on disk - adds a (n) suffix if the file already exists)
  • Added a clearBucket() method to class GridFs
  • Added a dropBucket() mehthod to class GridFs
  • Fixed an issue on GridFsFile numChunks() method

0.9.0 #

  • Fixed an issue on GridFs save() method using MongoDb 6.0
  • Possible breaking change. The cursorId has been changed from type BsonLong to type Int64. In general all BsonLong fields received from the server now are received as Int64 instead of int (see Bson package)
  • authSourceDb defaulted to 'admin' in case neither the default Db nor the authSourceDb has been specified

0.8.2 #

  • Fixed a regression bug using MongoDb-CR authMethod

0.8.1 #

  • Fixed bug preventing pre 3.6 releases to work with mongo_dart

0.8.0 #

  • inherited fro Bson: Moving to the most recent version of the Rational class, a Breaking change had been introduced. We have decided to substitute the Rational class with the Decimal one, because the latter, that it is a wrapper around the former, contains more user friendly methods. You can always get a Rational instance, if needed, calling the toRational() method of theDecimal class.
  • a connection error condition was throwing the natural number "e" instead of the error text
  • connection_pool: _DbFactory renamed DbFactory
  • connection: _ServerCapabilities renamed ServerCapabilities
  • connection_manager: _ConnectionManager renamed ConnectionManager
  • Lint fixes
  • The folder lib\src\database\commands\aggreagation_commands has bin renamed into lib\src\database\commands\aggregation_commands
  • created modernCount method
  • OP_MSG commands added: Drop, DropDatabase and ListCollections
  • Db.runCommand()
  • dropIndex()

0.8.0-1.0.beta #

  • The unionWith stage has been added to the AggregationPipelineBuilder.
  • unionWith examples added in example/manual/aggregate

Breaking changes #

  • Updating the dependencies, the Decimal class substitutes the Rational one. Inherited from BSON package. It seems that the Rational class has been designed more like a "core" class and the Decimal one (that is a subclass) is for everyday use. You can alway get a Rational instance from a Decimal calling the method toRational().

0.7.4+2 #

Now using Lints instead of Pedantic

0.7.4+1 #

Fixed Warnings and Lints for pub evaluation.

0.7.4 #

  • Fixed misleading error message if the database name was not specified in the connection string
  • As the mongo shell assumes test if no database is specified, we will do the same. This could be a potential breaking change in some situations.

0.7.3 #

  • Fixed a problem in Timestamp class so that seconds and increment were inverted in reading from db.
  • Decoupled the Timestamp class from the newly created BsonTimestamp one.

0.7.2 #

  • Added SCRAM-SHA-256 authentication mechanism If no authentication mechanism is set, as a first try the driver analyze the server response that returns the available scram mechanisms for the required user, otherwise, SCRAM-SHA-256 is set starting from release 4.0.

    BREAKING CHANGE Incidentally a potential breaking change has been introduced. If there is any problem during authentication, in previous versions a map containing the error message was thrown. Now a MongoDartError object is thrown.

    Please NOTE By default the driver automatically sets SCRAM-SHA-256 if the server release is equal or greater to 4.0. Unfortunately Atlas does not yet support SHA-256, and does not return informations about the supported authentication mechanisms for the user, so the driver, when detects the connection error, automatically downgrades to SHA-1 If you want to avoid the first attempt, you can set the autentication mechanism to SHA-1 in the connection string.

0.7.1 #

  • Removed deprecated MD5 calculation in GridFs

0.7.0+2 #

  • Fix in README. There was a wrong example on how to call the replaceOne method.

0.7.0+1 #

  • changed documentation references, now pointing directly on GitHub

0.7.0 #

  • Fixed problem with tls CAFile parameter if passed more than once.

0.7.0-nullsafety.3 #

  • Documentation and examples

0.7.0-nullsafety.2 #

  • Example of cursor use.
  • Created cursor.batchSize variable
  • Fix on setting operation batchSize to zero

0.7.0-nullsafety.1 #

  • Null-safety port - first step
  • Uuid fields (UuidType class)
  • $mul operator in ModifierBuilder

0.5.0-beta #

  • Added tls client and server certificate management
  • Created method .onlyFirst() in class ModernCursor

0.5.0-dev.4 #

  • distinct()
  • reorganized folder with new commands
  • more examples and docs

0.5.0-dev.3 #

  • Renamed DeleteRequest classes as DeleteStatement
  • updateOne(), replaceOne() and updateMany()
  • modermFindAndModify()
  • bulkWrite()
  • watch()
  • all crud methods have been modified to call the modern version if MongoDb has a version of 3.6 or greater.

0.5.0-dev.2 #

  • DbCollection.deleteOne()
  • DbCollection.deleteMany()

0.5.0-dev.1 #

Breaking Changes

  • The hidden class _Connection has been renamed Connection. If you have already your own Connection class may be that they conflict. In this case, you shoul hide the Connection class while importing MongoDart in your sources. Ex.dart import 'package:mongo_dart/mongo_dart.dart' hide Connection;

Other Changes

  • OP_MSG operations and commands. See the README file.
  • Decimal128 Type (inherited from BSON enhancements)

0.4.4 #

  • Test for text index.
  • Fix problem wit "OPENING" state in db. When a socket error happened during opening, the state was't resetted so that any new attempt failed.
  • Closing a db when the connection socket was null threw error.
  • Changed the way the socket error is thrown on All errors detected are collected.
    1. If after all the attempts the master connection is not on, an error is thrown relative to the the first server tested. This for compatibility reason with the previous way the message was thrown.
    2. If the master connection is on, the errors are logged as warning.
  • The socket error message has been changed to comprehend also the address of the server, so it is easier to identify the problem.
  • If an authentication error occurs, the relative socket is closed.

0.4.3 #

  • New isConnected Db getter. It returns true if the state of the database is open and at least the primary connection is on.
  • db._masterConnectionVerified() now throws an explicit error if the db state is not OPEN (it was throwing a NoSuchMethodError).

0.4.2 #

  • New Db constructor (Db.create()) that accepts also the url in DNS Seedlist Connection Format (mongodb+srv://)

0.4.1 #

  • Secure Connection
  • The connection string now accepts more than one server.
    • Before: only mongodb://
    • Now it can be: mongodb://,,
    • It is equivalent to: db.pool([mongodb://, mongodb://, mongodb://]);
  • Added an "uriList" getter in "Db" class.

0.4.1-dev.2.2 #

  • Lint clean-up

0.4.1-dev.2.1 #

  • Fix - socket error on connect was not catched

0.4.1-dev.2 #

  • Better management of socket error.

0.4.1-dev.1 #

Fixes problems with createIndex method.

Breaking changes:

  • The name of the index is now created without the leading underscore (Ex. creating an index on key "a", in the old version created an index named "_a_1", now the name will be "a_1").
  • The minimum dart sdk version required has been raised to 2.5.2

Changes List:

  • New message (called ModernMessage). This has been tested for createIndex() only, and could be the base for moving all operations and commands from the old messages to this new one. Gradually ;-)
  • A new method createIndex() has been created in the DbCollection class. This only works starting from 3.6. By default the result of the call is a little different form the old one (no getLastError() call is needed). For compatibility reasons I introduced a new parameter (modernReply), if set to false, it performs a getLastError() and returns the same way as the old method.
  • The original createIndex method in Db class has been changed in order to call the new one (with modernReply: false) if the release is at least 3.6.
  • The original MongoMessage has been split into two. The response part (Called MongoResponseMessage) now is the super class of MongoReplyMessage and MongoModernMessage.
  • Some WriteConcern instances have been deprecated.
  • A new "ServerStatus" message has been created. It is called when the connection is opened, and some values are stored if needed. The method is called ServerStatus() (in Db class) and returns a Map with all available status information. This method is only available from 3.6. on.
  • An experimental "InsertOne" method has been created (only from 3.6).
  • A MongoDbNamespace and a ReadPreference class have been created, mainly for future use.
  • New tests.
  • The Pedantic package has been included as a dev_dependency. The analysis.yaml has been updated to a more recent format, also including the pedantic package (default set of Google lint rules).

0.4.0-dev.1 #

  • Upgraded to mongo_dart_query 0.4.1. The update adds aggregation pipeline builder.

0.3.6 #

  • Updates for Dart 2.5 compatibility. As of Dart 2.5, the Socket class emits Uint8List, rather than plain List<int>, so some fixes were necessary to allow the package to continue to function.

0.3.5 #

  • Upgraded uuid constraint to ^2.0.0.

0.3.4 #

0.3.2 #

  • Cast fixes, for compatibility with Dart 2.
  • Moved from dart:convert usage to package:dart2_constant, for the sake of backwards compatibility.

0.3.1 #

  • Changed the signature of DbCollection.remove; its selector parameter is now required, while writeConcern is now a named optional parameter.
Future remove(selector, {WriteConcern writeConcern});

Resolves #73.

0.3.0 #

  • Strong mode compliance. Preparing for Dart 2.0

0.2.8 #

  • Fix bad type in _Connection class

0.2.7 #

  • Minor changes, commented out code removed
  • Big chunk of tests was commented out in 0.2.6 by error. All tests restored.

0.2.6 #

  • update for new sdk (with 1.17.0 [MongoMessageHandler] was broken in checked mode)
  • upgrade to current version of crypto package, and it's new (Converter based) API

0.2.5+1 #

  • Fixed markdown for pub.

0.2.5 #

  • Moved mongo_dart project to a new organization on GitHub.
  • Authentication schemes now use Secure Random coming from dart:math since 1.14. Note that this version now required SDK version >= 1.14 because of this
  • Added sort by text score to the query builders.

0.2.5-beta #

  • SCRAM-SHA1 authentication scheme added by Joel Trottier-Hebert. Random string (salt) is generated with standard dart Random, which is not cryptographically strong for now, hence beta marker on version.
    Secure Random is due in the next version of SDK, so that would be improved soon.
  • SCRAM-SHA1 scheme used as a default while driver is connected to mongodb 3.0, MONGODB_CR used otherwise. authMechanism connection string option can be used to override these defaults.
  • authSource connection string option added See:
  • Many refactorings in tests and code with async/await done by Joel Trottier-Hebert
  • Dependency on logging package loosen to >=0.9.1 <0.12.0

0.2.4 #

  • Small bump up in dependencies

0.2.3 #

  • Swithed to travis from
  • Can use null-aware operators in example (blog)

0.2.2 #

  • Loosening parameter type in CursorStream in accordance with sdk 1.13.0
  • README update with basic usage

0.2.1 #

  • Fix issue 71 - Logger allocates lot of strings

0.2.0 #

  • Breaking change: DbCollection find method now returns Stream<Map> instead of Cursor. Cursor have had compatible with Stream<Map> toList and forEach quite some time already, so in case you used these methods only, you should be covered. On the other hand if you used find().stream to get a stream it is not valid anymore. In that case you should change your code to plain find()
  • Breaking change: This version use upgraded version of bson. ObjectId.toJson now converts ObjectId to simple hex string representation. Earlier it was something like ObjectId('a29d3ae24...aa') New behaviour would be more useful when you serialize bson map to json be default conversion. With new behaviour serialized ObjectId value could be passed to ObjecdId.parse method. But if your code currently depends on old behaviour (if you now use something like id.substring(10, 34) to get hex part of the string representation, you should change your code.

0.1.47 #

  • compatibility with MongoDB 3.0 and WiredTiger. New db.getCollectionNames(), db.getCollectionInfos(), collection.getIndexes() methods, backward compatible with earlier versions of MongoDb.
  • collectionsInfoCursor, listCollections, indexInformation methods of Db deprecated
  • use test instead of unittest package
  • add code coverage metrix with

0.1.46 #

  • Save method use upsert flag in accordance with mongodb docs

0.1.45 #

  • Remove validation for index keys.

0.1.44 #

  • Tailable cursor support added by sestegra. See tailable_cursor.dart in example directory.
  • Preliminary support for streaming in Aggregate framerork. Added method aggregateToStream
  • Added getBuildInfo command

0.1.43 #

  • Additional checks and descriptive error message against opening db in opening state, additional tests

0.1.42 #

  • Additional checks and descriptive error message against querying closed db

0.1.41 #

  • Bugfix for Issue 51 Can't reopen a closed database
  • API docs redirected to Issue 48

0.1.40 #

  • Better error handling when a connection with the database is lost. Thanks to luizmineo PR 50.
  • Future(List<String>) listCollections() helper added to Db
  • Future(List<String>) listDatabases() helper added to Db

0.1.39 #

  • Better error handling. Bugfix for issue 49

0.1.38 #

  • Initial support for replica set added by sestegra

0.1.37 #

  • Change log made compatible with pub site preferences, thanks to Andreas Olund.
  • API docs generation set up as hop task.

0.1.36 #

0.1.35 #

  • Ready for Dart 1.0

0.1.34 #

  • adding multiupdate support

0.1.33 #

  • Upgrade for Dart SDK version

0.1.32 #

  • Meta lib removed.

0.1.31 #

  • Upgrade for braking changes in dart:async (StreamEventTransformed removed from API). Ready for Dart SDK version

0.1.30 #

  • Version contraints removed from pubspec

0.1.29 #

  • Merge pull request from analogic. Added Future to save and removed unnecessary completers

0.1.28 #

  • Bugfix for count() method

0.1.27 #

  • New sample added. Readme rewritten.

0.1.26 #

  • Network data packets to MongoDb messages conversion refactored.

0.1.25 #

  • each() method is deprecated in favor of foEach(), so Cursor have more stream-like interface.
  • stream getter added to Cursor. After deprecation period find() will return Stream<Map> instead of Cursor

0.1.24 #

  • Added support for modifier builder for field level updates. See example/update.dart and testFieldLevelUpdateSimple

0.1.23 #

  • Updgrate for Dart SDK version (? operator removed)

0.1.22 #

0.1.21 #

0.1.20 #

  • Upgrade for Dart SDK version

0.1.19 #

  • Query API supports logical AND and OR operators.

0.1.18 #

  • Bugfix to fields() issue. Fields clause in find(), findOne() methods did not work. Relevant test and sample (in example/query.dart) added

0.1.17 #

  • Update for changed SelectorBuilder

0.1.15 #

  • mongo_dart_query published separately and added as dependency to mongo_dart. Unified SelectorBuilder will be used by mongo_dart and objectory.

0.1.14 #

  • Bson library published separately and added as dependency to mongo_dart

0.1.13 #

  • Upgrade in Bson for changed implementation of dart:typeddata in Dart SDK version

0.1.12 #

  • Upgrade for M4.

0.1.10 #

  • Switch from dart:scalarlist to dart:typeddata. Logging updated to new API.

0.1.9 #

  • Bug fix on Issue 18 about db.ensureIndex

0.1.8 #

  • Bug fix for unitialized BsonPlatform

0.1.7 #

  • Bug fix for MongoMessage header curruption

0.1.6 #

  • Support for dart SDK version

0.1.4 #

  • Support for Dart Editor version 0.4.1_r19425

0.1.3 #

  • GridFS refactored, now works on all old and added tests.

0.1.2 #

  • GridFS still broken, but in this version there is no malformed types from previous dart:io version

0.1.1 #

  • Support of dart:io version 2. (Stream-based).
  • WriteConcern introduced. method has writeConcern param, as individual modifying operations. Default writeConcern = WriteConcern.AKNOWLEDGED
  • writeConcern parameter replaced safeMode parameter on modifying operations
  • GridFS not yet ported to dart:io version 2.

0.0.14 #

  • Fixed bug in limit functionality. Corresponding test added.

0.0.12 #

  • M3 ready. Run on version

0.0.10 #

  • New syntax cleanUp. Next revisions will be published on No more need to use git dependency for dependend application.

0.0.9 #

  • Ted Sander joined project and added initial support of GridFS functionality

0.0.8 #

  • Fixed bux in database_tests.dart (Process did not ends cleanly)
  • Sdk package dependencies moved to

0.0.7 #

  • new syntax changes
  • Selector API changed
  • modifier_builder added

0.0.6 #

  • Repairing incomplete commit v0.0.5

0.0.5 #

  • DbCollection's update and insert methods got optional *safeMode- parameter
  • $err field set in MongoDB result object raises Error in mongo_dart
  • Db got createIndex and ensureIndex methods
  • Feature checklist added.

0.0.4 #

  • code updates for SDK r14458

0.0.3 #

  • Changes reflecting dart lib changes - methods to getters, such as String.charCodes(), Map.getKeys() and so on
  • New rules for optional function parameters applied
  • Tests reworked. Got rid of asyncTest. Use expectAsync1 within future chain() and then() methods.
pub points


unverified uploader

MongoDB driver, implemented in pure Dart. All CRUD operations, aggregation pipeline and more!

Repository (GitHub)
View/report issues


API reference




basic_utils, bson, collection, crypto, decimal, fixnum, logging, mongo_dart_query, path, pool, sasl_scram, uuid, vy_string_utils


Packages that depend on mongo_dart