MongoDB C++11 Driver 3.2.0-rc1

This is the second release candidate for mongocxx 3.2.0, the MongoDB C++11 driver.

This release includes fixes for bugs found in 3.2.0-rc0. Please see the 3.2.0-rc0 release notes for information on changes since the prior 3.1.x release series.

Please note that this version of mongocxx requires the MongoDB C driver 1.8.2.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.2.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.2.0-rc1 since 3.2.0-rc0 series are as follows:

Bug

• [CXX-1476] - Element search stops prematurely due to missing string length check

MongoDB C++11 Driver 3.2.0-rc0

This is the first release candidate for mongocxx 3.2.0, the MongoDB C++11 driver.

This release provides additional support for new features in MongoDB 3.4, introduces support for GridFS, and includes a large number of fixes and improvements since the 3.1.x release series.

Please note that this version of mongocxx requires the MongoDB C driver 1.8.2.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.2.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.2.0-rc0 since the prior 3.1.x series are as follows:

Bug

• [CXX-771] - Change collection methods to use options.max_time()
• [CXX-994] - Fix missing or misleading docs about pools, thread/fork safety and background monitoring
• [CXX-1014] - bsoncxx::builder::core exceptions are undocumented
• [CXX-1043] - Add doxygen tag for mongocxx and bsoncxx namespaces
• [CXX-1080] - Document autoIndexId as deprecated
• [CXX-1118] - BSON Regex flags must be alphabetically ordered
• [CXX-1144] - Mutator methods which return non-void should document their return value
• [CXX-1150] - bsoncxx builders should error when multiple keys are pushed without a value
• [CXX-1151] - bsoncxx::builder::core::view_document() and bsoncxx::builder::core::view_array() should throw when builder top-level BSON datum type is incorrect
• [CXX-1152] - Context enforcement for BSON stream builder doesn't play nicely with statements that leave open sub-documents or sub-arrays
• [CXX-1158] - Unable to link against SSL libs on MacOS
• [CXX-1163] - Compiling with SSL support doesn't work
• [CXX-1172] - Document `result::bulk_write::modified_count()` throws with mongod 2.4
• [CXX-1175] - Drivers MUST NOT require a username *in the URI* for MONGODB-X509
• [CXX-1178] - CMAKE_C_COMPILER, CMAKE_CXX_COMPILER not passed to CMake invocation for EP_mnmlstc_core
• [CXX-1187] - mongocxx::uri::database() segfaults if no database specified in URL
• [CXX-1196] - Improve mongocxx::instance documentation
• [CXX-1220] - Invalid URI passed to SSL unit test for mongocxx::pool
• [CXX-1228] - fix minor issues with stream builder and example
• [CXX-1231] - When patching include paths to use 'mnmlstc', avoid filename collisions (PR #582)
• [CXX-1242] - Index pages from each section in driver manual fail to render properly
• [CXX-1243] - Audit GridFS implementation for correct handling of user-provided and server-provided file lengths and chunk sizes
• [CXX-1246] - bsoncxx::builder::stream::single_context should not permit appending of multiple values
• [CXX-1252] - Tailable cursors only work once
• [CXX-1254] - Document that write_concern timeout of zero means no timeout
• [CXX-1258] - Cursor iterators lose lockstep at cursor end
• [CXX-1279] - Copy assignment for database/collection incorrectly degrades to no-op if rhs is default-constructed
• [CXX-1281] - collection::find() and collection::distinct() leak a mongoc_cursor_t on some error paths
• [CXX-1285] - aggregate sets read preference option incorrectly
• [CXX-1300] - Prevent mongoc_init/mongoc_cleanup from running more than once
• [CXX-1302] - Documentation for read_concern::acknowledge_string() should clarify that any read concern string can be passed in
• [CXX-1317] - bucket::upload_from_stream() and bucket::upload_from_stream_with_id() should abort upload on failure
• [CXX-1322] - gridfs::bucket::upload_from_stream and upload_from_stream_with_id infinitely loop on invalid ifstream without error bits set
• [CXX-1324] - Examples not running under Ubuntu 16.04 builders
• [CXX-1325] - Overly-greedy template substitution in declarations of comparison operator free functions for bsoncxx::types::value
• [CXX-1338] - Capped size in bytes is limited to 32bit integer, need 64bit integer
• [CXX-1341] - Wrong integer type for many CRUD spec API fields
• [CXX-1346] - PR: fixing more __imp_bson and __imp_mongoc linker errors
• [CXX-1347] - Calls to bson_append_* are not checked for errors in the core builder
• [CXX-1367] - bsoncxx::types::timestamp t and i parts are reversed
• [CXX-1387] - Bulk write operations don't inherit write concern from the collection
• [CXX-1441] - Build fails on Evergreen because of use of deprecated libmongoc API
• [CXX-1453] - Compilation fails on GCC 6 due to -Wignored-attributes
• [CXX-1454] - list_collections test fails with MMAPv1 storage engine
• [CXX-1458] - Deprecate ~frame() destructor, and add close() function as replacement
• [CXX-1461] - Missing UNREACHABLE in json.cpp
• [CXX-1463] - b_regex and b_codewscope constructors lack SFINAE protections

Epic

• [CXX-1257] - Revise static library naming and link configuration
• [CXX-1358] - Implement the index view API for the C++ driver
• [CXX-1372] - Implement the microbenchmark suite and generate scores for the driver

New Feature

• [CXX-915] - Add example of how to write a CMake project to build against the C++11 driver
• [CXX-995] - Add mongocxx::pool examples
• [CXX-1055] - Add new read_preference setters that support method chaining, deprecate existing setters and constructors
• [CXX-1060] - Adopting bsoncxx::stdx polyfills into mongocxx::stdx namespace is confusing
• [CXX-1075] - Add section to manua...

MongoDB C++11 Driver 3.1.3

This is the fourth stable release in the mongocxx 3.1.x series.

This release provides bug fixes since r3.1.2.

Please note that this version of mongocxx requires the MongoDB C Driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.1.3 since the prior 3.1.2 series are as follows:

Bug

• [CXX-1423] - Add missing include for <cassert> in tests

MongoDB C++11 Driver 3.1.2

This is the third stable release in the mongocxx 3.1.x series.

This release provides bug fixes since r3.1.1.

Please note that this version of mongocxx requires the MongoDB C Driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.1.2 since the prior 3.1.1 series are as follows:

Bug

• [CXX-1191] - Backport mongocxx::uri::database() segfaults if no database specified in URL
• [CXX-1371] - Backport fix for b_timestamp fields appending in wrong order

MongoDB C++11 Driver 3.1.1

This is the second stable release in the mongocxx 3.1.x series.

This release provides bug fixes since r3.1.0.

Please note that this version of mongocxx requires the MongoDB C Driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.1.1 since the prior 3.1.0 series are as follows:

Bug

• [CXX-1167] - Backport CXX-1163 - Compiling with SSL support doesn't work
• [CXX-1170] - Backport CXX-1158 - Unable to link against SSL libs on MacOS
• [CXX-1176] - Backport CXX-1043 - Add doxygen tag for mongocxx and bsoncxx namespaces

MongoDB C++11 Driver 3.1.0

This is the first stable release in the mongocxx 3.1.x series.

This release provides support for new features in MongoDB 3.4.

Please note that this version of mongocxx requires the MongoDB C Driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

Note that there are no changes since the prior 3.1.0-rc0 release, with the exception of two documentation fixes (CXX-1149 and CXX-1155).

The full list of user-visible issues that have been resolved in 3.1.0 since the prior 3.0.x series are as follows:

Bug

• [CXX-894] - Return disengaged result optionals for unack'ed write operations
• [CXX-938] - stdx polyfills are not declared in the ABI inline namespace
• [CXX-1001] - mongocxx::cursor.begin() increments the iterator
• [CXX-1009] - mongocxx::pool should take options::pool, not options::ssl
• [CXX-1039] - Update link to final collation page in 3.4 manual
• [CXX-1047] - MSVC warning C4714, bsoncxx operator <<, view() etc. marked as __forceinline not inlined
• [CXX-1061] - Update link to final views page in 3.4 manual
• [CXX-1065] - read_concern::acknowledge_string should return const string_view
• [CXX-1070] - Confusing installation instructions
• [CXX-1093] - collection::distinct() should return error to user if collation specified and connection max wire version < 5
• [CXX-1100] - Having more than one iterator per cursor violates mongoc lifecycle constraints
• [CXX-1109] - Integration tests should pass against server versions 2.4 through 3.0
• [CXX-1135] - Read preference option not applied to distinct
• [CXX-1149] - Links to MongoDB Manual in documentation should point to development version of manual instead of stable version

New Feature

• [CXX-778] - Allow configuration of SSL independently of the C driver
• [CXX-859] - Implement Decimal 128 type spec
• [CXX-927] - Support sending writeConcern for commands that write
• [CXX-948] - Support new readConcern level "linearizable"
• [CXX-957] - Allow a user to decide whether to build static or shared libraries
• [CXX-971] - Support providing collation per operation
• [CXX-976] - Allow users to set a limit on acceptable staleness
• [CXX-978] - Add application name and driver version to the MongoDB handshake
• [CXX-999] - Support read-only views
• [CXX-1042] - Write mongocxx configuration guide
• [CXX-1051] - Add new top-level find options and deprecate options::find::modifiers()
• [CXX-1053] - Add getters to options::create_collection/options::create_view/validation_criteria classes, make setters support chaining, deprecate to_document() methods
• [CXX-1059] - Add aggregation pipeline class builder methods for new MongoDB 3.4 stages and $geoNear / $indexStats stages
• [CXX-1124] - Username no longer required for MONGODB-X509 auth
• [CXX-1132] - Test that collection::find(), collection::find_one(), and collection::find_one_and_*() fail with error if collation specified and server lacks collation support
• [CXX-1134] - Add bsoncxx generic internal error code
• [CXX-1142] - Make minimum value of maxStalenessSeconds 90 seconds
• [CXX-1155] - Add Windows configure/build/test instructions to cxx driver manual

MongoDB C++11 Driver 3.1.0-rc0

This is the first release candidate for mongocxx 3.1.0, the MongoDB C++11 driver.

This release provides support for new features in MongoDB 3.4.

Please note that this version of mongocxx requires the MongoDB C driver 1.5.0.

See the MongoDB C++ Driver Manual and the Driver Installation Instructions for more details on downloading, installing, and using this driver.

NOTE: The mongocxx 3.1.x series does not promise API or ABI stability across patch releases.

The full list of user-visible issues that have been resolved in 3.1.0-rc0 since the prior 3.0.x series are as follows:

Bug

• [CXX-894] - Return disengaged result optionals for unack'ed write operations
• [CXX-938] - stdx polyfills are not declared in the ABI inline namespace
• [CXX-1001] - mongocxx::cursor.begin() increments the iterator
• [CXX-1009] - mongocxx::pool should take options::pool, not options::ssl
• [CXX-1039] - Update link to final collation page in 3.4 manual
• [CXX-1047] - MSVC warning C4714, bsoncxx operator <<, view() etc. marked as __forceinline not inlined
• [CXX-1061] - Update link to final views page in 3.4 manual
• [CXX-1065] - read_concern::acknowledge_string should return const string_view
• [CXX-1070] - Confusing installation instructions
• [CXX-1093] - collection::distinct() should return error to user if collation specified and connection max wire version < 5
• [CXX-1100] - Having more than one iterator per cursor violates mongoc lifecycle constraints
• [CXX-1109] - Integration tests should pass against server versions 2.4 through 3.0
• [CXX-1135] - Read preference option not applied to distinct

New Feature

• [CXX-778] - Allow configuration of SSL independently of the C driver
• [CXX-859] - Implement Decimal 128 type spec
• [CXX-927] - Support sending writeConcern for commands that write
• [CXX-948] - Support new readConcern level "linearizable"
• [CXX-957] - Allow a user to decide whether to build static or shared libraries
• [CXX-971] - Support providing collation per operation
• [CXX-976] - Allow users to set a limit on acceptable staleness
• [CXX-978] - Add application name and driver version to the MongoDB handshake
• [CXX-999] - Support read-only views
• [CXX-1042] - Write mongocxx configuration guide
• [CXX-1051] - Add new top-level find options and deprecate options::find::modifiers()
• [CXX-1053] - Add getters to options::create_collection/options::create_view/validation_criteria classes, make setters support chaining, deprecate to_document() methods
• [CXX-1059] - Add aggregation pipeline class builder methods for new MongoDB 3.4 stages
• [CXX-1124] - Username no longer required for MONGODB-X509 auth
• [CXX-1132] - Test that collection::find(), collection::find_one(), and collection::find_one_and_*() fail with error if collation specified and server lacks collation support
• [CXX-1134] - Add bsoncxx generic internal error code
• [CXX-1142] - Make minimum value of maxStalenessSeconds 90 seconds

MongoDB C++11 Driver 3.0.3

This is the third patch release of the new MongoDB C++11 driver. Please see the release notes for the 3.0.3 driver below for additional details on this new driver.

Please note that this version of the driver requires the MongoDB C driver 1.3.4 in order to build and exhibit expected behavior.

The MongoDB C++11 driver 3.0.x series does not promise API or ABI stability across patch releases. There are two API breaking changes in the 3.0.3 release:

• [CXX-1068] - Make bsoncxx iterators always const_iterators
• [CXX-1089] - document::element::operator[] overloads should not throw when given an invalid element

The full list of user-visible issues that have been resolved in 3.0.3 since the prior 3.0.2 release are as follows:

Bug

• [CXX-1018] - Document production/API/ABI stability across branches
• [CXX-1044] - collection::find() ignores find options "allow_partial_results" and "no_cursor_timeout"
• [CXX-1045] - collection::count() serializes options::count::hint incorrectly
• [CXX-1049] - Install target fails to install headers when source absolute path contains the substring "test"
• [CXX-1062] - read_concern::acknowledge_string() creates invalid read concern when attempting to set to server default
• [CXX-1063] - mongocxx::uri doesn't validate URI on construction
• [CXX-1068] - Make bsoncxx iterators always const_iterators
• [CXX-1072] - database::create_collection() sends invalid request to server when "no_padding" option is set to true
• [CXX-1089] - document::element::operator[] overloads should not throw when given an invalid element
• [CXX-1101] - collection::drop() throws exception when collection does not exist and connected to 3.0 mongod or earlier
• [CXX-1103] - bsoncxx test binary doesn't return test status in exit code
• [CXX-1116] - result::insert_one/insert_many returns possibly-dangling references for inserted ids, no definition provided for result::insert_many::result()

MongoDB C++11 Driver 3.0.2

This is the second patch release of the new MongoDB C++11 driver. Please see the release notes for the 3.0.1 driver below for additional details on this new driver.

Please note that this version of the driver requires the MongoDB C driver 1.3.4 in order to build and exhibit expected behavior.

The MongoDB C++11 driver 3.0.x series does not promise API or ABI stability across patch releases. There are some minor API breaking changes in the 3.0.2 release. We apologize for any inconvenience. We are aiming to achieve API stability for the upcoming 3.1.x series. Some known changes include:

• bsoncxx::oid objects are now default initialized to a valid state
• JSON-ification of element and types has been removed
• JSON formatting has changed to use libbson's JSON algorithm

Bug

• [CXX-878] - max_time->count(), seconds.count() ambiguous
• [CXX-879] - Error-prone use of std::time_t in bsoncxx::types::b_date
• [CXX-880] - MongoDB C++11 driver fails to build on FreeBSD
• [CXX-893] - Link errors in Debug Build
• [CXX-896] - Use chrono::duration for mongocxx::options::index::expire_after_seconds
• [CXX-917] - SSL support is examining the wrong define to detect C driver SSL support
• [CXX-919] - BSON Null should not be discouraged
• [CXX-934] - Remove database::stats()
• [CXX-940] - Default constructed bsoncxx::oid object is dangerous
• [CXX-941] - When converting to JSON, strings are not escaped
• [CXX-986] - Invalid error handling in find_and_modify - null pointer access
• [CXX-988] - Fix documentation of invalid element access
• [CXX-1010] - PR: Use a regular string not a raw string for MSVC2015
• [CXX-1011] - PR: Support finding libbson and mongo_c on Windows when pkg-config is present
• [CXX-1034] - unique_ptr T type for document and array value should be array-ish
• [CXX-1040] - Segmentation fault in instance_management

Improvement

• [CXX-861] - Documentation missing examples for accessing data
• [CXX-881] - Change mongocxx::options setters to return a self reference
• [CXX-882] - Incorrect mongoc include path, non-pkgconfig
• [CXX-886] - Add the $lookup pipeline operator
• [CXX-887] - Create an example of getting _id's from insert results
• [CXX-890] - Add an example that shows how to manage a long-lived instance object
• [CXX-902] - Reduce flushes on output operations...
• [CXX-904] - Grammatical errors in API documentation...
• [CXX-916] - Documented exceptions are incorrect

New Feature

• [CXX-784] - Add ability to use document::view with stream builder
• [CXX-875] - Database::has_collection has ambiguous error modes

MongoDB Legacy C++ Driver 1.1.2

This is a minor patch release above the prior legacy-1.1.1 release, and is a recommended upgrade for all users of legacy-1.1.1 or older legacy driver releases.

There are only trivial differences between this release and the legacy-1.1.1 release, below. This release is being issued to roll up backports from MongoDB r3.0.8...r3.0.12.

Bug

• [CXX-899] - Update documentation of third-party licenses
• [CXX-906] - Null dereference in DBClientWithCommands methods: getCollectionNames(), getCollectionInfos(), exists()
• [CXX-920] - ConfError utility is not defined in the legacy driver build system
• [CXX-921] - legacy driver fails to build on FreeBSD
• [CXX-924] - legacy driver fails to build on Hurd
• [CXX-928] - "KeyError: 'MONGO_SSL'" build error in non-SSL legacy builds

Improvement

• [CXX-832] - Friendlier error message when decoding Decimal128 BSONElements

Task

• [CXX-850] - Backport server r3.0.8..r3.0.12 changes