MongoDB-v2.2.2/000755 000766 000024 00000000000 13715253235 013431 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/inc/000755 000766 000024 00000000000 13715253235 014202 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/LICENSE000644 000766 000024 00000026136 13715253235 014446 0ustar00davidstaff000000 000000 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. MongoDB-v2.2.2/Changes000644 000766 000024 00000204333 13715253235 014731 0ustar00davidstaff000000 000000 # Change history for the MongoDB Perl driver: v2.2.2 2020-08-13 11:04:29-04:00 America/New_York [!!! END OF LIFE NOTICE !!!] - As of August 13, 2020, the MongoDB Perl driver has reached end of life and is no longer supported by MongoDB. v2.2.1 2019-12-12 23:29:11-05:00 America/New_York [!!! END OF LIFE NOTICE !!!] - Version v2.2.0 is the final feature release of the MongoDB Perl driver. The driver is now in a 12-month "sunset" period and will receive security patches and critical bug fixes only. The Perl driver will be end-of-life and unsupported on August 13, 2020. [Bug Fixes] - PERL-1118 Improved URI sanitization - PERL-1121 MongoDB::BulkWriteResult had incorrect elements in inserted[] - PERL-1125/PERL-1126 Error connecting using mongodb+srv style URI - PERL-1127 BulkWriteView doesn't support update pipelines - PERL-1129 TLS URI options not used in connections v2.2.0 2019-08-13 07:19:10-04:00 America/New_York [!!! END OF LIFE NOTICE !!!] - Version v2.2.0 is the final feature release of the MongoDB Perl driver. The driver is now in a 12-month "sunset" period and will receive security patches and critical bug fixes only. The Perl driver will be end-of-life and unsupported on August 13, 2020. [*** Deprecations ***] - PERL-993 Deprecate parallel_scan [Additions] - PERL-789 OP_MSG support - PERL-920 Add option for applications to register a custom server selector - PERL-989 Implement SDAM monitoring - PERL-1008 Support index all paths - PERL-1021 Implement Unified URI Options - PERL-1022 Implement Convenient API for Transactions - PERL-1024 Support mongos pinning for sharded transactions - PERL-1025 Retryable Reads - PERL-1026 Support polling SRV records for mongos discovery - PERL-1035 Support sharded transactions recovery token - PERL-1046 Add database aggregation method - PERL-1052 Support 'startAfter' option to the $changeStream stage - PERL-1053 Add support for Zstandard compression - PERL-1060 Add support for Snappy compression - PERL-1070 Support postBatchResumeToken in change streams - PERL-1082 Add the ability to specify a pipeline to an update command - PERL-1098 Allow applications to set maxTimeMS for commitTransaction - PERL-1105 Support aggregation $merge stage [Changes] - PERL-785 Call "ping" on a socket that has been idle for socketCheckIntervalMS - PERL-1028 Support server connections that survive primary stepdown - PERL-1054 Disable TLS renegotiation when possible (security) - PERL-1057 Use majority write concern when retrying commitTransaction - PERL-1068 Make Retryable Writes on by Default - PERL-1075 Add support for read concern to aggregation $out - PERL-1100 Specify behavior where connection string contain auth database but no credentials [Bug Fixes] - PERL-927 Ensure hint used with aggregate is string or IxHash or BSON::Doc - PERL-930 Allow use of BSON::Raw for insert, update, etc. - PERL-970 Can't use BSON::Doc as sort option in find command - PERL-988 Index lists should preserve key order in results - PERL-994 GridFS DownloadStream warns in spec tests on old perls - PERL-1012 Driver doesn't clear session pool after fork - PERL-1017 Ignore db and collection read concern in transaction - PERL-1033 Pod link error - PERL-1041 Bulk Write Op calls result method on non-object error - PERL-1057 Use majority write concern when retrying commitTransaction - PERL-1058 Drivers should ignore batchSize=0 for aggregate with $out - PERL-1061 The driver fails to parse a URI if mongodb+srv format is used and the ssl=true option is set - PERL-1076 Ensure that getMore right after a resume is retried in changestreams - PERL-1083 Work around StaleDbVersion distinct bug - PERL-1096 ChangeStream spec's Resumable Error definition is too broad - PERL-1097 Discard ServerSessions involved in network errors - PERL-1123 Raise better error for retryable writes with mmapv1 [Testing] - PERL-806 Test Driver Wire Version Overlap logic - PERL-833 Test QueryResult destructor kills cursor - PERL-867 Resync GridFS tests to add test for legacy GridFS, where no filename was set - PERL-976 Test only the initial command in a transaction includes readConcern - PERL-996 Resync read write concern tests to add new read concern levels - PERL-1018 Test deleteMany and updateMany with retryWrites=true - PERL-1048 Transaction test runner should use "local" read concern when asserting the final collection state - PERL-1051 Update CRUD spec tests to use transaction spec test format - PERL-1074 Resync transaction spec tests for bulk write error reporting change - PERL-1090 Amend change stream missing resume token tests for MongoDB 4.2+ - PERL-1095 Stop testing with threads (too many errors on process exit) - PERL-1109 Fix result assertion in change stream spec test [Documentation] - PERL-780 Document that TCP keepalive defaults to true - PERL-972 Amend transaction examples - PERL-986 Causal Consistency Examples - PERL-1056 Update Transactions Retry Example 3 to include read preference - PERL-1085 Document connection string and URI option precedence rules - PERL-1101 Documentation for countDocuments mentions estimatedDocumentCount - PERL-1112 Update change stream docs example for resume token access - PERL-1117 Specify effect of client-side errors on in-progress transactions [Prerequisites] - PERL-841 Remove Try::Tiny as a dependency - Bump BSON to v1.12.0 and BSON::XS (optional) to v0.8.0 - Bump Path::Tiny to 0.058 [~ Internal Changes ~] - PERL-921 Only send bypassDocumentValidation if it's true - PERL-935 Consolidate session vs retryable write feature detection - PERL-1078 countDocuments should internally use group with _id: 1 v2.1.2 2019-08-05 19:29:08-04:00 America/New_York (TRIAL RELEASE) v2.1.1 2019-08-02 12:48:13-04:00 America/New_York (TRIAL RELEASE) v2.1.0 2019-02-06 16:59:56-05:00 America/New_York (TRIAL RELEASE) v2.0.3 2019-02-07 10:43:16-05:00 America/New_York [Bug fixes] - PERL-1061 The driver fails to parse a URI if mongodb+srv format is used and the ssl=true option is set v2.0.2 2018-11-30 13:57:28-05:00 America/New_York [Bug fixes] - PERL-927 Coerce hint to IxHash or BSON::Doc if not string - PERL-927 Skip count hint test before MongoDB 3.6 - PERL-970 Allow BSON::Doc as sort argument - PERL-988 Preserve index key order in results - PERL-1012 Clear session pool on reconnect after fork/thread - PERL-1041 Check bulk error can call result before calling it [Testing] - PERL-806 Check compatibility for SDAM tests - PERL-972 PERL-1005 Amended transaction examples - PERL-1006 Enable retry_writes during testing [Documentation] - PERL-1033 Fix docs link to BSON/wrap_numbers [Prerequisites] - Requires BSON v1.10.1; if compiler is available, will require BSON::XS v0.6.0. v2.0.1 2018-07-10 18:05:38-04:00 America/New_York [Additions] - PERL-897 'nameOnly' option added to 'list_collections' for efficiency [Bug Fixes] - PERL-953 Suppress warnings when using compression without specifying a compression level. - PERL-959 Undefer constructor in the private constructor to ensure cursors are cleaned up on destructions. [Documentation] - PERL-952 Show how to upgrade v2 over v1 while avoiding shadows - PERL-967 Document more clearlly that X509 doesn't need a 'username' parameters, as the username is extracted from the certificate. - PERL-968 Fix various spelling errors [Prerequisites] - PERL-958 BSON::XS not available on Windows before Vista - Bumped BSON.pm prereq to v1.6.6 for a BSON::Timestamp bug fix v2.0.0 2018-06-26 14:55:50-04:00 America/New_York [!!! Incompatible Changes !!!] - PERL-640 Remove bundled MongoDB::BSON codec and use BSON.pm and/or BSON::XS instead. While this is a sweeping change, applications that relied on the default encoder are likely to need minimal changes. MongoDB type wrapper classes will encode correctly, but decoded wrappers will be from the BSON.pm library instead. See MongoDB::Upgrading for more details. Additionally, with this change, the MongoDB driver can now be used without a compiler. - PERL-742 Require Perl 5.10.1 or later - PERL-871 Remove features and methods deprecated in v1.0.0 [*** Deprecations ***] - PERL-718 Deprecate find option 'modifiers' - PERL-856 Deprecate 'md5' field in GridFS file documents - PERL-872 Deprecate maxScan find option - PERL-873 Deprecate cursor snapshot option - PERL-926 Deprecate 'count' method [Additions] - PERL-710 Support authSource URI option - PERL-718 Add find options to replace deprecated 'modifiers' option - PERL-768 Added support for aggregation hints - PERL-778 Add support for wire protocol compression - PERL-782 Add maxTimeMS option to Indexview methods - PERL-787 Implement arrayFilters support - PERL-790 Implement Drivers Sessions API - PERL-791 Change stream support - PERL-792 Implement Retryable Writes - PERL-793 Causally Consistency read support - PERL-805 Implement database enumeration spec - PERL-807 Implement DNS Seedlist Discovery (mongodb+srv://...) - PERL-808 Add support for aggregation comment option - PERL-863 Implement SCRAM-SHA-256 authentication - PERL-875 Multi-document ACID transactions (replica sets only) - PERL-883 Implement command monitoring - PERL-912 Add 'watch' methods to MongoDB::Database and MongoDB::MongoClient - PERL-940 Added 'startAtOperationTime' option to 'watch' methods - PERL-944 Add 'client' method to MongoDB::Database [Bug fixes] - PERL-690 Fix undefined reference to strerror_r on Windows - PERL-781 Prevent index drop errors for no collection - PERL-783 Check username/password are URI-escaped - PERL-865 Fix wide character error in auth - PERL-887 Fix topology_status with refresh - PERL-891 Fix bugs found during command monitoring testing (bulk_write write concern, query limit propagation, cursor internal accounting) - PERL-936 Added session support to 'watch' for MongoDB::Collection - PERL-948 Refactor op dispatching to avoid introducing circular refs in session management [Changes] - PERL-641 Make legacy typewrappers into subclasses of BSON.pm classes - PERL-733 Require ordered document for run_command - PERL-794 Improve resolution of GridFS uploadDate - PERL-816 Improve error message for incompatible MongoDB versions - PERL-864 Improve auth error messages [Documentation] - PERL-768 Document GridFS uniqueness constraints - PERL-788 Amend MongoDB::Cursor docs - PERL-809 Added t/examples/changestream.t - PERL-859 Added tests with example code for MongoDB's docs site - PERL-859 Add test examples for aggregate, run_command and indexing - PERL-866 Document how to use the latest TLS protocols - PERL-903 Revise MongoDB::DataTypes and MongoDB::Tutorial - PERL-908 Add transaction examples for docs - PERL-917 Fix minor spelling error [Prerequisites] - PERL-900 Conditionally require XS dependencies (BSON::XS, Class::XSAccessor and Type::Tiny::XS) - PERL-934 Bumped Authen::SCRAM prerequisite to work around deep dependency issues - PERL-941 Bump BSON prereq to v1.6.5 for BSON::Time fix on 32-bit perls - PERL-947 Require Authen::SCRAM 0.011 to avoid memory leak [Removals] - PERL-765 Remove DateTime from driver code and tests [Testing] - PERL-668 Update SDAM spec tests - PERL-671 Update CRUD testing data files - PERL-700 Fix app_name test for multi-shard topologies - PERL-719 Resync CRUD spec tests - PERL-726 Update deprecated 'last_error' test - PERL-727 Fix GridFS tests on Windows - PERL-907 Test with BSON Codec using full wrapping - PERL-951 Make await cursor test more robust [~ Internal changes ~] - PERL-666 Eliminate Module::Install in Makefile.PL - PERL-715 Force localhost to connect via IPv4 - PERL-767 Cache SCRAM-SHA-1 client key - PERL-826 Stop sending maxAwaitTimeMS if not set - PERL-900 Vendor ExtUtils::HasCompiler - PERL-937 Gossip cluster time during SDAM v1.999.1 2018-06-23 23:41:05-04:00 America/New_York (TRIAL RELEASE) v1.999.0 2018-06-15 12:38:56-04:00 America/New_York (TRIAL RELEASE) v1.8.3 2018-06-25 12:20:13-04:00 America/New_York [Bug fixes] - PERL-923 Fix user/password percent encoding validation v1.8.2 2018-05-22 12:24:02-04:00 America/New_York [Bug fixes] - PERL-870 Repeated credential validation may skip validation after first failure - PERL-878 - Update Authen::SCRAM prereq to fix unicode bug - PERL-879 - Deprecate snapshot option - PERL-882 - Document how to use the latest TLS protocols - PERL-906 - Work around new version of Type::Tiny::XS with a stricter definition of type Bool v1.8.1 2018-01-17 10:44:22-05:00 America/New_York [Bug fixes] - PERL-770 Repeated find_one queries sometime result in MongoDB::ProtocolError on short network reads. - PERL-796 Improve resolution of GridFS uploadDate. - PERL-803 Kerberos authentication not working in 1.8.0 version using some SASL backends. - PERL-825 Unacknowledged insert_many throws an error. - PERL-828 maxTimeMS incorrectly sent on tailable await cursors. [Testing] - PERL-800 CI testing no longer tests against EOL MongoDB 2.4. - PERL-832 Skip Windows thread tests with SASL to avoid wrong pool in global destruction test failures. [Documentation] - PERL-795 Document that GridFS filename+uploadDate must be unique. - PERL-798 Fix typos in Tutorial.pod. [Prerequisites] - PERL-844 Timeout configs not supported for older IO::Socket::IP, so minimum version bumped to 0.32. v1.8.0 2017-04-10 14:05:59-04:00 America/New_York [Additions] - PERL-713 PERL-714 A username parameter no longer required for MONGODB-X509 auth. The username will be extracted from the client certificate. [Bug fixes] - PERL-717 Avoid address lookup for localhost to workaround IO::Socket::IP quirks. - PERL-746 Fix GridFS tests on Windows if checked out from the repository - PERL-763 Fix Makefile.PL for no '.' in @INC. [~ Internal Changes ~] - PERL-760 Switch to binary SASL payloads for compatibility with MongoDB Atlas Free Tier. - PERL-761 Replace OP_KILL_CURSORS with killCursors command for compatibility with MongoDB Atlas Free Tier. [Prerequisites] - PERL-843 Bump IO::Socket::IP prereq to 0.32 for Timeout support v1.6.1 2017-01-10 09:26:56-05:00 America/New_York [Bug fixes] - PERL-711 Support authSource URI parameter - PERL-712 Undefined reference to strerror_r on Windows v1.6.0 2016-11-29 12:12:26-05:00 America/New_York [*** Deprecations ***] - PERL-643 No new deprecations, but deprecated methods now issue warnings and a stack trace once per call-site. [Additions] - PERL-443 Database->collection_names takes an optional filter parameter. - PERL-611 Add support for the BSON Decimal128 type, available in MongoDB v3.3.8 or later. Adds a dependency on BSON::Decimal128 as the type-wrapper for this type. - PERL-620 Add support for GridFS files with custom file_id values. - PERL-626 PERL-680 PERL-684 Add support for maxStalenessSeconds configuration parameter, available for use with MongoDB v3.4.0 or later. - PERL-627 Add support for sending write concern for all database commands that allow it (varies based on server version). Exceptions will be thrown if write concern is requested for a command and the server version does not support it. - PERL-635 Add support for collation option to CRUD and index building methods, available in MongoDB v3.4.0 or later. - PERL-649 Report driver information, system information, and user-configured application name to server during connection handshake. [Bug fixes] - PERL-582 Fix some edge cases in URI parsing. - PERL-630 ReadConcern level must always be lower-case when sent to server. - PERL-632 Fix server selection bugs in the case of read preferences with multiple tag-set entries. - PERL-670 Make collection drop check for server error codes, not just a magic text error string. - PERL-685 Cached primary for server selection now expires based on heartbeat frequency. - PERL-687 Add support for bson_codec specific OID generation if the codec has a "create_oid" class method (forthcoming in BSON.pm). [Changes] - PERL-644 Use of threads is no longer supported on perls before 5.8.5. [Testing] - PERL-665 Make index creation tests robust against changes in server treatment of arbitrary options. - PERL-675 Make fsync tests more robust by removing tests for specific error strings. [Documentation] - PERL-657 Fix spelling typos. - PERL-662 Update collation documentation links. - PERL-664 Add Decimal128 type example. [~ Internal changes ~] - PERL-573 Generate a default ReadPreference if not specified in the private _ReadOp role. - PERL-645 Refactor internal roles. - PERL-667 Add and pass Perl::Critic tests before release. v1.5.0 2016-09-19 15:26:09-07:00 America/Los_Angeles (TRIAL RELEASE) v1.4.5 2016-08-22 15:40:36-04:00 America/New_York [Bug fixes] - PERL-652 The deprecated legacy 'update' method had a bug that wouldn't allow an empty replacement document (which destroys all fields except for _id). While strange, this now works. v1.4.4 2016-07-27 15:06:43-04:00 America/New_York [Bug fixes] - PERL-647 Authenticate always to topology type Single to ensure auth happens for hidden or uninitialized replica set members. v1.4.3 2016-07-18 16:05:16-04:00 America/New_York [Bug fixes] - PERL-636 Fix application of read preference to mongos - PERL-638 Fix application of query modifiers for MongoDB server 3.2+ v1.4.2 2016-06-14 09:30:05-04:00 America/New_York [Bug fixes] - PERL-622 Fixed GridFSBucket uploads when Class::XSAccessor is not installed. NOTE: Class::XSAccessor is currently listed as a requirement for MongoDB. This and PERL-621 lay the groundwork for making the driver optionally pure-Perl. v1.4.1 2016-05-17 13:34:58-04:00 America/New_York [Bug fixes] - PERL-621 Fixed GridFSBucket uploads when Class::XSAccessor (an optional dependency for Moo) is not installed. [Documentation] - Consolidated v1.3.x change notices into section v1.4.0 v1.4.0 2016-05-10 16:59:16-04:00 America/New_York [*** Deprecations ***] - The MongoDB::GridFS and MongoDB::GridFS::File classes are deprecated in favor of the MongoDB::GridFSBucket and related classes. It will be removed in a future major release. [Additions] - PERL-610 Adds support for maxTimeMS for parallel_scan (available in MongoDB 3.4). - Adds MongoDB::GridFSBucket class, which implements the new driver-standard GridFS API. Also included are classes to emulate file handles for uploads and downloads, making GridFS operations more composable with existing Perl libraries. [Bug fixes] - PERL-619 Fixed BSON memory leak when throwing exceptions during encoding or decoding. - Invalid BSON documents (e.g. invalid length, not null-terminated) were silently ignored; the driver now correctly throws an error. - bypassDocumentValidation is now sent as a boolean. [Documentation] - Fixed index creation examples. - Fixed some typos and broken POD links. [~ Internal changes ~] - 'insert_one' with write concern {w:0} is sent via the legacy OP_INSERT wire protocol for reduced latency. - Optimized some query/command execution paths. v1.3.4 2016-04-27 11:06:55-04:00 America/New_York (TRIAL RELEASE) v1.3.3 2016-03-08 15:10:33-05:00 America/New_York (TRIAL RELEASE) v1.3.2 2016-01-26 16:44:09-05:00 America/New_York (TRIAL RELEASE) v1.3.1 2015-12-23 12:03:47-05:00 America/New_York (TRIAL RELEASE) v1.3.0 2015-12-18 12:21:09-05:00 America/New_York (TRIAL RELEASE) v1.2.3 2016-03-08 15:15:36-05:00 America/New_York [Testing] - Fixed tests for v3.3.X MongoDB series [Documentation] - Fixed method and attribute documentation in MongoDB::BSON::Regexp v1.2.2 2016-01-26 15:33:30-05:00 America/New_York [Bug fixes] - PERL-602 Support legacy Cpanel::JSON::XS booleans (before 2.3404) - PERL-604 Improve detection of stale primaries when a replica set election protocol version is being upgraded/downgraded. - Fix uninitialized 'inserted_count' in MongoDB::InsertManyResult [Documentation] - Fixed broken link in POD for MongoDB::DataTypes v1.2.1 2015-12-18 11:32:19-05:00 America/New_York [Bug fixes] - PERL-599 Fix bson/bson-error.c compilation problem on Win32 v1.2.0 2015-12-07 12:55:11-05:00 America/New_York [Additions] - PERL-561 Add support for bypassDocumentValidation option to relevant CRUD methods. - PERL-564 Add support for readConcern (for MongoDB 3.2 only). - PERL-569 Add 'batch' method to QueryResult for retrieving a chunk of results instead of just one (via 'next') or all. - PERL-594 Add maxAwaitTimeMS option for tailable-await cursors on MongoDB 3.2 servers. - Add find_id method to MongoDB::Collection for easy retrieval of a single document by _id. - Add support for write concern find-and-modify-style methods (for MongoDB 3.2 only) [Bug fixes] - PERL-493 Don't send writeConcern if it is not set; this allows the user to get the default write concern set on the server. - PERL-571 Add -D_GNU_SOURCE to ccflags if needed. - PERL-597 Check findAndModify-type command results for writeConcernErrors (for MongoDB 3.2 only). [Changes] - PERL-595 Change limit/batchSize behavior to match CRUD spec; most users won't notice the difference, but generally speaking, when there is both a limit and a batch size, under MongoDB 3.2, the batch size is respected if it is smaller than the limit. Previously, in some cases, the batch size was ignored and the limit used instead. [Documentation] - PERL-570 Update MongoDB::Cursor::info documentation. - Replace term 'slave' with 'secondary' in docs. [Testing] - Skip fsync test on inMemory storage engine. [~ Internal changes ~] - PERL-558 Implement fsyncUnlock as a command for MongoDB 3.2+. - PERL-563 Implement find/getMore/killCursors as commands for MongoDB 3.2+. - Verify that server replies are less than maxMessageSizeBytes. v1.1.1 2015-12-01 20:24:04-05:00 America/New_York (TRIAL RELEASE) v1.1.0 2015-11-18 10:37:37-05:00 America/New_York (TRIAL RELEASE) v1.0.4 2015-12-02 10:21:03-05:00 America/New_York [Bug fixes] - PERL-571 Add -D_GNU_SOURCE to ccflags if needed. [Documentation] - Fixed SYNOPSIS bug in MongoDB::IndexView for create_many v1.0.3 2015-11-03 22:25:12-05:00 America/New_York [Bug fixes] - Fixed BSON encoding tests for big-endian platforms. v1.0.2 2015-10-14 15:26:30-04:00 America/New_York [Bug fixes] - PERL-198 Validate user-constructed MongoDB::OID objects; also coerces to lower case for consistency with generated OIDs. - PERL-495 Preserve fractional seconds when using dt_type 'raw' - PERL-571 Include limits.h explicitly rather than relying on other headers to load it. - PERL-526 Detect stale primaries by election_id (only supported by MongoDB 3.0 or later) - PERL-575 Copy inflated booleans instead of aliasing them. - Fix a failing test in the case where a user is running a single-node replica set. [Documentation] - PERL-532 Document loss of precision when serializing long doubles - Noted that IPv6 support requires IO::Socket::IP (core since Perl v5.20.0). [Prerequisites] - PERL-579 Require at least version 0.25 of boolean.pm [~ Internal changes ~] - PERL-475 Optimize 'all' QueryResult method v1.0.1 2015-09-22 12:55:08-04:00 America/New_York [Bug fixes] - PERL-567 Fixed a failing test in the case where a user is running a replica set on the default port 27017. [Documentation] - PERL-568 Fixed SYNOPSIS of MongoDB.pm - Clarified some confusing sections of MongoDB::Tutorial and added hyperlinks to documentation for methods used in the tutorial. - Clarified some sections of MongoDB::Collection and MongoDB::Cursor and added some hyperlinks. v1.0.0 2015-09-21 16:15:04-04:00 America/New_York [!!! Incompatible Changes !!!] - The v1.0.0 driver includes numerous incompatible changes; users are STRONGLY encouraged to read MongoDB::Upgrading for advice on upgrading applications written for the 'v0' driver. - PERL-221 The 'inflate_regexps' MongoDB::MongoClient option has been removed. BSON regular expressions always decode to MongoDB::BSON::Regexp objects. This ensure safety and consistency with other drivers. - PERL-330 The driver now uses pure-Perl networking; SSL and SASL now implemented via optional CPAN modules IO::Socket::SSL and Authen::SASL. - PERL-442 Connection string options have revised to match MongoClient options; connection string options always take precedence over MongoClient constructor arguments. - PERL-470 The MongoDB::Cursor globals "slave_ok" and "timeout" no longer have any effect and have been removed. - PERL-471 The MongoDB::Cursor 'snapshot' method now requires a boolean argument. - PERL-505 When bulk inserting a document without an '_id' field, the _id will be added during BSON encoding, but the original document will NOT be changed. (This was the case for regular insertion in the v0.x series, but not for the Bulk API.) - PERL-519 The $MongoDB::BSON::use_binary global variable has been removed. Binary data always decodes to MongoDB::BSON::Binary objects (which now overload stringification). This ensures that binary data will correctly round-trip. - PERL-520 The $MongoDB::BSON::utf8_flag_on global variable has been removed. BSON strings will always be decoded to Perl character strings. This ensures that string data will correctly round-trip. - PERL-523 Requires a replica set name explicitly to connect to a replica set. Connecting to a single host is always in a 'direct' mode otherwise. - PERL-546 MongoDB::DBRef objects no longer have a 'fetch' method or 'client' attribute. This is consistent with the design of the MongoDB drivers for other language. For the Perl driver, specifically, it decouples the BSON model from the MongoClient model, eliminates a circular reference, and avoid Perl memory bugs using weak references under threads. - MongoDB::MongoClient configuration options are now read-only and may not be modified after client construction. - The $MongoDB::BSON::looks_like_number and $MongoDB::BSON::char global variables now ONLY have an effect at MongoDB::MongoClient construction. Changing them later does not change BSON encoding. Both are deprecated as well and should not be used in new code. Instead, the enhanced MongoDB::BSON codec class has attributes that encapsulate these behaviors. - The 'dt_type' MongoDB::MongoClient option has been deprecated and made read-only. It now only takes effect if C constructs a MongoDB::BSON codec object and is read-only so that any code that relied on changing it after client construction will fail rather that being silently ignored. - The 'inflate_dbrefs' MongoDB::MongoClient option has been removed. By default, dbrefs are always inflated to MongoDB::DBRef objects. - The MongoDB::MongoClient 'read_preference' method is no longer a mutator. It is now only an accessor for a MongoDB::ReadPreference object constructed from 'read_preference_mode' and 'read_preference_tag_sets'. - The legacy read preference constants in MongoDB::MongoClient have been removed, as they are no longer are used with the new MongoDB::ReadPreference class. - The MongoDB::MongoClient 'authenticate' method has been removed; credentials now must be passed via configuration options and authentication is automatic on server connection. - The MongoDB::Cursor class has been split. Actual result iteration is done via a new MongoDB::QueryResult class. - MongoDB::Error exception objects are now used consistently throughout the driver, replacing other error mechanism and raw "die" calls. - The MongoDB::WriteResult class was renamed to MongoDB::BulkWriteResult. - The long-deprecated MongoDB::Connection class has been removed. - Low-level client functions have been removed. [*** Deprecations ***] - PERL-398 The MongoDB::MongoClient 'timeout' and 'query_timeout' options are deprecated in favor of new, more explicit 'connect_timeout_ms' and 'socket_timeout_ms' options. - PERL-424 The MongoDB::Cursor 'count' method has been deprecated. - PERL-464 The MongoDB::Database 'last_error' method has been deprecated. - PERL-507 MongoDB::Collection 'get_collection' method is deprecated; it implied sub-collections, which don't actually exist in MongoDB. - PERL-511 The old CRUD method names for the MongoDB::Bulk API have been deprecated in favor of names that match the new MongoDB::Collection CRUD API. - PERL-516 The MongoDB::Collection index management methods have been deprecated in favor of the new MongoDB::IndexView API. - PERL-533 The MongoDB::Collection 'save' method has been deprecated. - PERL-534 The MongoDB::Collection 'validate' method has been deprecated. - PERL-559 The MongoDB::Database 'eval' method has been deprecated, as the MongoDB server version 3.0 deprecated the '$eval' command. - The MongoDB::MongoClient 'sasl' and 'sasl_mechanism' config options have been deprecated in favor of the more generic 'auth_mechanism' option. - Legacy MongoDB::Collection CRUD methods (insert, update, etc.) have been deprecated in favor of new CRUD API methods. - MongoDB::CommandResult changed the name of the accessor for the document returned by the server to 'output' instead of 'result' for clarity. The 'result' method is deprecated. - As mentioned above, 'dt_type', '$MongoDB::BSON::looks_like_number' and '$MongoDB::BSON::char' have been deprecated in addition to their other behavior changes. [Additions] - PERL-93 Implemented awaitData cursor support. - PERL-135 Added the ability to set write_concern at database and collection level, rather than only in MongoDB::MongoClient. - PERL-233 Implemented SSL certificate support via IO::Socket::SSL options. - PERL-375 Added support for cursor options to the MongoDB::Collection 'find_one' method. - PERL-378 Implemented the cross-driver Server Discovery and Monitoring specification. - PERL-379 Implemented the cross-driver Server Selection specification. - PERL-406 Allowed count methods to work with query hints. - PERL-408 Implemented SCRAM-SHA-1 and revised handshake for MongoDB 3.0 and later. - PERL-413 Added max_time_ms as a MongoDB::MongoClient configuration option to set a default for database and collection objects. - PERL-422 Added support for specifying read preferences in the connection string URI. - PERL-465 Added support for arbitrary options on index creation. - PERL-466 Added the ability to set read preference at the database and collection level. - PERL-486 Added 'has_modified_count' method to MongoDB::UpdateResult and MongoDB::BulkWriteResult to ease detection of when that attribute is supported by a server or not. - PERL-490 Added 'list_collections' method to MongoDB::Database. - PERL-500 Added 'topology_status' method to MongoDB::MongoClient. - PERL-502 and PERL-503 Implemented new common driver CRUD API specification in MongoDB::Collection. - PERL-506 Added support for serializing/deserializing Time::Moment objects. - PERL-515 Added new MongoDB::IndexView API. - PERL-554 Implemented 'server_selection_try_once' configuration option on MongoDB::MongoClient. - Added an optional read preference argument to 'run_command'. - Added 'db' and 'coll' methods as aliases for 'get_database' and 'get_collection' on MongoDB::MongoClient and MongoDB::Database, respectively. - Added the 'get_namespace' method to MongoDB::MongoClient (with the alias 'ns'), to get a MongoDB::Collection object directly from a MongoDB::MongoClient object. - Added a 'connect' class method to the MongoDB class for syntactic sugar to create a client object. - Added a 'with_codec' method to MongoDB::Collection for easier localized changes to BSON codec attributes. - Added a 'reconnect' method to MongoClient to handle reconnection after a fork or thread spawn. - Added support for correctly encoding boolean objects from JSON::XS, Cpanel::JSON::XS, JSON::PP, JSON::Tiny and Mojo::JSON. [Bug Fixes] - PERL-146 Normalized server addresses to lower case. - PERL-401 Fixed index creation to always have a non-zero write concern. - PERL-409 Added missing declarations for MinGW on Windows. - PERL-410 Fixed BSON encoding/decoding to detect and throw and error if invalid UTF-8 is detected. - PERL-429 Fixed read preference tag sets logic. - PERL-435 Switched to http-style SSL certificate name validation. - PERL-454 Prevented warnings when creating BSON datetimes at the epoch. - PERL-477 Fixed list_indexes and list_collections when responses are too big to fit in a single database response. - PERL-480 Fixed GridFS bug: retrieving a GridFS file now throws an error if no chunks exist instead of returning an empty string. - PERL-489 Fixed fatal BSON encoding bug serializing references to dual-vars. - PERL-531 Bulk update/replace documents would not validate properly when $MongoDB::BSON::char was not '$'. While that functionality has moved to the MongoDB::BSON codec instead of the global variable, all update/replace documents (bulk and CRUD API) are now validated after key munging. - PERL-536 Fixed GridFS to stop throwing an error when a known empty file has no chunks; errors will still be thrown if a non-empty file has no chunks. - PERL-540 Fixed memory leak in DateTime::Tiny inflation. - PERL-543 Fixed a bug serializing undef from Tie::IxHash objects. - PERL-556 Fixed serialization of thread-shared variables. - Fixed t/cursor.t for new explain format. - Removed storage engine dependent code and tests. - Fixed MSVC compilation: fix unused vars and statements before declarations; removed unused, but problematic bcon.c and bcon.h; use Perl memory alloc functions instead of malloc. - Made conflicting 'multi' and 'multiple' update options fatal. - Fixed use of slave_ok and $readPreference for communicating read preferences to a mongos. - Fixed t/database.t for change in server error message. - Ensured topology type is correct whenever a server is marked unavailable. - Fixed incorrect 'matched_count' result attribute for upserts. - Fixed failing BSON element tests on 32-bit perls. - Fixed bug in MongoDB::MongoClient::database_names error handling. - Use of -Wall compiler flag during smoke testing has been restricted to gcc compilers, only. - Fixed encoding to raise an error if an array-reference document contains duplicate keys. - Stopped encoding scalar-ref objects as BSON BINARY type. (Throws an error instead about an unhandled type.) - Fixed incorrect configuration test for GCC atomic operations. - Fixed bug numifying wtimeout in write concern serialization. - Fixed BSON double tests on Perls with long-doubles enabled. - Fixed t/gridfs to work around a bug in MongoDB 3.1.2. - Fixed a number of XS memory leaks from non-mortalized variables during BSON encoding. [Changes] - PERL-127 Integers that fit in 32-bits are now encoded as BSON Int32; larger integers are encoded as BSON Int64; Math::BigInt objects are always encoded as BSON Int64. - PERL-331 The MongoDB::BSON package is now a full class, implementing a BSON encoder-decoder (codec). It can be supplied as an attribute to MongoDB::MongoClient, MongoDB::Database and MongoDB::Collection objects. - PERL-488 MongoDB::WriteConcern method 'is_safe' renamed to 'is_acknowledged'. - PERL-527 A database name is now optional for MongoDB::DBRef, which is consistent with the DBRef specification. - PERL-529 Connection string option keys are now parsed case-insensitively. - PERL-530 The driver now warns on unsupported connection options. - PERL-550 DBRefs allow extra fields (for compatibility); this is not recommended for new DBRefs. - Renamed DocumentSizeError to a more general general DocumentError. - MongoDB::Collection attributes that should not be set in the constructor have been made private, but with public accessors for backwards compatibility. Private attributes that are set in the constructor (e.g. 'database') are now public. - Failure to create indexes when constructing a GridFS object are ignored rather than a fatal error. - Calls to Carp::confess() or die() have been replaced with exceptions from MongoDB::Error subclasses, typically MongoDB::UsageError. - Generic MongoDB::Error exceptions have been replaced with subclasses that have a specific, documented purpose, including: MongoDB::AuthError, MongoDB::GridFSError, MongoDB::InternalError and MongoDB::UsageError. - Configuration options representing times have stricter validation such that options that should be non-negative will raise exceptions when given negative numbers. - BSON code derived from libbson has been updated to libbson 1.1.7. - Returns MongoDB::UnacknowledgedResult from unacknowledged writes (i.e. { w => 0 } write concern) instead of the corresponding result object (i.e. MongoDB::InsertResult for inserts). - Loads Authen::SCRAM::Client only on demand, as its Unicode module dependencies are costly when not needed. - MongoDB::QueryResult attributes have become private, as they are an implementation detail and not intended for end-users to inspect. - Aborts Makefile.PL on Windows before Vista/2008 for better error message than subsequent compilation/test failures. - Changes default connect_timeout_ms to 10,000. - Credential details omitted from usage error messages. [Documentation] - PERL-423 Improved documentation of cursor snapshot mode, as it doesn't do what many people think it does. - PERL-425 Documented deprecation of the 'drop_dups' option for index creation. - PERL-524 Updated legacy author emails in docs and metadata. - Added contributors section to MongoDB main documentation based on git commit logs. - Added MongoDB::Upgrading document with changes from v0.x. - Documented how to disable returning _id from queries. - Rearranged Collection and Database documentation. - Corrected errors in MongoDB::Cursor documentation. [Prerequisites] - Added core modules IO::Socket and MIME::Base64 to the dependency list for completeness. - Added Class::XSAccessor, Moo and Type::Tiny::XS. - Enforced minimum versions for configuration requirements. - Moved DateTime::Tiny from a test_requires dependency to a test_recommends dependency. - Removed core modules File::Copy, File::Path and File::Spec from the list of test dependencies. - Removed Class::MOP::Class as an explicit dependency (still used internally by Moose). - Removed Data::Types and Data::Dump as test dependencies. - Removed File::Slurp. - Removed JSON module in favor of JSON::MaybeXS. - Removed Moose, Syntax::Keyword::Junction and Throwable. - Removed Test::Warn. - Updated Path::Tiny minimum version to 0.054 (rather than unspecified). - Updated IO::Socket requirement on Windows to 1.31. - Updated Authen::SCRAM::Client minimum version to 0.003. [Removals] - PERL-467 Removed outdated MongoDB::Indexing document. - PERL-497 The $MongoDB::BSON::use_boolean never worked; BSON boolean values were always deserialized as boolean.pm objects. Rather than "fix" this and break people's code, the option has been removed and documented as such. - The MongoDB::MongoClient 'auto_connect', 'auto_reconnect', and 'find_master' methods have been removed, as server discovery and selection is now automatic. [Testing] - PERL-371 Added tests for parsing localhost:port. - PERL-492 Implemented server selection tests. - PERL-513 Added maxTimeMS tests for CRUD API methods. - Changed text index test to use $text operator, not text command (which was removed in MongoDB 3.0). - Changed t/max_time_ms.t to skip unless $ENV{FAILPOINT_TESTING} is true. - Reduced number of threads used in threads testing to avoid out of memory errors on memory constrained systems. [~ Internal changes ~] - PERL-133 Implemented a test that client can connect to replica sets without primary. - PERL-259 Implemented write commands for MongoDB 2.6+ (i.e. doing writes via database commands versus via the wire protocol with OP_INSERT, OP_UPDATE, etc.). - PERL-325 Updated vendored ppport.h to version 3.31. - PERL-433 Updated listCollections to use command form on 3.0 servers. - PERL-434 Updated listIndexes to use command form on 3.0 servers. - PERL-436 Bumped maxWireProtocolVersion for 3.0 support. - PERL-455 Changed to use connect timeout as the socket timeout for topology scans. - Implemented a 5 second "cooldown" period after a network error during topology scanning during which new connection attempts will not be made. This avoids excessive blocking in the driver when it's unlikely that the server will be available right away. - Removed unused vendored libyajl files. - Refactored and reorganized perl-mongo.h and perl_mongo.c. Removed unused functions and macros. - Disabled many internal class type constraints and runtime assertions unless the PERL_MONGO_WITH_ASSERTS environment variable is true. - Changed use of 'strerror_s' to 'strerror' to attempt to get C/XS linking on Windows XP. - Changed all Moose classes to Moo classes for speed and to minimize the deep dependency tree. - Changed argument handling for CRUD API methods to stop coercing inputs to Tie::IxHash. This makes them significantly faster. - Optimized networking code paths substantially. - Consolidated various constants to MongoDB::_Constants. - Inlined and adapted the Throwable CPAN module to avoid deep dependencies for MongoDB::Error. v0.999.999.6 2015-08-24 10:42:35-04:00 America/New_York (TRIAL RELEASE) v0.999.999.5 2015-08-13 17:11:49-04:00 America/New_York (TRIAL RELEASE) v0.999.999.4 2015-07-31 17:02:21-04:00 America/New_York (TRIAL RELEASE) v0.999.999.3 2015-06-29 12:21:07-04:00 America/New_York (TRIAL RELEASE) v0.999.999.2 2015-06-17 11:34:48-04:00 America/New_York (TRIAL RELEASE) v0.999.999.1 2015-06-10 09:48:53-06:00 America/Denver (TRIAL RELEASE) v0.999.998.6 2015-05-20 14:28:18-04:00 America/New_York (TRIAL RELEASE) v0.999.998.5 2015-04-30 06:12:39-04:00 America/New_York (TRIAL RELEASE) v0.999.998.4 2015-03-25 14:37:52-04:00 America/New_York (TRIAL RELEASE) v0.999.998.3 2015-03-25 14:30:00-05:00 America/New_York (TRIAL RELEASE) v0.999.998.2 2015-02-23 17:10:36-05:00 America/New_York (TRIAL RELEASE) v0.999.998.1 2014-11-12 15:10:40-05:00 America/New_York (TRIAL RELEASE) v0.708.4.0 2015-08-11 16:06:55-04:00 America/New_York [Bug fixes] - Fixes handling of 'safe' option for 'remove' - PERL-555 Fixes serialization of thread-shared scalars (and likely other tied/magic-using scalars) on Perls before 5.18 v0.708.3.0 2015-07-14 15:42:16-04:00 America/New_York [Bug fixes] - PERL-543 fix serialization of undef in tied hashes - PERL-553 fix duplicate _id bug with Tie::IxHash and array reference documents with an existing _id - Fix BSON tests on Perl with long doubled enabled v0.708.2.0 2015-06-05 16:39:00-04:00 America/New_York [Bug fixes] - PERL-536 fix GridFS to stop throwing an error when a known empty file has no chunks; errors will still be thrown if a non-empty file has no chunks. - PERL-541 fixed remove() to respect MongoClient write concern [Documentation] - PERL-525 updated legacy author emails in docs and metadata v0.708.1.0 2015-04-29 16:51:52-04:00 America/New_York [Bug fixes] - PERL-479 retrieving a GridFS file now throws an error if no chunks exist instead of returning an empty string [Removals] - PERL-496 The $MongoDB::BSON::use_boolean never worked; BSON boolean values were always deserialized as boolean.pm objects. Rather than "fix" this and break people's code, the option has been removed and documented as such. v0.708.0.0 2015-01-20 16:57:11-05:00 America/New_York [Additions] - Added 'get_namespace' method (and 'ns' alias) to MongoDB::MongoClient for getting a collection directly without an intermediate database object. - Added 'db' and 'coll' aliases for 'get_database' and 'get_collection' [Bug fixes] - PERL-489 references to scalars with both number and string slots internally would crash on BSON encoding, rather than encode the string part as a binary. [Diagnostics] - Added parenthetical note to "can't get db response" errors to disambiguate where they occur. v0.707.2.0 2014-12-22 05:35:31-05:00 America/New_York [Bug fixes] - PERL-476 fixed getting lists of collections and indices for changes in MongoDB 2.8-rc3 and later. v0.707.1.0 2014-12-10 12:50:45-05:00 America/New_York [Bug fixes] - PERL-465 allowed arbitrary options on index creation - Fixed t/database.t for change in error message for missing commands - Fixed undef warning from get_indexes on older MongoDB versions [Prerequisites] - Removed Data::Types as a test dependency as it was barely used and not necessary v0.707.0.0 2014-11-12 15:04:46-05:00 America/New_York [Additions] - Supports MongoDB 3.0; in addition to prior feature support, this release fixes tests that were broken against non-default storage engines [Bug fixes] - PERL-454 suppress warnings storing datetimes at the epoch v0.706.0.0 2014-10-28 11:30:42-04:00 America/New_York [*** Deprecations ***] - PERL-425 the 'drop_dups' indexing option is deprecated because it is ignored as of server version 2.7.5 [Additions] - PERL-408 added support for SCRAM-SHA-1 (for MongoDB 2.7.8+) [Bug fixes] - PERL-409 fixed compilation on MSWin32 using the MinGW compiler - Fixed compilation errors on MSWin32 using the MSVC compiler - Fixed construction of Makefile LIBS argument for some platforms - Fixed parallel scan and explain tests for changes in the MongoDB 2.7.x development series [Diagnostics] - Passing the "ssl" parameter to MongoDB::MongoClient will now warn if SSL support is not available. [Documentation] - Revised "run_command" documentation to explain that array references or Tie::IxHash should be used. [Prerequisites] - Added dependency on Authen::SCRAM::Client 0.003 - Removed (test) dependency on File::Slurp - Minimum required versions of configuration dependencies Path::Tiny and Config::AutoConf are now enforced in the code, not just specified in META.json [~ Internal changes ~] - PERL-433 uses the listCollections command if available (MongoDB 2.7.8+) - PERL-434 uses the listIndexes command if available (MongoDB 2.7.8+) - PERL-436 bumped supported maxWireProtocolVersion to 3 (MongoDB 2.7.8+) v0.705.0.0 2014-09-09 10:04:59-04:00 America/New_York [Additions] - PERL-406 allow count() to use hints [Prerequisites] - Clarified that Test::Deep 0.111 is required rather than any version v0.704.5.0 2014-08-19 14:17:00-04:00 America/New_York [Bug fixes] - PERL-407 fixed request_id race condition under threads - PERL-410 dies on BSON encoding/decoding if invalid UTF-8 is detected v0.704.4.0 2014-07-30 05:43:11-04:00 America/New_York [Testing] - Restores behavior of skipping tests if no mongod is available for testing v0.704.3.0 2014-07-28 17:02:13-04:00 America/New_York [Additions] - PERL-130 improved support for connection string URI; added support for options: ssl, connectTimeoutMS, w, wtimeoutMS, and journal [Bug fixes] - PERL-130 fixed parsing of connection string to allow for usernames containing : and passwords containing @ if they are percent encoded (RFC 3986) - PERL-166 fixed tailable cursors with no initial results - PERL-290 when find_master is 0, the driver now consistently picks the first server in the list - PERL-387 made database_names() retry up to three times if the server returns a lock error v0.704.2.0 2014-07-08 12:04:02-04:00 America/New_York [Bug fixes] - PERL-376 fixed fatal error loading the MongoDB::MongoClient module before loading the top-level MongoDB module - Fixed cursor to catch query or timeout errors that occur after the initial query batch is received - Fixed primary server selection to retry for 60 seconds instead of immediately failing with an error - Changed bulk insert to shallow copy inserted documents before adding an '_id' field (if it didn't exist) to avoid modifying the original [Testing] - Fixed t/database.t for old versions of mongos - PERL-355 Added support for parallel testing - Finished converting from Test::Exception to the more robust Test::Fatal - Improved test coverage v0.704.1.0 2014-06-17 21:55:18-04:00 America/New_York [Bug fixes] - PERL-336 fixed unknown command exception with index creation on 2.2 and older servers; we now correctly fall back to legacy index creation - PERL-349 fixed request ID misordering when reconnecting to a server; this fixes the known issue regarding test failures with threads under find_master - PERL-368 changed all query docs to be coerced to Tie::IxHash; this ensures that command queries are properly ordered and fixes a crashing bug when using command helpers in concert with read preference - PERL-369 fixed segfaults deserializing 64-bit integers from BSON on pure 32-bit perls - PERL-370 fixed bulk update results for upserts with non OID _id on servers prior to 2.6 - Fixed stale detection of write command support for bulk operations - Fixed wire version checks and max BSON size inspection for replica sets with multiple hosts in the connection URI [Documentation] - PERL-366 documented bulk write initializers in Collection docs - Updated Example.pod docs for field projection (Johann Rolschewski) [Testing] - PERL-348 tests report MongoDB version in test diagnostics - PERL-351 fixed test failures if the local database has auth enabled; tests will skip instead of fail - PERL-356 enabled additional tests if the test database is a replica set or sharded cluster - Added test for field projection (Johann Rolschewski) - Fixed various tests to run against a sharded cluster - Moved unused orchestration tests out of the main test suite [~ Internal changes ~] - PERL-357 added developer tools for testing different cluster configuration v0.704.0.0 2014-05-27 13:54:01-04:00 America/New_York [!!! Incompatible Changes !!!] - PERL-108 removed previously-deprecated AUTOLOAD functions [*** Deprecations ***] - PERL-320 low-level protocol functions in MongoDB.pm are deprecated [Additions] - PERL-221 added MongoDB::Regex class to represent stored regexes - PERL-251 implemented support for aggregation command cursors - PERL-252 added 'max_time_ms' method to cursors - PERL-258 added support for '$out' aggregation pipeline operator - PERL-262 read preference implementation - PERL-278 added explain support for aggregation queries - PERL-298 implement parallel_scan method for collections - PERL-299 implemented new bulk write API - Added nolock support to eval in MongoDB::Database (Ashley Willis) [Bug Fixes] - PERL-233 Fix find_and_modify error handling - PERL-260 ensure_index no longer ignores weights, default_language, and language_override options - PERL-267 memory leak fixes (Casey Rojas) - PERL-307 fix drop_dups option for ensure_index - PERL-315 require DateTime 0.78 or later - PERL-318 fix compiler warnings - PERL-319 fix compilation failures on some platforms - PERL-322 change return value and document low-level recv - PERL-323 fixed possible socket leaks on communication errors - PERL-336 fixed index creation legacy fallback against older mongos - Cached client constructor arguments for replica set connections - Cleaned Moose class namespaces of imported methods - Ensured internal run_command exceptions include correct error string - Fixed a bug that would serialize an index direction as a string on some older Perls - Fixed clock race in OID unit test - Fixed exception handling for internal run_command calls - Fixed fatal error in DESTROY with find_master and down server - Fixed gridfs test for unique keys - Fixed hint tests for MongoDB >= 2.5.4 - Fixed index creation and drop on MongoDB 2.6 - Fixed memory corruption error on Perl 5.19.1+ - Fixed several compiler warnings on Perl 5.8 - Fixed use of re::regexp_pattern for 5.10.0 - Made t/dbref.t use fresh test database - Prevented GridFS MD5 calculation when 'safe' is not set (mapbuh) - Provided backwards compatible HeUTF8 macro for Perl v5.10 and v5.8.8 and earlier - Removed hard-coded compiler flags for Darwin - Updated ppport.h to version 3.22 [Documentation] - PERL-217 improved documentation of GridFS::get - PERL-287 updated "j" and "fsync" option docs for MongoDB 2.6 - PERL-311 fix legacy docs authentication link - PERL-317 Clarified support for threads - PERL-341 Added install documentation including use of non-standard C library paths - Added abstract to MongoDB::BSON::Regexp documentation - Revised main MongoDB module and MongoDB::MongoClient docs - Updated Changes file with changes since 0.701 [Prerequisites] - Added namespace::clean - Added Test::Deep - Added Test::Fatal - Added Throwable - Added Syntax::Keyword::Junction - Changed Test::More requirement to 0.96 - Removed Devel::Size [~ Internal changes ~] - PERL-261 use setVersion field in isMaster for replica set discovery (David Storch) - PERL-264 test for closing connection when MongoClient object leaves scope. (Ashley Willis) - PERL-269 test libraries for replica set and sharded cluster testing - PERL-285 added wire protocol check - PERL-296 implemented new index creation command for MongoDB 2.6 - PERL-312 default GridFS chunk size changed from 1mb -> 255kb - Switched BSON implementation to libbson and bundled patched libbson 0.6.4 to avoid external library dependency [~ Known Issues ~] - PERL-233 SSL certificate validation not yet implemented - PERL-349 changes to the testing framework revealed a bug when threads are used with 'find_master' on the client; the offending test is marked TODO and the bug will be addressed in the next stable release. - Some platforms may not compile, including Windows and some Solaris and OpenBSD systems; these issues will be addressed in a future release v0.703.5 2014-05-23 06:26:46-04:00 America/New_York (TRIAL RELEASE) v0.703.4 2014-04-07 20:12:27-04:00 America/New_York (TRIAL RELEASE) v0.703.3 2014-04-01 10:32:49-04:00 America/New_York (TRIAL RELEASE) 0.703_2 (TRIAL RELEASE) 0.702.2 [Bug Fixes] - Fix double-from-buffer alignment issue on ARM platform (Robin Lee) - Set BSON_MINKEY to 255 if char is unsigned (Robin Lee) - Fix test plans in connection.t and delegation.t (Robin Lee) [Internal] - Copyright update s/10gen/MongoDB/ due to company name change 0.702.1 [Bug Fixes] - Query Fields accept Tie::IxHash and Hashref.. (Colin Cyr) - Fix for gridfs and creation of indexes (mapbuh) 0.702.0 [Enhancements] - SASL PLAIN suport added - Makefile.PL can enable SSL/SASL builds via environment variables [Bug Fixes] - PERL-162 set_timeout fix - PERL-245 fix fractional seconds in BSON datetime deserialization - Fix specifying index keys as an array ref (D. Ilmari Mannsåker) - Prevent legacy auth when in SASL mode - Drop all created collections in dbref.t (D. Ilmari Mannsåker) [Documentation] - Deprecated AUTOLOAD functions removed from documenation - Various module docs revised and updated [Internal] - Refactored boilerplate test code to a separate testing module 0.701 [Enhancements] - Support for Kerberos authentication on Linux (EXPERIMENTAL) - Add a get_collection method to MongoDB::Collection (@sanbeg, pull #52) - Optimizations on inserts and fetch (@ilmari, pull #66, PERL-129) - Hash ordering fixes (@ilmari, pull #64) - Double and int type helpers (@kenahoo, pull #65, PERL-227) - TTL index support (@drtz, pull #60, PERL-222) - Restored support for Perl 5.8. - Support for native DBRefs. [Bug Fixes] - UTF-8 fixes (@ilmari, pull #67, #68) - DateTime fixes (@kenahoo, pull #65) - Don't do aggregation tests when running against MongoDB < 2.2. 0.47 - 0.503.4 [Enhancements] - Ordered hash support for MongoDB::Cursor::hint() (Colin Syr) - timegm() implementation for Windows (Stevie-O) - aggregate() helper method - find_and_modify helper - Connection URI support enhancements (Tianon Gravi) - MongoClient new top-level object - Removing AUTOLOAD method examples from documentation - Replacing $conn examples with $client in docs. - Deprecation warning for MongoDB::Connection - Removed dependence on Any::Moose - Support for fsyncLock/unlock (Casey Rojas) - Support for dt_type param, DateTime::Tiny and raw epoch times - Support for UTF8 hash keys (Roman Yerin) - Support for 'j' param to turn on journaling (Casey Rojas) [Bug Fixes] - Miscellaneous documentation fixes (Andrey Khozov, others) - Fixed socket timeout bug (nightlord) - Fixed broken regex test for Perls < 5.14. - More accurate isUTF8 function (Jan Anderssen) - Proper serialization of regex flags via re::regexp_pattern 0.46 [Enhancements] - Added SSL support (Casey Rojas). See new documentation on MongoDB::Connection's ssl attribute. - Added MongoDB::BSON::Binary type and MongoDB::BSON::use_binary option. See the Data Types documentation on using the Binary type instead of string refs for binary data. - Change default binary type from 2 to 0. See MongoDB::BSON::Binary for more information about the implications of this change. [Bug Fixes] - Fix auth connection issues (Olly Stephens) - Fix driver creating duplicate connections when port isn't specified (Olly Stephens) - Fix authentication check on some versions of Perl (Olly Stephens) 0.45 - September 7, 2011 This is a recommended upgrade. There are no backwards-breaking changes, only bug fixes and enhancements. [Enhancements] - Perl 5.8.4 and higher is now officially supported (5.8.7 was the previous minimum version). - Improved the way that connecting handles an interrupt signal. The driver now continues to attempt connection for the remaining duration of the timeout, instead of erroring out immediately. [Bug Fixes] - Fixed MaxKey and MinKey deserialization. Deserializing these types would seg fault if they hadn't been serialized previously. - Fixed Windows compilation (Taro Nishino) - Fixed MakeMaker arguments which were causing build problems on 5.14. 0.44 - July 26, 2011 This is a recommended upgrade. There are no backwards-breaking changes, only bug-fixes and enhancements. [Enhancements] - Added MongoDB::BSON::looks_like_number flag. The Perl driver has always been coy about turning strings into numbers. If you would like aggressive number parsing (if it looks like a number, send it to the DB as a number), you can set MongoDB::BSON::looks_like_number to 1 (defaults to 0, the previous behavior). See the MongoDB::DataTypes pod for more info. - Tests should now clean up after themselves, leaving no test databases behind. [Bug Fixes] - Setting a sort in the arguments to MongoDB::Collection::find is now passed through correctly to the cursor. - Fixed segmentation fault in array serialization: caused by specifying an _id field on insert and using an array (not a hash or Tie::IxHash). - Fixed segmentation fault in threading: if Mouse was used instead of Moose, version 0.43 of the driver would segfault if multiple threads were used. - MongoDB::Cursor now inherits the $Mongo::Cursor::slave_okay global setting, as well as checking if slave_okay is set on the cursor instance. - Fix GridFS functions to only ensure GridFS indexes on writes, allowing GridFS API usage on slaves. 0.43 - May 31, 2011 This is a recommended upgrade. There are no backwards-breaking changes, only bug-fixes and enhancements. [Enhancements] - Auto-detects max BSON size for inserts, which means documents larger than 4MB can now be inserted. See L for details. - Added the L method, which returns meta information about the results being returned. [Bug Fixes] - When high UTF-8 values as hash keys, the driver now croaks instead of segfaulting. - Added 'use IO::File' before IO::File is used (Michael Langner) - Fixed Perl 5.14 compile (Chip Salzenberg) 0.42 - Fixes for Sparc architecture - Fixed PVIV misinterpretations 0.41 - Re-discover master on "not master" errors - Make driver thread safe (Florian Ragwitz) - POD fix (Ronald Kimball) - Fix GridFS warning (Graham Barr) - Allow auto_connect => 0 for replica sets (Graham Barr) 0.40 - DateTime floating timezones now warn on serialization - Attempting to serialize unrecognized object types now croaks - MongoDB::Cursor::explain now resets cursor properly - Added BSON::encode_bson and BSON::decode_bson (Jason Toffaletti) - Safe writes return a hash of information instead of 1 (on success) - Improved last_error/safe docs - Fixed doc spelling errors (Stefan Hornburg) 0.39 - Fixed memory leak 0.38 - Fixed indexing subdocuments (x.y.z) - Fixed GridFS to accept non-fs prefixes (Olly Stephens) - Fixed compile for old C compilers (Taro Nishino) - Added MongoDB::read_documents for handling db replies (Graham Barr) 0.37 - Fixed cursor not found error condition - Fixed compile for old C compilers - Fixed weird file behavoir on some machines 0.36 - Replica set support - Deserialize booleans as booleans (instead of ints) (Andrew Page) - Fixed OS X build (Todd Caine) - Added background option for index creation (Graham Barr) - Fixed slurp tests (Josh Rabinowitz) - Added MongoDB::Timestamp type 0.35 - 02 July 2010 - Added MongoDB::BSON::utf8_flag_on (Pan Fan) - Added MongoDB::GridFS::File::slurp (Pan Fan) - Fixed memory leak 0.34 - 17 June 2010 - $conn->foo->bar->baz now gets the bar.baz collection in the foo database - Slight speed improvements on inserts - Added $conn->query_timeout option to control timeout lengths for all queries done over a given connection - MongoDB::Cursor::tailable and MongoDB::Cursor::immortal - Added TO_JSON function to MongoDB::OID - Fixed safe save (Othello Maurer) - BACKWARD-BREAKING: removed old indexing syntax (if you started using the driver less than a year ago, this shouldn't affect you. If you're an old- timer, make sure you're not using the syntax that has been deprecated for a year). 0.33 26 April 2010 - Fixed tests 0.32 21 April 2010 - BACKWARD COMPATIBILITY BREAK: croak on failed safe update/insert/remove/ensure_index (Eric Wilhelm) - w and wtimeout (see MongoDB::Connection::w) - die correctly on MongoCollection::count errors (help from Josh Rabinowitz) - Added MongoDB::Collection::find (same as query) - Added get, put, and delete methods to MongoDB::GridFS - Perl 5.12 compatibility 0.31 05 April 2010 - C89 fix (Taro Nishino) - Added MongoDB::Code type - Use connection format: mongodb://host1,host2:port2,host3... - Arbitrary number of hosts supported - Auto-reauthentication on dropped connection - ensure_index name option 0.30 10 March 2010 - Support BigInt - On 64-bit machines, support 64-bit nums w/out BigInt (Ryan Olson) - Added connection timeout option (Othello Maurer) - Added clarifying docs on fields (Josh Rabinowitz) 0.29 01 March 2010 - Added safe options for remove, update, and ensure_index - Added save method - Fixed bug in UTF8 checking - Fixed serialization of "tie %hash, 'Tie:IxHash'" 0.28 28 Jan 2010 - Fixed undef values (Andrew Bryan) - Added GridFS multi-chunk test using File::Temp (Josh Rabinowitz) - Allow tie(%h, 'Tie::IxHash') to be used as well as Tie::IxHash->new - Fixed GridFS indexes and added chunkSize and uploadDate to metadata - Fixed batch_insert doc (Eric Wilhelm) - Fixed big endian build 0.27 22 Dec 2009 - Indexes: Improved ensure_index syntax, added drop_dups option - Inserts: Added safe insert, checks object is < 4 MB before inserting - Fixed socket closing bug - Big-endian support - $ can be replaced by any character using MongoDB::BSON::char - MongoDB::OIDs: Fixed undefined behavior in serialization (Peter Edwards), added OID::get_time - 5.8.7-compatible memory allocation (Peter Edwards) - Added MongoDB::MaxKey and MongoDB::MinKey support 0.26 09 Nov 2009 - Don't force i386 arch (Needed to compile on OS X with x86_64) (Graham Barr) - Include inc/ dir for CPAN - Memory leak fixes - Added tutorial 0.24 15 Oct 2009 - Fix for uninitialized array values (David Morrison) - Boolean support - Connection memory leak fix - Added MongoDB::Cursor::count 0.23 25 Sept 2009 Changes in this version by Ask Bjørn Hansen, Florian Ragwitz, Orlando Vazquez, Kristina Chodorow, and Eric Wilhelm: - Make inserting double's (floats/NV's), undefined/null, Tie::IxHash values - Query sorting, snapshot, explain, and hint - Added non-unique ensure_index - Added GridFS - Added regex support - find_one takes optional fields parameter - DateTime used for dates - No C++ driver dependency 0.01 06 May 2009 - Initial release. # vim: set ts=2 sts=2 sw=2 et tw=75: MongoDB-v2.2.2/MANIFEST000644 000766 000024 00000120416 13715253235 014566 0ustar00davidstaff000000 000000 # This file was automatically generated by Dist::Zilla::Plugin::Manifest v6.015. CONTRIBUTING.md Changes INSTALL.md LICENSE MANIFEST META.json META.yml Makefile.PL README README.md inc/CheckJiraInChanges.pm inc/ExtUtils/HasCompiler.pm inc/Makefile.footer lib/MongoDB.pm lib/MongoDB/BSON/Binary.pm lib/MongoDB/BSON/Regexp.pm lib/MongoDB/BulkWrite.pm lib/MongoDB/BulkWriteResult.pm lib/MongoDB/BulkWriteView.pm lib/MongoDB/ChangeStream.pm lib/MongoDB/ClientSession.pm lib/MongoDB/Code.pm lib/MongoDB/Collection.pm lib/MongoDB/CommandResult.pm lib/MongoDB/Cursor.pm lib/MongoDB/DBRef.pm lib/MongoDB/DataTypes.pod lib/MongoDB/Database.pm lib/MongoDB/DeleteResult.pm lib/MongoDB/Error.pm lib/MongoDB/Examples.pod lib/MongoDB/GridFSBucket.pm lib/MongoDB/GridFSBucket/DownloadStream.pm lib/MongoDB/GridFSBucket/UploadStream.pm lib/MongoDB/IndexView.pm lib/MongoDB/InsertManyResult.pm lib/MongoDB/InsertOneResult.pm lib/MongoDB/MongoClient.pm lib/MongoDB/Monitoring.pod lib/MongoDB/OID.pm lib/MongoDB/Op/_Aggregate.pm lib/MongoDB/Op/_BatchInsert.pm lib/MongoDB/Op/_BulkWrite.pm lib/MongoDB/Op/_ChangeStream.pm lib/MongoDB/Op/_Command.pm lib/MongoDB/Op/_Count.pm lib/MongoDB/Op/_CreateIndexes.pm lib/MongoDB/Op/_Delete.pm lib/MongoDB/Op/_Distinct.pm lib/MongoDB/Op/_DropCollection.pm lib/MongoDB/Op/_DropDatabase.pm lib/MongoDB/Op/_DropIndexes.pm lib/MongoDB/Op/_EndTxn.pm lib/MongoDB/Op/_Explain.pm lib/MongoDB/Op/_FSyncUnlock.pm lib/MongoDB/Op/_FindAndDelete.pm lib/MongoDB/Op/_FindAndUpdate.pm lib/MongoDB/Op/_GetMore.pm lib/MongoDB/Op/_InsertOne.pm lib/MongoDB/Op/_KillCursors.pm lib/MongoDB/Op/_ListCollections.pm lib/MongoDB/Op/_ListIndexes.pm lib/MongoDB/Op/_ParallelScan.pm lib/MongoDB/Op/_Query.pm lib/MongoDB/Op/_RenameCollection.pm lib/MongoDB/Op/_Update.pm lib/MongoDB/QueryResult.pm lib/MongoDB/QueryResult/Filtered.pm lib/MongoDB/ReadConcern.pm lib/MongoDB/ReadPreference.pm lib/MongoDB/Role/_BypassValidation.pm lib/MongoDB/Role/_CollectionOp.pm lib/MongoDB/Role/_CommandCursorOp.pm lib/MongoDB/Role/_CommandMonitoring.pm lib/MongoDB/Role/_CursorAPI.pm lib/MongoDB/Role/_DatabaseErrorThrower.pm lib/MongoDB/Role/_DatabaseOp.pm lib/MongoDB/Role/_DeprecationWarner.pm lib/MongoDB/Role/_InsertPreEncoder.pm lib/MongoDB/Role/_OpReplyParser.pm lib/MongoDB/Role/_PrivateConstructor.pm lib/MongoDB/Role/_ReadOp.pm lib/MongoDB/Role/_ReadPrefModifier.pm lib/MongoDB/Role/_SessionSupport.pm lib/MongoDB/Role/_SingleBatchDocWrite.pm lib/MongoDB/Role/_TopologyMonitoring.pm lib/MongoDB/Role/_UpdatePreEncoder.pm lib/MongoDB/Role/_WriteOp.pm lib/MongoDB/Role/_WriteResult.pm lib/MongoDB/Timestamp.pm lib/MongoDB/Tutorial.pod lib/MongoDB/UnacknowledgedResult.pm lib/MongoDB/UpdateResult.pm lib/MongoDB/Upgrading.pod lib/MongoDB/Upgrading/v1.pod lib/MongoDB/WriteConcern.pm lib/MongoDB/_Constants.pm lib/MongoDB/_Credential.pm lib/MongoDB/_Dispatcher.pm lib/MongoDB/_Link.pm lib/MongoDB/_Platform.pm lib/MongoDB/_Protocol.pm lib/MongoDB/_Server.pm lib/MongoDB/_ServerSession.pm lib/MongoDB/_SessionPool.pm lib/MongoDB/_Topology.pm lib/MongoDB/_TransactionOptions.pm lib/MongoDB/_Types.pm lib/MongoDB/_URI.pm perlcritic.rc t/00-report-mongod.t t/00-report-prereqs.dd t/00-report-prereqs.t t/auth_spec.t t/bulk.t t/bulk_write_pipeline.t t/bypass_doc_validation.t t/causal_consistency.t t/changestreams.t t/changestreams_spec.t t/collection.t t/connection.t t/connection_string_spec.t t/connections-survive-step-down.t t/crud.t t/crud_spec.t t/cursor.t t/data/CRUD/README.rst t/data/CRUD/v1/read/aggregate-collation.json t/data/CRUD/v1/read/aggregate-collation.yml t/data/CRUD/v1/read/aggregate-out.json t/data/CRUD/v1/read/aggregate-out.yml t/data/CRUD/v1/read/aggregate.json t/data/CRUD/v1/read/aggregate.yml t/data/CRUD/v1/read/count-collation.json t/data/CRUD/v1/read/count-collation.yml t/data/CRUD/v1/read/count-empty.json t/data/CRUD/v1/read/count-empty.yml t/data/CRUD/v1/read/count.json t/data/CRUD/v1/read/count.yml t/data/CRUD/v1/read/distinct-collation.json t/data/CRUD/v1/read/distinct-collation.yml t/data/CRUD/v1/read/distinct.json t/data/CRUD/v1/read/distinct.yml t/data/CRUD/v1/read/find-collation.json t/data/CRUD/v1/read/find-collation.yml t/data/CRUD/v1/read/find.json t/data/CRUD/v1/read/find.yml t/data/CRUD/v1/write/bulkWrite-arrayFilters.json t/data/CRUD/v1/write/bulkWrite-arrayFilters.yml t/data/CRUD/v1/write/bulkWrite-collation.json t/data/CRUD/v1/write/bulkWrite-collation.yml t/data/CRUD/v1/write/bulkWrite.json t/data/CRUD/v1/write/bulkWrite.yml t/data/CRUD/v1/write/deleteMany-collation.json t/data/CRUD/v1/write/deleteMany-collation.yml t/data/CRUD/v1/write/deleteMany.json t/data/CRUD/v1/write/deleteMany.yml t/data/CRUD/v1/write/deleteOne-collation.json t/data/CRUD/v1/write/deleteOne-collation.yml t/data/CRUD/v1/write/deleteOne.json t/data/CRUD/v1/write/deleteOne.yml t/data/CRUD/v1/write/findOneAndDelete-collation.json t/data/CRUD/v1/write/findOneAndDelete-collation.yml t/data/CRUD/v1/write/findOneAndDelete.json t/data/CRUD/v1/write/findOneAndDelete.yml t/data/CRUD/v1/write/findOneAndReplace-collation.json t/data/CRUD/v1/write/findOneAndReplace-collation.yml t/data/CRUD/v1/write/findOneAndReplace-upsert.json t/data/CRUD/v1/write/findOneAndReplace-upsert.yml t/data/CRUD/v1/write/findOneAndReplace.json t/data/CRUD/v1/write/findOneAndReplace.yml t/data/CRUD/v1/write/findOneAndUpdate-arrayFilters.json t/data/CRUD/v1/write/findOneAndUpdate-arrayFilters.yml t/data/CRUD/v1/write/findOneAndUpdate-collation.json t/data/CRUD/v1/write/findOneAndUpdate-collation.yml t/data/CRUD/v1/write/findOneAndUpdate.json t/data/CRUD/v1/write/findOneAndUpdate.yml t/data/CRUD/v1/write/insertMany.json t/data/CRUD/v1/write/insertMany.yml t/data/CRUD/v1/write/insertOne.json t/data/CRUD/v1/write/insertOne.yml t/data/CRUD/v1/write/replaceOne-collation.json t/data/CRUD/v1/write/replaceOne-collation.yml t/data/CRUD/v1/write/replaceOne.json t/data/CRUD/v1/write/replaceOne.yml t/data/CRUD/v1/write/updateMany-arrayFilters.json t/data/CRUD/v1/write/updateMany-arrayFilters.yml t/data/CRUD/v1/write/updateMany-collation.json t/data/CRUD/v1/write/updateMany-collation.yml t/data/CRUD/v1/write/updateMany.json t/data/CRUD/v1/write/updateMany.yml t/data/CRUD/v1/write/updateOne-arrayFilters.json t/data/CRUD/v1/write/updateOne-arrayFilters.yml t/data/CRUD/v1/write/updateOne-collation.json t/data/CRUD/v1/write/updateOne-collation.yml t/data/CRUD/v1/write/updateOne.json t/data/CRUD/v1/write/updateOne.yml t/data/CRUD/v2/aggregate-merge.json t/data/CRUD/v2/aggregate-merge.yml t/data/CRUD/v2/aggregate-out-readConcern.json t/data/CRUD/v2/aggregate-out-readConcern.yml t/data/CRUD/v2/bulkWrite-arrayFilters.json t/data/CRUD/v2/bulkWrite-arrayFilters.yml t/data/CRUD/v2/db-aggregate.json t/data/CRUD/v2/db-aggregate.yml t/data/CRUD/v2/updateWithPipelines.json t/data/CRUD/v2/updateWithPipelines.yml t/data/SDAM/README.rst t/data/SDAM/monitoring/README.rst t/data/SDAM/monitoring/replica_set_with_no_primary.json t/data/SDAM/monitoring/replica_set_with_no_primary.yml t/data/SDAM/monitoring/replica_set_with_primary.json t/data/SDAM/monitoring/replica_set_with_primary.yml t/data/SDAM/monitoring/replica_set_with_removal.json t/data/SDAM/monitoring/replica_set_with_removal.yml t/data/SDAM/monitoring/required_replica_set.json t/data/SDAM/monitoring/required_replica_set.yml t/data/SDAM/monitoring/standalone.json t/data/SDAM/monitoring/standalone.yml t/data/SDAM/rs/compatible.json t/data/SDAM/rs/compatible.yml t/data/SDAM/rs/discover_arbiters.json t/data/SDAM/rs/discover_arbiters.yml t/data/SDAM/rs/discover_passives.json t/data/SDAM/rs/discover_passives.yml t/data/SDAM/rs/discover_primary.json t/data/SDAM/rs/discover_primary.yml t/data/SDAM/rs/discover_secondary.json t/data/SDAM/rs/discover_secondary.yml t/data/SDAM/rs/discovery.json t/data/SDAM/rs/discovery.yml t/data/SDAM/rs/equal_electionids.json t/data/SDAM/rs/equal_electionids.yml t/data/SDAM/rs/ghost_discovered.json t/data/SDAM/rs/ghost_discovered.yml t/data/SDAM/rs/hosts_differ_from_seeds.json t/data/SDAM/rs/hosts_differ_from_seeds.yml t/data/SDAM/rs/ls_timeout.json t/data/SDAM/rs/ls_timeout.yml t/data/SDAM/rs/member_reconfig.json t/data/SDAM/rs/member_reconfig.yml t/data/SDAM/rs/member_standalone.json t/data/SDAM/rs/member_standalone.yml t/data/SDAM/rs/new_primary.json t/data/SDAM/rs/new_primary.yml t/data/SDAM/rs/new_primary_new_electionid.json t/data/SDAM/rs/new_primary_new_electionid.yml t/data/SDAM/rs/new_primary_new_setversion.json t/data/SDAM/rs/new_primary_new_setversion.yml t/data/SDAM/rs/new_primary_wrong_set_name.json t/data/SDAM/rs/new_primary_wrong_set_name.yml t/data/SDAM/rs/non_rs_member.json t/data/SDAM/rs/non_rs_member.yml t/data/SDAM/rs/normalize_case.json t/data/SDAM/rs/normalize_case.yml t/data/SDAM/rs/normalize_case_me.json t/data/SDAM/rs/normalize_case_me.yml t/data/SDAM/rs/null_election_id.json t/data/SDAM/rs/null_election_id.yml t/data/SDAM/rs/primary_becomes_ghost.json t/data/SDAM/rs/primary_becomes_ghost.yml t/data/SDAM/rs/primary_becomes_mongos.json t/data/SDAM/rs/primary_becomes_mongos.yml t/data/SDAM/rs/primary_becomes_standalone.json t/data/SDAM/rs/primary_becomes_standalone.yml t/data/SDAM/rs/primary_changes_set_name.json t/data/SDAM/rs/primary_changes_set_name.yml t/data/SDAM/rs/primary_disconnect.json t/data/SDAM/rs/primary_disconnect.yml t/data/SDAM/rs/primary_disconnect_electionid.json t/data/SDAM/rs/primary_disconnect_electionid.yml t/data/SDAM/rs/primary_disconnect_setversion.json t/data/SDAM/rs/primary_disconnect_setversion.yml t/data/SDAM/rs/primary_hint_from_secondary_with_mismatched_me.json t/data/SDAM/rs/primary_hint_from_secondary_with_mismatched_me.yml t/data/SDAM/rs/primary_mismatched_me.json t/data/SDAM/rs/primary_mismatched_me.yml t/data/SDAM/rs/primary_reports_new_member.json t/data/SDAM/rs/primary_reports_new_member.yml t/data/SDAM/rs/primary_to_no_primary_mismatched_me.json t/data/SDAM/rs/primary_to_no_primary_mismatched_me.yml t/data/SDAM/rs/primary_wrong_set_name.json t/data/SDAM/rs/primary_wrong_set_name.yml t/data/SDAM/rs/response_from_removed.json t/data/SDAM/rs/response_from_removed.yml t/data/SDAM/rs/rsother_discovered.json t/data/SDAM/rs/rsother_discovered.yml t/data/SDAM/rs/sec_not_auth.json t/data/SDAM/rs/sec_not_auth.yml t/data/SDAM/rs/secondary_ignore_ok_0.json t/data/SDAM/rs/secondary_ignore_ok_0.yml t/data/SDAM/rs/secondary_mismatched_me.json t/data/SDAM/rs/secondary_mismatched_me.yml t/data/SDAM/rs/secondary_wrong_set_name.json t/data/SDAM/rs/secondary_wrong_set_name.yml t/data/SDAM/rs/secondary_wrong_set_name_with_primary.json t/data/SDAM/rs/secondary_wrong_set_name_with_primary.yml t/data/SDAM/rs/setversion_without_electionid.json t/data/SDAM/rs/setversion_without_electionid.yml t/data/SDAM/rs/stepdown_change_set_name.json t/data/SDAM/rs/stepdown_change_set_name.yml t/data/SDAM/rs/too_new.json t/data/SDAM/rs/too_new.yml t/data/SDAM/rs/too_old.json t/data/SDAM/rs/too_old.yml t/data/SDAM/rs/unexpected_mongos.json t/data/SDAM/rs/unexpected_mongos.yml t/data/SDAM/rs/use_setversion_without_electionid.json t/data/SDAM/rs/use_setversion_without_electionid.yml t/data/SDAM/rs/wrong_set_name.json t/data/SDAM/rs/wrong_set_name.yml t/data/SDAM/sharded/compatible.json t/data/SDAM/sharded/compatible.yml t/data/SDAM/sharded/ls_timeout_mongos.json t/data/SDAM/sharded/ls_timeout_mongos.yml t/data/SDAM/sharded/mongos_disconnect.json t/data/SDAM/sharded/mongos_disconnect.yml t/data/SDAM/sharded/multiple_mongoses.json t/data/SDAM/sharded/multiple_mongoses.yml t/data/SDAM/sharded/non_mongos_removed.json t/data/SDAM/sharded/non_mongos_removed.yml t/data/SDAM/sharded/normalize_uri_case.json t/data/SDAM/sharded/normalize_uri_case.yml t/data/SDAM/sharded/too_new.json t/data/SDAM/sharded/too_new.yml t/data/SDAM/sharded/too_old.json t/data/SDAM/sharded/too_old.yml t/data/SDAM/single/compatible.json t/data/SDAM/single/compatible.yml t/data/SDAM/single/direct_connection_external_ip.json t/data/SDAM/single/direct_connection_external_ip.yml t/data/SDAM/single/direct_connection_mongos.json t/data/SDAM/single/direct_connection_mongos.yml t/data/SDAM/single/direct_connection_rsarbiter.json t/data/SDAM/single/direct_connection_rsarbiter.yml t/data/SDAM/single/direct_connection_rsprimary.json t/data/SDAM/single/direct_connection_rsprimary.yml t/data/SDAM/single/direct_connection_rssecondary.json t/data/SDAM/single/direct_connection_rssecondary.yml t/data/SDAM/single/direct_connection_slave.json t/data/SDAM/single/direct_connection_slave.yml t/data/SDAM/single/direct_connection_standalone.json t/data/SDAM/single/direct_connection_standalone.yml t/data/SDAM/single/ls_timeout_standalone.json t/data/SDAM/single/ls_timeout_standalone.yml t/data/SDAM/single/not_ok_response.json t/data/SDAM/single/not_ok_response.yml t/data/SDAM/single/standalone_removed.json t/data/SDAM/single/standalone_removed.yml t/data/SDAM/single/too_new.json t/data/SDAM/single/too_new.yml t/data/SDAM/single/too_old.json t/data/SDAM/single/too_old.yml t/data/SDAM/single/unavailable_seed.json t/data/SDAM/single/unavailable_seed.yml t/data/SS/README.rst t/data/SS/rtt/first_value.json t/data/SS/rtt/first_value.yml t/data/SS/rtt/first_value_zero.json t/data/SS/rtt/first_value_zero.yml t/data/SS/rtt/value_test_1.json t/data/SS/rtt/value_test_1.yml t/data/SS/rtt/value_test_2.json t/data/SS/rtt/value_test_2.yml t/data/SS/rtt/value_test_3.json t/data/SS/rtt/value_test_3.yml t/data/SS/rtt/value_test_4.json t/data/SS/rtt/value_test_4.yml t/data/SS/rtt/value_test_5.json t/data/SS/rtt/value_test_5.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest_multiple.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest_multiple.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest_non_matching.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/PossiblePrimary.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/PossiblePrimary.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/PossiblePrimaryNearest.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/PossiblePrimaryNearest.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Primary.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Primary.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_multi_tags.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_multi_tags.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_multi_tags2.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_multi_tags2.yml t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_non_matching.json t/data/SS/server_selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml t/data/SS/server_selection/ReplicaSetNoPrimary/write/SecondaryPreferred.json t/data/SS/server_selection/ReplicaSetNoPrimary/write/SecondaryPreferred.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest_multiple.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest_multiple.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest_non_matching.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Nearest_non_matching.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Primary.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Primary.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Secondary.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Secondary.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred_non_matching.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred_non_matching.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred_tags.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/SecondaryPreferred_tags.yml t/data/SS/server_selection/ReplicaSetWithPrimary/read/Secondary_non_matching.json t/data/SS/server_selection/ReplicaSetWithPrimary/read/Secondary_non_matching.yml t/data/SS/server_selection/ReplicaSetWithPrimary/write/SecondaryPreferred.json t/data/SS/server_selection/ReplicaSetWithPrimary/write/SecondaryPreferred.yml t/data/SS/server_selection/Sharded/read/Nearest.json t/data/SS/server_selection/Sharded/read/Nearest.yml t/data/SS/server_selection/Sharded/read/Primary.json t/data/SS/server_selection/Sharded/read/Primary.yml t/data/SS/server_selection/Sharded/read/PrimaryPreferred.json t/data/SS/server_selection/Sharded/read/PrimaryPreferred.yml t/data/SS/server_selection/Sharded/read/Secondary.json t/data/SS/server_selection/Sharded/read/Secondary.yml t/data/SS/server_selection/Sharded/read/SecondaryPreferred.json t/data/SS/server_selection/Sharded/read/SecondaryPreferred.yml t/data/SS/server_selection/Sharded/write/Nearest.json t/data/SS/server_selection/Sharded/write/Nearest.yml t/data/SS/server_selection/Sharded/write/Primary.json t/data/SS/server_selection/Sharded/write/Primary.yml t/data/SS/server_selection/Sharded/write/PrimaryPreferred.json t/data/SS/server_selection/Sharded/write/PrimaryPreferred.yml t/data/SS/server_selection/Sharded/write/Secondary.json t/data/SS/server_selection/Sharded/write/Secondary.yml t/data/SS/server_selection/Sharded/write/SecondaryPreferred.json t/data/SS/server_selection/Sharded/write/SecondaryPreferred.yml t/data/SS/server_selection/Single/read/SecondaryPreferred.json t/data/SS/server_selection/Single/read/SecondaryPreferred.yml t/data/SS/server_selection/Single/write/SecondaryPreferred.json t/data/SS/server_selection/Single/write/SecondaryPreferred.yml t/data/SS/server_selection/Unknown/read/SecondaryPreferred.json t/data/SS/server_selection/Unknown/read/SecondaryPreferred.yml t/data/SS/server_selection/Unknown/write/SecondaryPreferred.json t/data/SS/server_selection/Unknown/write/SecondaryPreferred.yml t/data/auth/README.rst t/data/auth/connection-string.json t/data/auth/connection-string.yml t/data/change-streams/README.rst t/data/change-streams/change-streams-errors.json t/data/change-streams/change-streams-errors.yml t/data/change-streams/change-streams.json t/data/change-streams/change-streams.yml t/data/command-monitoring/README.rst t/data/command-monitoring/bulkWrite.json t/data/command-monitoring/bulkWrite.yml t/data/command-monitoring/command.json t/data/command-monitoring/command.yml t/data/command-monitoring/deleteMany.json t/data/command-monitoring/deleteMany.yml t/data/command-monitoring/deleteOne.json t/data/command-monitoring/deleteOne.yml t/data/command-monitoring/find.json t/data/command-monitoring/find.yml t/data/command-monitoring/insertMany.json t/data/command-monitoring/insertMany.yml t/data/command-monitoring/insertOne.json t/data/command-monitoring/insertOne.yml t/data/command-monitoring/unacknowledgedBulkWrite.json t/data/command-monitoring/unacknowledgedBulkWrite.yml t/data/command-monitoring/updateMany.json t/data/command-monitoring/updateMany.yml t/data/command-monitoring/updateOne.json t/data/command-monitoring/updateOne.yml t/data/connection_string/README.rst t/data/connection_string/invalid-uris.json t/data/connection_string/invalid-uris.yml t/data/connection_string/valid-auth.json t/data/connection_string/valid-auth.yml t/data/connection_string/valid-db-with-dotted-name.json t/data/connection_string/valid-db-with-dotted-name.yml t/data/connection_string/valid-host_identifiers.json t/data/connection_string/valid-host_identifiers.yml t/data/connection_string/valid-options.json t/data/connection_string/valid-options.yml t/data/connection_string/valid-unix_socket-absolute.json t/data/connection_string/valid-unix_socket-absolute.yml t/data/connection_string/valid-unix_socket-relative.json t/data/connection_string/valid-unix_socket-relative.yml t/data/connection_string/valid-warnings.json t/data/connection_string/valid-warnings.yml t/data/gridfs/big.txt t/data/gridfs/data.bin t/data/gridfs/input.txt t/data/gridfs/tests/delete.json t/data/gridfs/tests/download.json t/data/gridfs/tests/upload.json t/data/initial_dns_seedlist_discovery/README.rst t/data/initial_dns_seedlist_discovery/longer-parent-in-return.json t/data/initial_dns_seedlist_discovery/longer-parent-in-return.yml t/data/initial_dns_seedlist_discovery/misformatted-option.json t/data/initial_dns_seedlist_discovery/misformatted-option.yml t/data/initial_dns_seedlist_discovery/no-results.json t/data/initial_dns_seedlist_discovery/no-results.yml t/data/initial_dns_seedlist_discovery/not-enough-parts.json t/data/initial_dns_seedlist_discovery/not-enough-parts.yml t/data/initial_dns_seedlist_discovery/one-result-default-port.json t/data/initial_dns_seedlist_discovery/one-result-default-port.yml t/data/initial_dns_seedlist_discovery/one-txt-record-multiple-strings.json t/data/initial_dns_seedlist_discovery/one-txt-record-multiple-strings.yml t/data/initial_dns_seedlist_discovery/one-txt-record.json t/data/initial_dns_seedlist_discovery/one-txt-record.yml t/data/initial_dns_seedlist_discovery/parent-part-mismatch1.json t/data/initial_dns_seedlist_discovery/parent-part-mismatch1.yml t/data/initial_dns_seedlist_discovery/parent-part-mismatch2.json t/data/initial_dns_seedlist_discovery/parent-part-mismatch2.yml t/data/initial_dns_seedlist_discovery/parent-part-mismatch3.json t/data/initial_dns_seedlist_discovery/parent-part-mismatch3.yml t/data/initial_dns_seedlist_discovery/parent-part-mismatch4.json t/data/initial_dns_seedlist_discovery/parent-part-mismatch4.yml t/data/initial_dns_seedlist_discovery/parent-part-mismatch5.json t/data/initial_dns_seedlist_discovery/parent-part-mismatch5.yml t/data/initial_dns_seedlist_discovery/returned-parent-too-short.json t/data/initial_dns_seedlist_discovery/returned-parent-too-short.yml t/data/initial_dns_seedlist_discovery/returned-parent-wrong.json t/data/initial_dns_seedlist_discovery/returned-parent-wrong.yml t/data/initial_dns_seedlist_discovery/two-results-default-port.json t/data/initial_dns_seedlist_discovery/two-results-default-port.yml t/data/initial_dns_seedlist_discovery/two-results-nonstandard-port.json t/data/initial_dns_seedlist_discovery/two-results-nonstandard-port.yml t/data/initial_dns_seedlist_discovery/two-txt-records.json t/data/initial_dns_seedlist_discovery/two-txt-records.yml t/data/initial_dns_seedlist_discovery/txt-record-not-allowed-option.json t/data/initial_dns_seedlist_discovery/txt-record-not-allowed-option.yml t/data/initial_dns_seedlist_discovery/txt-record-with-overridden-ssl-option.json t/data/initial_dns_seedlist_discovery/txt-record-with-overridden-ssl-option.yml t/data/initial_dns_seedlist_discovery/txt-record-with-overridden-uri-option.json t/data/initial_dns_seedlist_discovery/txt-record-with-overridden-uri-option.yml t/data/initial_dns_seedlist_discovery/txt-record-with-unallowed-option.json t/data/initial_dns_seedlist_discovery/txt-record-with-unallowed-option.yml t/data/initial_dns_seedlist_discovery/uri-with-admin-database.json t/data/initial_dns_seedlist_discovery/uri-with-admin-database.yml t/data/initial_dns_seedlist_discovery/uri-with-auth.json t/data/initial_dns_seedlist_discovery/uri-with-auth.yml t/data/initial_dns_seedlist_discovery/uri-with-port.json t/data/initial_dns_seedlist_discovery/uri-with-port.yml t/data/initial_dns_seedlist_discovery/uri-with-two-hosts.json t/data/initial_dns_seedlist_discovery/uri-with-two-hosts.yml t/data/max_staleness/README.rst t/data/max_staleness/ReplicaSetNoPrimary/DefaultNoMaxStaleness.json t/data/max_staleness/ReplicaSetNoPrimary/DefaultNoMaxStaleness.yml t/data/max_staleness/ReplicaSetNoPrimary/Incompatible.json t/data/max_staleness/ReplicaSetNoPrimary/Incompatible.yml t/data/max_staleness/ReplicaSetNoPrimary/LastUpdateTime.json t/data/max_staleness/ReplicaSetNoPrimary/LastUpdateTime.yml t/data/max_staleness/ReplicaSetNoPrimary/Nearest.json t/data/max_staleness/ReplicaSetNoPrimary/Nearest.yml t/data/max_staleness/ReplicaSetNoPrimary/Nearest2.json t/data/max_staleness/ReplicaSetNoPrimary/Nearest2.yml t/data/max_staleness/ReplicaSetNoPrimary/NoKnownServers.json t/data/max_staleness/ReplicaSetNoPrimary/NoKnownServers.yml t/data/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred.json t/data/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred.yml t/data/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred_tags.json t/data/max_staleness/ReplicaSetNoPrimary/PrimaryPreferred_tags.yml t/data/max_staleness/ReplicaSetNoPrimary/Secondary.json t/data/max_staleness/ReplicaSetNoPrimary/Secondary.yml t/data/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred.json t/data/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred.yml t/data/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred_tags.json t/data/max_staleness/ReplicaSetNoPrimary/SecondaryPreferred_tags.yml t/data/max_staleness/ReplicaSetNoPrimary/ZeroMaxStaleness.json t/data/max_staleness/ReplicaSetNoPrimary/ZeroMaxStaleness.yml t/data/max_staleness/ReplicaSetWithPrimary/DefaultNoMaxStaleness.json t/data/max_staleness/ReplicaSetWithPrimary/DefaultNoMaxStaleness.yml t/data/max_staleness/ReplicaSetWithPrimary/Incompatible.json t/data/max_staleness/ReplicaSetWithPrimary/Incompatible.yml t/data/max_staleness/ReplicaSetWithPrimary/LastUpdateTime.json t/data/max_staleness/ReplicaSetWithPrimary/LastUpdateTime.yml t/data/max_staleness/ReplicaSetWithPrimary/LongHeartbeat.json t/data/max_staleness/ReplicaSetWithPrimary/LongHeartbeat.yml t/data/max_staleness/ReplicaSetWithPrimary/LongHeartbeat2.json t/data/max_staleness/ReplicaSetWithPrimary/LongHeartbeat2.yml t/data/max_staleness/ReplicaSetWithPrimary/MaxStalenessTooSmall.json t/data/max_staleness/ReplicaSetWithPrimary/MaxStalenessTooSmall.yml t/data/max_staleness/ReplicaSetWithPrimary/MaxStalenessWithModePrimary.json t/data/max_staleness/ReplicaSetWithPrimary/MaxStalenessWithModePrimary.yml t/data/max_staleness/ReplicaSetWithPrimary/Nearest.json t/data/max_staleness/ReplicaSetWithPrimary/Nearest.yml t/data/max_staleness/ReplicaSetWithPrimary/Nearest2.json t/data/max_staleness/ReplicaSetWithPrimary/Nearest2.yml t/data/max_staleness/ReplicaSetWithPrimary/Nearest_tags.json t/data/max_staleness/ReplicaSetWithPrimary/Nearest_tags.yml t/data/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred.json t/data/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred.yml t/data/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred_incompatible.json t/data/max_staleness/ReplicaSetWithPrimary/PrimaryPreferred_incompatible.yml t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred.json t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred.yml t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags.json t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags.yml t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags2.json t/data/max_staleness/ReplicaSetWithPrimary/SecondaryPreferred_tags2.yml t/data/max_staleness/ReplicaSetWithPrimary/Secondary_tags.json t/data/max_staleness/ReplicaSetWithPrimary/Secondary_tags.yml t/data/max_staleness/ReplicaSetWithPrimary/Secondary_tags2.json t/data/max_staleness/ReplicaSetWithPrimary/Secondary_tags2.yml t/data/max_staleness/ReplicaSetWithPrimary/ZeroMaxStaleness.json t/data/max_staleness/ReplicaSetWithPrimary/ZeroMaxStaleness.yml t/data/max_staleness/Sharded/Incompatible.json t/data/max_staleness/Sharded/Incompatible.yml t/data/max_staleness/Sharded/SmallMaxStaleness.json t/data/max_staleness/Sharded/SmallMaxStaleness.yml t/data/max_staleness/Single/Incompatible.json t/data/max_staleness/Single/Incompatible.yml t/data/max_staleness/Single/SmallMaxStaleness.json t/data/max_staleness/Single/SmallMaxStaleness.yml t/data/max_staleness/Unknown/SmallMaxStaleness.json t/data/max_staleness/Unknown/SmallMaxStaleness.yml t/data/read-write-concern/README.rst t/data/read-write-concern/connection-string/read-concern.json t/data/read-write-concern/connection-string/read-concern.yml t/data/read-write-concern/connection-string/write-concern.json t/data/read-write-concern/connection-string/write-concern.yml t/data/read-write-concern/document/read-concern.json t/data/read-write-concern/document/read-concern.yml t/data/read-write-concern/document/write-concern.json t/data/read-write-concern/document/write-concern.yml t/data/retryable-reads/README.rst t/data/retryable-reads/aggregate-merge.json t/data/retryable-reads/aggregate-merge.yml t/data/retryable-reads/aggregate-serverErrors.json t/data/retryable-reads/aggregate-serverErrors.yml t/data/retryable-reads/aggregate.json t/data/retryable-reads/aggregate.yml t/data/retryable-reads/changeStreams-client.watch-serverErrors.json t/data/retryable-reads/changeStreams-client.watch-serverErrors.yml t/data/retryable-reads/changeStreams-client.watch.json t/data/retryable-reads/changeStreams-client.watch.yml t/data/retryable-reads/changeStreams-db.coll.watch-serverErrors.json t/data/retryable-reads/changeStreams-db.coll.watch-serverErrors.yml t/data/retryable-reads/changeStreams-db.coll.watch.json t/data/retryable-reads/changeStreams-db.coll.watch.yml t/data/retryable-reads/changeStreams-db.watch-serverErrors.json t/data/retryable-reads/changeStreams-db.watch-serverErrors.yml t/data/retryable-reads/changeStreams-db.watch.json t/data/retryable-reads/changeStreams-db.watch.yml t/data/retryable-reads/count-serverErrors.json t/data/retryable-reads/count-serverErrors.yml t/data/retryable-reads/count.json t/data/retryable-reads/count.yml t/data/retryable-reads/countDocuments-serverErrors.json t/data/retryable-reads/countDocuments-serverErrors.yml t/data/retryable-reads/countDocuments.json t/data/retryable-reads/countDocuments.yml t/data/retryable-reads/distinct-serverErrors.json t/data/retryable-reads/distinct-serverErrors.yml t/data/retryable-reads/distinct.json t/data/retryable-reads/distinct.yml t/data/retryable-reads/estimatedDocumentCount-serverErrors.json t/data/retryable-reads/estimatedDocumentCount-serverErrors.yml t/data/retryable-reads/estimatedDocumentCount.json t/data/retryable-reads/estimatedDocumentCount.yml t/data/retryable-reads/find-serverErrors.json t/data/retryable-reads/find-serverErrors.yml t/data/retryable-reads/find.json t/data/retryable-reads/find.yml t/data/retryable-reads/findOne-serverErrors.json t/data/retryable-reads/findOne-serverErrors.yml t/data/retryable-reads/findOne.json t/data/retryable-reads/findOne.yml t/data/retryable-reads/gridfs-download-serverErrors.json t/data/retryable-reads/gridfs-download-serverErrors.yml t/data/retryable-reads/gridfs-download.json t/data/retryable-reads/gridfs-download.yml t/data/retryable-reads/gridfs-downloadByName-serverErrors.json t/data/retryable-reads/gridfs-downloadByName-serverErrors.yml t/data/retryable-reads/gridfs-downloadByName.json t/data/retryable-reads/gridfs-downloadByName.yml t/data/retryable-reads/listCollectionNames-serverErrors.json t/data/retryable-reads/listCollectionNames-serverErrors.yml t/data/retryable-reads/listCollectionNames.json t/data/retryable-reads/listCollectionNames.yml t/data/retryable-reads/listCollectionObjects-serverErrors.json t/data/retryable-reads/listCollectionObjects-serverErrors.yml t/data/retryable-reads/listCollectionObjects.json t/data/retryable-reads/listCollectionObjects.yml t/data/retryable-reads/listCollections-serverErrors.json t/data/retryable-reads/listCollections-serverErrors.yml t/data/retryable-reads/listCollections.json t/data/retryable-reads/listCollections.yml t/data/retryable-reads/listDatabaseNames-serverErrors.json t/data/retryable-reads/listDatabaseNames-serverErrors.yml t/data/retryable-reads/listDatabaseNames.json t/data/retryable-reads/listDatabaseNames.yml t/data/retryable-reads/listDatabaseObjects-serverErrors.json t/data/retryable-reads/listDatabaseObjects-serverErrors.yml t/data/retryable-reads/listDatabaseObjects.json t/data/retryable-reads/listDatabaseObjects.yml t/data/retryable-reads/listDatabases-serverErrors.json t/data/retryable-reads/listDatabases-serverErrors.yml t/data/retryable-reads/listDatabases.json t/data/retryable-reads/listDatabases.yml t/data/retryable-reads/listIndexNames-serverErrors.json t/data/retryable-reads/listIndexNames-serverErrors.yml t/data/retryable-reads/listIndexNames.json t/data/retryable-reads/listIndexNames.yml t/data/retryable-reads/listIndexes-serverErrors.json t/data/retryable-reads/listIndexes-serverErrors.yml t/data/retryable-reads/listIndexes.json t/data/retryable-reads/listIndexes.yml t/data/retryable-writes/README.rst t/data/retryable-writes/bulkWrite-serverErrors.json t/data/retryable-writes/bulkWrite-serverErrors.yml t/data/retryable-writes/bulkWrite.json t/data/retryable-writes/bulkWrite.yml t/data/retryable-writes/deleteMany.json t/data/retryable-writes/deleteMany.yml t/data/retryable-writes/deleteOne-serverErrors.json t/data/retryable-writes/deleteOne-serverErrors.yml t/data/retryable-writes/deleteOne.json t/data/retryable-writes/deleteOne.yml t/data/retryable-writes/findOneAndDelete-serverErrors.json t/data/retryable-writes/findOneAndDelete-serverErrors.yml t/data/retryable-writes/findOneAndDelete.json t/data/retryable-writes/findOneAndDelete.yml t/data/retryable-writes/findOneAndReplace-serverErrors.json t/data/retryable-writes/findOneAndReplace-serverErrors.yml t/data/retryable-writes/findOneAndReplace.json t/data/retryable-writes/findOneAndReplace.yml t/data/retryable-writes/findOneAndUpdate-serverErrors.json t/data/retryable-writes/findOneAndUpdate-serverErrors.yml t/data/retryable-writes/findOneAndUpdate.json t/data/retryable-writes/findOneAndUpdate.yml t/data/retryable-writes/insertMany-serverErrors.json t/data/retryable-writes/insertMany-serverErrors.yml t/data/retryable-writes/insertMany.json t/data/retryable-writes/insertMany.yml t/data/retryable-writes/insertOne-serverErrors.json t/data/retryable-writes/insertOne-serverErrors.yml t/data/retryable-writes/insertOne.json t/data/retryable-writes/insertOne.yml t/data/retryable-writes/replaceOne-serverErrors.json t/data/retryable-writes/replaceOne-serverErrors.yml t/data/retryable-writes/replaceOne.json t/data/retryable-writes/replaceOne.yml t/data/retryable-writes/updateMany.json t/data/retryable-writes/updateMany.yml t/data/retryable-writes/updateOne-serverErrors.json t/data/retryable-writes/updateOne-serverErrors.yml t/data/retryable-writes/updateOne.json t/data/retryable-writes/updateOne.yml t/data/sessions/README.rst t/data/sessions/dirty-session-errors.json t/data/sessions/dirty-session-errors.yml t/data/transactions-convenient-api/README.rst t/data/transactions-convenient-api/callback-aborts.json t/data/transactions-convenient-api/callback-aborts.yml t/data/transactions-convenient-api/callback-commits.json t/data/transactions-convenient-api/callback-commits.yml t/data/transactions-convenient-api/callback-retry.json t/data/transactions-convenient-api/callback-retry.yml t/data/transactions-convenient-api/commit-retry.json t/data/transactions-convenient-api/commit-retry.yml t/data/transactions-convenient-api/commit-transienttransactionerror-4.2.json t/data/transactions-convenient-api/commit-transienttransactionerror-4.2.yml t/data/transactions-convenient-api/commit-transienttransactionerror.json t/data/transactions-convenient-api/commit-transienttransactionerror.yml t/data/transactions-convenient-api/commit-writeconcernerror.json t/data/transactions-convenient-api/commit-writeconcernerror.yml t/data/transactions-convenient-api/commit.json t/data/transactions-convenient-api/commit.yml t/data/transactions-convenient-api/transaction-options.json t/data/transactions-convenient-api/transaction-options.yml t/data/transactions-convenient-api/transactions-convenient-api.rst t/data/transactions/README.rst t/data/transactions/abort.json t/data/transactions/abort.yml t/data/transactions/bulk.json t/data/transactions/bulk.yml t/data/transactions/causal-consistency.json t/data/transactions/causal-consistency.yml t/data/transactions/commit.json t/data/transactions/commit.yml t/data/transactions/count.json t/data/transactions/count.yml t/data/transactions/delete.json t/data/transactions/delete.yml t/data/transactions/error-labels.json t/data/transactions/error-labels.yml t/data/transactions/errors-client.json t/data/transactions/errors-client.yml t/data/transactions/errors.json t/data/transactions/errors.yml t/data/transactions/findOneAndDelete.json t/data/transactions/findOneAndDelete.yml t/data/transactions/findOneAndReplace.json t/data/transactions/findOneAndReplace.yml t/data/transactions/findOneAndUpdate.json t/data/transactions/findOneAndUpdate.yml t/data/transactions/insert.json t/data/transactions/insert.yml t/data/transactions/isolation.json t/data/transactions/isolation.yml t/data/transactions/mongos-pin-auto-tests.py t/data/transactions/mongos-pin-auto.json t/data/transactions/mongos-pin-auto.yml t/data/transactions/mongos-recovery-token.json t/data/transactions/mongos-recovery-token.yml t/data/transactions/pin-mongos.json t/data/transactions/pin-mongos.yml t/data/transactions/read-concern.json t/data/transactions/read-concern.yml t/data/transactions/read-pref.json t/data/transactions/read-pref.yml t/data/transactions/reads.json t/data/transactions/reads.yml t/data/transactions/retryable-abort.json t/data/transactions/retryable-abort.yml t/data/transactions/retryable-commit.json t/data/transactions/retryable-commit.yml t/data/transactions/retryable-writes.json t/data/transactions/retryable-writes.yml t/data/transactions/run-command.json t/data/transactions/run-command.yml t/data/transactions/transaction-options.json t/data/transactions/transaction-options.yml t/data/transactions/update.json t/data/transactions/update.yml t/data/transactions/write-concern.json t/data/transactions/write-concern.yml t/data/uri/README.rst t/data/uri/auth-options.json t/data/uri/auth-options.yml t/data/uri/ca.pem t/data/uri/cert.pem t/data/uri/client.pem t/data/uri/compression-options.json t/data/uri/compression-options.yml t/data/uri/concern-options.json t/data/uri/concern-options.yml t/data/uri/connection-options.json t/data/uri/connection-options.yml t/data/uri/connection-pool-options.json t/data/uri/connection-pool-options.yml t/data/uri/general.json t/data/uri/general.yml t/data/uri/read-preference-options.json t/data/uri/read-preference-options.yml t/data/uri/single-threaded-options.json t/data/uri/single-threaded-options.yml t/data/uri/tls-options.json t/data/uri/tls-options.yml t/database.t t/dbref.t t/deprecated/bson.t t/deprecated/collection.t t/deprecated/cursor.t t/deprecated/find_modifiers.t t/deprecated/parallel_scan.t t/deprecated/regexp_obj.t t/deprecated/types.t t/deprecated/typewrappers.t t/enumerate_databases.t t/errors.t t/examples/changestream.t t/examples/driver-examples.t t/examples/transaction.t t/find_modifiers.t t/fsync.t t/gridfs_spec.t t/gridfsbucket.t t/indexview.t t/kill-cursor.t t/lib/MongoDBSpecTest.pm t/lib/MongoDBTest.pm t/lib/MongoDBTest/Callback.pm t/lib/TestBSON.pm t/lib/TestCodecWrapper.pm t/max_staleness_spec.t t/max_time_ms.t t/monitoring.t t/monitoring_spec.t t/oid_generation.t t/op_msg.t t/pre_encode_insert_update.t t/protocol_op_msg.t t/read_write_concern_spec.t t/readpref.t t/retryable-reads-spec.t t/retryable-writes-command-construction.t t/retryable-writes-spec.t t/retryable-writes-split-batch.t t/sdam_monitoring.t t/sdam_spec.t t/sessions-cursors.t t/sessions-driver.t t/sessions-end.t t/sessions-spec.t t/sessions-unacknowledged-write.t t/ss_spec.t t/testrules.yml t/transactions-convenient-api-spec.t t/transactions-convenient-api.t t/transactions-mongos-pinning.t t/transactions-spec.t t/unit/configuration.t t/unit/link.t t/unit/read_preference.t t/unit/uri.t t/unit/uri_spec.t t/unit/uri_srv.t t/unit/write_concern.t t/using_profiler.t xt/author/00-compile.t xt/author/circular-refs.t xt/author/critic.t xt/author/minimum-version.t xt/author/pod-spell.t xt/author/pod-syntax.t xt/author/test-version.t xt/release/check-jira-in-changes.t MongoDB-v2.2.2/perlcritic.rc000644 000766 000024 00000001250 13715253235 016115 0ustar00davidstaff000000 000000 severity = 5 verbose = [%p] %m at %f, line %l, column %c. (Severity: %s)\n [Variables::ProhibitPunctuationVars] allow = $@ $! [TestingAndDebugging::ProhibitNoStrict] allow = refs [Variables::ProhibitEvilVariables] variables = $DB::single # Turn these off [-BuiltinFunctions::ProhibitStringyEval] [-ControlStructures::ProhibitPostfixControls] [-ControlStructures::ProhibitUnlessBlocks] [-Documentation::RequirePodSections] [-InputOutput::ProhibitInteractiveTest] [-References::ProhibitDoubleSigils] [-RegularExpressions::RequireExtendedFormatting] [-InputOutput::ProhibitTwoArgOpen] [-Modules::ProhibitEvilModules] # Turn this on [Lax::ProhibitStringyEval::ExceptForRequire] MongoDB-v2.2.2/INSTALL.md000644 000766 000024 00000010243 13715253235 015061 0ustar00davidstaff000000 000000 # Installation Instructions for the MongoDB Perl Driver This file describes requirements and procedures for installing the MongoDB Perl driver, typically from CPAN or a tarball. ## Supported platforms The driver requires Perl v5.8.4 or later for most Unix-like platforms. It is known to build successfully on the following operating systems: * Linux * FreeBSD, OpenBSD, NetBSD * Mac OSX * Windows Vista/2008+ with Strawberry Perl 5.14 or later Please see the [CPAN Testers Matrix](http://matrix.cpantesters.org/?dist=MongoDB) for more details on platform/perl compatibility. The driver has not been tested on big-endian platforms. Big-endian platforms will require Perl 5.10 or later. ## Compiler tool requirements This module requires `make` and a compiler. For example, Debian and Ubuntu users should issue the following command: $ sudo apt-get install build-essential Users of Red Hat based distributions (RHEL, CentOS, Amazon Linux, Oracle Linux, Fedora, etc.) should issue the following command: $ sudo yum install make gcc On Windows, [StrawberryPerl](http://strawberryperl.com/) ships with a GCC compiler. ## Configuration requirements Configuration requires the following Perl modules: * Config::AutoConf * Path::Tiny If you are using a modern CPAN client (anything since Perl v5.12), these will be installed automatically as needed. If you have an older CPAN client or are doing manual installation, install these before running `Makefile.PL`. $ cpan Config::AutoConf Path::Tiny ## Testing with a database Most tests will skip unless a MongoDB database is available either on the default localhost and port or on an alternate `host:port` specified by the `MONGOD` environment variable: $ export MONGOD=localhosts:31017 ## Installing as a non-privileged user If you do not have write permissions to your Perl's site library directory (`perl -V:sitelib`), then you will need to use your CPAN client or run `make install` as root or with `sudo`. Alternatively, you configure a local library. See [local::lib](https://metacpan.org/pod/local::lib#The-bootstrapping-technique) on CPAN for more details. ## Installing from CPAN You can install the latest stable release by installing the `MongoDB` package: $ cpan MongoDB To install a development release, specify it by author and tarball path. For example: $ cpan MONGODB/MongoDB-v0.999.999.4-TRIAL.tar.gz ## Installing from a tarball downloaded from CPAN You can install using a CPAN client. Unpack the tarball and from inside the unpacked directly, run your CPAN client with `.` as the target: $ cpan . To install manually, first install the configuration requirements listed above. Then run the `Makefile.PL` manually: $ perl Makefile.PL This will report any missing prerequisites and you will need to install them all. You can then run `make`, etc. as usual: $ make $ make test $ make install ## Installing from the git repository If you have checked out the git repository (or downloaded a tarball from Github), you will need to install configuration requirements and follow the manual procedure described above. ## SSL and/or SASL support SSL support requires installing the [IO::Socket::SSL](http://p3rl.org/IO::Socket::SSL) module. You will need to have the libssl-dev package or equivalent installed for that to build successfully. SASL support requires [Authen::SASL](http://p3rl.org/Authen::SASL) and possibly a Kerberos-capable backend. The [Authen::SASL::Perl](http://p3rl.org/Authen::SASL::Perl) backend comes with Authen::SASL and requires the [GSSAPI](http://p3rl.org/GSSAPI) CPAN module for GSSAPI support. Installing the GSSAPI module from CPAN rather than an OS package requires libkrb5 and the krb5-config utility (available for Debian/RHEL systems in the libkrb5-dev or equivalent package). Alternatively, the [Authen::SASL::XS](http://p3rl.org/Authen::SASL::XS) or [Authen::SASL::Cyrus](http://p3rl.org/Authen::SASL::Cyrus) modules may be used. Both rely on Cyrus libsasl. Authen::SASL::XS is preferred. Installing Authen::SASL::XS or Authen::SASL::Cyrus from CPAN requires libsasl. On Debian systems, it is available from libsasl2-dev; on RHEL, it is available in cyrus-sasl-devel. MongoDB-v2.2.2/t/000755 000766 000024 00000000000 13715253235 013674 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/xt/000755 000766 000024 00000000000 13715253235 014064 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/README000644 000766 000024 00000000501 13715253235 014305 0ustar00davidstaff000000 000000 This archive contains the distribution MongoDB, version v2.2.2: Official MongoDB Driver for Perl (EOL) This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 This README file was generated by Dist::Zilla::Plugin::Readme v6.015. MongoDB-v2.2.2/README.md000644 000766 000024 00000006465 13715253235 014723 0ustar00davidstaff000000 000000 # END OF LIFE NOTICE Version v2.2.0 was the final feature release of the MongoDB Perl driver and version v2.2.2 is the final patch release. **As of August 13, 2020, the MongoDB Perl driver and related libraries have reached end of life and are no longer supported by MongoDB.** See the [August 2019 deprecation notice](https://www.mongodb.com/blog/post/the-mongodb-perl-driver-is-being-deprecated) for rationale. If members of the community wish to continue development, they are welcome to fork the code under the terms of the Apache 2 license and release it under a new namespace. Specifications and test files for MongoDB drivers and libraries are published in an open repository: [mongodb/specifications](https://github.com/mongodb/specifications/tree/master/source). # Introduction `mongo-perl-driver` is the official client-side driver for talking to MongoDB with Perl. It is free software released under the Apache 2.0 license and available on CPAN under the distribution name `MongoDB`. This file describes requirements and procedures for developing and testing the MongoDB Perl driver from its code repository. For instructions installing from CPAN or tarball, see the [INSTALL.md](INSTALL.md) file instead. While this distribution is shipped using Dist::Zilla, you do not need to install it or use it for development and testing. # Working with the source ## Compiler tool requirements This module requires `make` and a compiler. For example, Debian and Ubuntu users should issue the following command: $ sudo apt-get install build-essential Users of Red Hat based distributions (RHEL, CentOS, Amazon Linux, Oracle Linux, Fedora, etc.) should issue the following command: $ sudo yum install make gcc On Windows, [StrawberryPerl](http://strawberryperl.com/) ships with a GCC compiler. On Mac, install XCode or just the [XCode command line tools](https://developer.apple.com/library/ios/technotes/tn2339/_index.html). ## Installing Perl dependencies as a non-privileged user If you do not have write permissions to your Perl's site library directory (`perl -V:sitelib`), then you will need to use your CPAN client or run `make install` as root or with `sudo`. Alternatively, you can configure a local library. See [local::lib](https://metacpan.org/pod/local::lib#The-bootstrapping-technique) on CPAN for more details. If you configure a local library, don't forget to modify your `.bashrc` or equivalent files. ## Configuration and dependencies You will need to install Config::AutoConf and Path::Tiny to be able to run the Makefile.PL. $ cpan Config::AutoConf Path::Tiny To configure: $ perl Makefile.PL The output will highlight any missing dependencies. Install those with the `cpan` client. $ cpan [list of dependencies] You may also use `cpan` to install the current stable MongoDB driver with `cpan MongoDB`, which should pick up most of the dependencies you will need automatically. ## Building and testing Most tests will skip unless a MongoDB database is available either on the default localhost and port or on an alternate `host:port` specified by the `MONGOD` environment variable: $ export MONGOD=localhosts:31017 You can download a free, community edition of MongoDB from [MongoDB Downloads](https://www.mongodb.org/downloads). To build and test (after configuration): $ make $ make test MongoDB-v2.2.2/CONTRIBUTING.md000644 000766 000024 00000006465 13715253235 015675 0ustar00davidstaff000000 000000 # END OF LIFE NOTICE Version v2.2.0 was the final feature release of the MongoDB Perl driver and version v2.2.2 is the final patch release. **As of August 13, 2020, the MongoDB Perl driver and related libraries have reached end of life and are no longer supported by MongoDB.** See the [August 2019 deprecation notice](https://www.mongodb.com/blog/post/the-mongodb-perl-driver-is-being-deprecated) for rationale. If members of the community wish to continue development, they are welcome to fork the code under the terms of the Apache 2 license and release it under a new namespace. Specifications and test files for MongoDB drivers and libraries are published in an open repository: [mongodb/specifications](https://github.com/mongodb/specifications/tree/master/source). # Introduction `mongo-perl-driver` is the official client-side driver for talking to MongoDB with Perl. It is free software released under the Apache 2.0 license and available on CPAN under the distribution name `MongoDB`. This file describes requirements and procedures for developing and testing the MongoDB Perl driver from its code repository. For instructions installing from CPAN or tarball, see the [INSTALL.md](INSTALL.md) file instead. While this distribution is shipped using Dist::Zilla, you do not need to install it or use it for development and testing. # Working with the source ## Compiler tool requirements This module requires `make` and a compiler. For example, Debian and Ubuntu users should issue the following command: $ sudo apt-get install build-essential Users of Red Hat based distributions (RHEL, CentOS, Amazon Linux, Oracle Linux, Fedora, etc.) should issue the following command: $ sudo yum install make gcc On Windows, [StrawberryPerl](http://strawberryperl.com/) ships with a GCC compiler. On Mac, install XCode or just the [XCode command line tools](https://developer.apple.com/library/ios/technotes/tn2339/_index.html). ## Installing Perl dependencies as a non-privileged user If you do not have write permissions to your Perl's site library directory (`perl -V:sitelib`), then you will need to use your CPAN client or run `make install` as root or with `sudo`. Alternatively, you can configure a local library. See [local::lib](https://metacpan.org/pod/local::lib#The-bootstrapping-technique) on CPAN for more details. If you configure a local library, don't forget to modify your `.bashrc` or equivalent files. ## Configuration and dependencies You will need to install Config::AutoConf and Path::Tiny to be able to run the Makefile.PL. $ cpan Config::AutoConf Path::Tiny To configure: $ perl Makefile.PL The output will highlight any missing dependencies. Install those with the `cpan` client. $ cpan [list of dependencies] You may also use `cpan` to install the current stable MongoDB driver with `cpan MongoDB`, which should pick up most of the dependencies you will need automatically. ## Building and testing Most tests will skip unless a MongoDB database is available either on the default localhost and port or on an alternate `host:port` specified by the `MONGOD` environment variable: $ export MONGOD=localhosts:31017 You can download a free, community edition of MongoDB from [MongoDB Downloads](https://www.mongodb.org/downloads). To build and test (after configuration): $ make $ make test MongoDB-v2.2.2/META.yml000644 000766 000024 00000022727 13715253235 014714 0ustar00davidstaff000000 000000 --- abstract: 'Official MongoDB Driver for Perl (EOL)' author: - 'David Golden ' - 'Rassi ' - 'Mike Friedman ' - 'Kristina Chodorow ' - 'Florian Ragwitz ' build_requires: BSON::Decimal128: '0' Data::Dumper: '0' ExtUtils::MakeMaker: '0' File::Compare: '0' File::Spec: '0' IO::File: '0' JSON::MaybeXS: '0' Path::Tiny: '0.058' Storable: '0' Test::Deep: '0.111' Test::Fatal: '0' Test::More: '0.96' lib: '0' perl: '5.010001' utf8: '0' configure_requires: ExtUtils::MakeMaker: '6.17' Text::ParseWords: '0' dynamic_config: 1 generated_by: 'Dist::Zilla version 6.015, CPAN::Meta::Converter version 2.150010' license: apache meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: '1.4' name: MongoDB no_index: directory: - devel - inc - t - xt provides: MongoDB: file: lib/MongoDB.pm version: v2.2.2 MongoDB::AuthError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::BSON::Binary: file: lib/MongoDB/BSON/Binary.pm version: v2.2.2 MongoDB::BSON::Regexp: file: lib/MongoDB/BSON/Regexp.pm version: v2.2.2 MongoDB::BulkWrite: file: lib/MongoDB/BulkWrite.pm version: v2.2.2 MongoDB::BulkWriteResult: file: lib/MongoDB/BulkWriteResult.pm version: v2.2.2 MongoDB::BulkWriteView: file: lib/MongoDB/BulkWriteView.pm version: v2.2.2 MongoDB::ChangeStream: file: lib/MongoDB/ChangeStream.pm version: v2.2.2 MongoDB::ClientSession: file: lib/MongoDB/ClientSession.pm version: v2.2.2 MongoDB::Code: file: lib/MongoDB/Code.pm version: v2.2.2 MongoDB::Collection: file: lib/MongoDB/Collection.pm version: v2.2.2 MongoDB::CommandResult: file: lib/MongoDB/CommandResult.pm version: v2.2.2 MongoDB::ConfigurationError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::ConnectionError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::Cursor: file: lib/MongoDB/Cursor.pm version: v2.2.2 MongoDB::CursorNotFoundError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::DBRef: file: lib/MongoDB/DBRef.pm version: v2.2.2 MongoDB::Database: file: lib/MongoDB/Database.pm version: v2.2.2 MongoDB::DatabaseError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::DecodingError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::DeleteResult: file: lib/MongoDB/DeleteResult.pm version: v2.2.2 MongoDB::DocumentError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::DuplicateKeyError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::Error: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::ExecutionTimeout: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::GridFSBucket: file: lib/MongoDB/GridFSBucket.pm version: v2.2.2 MongoDB::GridFSBucket::DownloadStream: file: lib/MongoDB/GridFSBucket/DownloadStream.pm version: v2.2.2 MongoDB::GridFSBucket::UploadStream: file: lib/MongoDB/GridFSBucket/UploadStream.pm version: v2.2.2 MongoDB::GridFSError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::HandshakeError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::IndexView: file: lib/MongoDB/IndexView.pm version: v2.2.2 MongoDB::InsertManyResult: file: lib/MongoDB/InsertManyResult.pm version: v2.2.2 MongoDB::InsertOneResult: file: lib/MongoDB/InsertOneResult.pm version: v2.2.2 MongoDB::InternalError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::InvalidOperationError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::MongoClient: file: lib/MongoDB/MongoClient.pm version: v2.2.2 MongoDB::NetworkError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::NetworkTimeout: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::NotMasterError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::OID: file: lib/MongoDB/OID.pm version: v2.2.2 MongoDB::ProtocolError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::QueryResult: file: lib/MongoDB/QueryResult.pm version: v2.2.2 MongoDB::QueryResult::Filtered: file: lib/MongoDB/QueryResult/Filtered.pm version: v2.2.2 MongoDB::ReadConcern: file: lib/MongoDB/ReadConcern.pm version: v2.2.2 MongoDB::ReadPreference: file: lib/MongoDB/ReadPreference.pm version: v2.2.2 MongoDB::SelectionError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::TimeoutError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::Timestamp: file: lib/MongoDB/Timestamp.pm version: v2.2.2 MongoDB::UnacknowledgedResult: file: lib/MongoDB/UnacknowledgedResult.pm version: v2.2.2 MongoDB::UpdateResult: file: lib/MongoDB/UpdateResult.pm version: v2.2.2 MongoDB::UsageError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::WriteConcern: file: lib/MongoDB/WriteConcern.pm version: v2.2.2 MongoDB::WriteConcernError: file: lib/MongoDB/Error.pm version: v2.2.2 MongoDB::WriteError: file: lib/MongoDB/Error.pm version: v2.2.2 recommends: IO::Socket::IP: '0.32' IO::Socket::SSL: '1.42' Mozilla::CA: '20130114' Net::SSLeay: '1.49' requires: Authen::SASL::SASLprep: '0' Authen::SCRAM::Client: '0.011' BSON: '1.012000' BSON::Bytes: '0' BSON::Code: '0' BSON::DBRef: '0' BSON::OID: '0' BSON::Raw: '0' BSON::Regex: '0' BSON::Time: '0' BSON::Timestamp: '0' BSON::Types: '0' Carp: '0' Compress::Zlib: '0' Digest::MD5: '0' Encode: '0' Exporter: '5.57' IO::Socket: '0' List::Util: '0' MIME::Base64: '0' Math::BigInt: '0' Moo: '2' Moo::Role: '0' Net::DNS: '0' Safe::Isa: '1.000007' Scalar::Util: '0' Socket: '0' Sub::Defer: '0' Sub::Quote: '0' Tie::IxHash: '0' Time::HiRes: '0' Type::Library: '0' Type::Utils: '0' Types::Standard: '0' UUID::URandom: '0' boolean: '0.25' bytes: '0' constant: '0' if: '0' namespace::clean: '0' overload: '0' perl: '5.010001' re: '0' strict: '0' version: '0' warnings: '0' resources: bugtracker: https://github.com/mongodb-labs/mongo-perl-driver/issues homepage: https://github.com/mongodb-labs/mongo-perl-driver repository: https://github.com/mongodb-labs/mongo-perl-driver.git version: v2.2.2 x_contributors: - 'Andrew Page ' - 'Andrey Khozov ' - 'Ashley Willis ' - 'Ask Bjørn Hansen ' - 'Bernard Gorman ' - 'Brendan W. McAdams ' - 'Brian Moss ' - 'Casey Rojas ' - 'Christian Hansen ' - 'Christian Sturm ' - 'Christian Walde ' - 'Colin Cyr ' - 'Danny Raetzsch ' - 'David Morrison ' - 'David Nadle ' - 'David Steinbrunner ' - 'David Storch ' - 'diegok ' - 'D. Ilmari Mannsåker ' - 'Eric Daniels ' - 'Finn Kempers (Shadowcat Systems Ltd) ' - 'Gerard Goossen ' - 'Glenn Fowler ' - 'Graham Barr ' - 'Hao Wu ' - 'Harish Upadhyayula ' - 'Jason Carey ' - 'Jason Toffaletti ' - 'Johann Rolschewski ' - 'John A. Kunze ' - 'Joseph Harnish ' - 'Josh Matthews ' - 'Joshua Juran ' - 'J. Stewart ' - 'Kamil Slowikowski ' - 'Ken Williams ' - 'Matthew Shopsin ' - 'Matt S Trout ' - 'Michael Langner ' - 'Michael Rotmanov ' - 'Mike Dirolf ' - 'Mohammad S Anwar ' - 'Nickola Trupcheff ' - 'Nigel Gregoire ' - 'Niko Tyni ' - 'Nuno Carvalho ' - 'Orlando Vazquez ' - 'Othello Maurer ' - 'Pan Fan ' - 'Pavel Denisov ' - 'Rahul Dhodapkar ' - 'Robert Sedlacek (Shadowcat Systems Ltd) ' - 'Robin Lee ' - 'Roman Yerin ' - 'Ronald J Kimball ' - 'Ryan Chipman ' - 'Slaven Rezic ' - 'Slaven Rezic ' - 'Stephen Oberholtzer ' - 'Steve Sanbeg ' - 'Stuart Watt ' - 'Thomas Bloor (Shadowcat Systems Ltd) ' - 'Tobias Leich ' - 'Uwe Voelker ' - 'Wallace Reis ' - 'Wan Bachtiar ' - 'Whitney Jackson ' - 'Xavier Guimard ' - 'Xtreak ' - 'Zhihong Zhang ' x_generated_by_perl: v5.32.0 x_serialization_backend: 'YAML::Tiny version 1.73' x_spdx_expression: Apache-2.0 MongoDB-v2.2.2/lib/000755 000766 000024 00000000000 13715253235 014177 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/Makefile.PL000644 000766 000024 00000014123 13715253235 015404 0ustar00davidstaff000000 000000 # This Makefile.PL for MongoDB was generated by # Dist::Zilla::Plugin::MakeMaker::Awesome 0.48. # Don't edit it but the dist.ini and plugins used to construct it. use strict; use warnings; use 5.010001; use ExtUtils::MakeMaker 6.17; my %WriteMakefileArgs = ( "ABSTRACT" => "Official MongoDB Driver for Perl (EOL)", "AUTHOR" => "David Golden , Rassi , Mike Friedman , Kristina Chodorow , Florian Ragwitz ", "CONFIGURE_REQUIRES" => { "ExtUtils::MakeMaker" => "6.17", "Text::ParseWords" => 0 }, "DISTNAME" => "MongoDB", "LICENSE" => "apache", "MIN_PERL_VERSION" => "5.010001", "NAME" => "MongoDB", "PREREQ_PM" => { "Authen::SASL::SASLprep" => 0, "Authen::SCRAM::Client" => "0.011", "BSON" => "1.012000", "BSON::Bytes" => 0, "BSON::Code" => 0, "BSON::DBRef" => 0, "BSON::OID" => 0, "BSON::Raw" => 0, "BSON::Regex" => 0, "BSON::Time" => 0, "BSON::Timestamp" => 0, "BSON::Types" => 0, "Carp" => 0, "Compress::Zlib" => 0, "Digest::MD5" => 0, "Encode" => 0, "Exporter" => "5.57", "IO::Socket" => 0, "List::Util" => 0, "MIME::Base64" => 0, "Math::BigInt" => 0, "Moo" => 2, "Moo::Role" => 0, "Net::DNS" => 0, "Safe::Isa" => "1.000007", "Scalar::Util" => 0, "Socket" => 0, "Sub::Defer" => 0, "Sub::Quote" => 0, "Tie::IxHash" => 0, "Time::HiRes" => 0, "Type::Library" => 0, "Type::Utils" => 0, "Types::Standard" => 0, "UUID::URandom" => 0, "boolean" => "0.25", "bytes" => 0, "constant" => 0, "if" => 0, "namespace::clean" => 0, "overload" => 0, "re" => 0, "strict" => 0, "version" => 0, "warnings" => 0 }, "TEST_REQUIRES" => { "BSON::Decimal128" => 0, "Data::Dumper" => 0, "ExtUtils::MakeMaker" => 0, "File::Compare" => 0, "File::Spec" => 0, "IO::File" => 0, "JSON::MaybeXS" => 0, "Path::Tiny" => "0.058", "Storable" => 0, "Test::Deep" => "0.111", "Test::Fatal" => 0, "Test::More" => "0.96", "lib" => 0, "utf8" => 0 }, "VERSION" => "v2.2.2", "test" => { "TESTS" => "t/*.t t/deprecated/*.t t/examples/*.t t/unit/*.t" } ); my %FallbackPrereqs = ( "Authen::SASL::SASLprep" => 0, "Authen::SCRAM::Client" => "0.011", "BSON" => "1.012000", "BSON::Bytes" => 0, "BSON::Code" => 0, "BSON::DBRef" => 0, "BSON::Decimal128" => 0, "BSON::OID" => 0, "BSON::Raw" => 0, "BSON::Regex" => 0, "BSON::Time" => 0, "BSON::Timestamp" => 0, "BSON::Types" => 0, "Carp" => 0, "Compress::Zlib" => 0, "Data::Dumper" => 0, "Digest::MD5" => 0, "Encode" => 0, "Exporter" => "5.57", "ExtUtils::MakeMaker" => 0, "File::Compare" => 0, "File::Spec" => 0, "IO::File" => 0, "IO::Socket" => 0, "JSON::MaybeXS" => 0, "List::Util" => 0, "MIME::Base64" => 0, "Math::BigInt" => 0, "Moo" => 2, "Moo::Role" => 0, "Net::DNS" => 0, "Path::Tiny" => "0.058", "Safe::Isa" => "1.000007", "Scalar::Util" => 0, "Socket" => 0, "Storable" => 0, "Sub::Defer" => 0, "Sub::Quote" => 0, "Test::Deep" => "0.111", "Test::Fatal" => 0, "Test::More" => "0.96", "Tie::IxHash" => 0, "Time::HiRes" => 0, "Type::Library" => 0, "Type::Utils" => 0, "Types::Standard" => 0, "UUID::URandom" => 0, "boolean" => "0.25", "bytes" => 0, "constant" => 0, "if" => 0, "lib" => 0, "namespace::clean" => 0, "overload" => 0, "re" => 0, "strict" => 0, "utf8" => 0, "version" => 0, "warnings" => 0 ); # inserted by Dist::Zilla::Plugin::DynamicPrereqs 0.038 if (!want_pp() && can_xs()) { runtime_requires('Class::XSAccessor'); runtime_requires('Type::Tiny::XS'); } # inserted by Dist::Zilla::Plugin::DynamicPrereqs 0.038 if (!want_pp() && can_xs() && ($^O ne "MSWin32" || do {my (undef,$major,undef,undef,$id)=Win32::GetOSVersion(); $id>2 || ($id==2 && $major>=6)})) { runtime_requires('BSON::XS', '0.008000'); } unless ( eval { ExtUtils::MakeMaker->VERSION('6.63_03') } ) { delete $WriteMakefileArgs{TEST_REQUIRES}; delete $WriteMakefileArgs{BUILD_REQUIRES}; $WriteMakefileArgs{PREREQ_PM} = \%FallbackPrereqs; } delete $WriteMakefileArgs{CONFIGURE_REQUIRES} unless eval { ExtUtils::MakeMaker->VERSION(6.52) }; WriteMakefile(%WriteMakefileArgs); package MY; sub postamble { my $self = shift; return $self->SUPER::postamble . <<'HERE'; cover : pure_all HARNESS_PERL_SWITCHES=-MDevel::Cover make test ptest : pure_all HARNESS_OPTIONS=j9 make test HERE } package main; # inserted by Dist::Zilla::Plugin::DynamicPrereqs 0.038 sub _add_prereq { my ($mm_key, $module, $version_or_range) = @_; $version_or_range ||= 0; warn "$module already exists in $mm_key (at version $WriteMakefileArgs{$mm_key}{$module}) -- need to do a sane metamerge!" if exists $WriteMakefileArgs{$mm_key}{$module} and $WriteMakefileArgs{$mm_key}{$module} ne '0' and $WriteMakefileArgs{$mm_key}{$module} ne $version_or_range; warn "$module already exists in FallbackPrereqs (at version $FallbackPrereqs{$mm_key}{$module}) -- need to do a sane metamerge!" if exists $FallbackPrereqs{$module} and $FallbackPrereqs{$module} ne '0' and $FallbackPrereqs{$module} ne $version_or_range; $WriteMakefileArgs{$mm_key}{$module} = $FallbackPrereqs{$module} = $version_or_range; return; } use lib 'inc'; use ExtUtils::HasCompiler 0.014 'can_compile_loadable_object'; { my $can_xs; sub can_xs { return $can_xs if defined $can_xs; $can_xs = can_compile_loadable_object(quiet => 1) ? 1 : 0; } } { my $parsed_args; sub parse_args { return $parsed_args if defined $parsed_args; require ExtUtils::MakeMaker; require Text::ParseWords; ExtUtils::MakeMaker::parse_args( my $tmp = {}, Text::ParseWords::shellwords($ENV{PERL_MM_OPT} || ''), @ARGV, ); $parsed_args = $tmp->{ARGS} || {}; } } sub runtime_requires { my ($module, $version_or_range) = @_; _add_prereq(PREREQ_PM => $module, $version_or_range); } { my $want_pp; sub want_pp { return $want_pp if defined $want_pp; $want_pp = parse_args()->{PUREPERL_ONLY} ? 1 : 0 } } MongoDB-v2.2.2/META.json000644 000766 000024 00000034044 13715253235 015057 0ustar00davidstaff000000 000000 { "abstract" : "Official MongoDB Driver for Perl (EOL)", "author" : [ "David Golden ", "Rassi ", "Mike Friedman ", "Kristina Chodorow ", "Florian Ragwitz " ], "dynamic_config" : 1, "generated_by" : "Dist::Zilla version 6.015, CPAN::Meta::Converter version 2.150010", "license" : [ "apache_2_0" ], "meta-spec" : { "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec", "version" : 2 }, "name" : "MongoDB", "no_index" : { "directory" : [ "devel", "inc", "t", "xt" ] }, "prereqs" : { "configure" : { "requires" : { "ExtUtils::MakeMaker" : "6.17", "Text::ParseWords" : "0" } }, "develop" : { "requires" : { "ExtUtils::HasCompiler" : "0.014", "File::Spec" : "0", "File::Temp" : "0", "IO::Handle" : "0", "IPC::Open3" : "0", "Pod::Wordlist" : "0", "Test::Memory::Cycle" : "0", "Test::MinimumVersion" : "0", "Test::More" : "0", "Test::Perl::Critic" : "0", "Test::Pod" : "1.41", "Test::Spelling" : "0.12", "Test::Version" : "1", "lib" : "0" } }, "runtime" : { "recommends" : { "IO::Socket::IP" : "0.32", "IO::Socket::SSL" : "1.42", "Mozilla::CA" : "20130114", "Net::SSLeay" : "1.49" }, "requires" : { "Authen::SASL::SASLprep" : "0", "Authen::SCRAM::Client" : "0.011", "BSON" : "1.012000", "BSON::Bytes" : "0", "BSON::Code" : "0", "BSON::DBRef" : "0", "BSON::OID" : "0", "BSON::Raw" : "0", "BSON::Regex" : "0", "BSON::Time" : "0", "BSON::Timestamp" : "0", "BSON::Types" : "0", "Carp" : "0", "Compress::Zlib" : "0", "Digest::MD5" : "0", "Encode" : "0", "Exporter" : "5.57", "IO::Socket" : "0", "List::Util" : "0", "MIME::Base64" : "0", "Math::BigInt" : "0", "Moo" : "2", "Moo::Role" : "0", "Net::DNS" : "0", "Safe::Isa" : "1.000007", "Scalar::Util" : "0", "Socket" : "0", "Sub::Defer" : "0", "Sub::Quote" : "0", "Tie::IxHash" : "0", "Time::HiRes" : "0", "Type::Library" : "0", "Type::Utils" : "0", "Types::Standard" : "0", "UUID::URandom" : "0", "boolean" : "0.25", "bytes" : "0", "constant" : "0", "if" : "0", "namespace::clean" : "0", "overload" : "0", "perl" : "5.010001", "re" : "0", "strict" : "0", "version" : "0", "warnings" : "0" }, "suggests" : { "IO::Socket::SSL" : "1.56" } }, "test" : { "recommends" : { "CPAN::Meta" : "2.120900", "Test::Harness" : "3.31", "Time::Moment" : "0.22" }, "requires" : { "BSON::Decimal128" : "0", "Data::Dumper" : "0", "ExtUtils::MakeMaker" : "0", "File::Compare" : "0", "File::Spec" : "0", "IO::File" : "0", "JSON::MaybeXS" : "0", "Path::Tiny" : "0.058", "Storable" : "0", "Test::Deep" : "0.111", "Test::Fatal" : "0", "Test::More" : "0.96", "lib" : "0", "perl" : "5.010001", "utf8" : "0" } } }, "provides" : { "MongoDB" : { "file" : "lib/MongoDB.pm", "version" : "v2.2.2" }, "MongoDB::AuthError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::BSON::Binary" : { "file" : "lib/MongoDB/BSON/Binary.pm", "version" : "v2.2.2" }, "MongoDB::BSON::Regexp" : { "file" : "lib/MongoDB/BSON/Regexp.pm", "version" : "v2.2.2" }, "MongoDB::BulkWrite" : { "file" : "lib/MongoDB/BulkWrite.pm", "version" : "v2.2.2" }, "MongoDB::BulkWriteResult" : { "file" : "lib/MongoDB/BulkWriteResult.pm", "version" : "v2.2.2" }, "MongoDB::BulkWriteView" : { "file" : "lib/MongoDB/BulkWriteView.pm", "version" : "v2.2.2" }, "MongoDB::ChangeStream" : { "file" : "lib/MongoDB/ChangeStream.pm", "version" : "v2.2.2" }, "MongoDB::ClientSession" : { "file" : "lib/MongoDB/ClientSession.pm", "version" : "v2.2.2" }, "MongoDB::Code" : { "file" : "lib/MongoDB/Code.pm", "version" : "v2.2.2" }, "MongoDB::Collection" : { "file" : "lib/MongoDB/Collection.pm", "version" : "v2.2.2" }, "MongoDB::CommandResult" : { "file" : "lib/MongoDB/CommandResult.pm", "version" : "v2.2.2" }, "MongoDB::ConfigurationError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::ConnectionError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::Cursor" : { "file" : "lib/MongoDB/Cursor.pm", "version" : "v2.2.2" }, "MongoDB::CursorNotFoundError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::DBRef" : { "file" : "lib/MongoDB/DBRef.pm", "version" : "v2.2.2" }, "MongoDB::Database" : { "file" : "lib/MongoDB/Database.pm", "version" : "v2.2.2" }, "MongoDB::DatabaseError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::DecodingError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::DeleteResult" : { "file" : "lib/MongoDB/DeleteResult.pm", "version" : "v2.2.2" }, "MongoDB::DocumentError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::DuplicateKeyError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::Error" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::ExecutionTimeout" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::GridFSBucket" : { "file" : "lib/MongoDB/GridFSBucket.pm", "version" : "v2.2.2" }, "MongoDB::GridFSBucket::DownloadStream" : { "file" : "lib/MongoDB/GridFSBucket/DownloadStream.pm", "version" : "v2.2.2" }, "MongoDB::GridFSBucket::UploadStream" : { "file" : "lib/MongoDB/GridFSBucket/UploadStream.pm", "version" : "v2.2.2" }, "MongoDB::GridFSError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::HandshakeError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::IndexView" : { "file" : "lib/MongoDB/IndexView.pm", "version" : "v2.2.2" }, "MongoDB::InsertManyResult" : { "file" : "lib/MongoDB/InsertManyResult.pm", "version" : "v2.2.2" }, "MongoDB::InsertOneResult" : { "file" : "lib/MongoDB/InsertOneResult.pm", "version" : "v2.2.2" }, "MongoDB::InternalError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::InvalidOperationError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::MongoClient" : { "file" : "lib/MongoDB/MongoClient.pm", "version" : "v2.2.2" }, "MongoDB::NetworkError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::NetworkTimeout" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::NotMasterError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::OID" : { "file" : "lib/MongoDB/OID.pm", "version" : "v2.2.2" }, "MongoDB::ProtocolError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::QueryResult" : { "file" : "lib/MongoDB/QueryResult.pm", "version" : "v2.2.2" }, "MongoDB::QueryResult::Filtered" : { "file" : "lib/MongoDB/QueryResult/Filtered.pm", "version" : "v2.2.2" }, "MongoDB::ReadConcern" : { "file" : "lib/MongoDB/ReadConcern.pm", "version" : "v2.2.2" }, "MongoDB::ReadPreference" : { "file" : "lib/MongoDB/ReadPreference.pm", "version" : "v2.2.2" }, "MongoDB::SelectionError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::TimeoutError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::Timestamp" : { "file" : "lib/MongoDB/Timestamp.pm", "version" : "v2.2.2" }, "MongoDB::UnacknowledgedResult" : { "file" : "lib/MongoDB/UnacknowledgedResult.pm", "version" : "v2.2.2" }, "MongoDB::UpdateResult" : { "file" : "lib/MongoDB/UpdateResult.pm", "version" : "v2.2.2" }, "MongoDB::UsageError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::WriteConcern" : { "file" : "lib/MongoDB/WriteConcern.pm", "version" : "v2.2.2" }, "MongoDB::WriteConcernError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" }, "MongoDB::WriteError" : { "file" : "lib/MongoDB/Error.pm", "version" : "v2.2.2" } }, "release_status" : "stable", "resources" : { "bugtracker" : { "web" : "https://github.com/mongodb-labs/mongo-perl-driver/issues" }, "homepage" : "https://github.com/mongodb-labs/mongo-perl-driver", "repository" : { "type" : "git", "url" : "https://github.com/mongodb-labs/mongo-perl-driver.git", "web" : "https://github.com/mongodb-labs/mongo-perl-driver" } }, "version" : "v2.2.2", "x_contributors" : [ "Andrew Page ", "Andrey Khozov ", "Ashley Willis ", "Ask Bj\u00f8rn Hansen ", "Bernard Gorman ", "Brendan W. McAdams ", "Brian Moss ", "Casey Rojas ", "Christian Hansen ", "Christian Sturm ", "Christian Walde ", "Colin Cyr ", "Danny Raetzsch ", "David Morrison ", "David Nadle ", "David Steinbrunner ", "David Storch ", "diegok ", "D. Ilmari Manns\u00e5ker ", "Eric Daniels ", "Finn Kempers (Shadowcat Systems Ltd) ", "Gerard Goossen ", "Glenn Fowler ", "Graham Barr ", "Hao Wu ", "Harish Upadhyayula ", "Jason Carey ", "Jason Toffaletti ", "Johann Rolschewski ", "John A. Kunze ", "Joseph Harnish ", "Josh Matthews ", "Joshua Juran ", "J. Stewart ", "Kamil Slowikowski ", "Ken Williams ", "Matthew Shopsin ", "Matt S Trout ", "Michael Langner ", "Michael Rotmanov ", "Mike Dirolf ", "Mohammad S Anwar ", "Nickola Trupcheff ", "Nigel Gregoire ", "Niko Tyni ", "Nuno Carvalho ", "Orlando Vazquez ", "Othello Maurer ", "Pan Fan ", "Pavel Denisov ", "Rahul Dhodapkar ", "Robert Sedlacek (Shadowcat Systems Ltd) ", "Robin Lee ", "Roman Yerin ", "Ronald J Kimball ", "Ryan Chipman ", "Slaven Rezic ", "Slaven Rezic ", "Stephen Oberholtzer ", "Steve Sanbeg ", "Stuart Watt ", "Thomas Bloor (Shadowcat Systems Ltd) ", "Tobias Leich ", "Uwe Voelker ", "Wallace Reis ", "Wan Bachtiar ", "Whitney Jackson ", "Xavier Guimard ", "Xtreak ", "Zhihong Zhang " ], "x_generated_by_perl" : "v5.32.0", "x_serialization_backend" : "Cpanel::JSON::XS version 4.19", "x_spdx_expression" : "Apache-2.0" } MongoDB-v2.2.2/lib/MongoDB.pm000644 000766 000024 00000032445 13715253235 016032 0ustar00davidstaff000000 000000 # Copyright 2009 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use 5.010001; use strict; use warnings; package MongoDB; # ABSTRACT: Official MongoDB Driver for Perl (EOL) use version; our $VERSION = 'v2.2.2'; # regexp_pattern was unavailable before 5.10, had to be exported to load the # function implementation on 5.10, and was automatically available in 5.10.1 use if ($] eq '5.010000'), 're', 'regexp_pattern'; use Carp (); use MongoDB::MongoClient; use MongoDB::Database; use MongoDB::Collection; use MongoDB::BulkWrite; use MongoDB::_Link; use MongoDB::_Protocol; use BSON::Types; # regexp_pattern was unavailable before 5.10, had to be exported to load the # function implementation on 5.10, and was automatically available in 5.10.1 if ( $] eq '5.010' ) { require re; re->import('regexp_pattern'); } #pod =method connect #pod #pod $client = MongoDB->connect(); # localhost, port 27107 #pod $client = MongoDB->connect($host_uri); #pod $client = MongoDB->connect($host_uri, $options); #pod #pod This function returns a L object. The first parameter is #pod used as the C argument and must be a host name or L. The second argument is #pod optional. If provided, it must be a hash reference of constructor arguments #pod for L. #pod #pod If an error occurs, a L object will be thrown. #pod #pod B: To connect to a replica set, a replica set name must be provided. #pod For example, if the set name is C<"setA">: #pod #pod $client = MongoDB->connect("mongodb://example.com/?replicaSet=setA"); #pod #pod =cut sub connect { my ($class, $host, $options) = @_; $host ||= "mongodb://localhost"; $options ||= {}; $options->{host} = $host; return MongoDB::MongoClient->new( $options ); } 1; =pod =encoding UTF-8 =head1 NAME MongoDB - Official MongoDB Driver for Perl (EOL) =head1 VERSION version v2.2.2 =head1 END OF LIFE NOTICE Version v2.2.0 was the final feature release of the MongoDB Perl driver and version v2.2.2 is the final patch release. B See the L for rationale. If members of the community wish to continue development, they are welcome to fork the code under the terms of the Apache 2 license and release it under a new namespace. Specifications and test files for MongoDB drivers and libraries are published in an open repository: L. =head1 SYNOPSIS use MongoDB; my $client = MongoDB->connect('mongodb://localhost'); my $collection = $client->ns('foo.bar'); # database foo, collection bar my $result = $collection->insert_one({ some => 'data' }); my $data = $collection->find_one({ _id => $result->inserted_id }); =head1 DESCRIPTION This is the official Perl driver for L. MongoDB is an open-source document database that provides high performance, high availability, and easy scalability. A MongoDB server (or multi-server deployment) hosts a number of databases. A database holds a set of collections. A collection holds a set of documents. A document is a set of key-value pairs. Documents have dynamic schema. Using dynamic schema means that documents in the same collection do not need to have the same set of fields or structure, and common fields in a collection's documents may hold different types of data. Here are some resources for learning more about MongoDB: =over 4 =item * L =item * L =item * L =back To get started with the Perl driver, see these pages: =over 4 =item * L =item * L =back Extensive documentation and support resources are available via the L. =head1 USAGE The MongoDB driver is organized into a set of classes representing different levels of abstraction and functionality. As a user, you first create and configure a L object to connect to a MongoDB deployment. From that client object, you can get a L object for interacting with a specific database. From a database object, you can get a L object for CRUD operations on that specific collection, or a L object for working with an abstract file system hosted on the database. Each of those classes may return other objects for specific features or functions. See the documentation of those classes for more details or the L for an example. L objects are generated from a L and allow for advanced consistency options, like causal-consistency and transactions. =head2 Error handling Unless otherwise documented, errors result in fatal exceptions. See L for a list of exception classes and error code constants. =head1 METHODS =head2 connect $client = MongoDB->connect(); # localhost, port 27107 $client = MongoDB->connect($host_uri); $client = MongoDB->connect($host_uri, $options); This function returns a L object. The first parameter is used as the C argument and must be a host name or L. The second argument is optional. If provided, it must be a hash reference of constructor arguments for L. If an error occurs, a L object will be thrown. B: To connect to a replica set, a replica set name must be provided. For example, if the set name is C<"setA">: $client = MongoDB->connect("mongodb://example.com/?replicaSet=setA"); =begin Pod::Coverage =end Pod::Coverage =head1 SUPPORTED MONGODB VERSIONS The driver has been tested against MongoDB versions 2.6 through 4.2. All features of these versions are supported, except for field-level encryption. The driver may work with future versions of MongoDB, but will not include support for new MongoDB features and should be B within applications before deployment. =head1 SEMANTIC VERSIONING SCHEME Starting with MongoDB C, the driver reverts to the more familiar three-part version-tuple numbering scheme used by both Perl and MongoDB: C =over 4 =item * C will be incremented for incompatible API changes. =item * Even-value increments of C indicate stable releases with new functionality. C will be incremented for bug fixes. =item * Odd-value increments of C indicate unstable ("development") releases that should not be used in production. C increments have no semantic meaning; they indicate only successive development releases. =back See the Changes file included with releases for an indication of the nature of changes involved. =head1 ENVIRONMENT VARIABLES If the C environment variable is true before the MongoDB module is loaded, then its various classes will be generated with internal type assertions enabled. This has a severe performance cost and is not recommended for production use. It may be useful in diagnosing bugs. If the C environment variable is true, then deprecated methods will not issue warnings when used. (Normally, a deprecation warning is issued once per call-site for deprecated methods.) =head1 THREADS Per L documentation, use of Perl threads is discouraged by the maintainers of Perl and the MongoDB Perl driver does not test or provide support for use with threads. =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 CONTRIBUTORS =for stopwords Andrew Page Andrey Khozov Ashley Willis Ask Bjørn Hansen Bernard Gorman Brendan W. McAdams Brian Moss Casey Rojas Christian Sturm Walde Colin Cyr Danny Raetzsch David Morrison Nadle Steinbrunner Storch diegok D. Ilmari Mannsåker Eric Daniels Finn Kempers (Shadowcat Systems Ltd) Gerard Goossen Glenn Fowler Graham Barr Hao Wu Harish Upadhyayula Jason Carey Toffaletti Johann Rolschewski John A. Kunze Joseph Harnish Josh Matthews Joshua Juran J. Stewart Kamil Slowikowski Ken Williams Matthew Shopsin Matt S Trout Michael Langner Rotmanov Mike Dirolf Mohammad Anwar Nickola Trupcheff Nigel Gregoire Niko Tyni Nuno Carvalho Orlando Vazquez Othello Maurer Pan Fan Pavel Denisov Rahul Dhodapkar Robert Sedlacek Robin Lee Roman Yerin Ronald J Kimball Ryan Chipman Slaven Rezic Stephen Oberholtzer Steve Sanbeg Stuart Watt Thomas Bloor Tobias Leich Uwe Voelker Wallace Reis Wan Bachtiar Whitney Jackson Xavier Guimard Xtreak Zhihong Zhang =over 4 =item * Andrew Page =item * Andrey Khozov =item * Ashley Willis =item * Ask Bjørn Hansen =item * Bernard Gorman =item * Brendan W. McAdams =item * Brian Moss =item * Casey Rojas =item * Christian Hansen =item * Christian Sturm =item * Christian Walde =item * Colin Cyr =item * Danny Raetzsch =item * David Morrison =item * David Nadle =item * David Steinbrunner =item * David Storch =item * diegok =item * D. Ilmari Mannsåker =item * Eric Daniels =item * Finn Kempers (Shadowcat Systems Ltd) =item * Gerard Goossen =item * Glenn Fowler =item * Graham Barr =item * Hao Wu =item * Harish Upadhyayula =item * Jason Carey =item * Jason Toffaletti =item * Johann Rolschewski =item * John A. Kunze =item * Joseph Harnish =item * Josh Matthews =item * Joshua Juran =item * J. Stewart =item * Kamil Slowikowski =item * Ken Williams =item * Matthew Shopsin =item * Matt S Trout =item * Michael Langner =item * Michael Rotmanov =item * Mike Dirolf =item * Mohammad S Anwar =item * Nickola Trupcheff =item * Nigel Gregoire =item * Niko Tyni =item * Nuno Carvalho =item * Orlando Vazquez =item * Othello Maurer =item * Pan Fan =item * Pavel Denisov =item * Rahul Dhodapkar =item * Robert Sedlacek (Shadowcat Systems Ltd) =item * Robin Lee =item * Roman Yerin =item * Ronald J Kimball =item * Ryan Chipman =item * Slaven Rezic =item * Slaven Rezic =item * Stephen Oberholtzer =item * Steve Sanbeg =item * Stuart Watt =item * Thomas Bloor (Shadowcat Systems Ltd) =item * Tobias Leich =item * Uwe Voelker =item * Wallace Reis =item * Wan Bachtiar =item * Whitney Jackson =item * Xavier Guimard =item * Xtreak =item * Zhihong Zhang =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut __END__ # vim: set ts=4 sts=4 sw=4 et tw=75: MongoDB-v2.2.2/lib/MongoDB/000755 000766 000024 00000000000 13715253235 015464 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/lib/MongoDB/BSON/000755 000766 000024 00000000000 13715253235 016225 5ustar00davidstaff000000 000000 MongoDB-v2.2.2/lib/MongoDB/_Types.pm000644 000766 000024 00000016162 13715253235 017273 0ustar00davidstaff000000 000000 # Copyright 2014 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::_Types; # MongoDB type definitions use version; our $VERSION = 'v2.2.2'; use Type::Library -base, -declare => qw( ArrayOfHashRef AuthMechanism Boolish Booleanpm BSONCodec BSONDoc ClientSession CompressionType ZlibCompressionLevel ConnectType CursorType DBRefColl DBRefDB Document ErrorStr HashLike HeartbeatFreq HostAddress HostAddressList Intish IndexModel IndexModelList IxHash MaxStalenessNum MaybeHashRef MongoDBClient MongoDBCollection MongoDBDatabase BSONTimestamp NonEmptyStr NonNegNum Numish OID OrderedDoc PairArrayRef ReadPrefMode ReadConcern ReadPreference ServerDesc ServerType SingleChar SingleKeyHash Stringish TopologyType TransactionState WriteConcern ); use Type::Utils -all; use Types::Standard qw( Any Bool ArrayRef Dict HashRef Int Maybe Num Optional Overload Ref Str Undef ); use Scalar::Util qw/reftype/; use boolean 0.25; use MongoDB::_Constants; require Tie::IxHash; #--------------------------------------------------------------------------# # Type declarations (without inherited coercions) #--------------------------------------------------------------------------# declare Stringish, as Str|Overload['""']; declare Numish, as Num|Overload['0+']; # Types::Standard::Bool is overly restrictive, not allowing objects that # overload boolification, and Overload['bool'] doesn't detect objects that # overload via fallback, so we use this type for documentation purposes, # but allow any actual type. declare Boolish, as Any; declare ArrayOfHashRef, as ArrayRef [HashRef]; enum AuthMechanism, [qw/NONE DEFAULT MONGODB-CR MONGODB-X509 GSSAPI PLAIN SCRAM-SHA-1 SCRAM-SHA-256/]; duck_type BSONCodec, [ qw/encode_one decode_one/ ]; class_type BSONDoc, { class => 'BSON::Doc' }; class_type ClientSession, { class => 'MongoDB::ClientSession' }; enum CompressionType, [qw/zlib zstd snappy/]; declare ZlibCompressionLevel, as Int, where { $_ >= -1 && $_ <= 9 }, message { "zlib compression value must be value from -1 to 9" }; enum ConnectType, [qw/replicaSet direct none/]; enum CursorType, [qw/non_tailable tailable tailable_await/]; declare ErrorStr, as Stringish, where { defined($_) && length($_) }; # needs a true value declare HashLike, as Ref, where { reftype($_) eq 'HASH' }; declare HeartbeatFreq, as Num, where { defined($_) && $_ >= 500 }, message { "value must be at least 500" }; # XXX loose address validation for now. Host part should really be hostname or # IPv4/IPv6 literals declare HostAddress, as Stringish, where { $_ =~ /^[^:]+:[0-9]+$/ and lc($_) eq $_ }, message { "Address '$_' either not lowercased or not formatted as 'hostname:port'" }; declare HostAddressList, as ArrayRef [HostAddress], message { "Address list <@$_> not all formatted as lowercased 'hostname:port' pairs" }; declare Intish, as Numish, where { defined $_ and $_ == int($_) }; class_type IxHash, { class => 'Tie::IxHash' }; declare MaybeHashRef, as Maybe[ HashRef ]; class_type MongoDBClient, { class => 'MongoDB::MongoClient' }; class_type MongoDBCollection, { class => 'MongoDB::Collection' }; class_type MongoDBDatabase, { class => 'MongoDB::Database' }; class_type BSONTimestamp, { class => 'BSON::Timestamp' }; declare NonEmptyStr, as Stringish, where { defined $_ && length $_ }; declare NonNegNum, as Numish, where { defined($_) && $_ >= 0 }, message { "value must be a non-negative number" }; declare MaxStalenessNum, as Numish, where { defined($_) && ( $_ > 0 || $_ == -1 ) }, message { "value must be a positive number or -1" }; declare OID, as Str, where { /\A[0-9a-f]{24}\z/ }, message { "Value '$_' is not a valid OID" }; declare PairArrayRef, as ArrayRef, where { @$_ % 2 == 0 }; enum ReadPrefMode, [qw/primary primaryPreferred secondary secondaryPreferred nearest/]; class_type ReadPreference, { class => 'MongoDB::ReadPreference' }; class_type ReadConcern, { class => 'MongoDB::ReadConcern' }; class_type ServerDesc, { class => 'MongoDB::_Server' }; enum ServerType, [ qw/Standalone Mongos PossiblePrimary RSPrimary RSSecondary RSArbiter RSOther RSGhost Unknown/ ]; declare SingleChar, as Str, where { length $_ eq 1 }; declare SingleKeyHash, as HashRef, where { 1 == scalar keys %$_ }; enum TopologyType, [qw/Single ReplicaSetNoPrimary ReplicaSetWithPrimary Sharded Direct Unknown/]; enum TransactionState, [ TXN_NONE, TXN_STARTING, TXN_IN_PROGRESS, TXN_COMMITTED, TXN_ABORTED ]; class_type WriteConcern, { class => 'MongoDB::WriteConcern' }; # after SingleKeyHash, PairArrayRef and IxHash declare OrderedDoc, as BSONDoc|PairArrayRef|IxHash|SingleKeyHash; declare Document, as HashRef|BSONDoc|PairArrayRef|IxHash|HashLike; # after NonEmptyStr declare DBRefColl, as NonEmptyStr; declare DBRefDB, as NonEmptyStr|Undef; # after OrderedDoc declare IndexModel, as Dict [ keys => OrderedDoc, options => Optional [HashRef] ]; declare IndexModelList, as ArrayRef [IndexModel]; #--------------------------------------------------------------------------# # Coercions #--------------------------------------------------------------------------# coerce ArrayOfHashRef, from HashRef, via { [$_] }; coerce BSONCodec, from HashRef, via { require BSON; BSON->new($_) }; coerce Boolish, from Any, via { !!$_ }; coerce DBRefColl, from MongoDBCollection, via { $_->name }; coerce DBRefDB, from MongoDBDatabase, via { $_->name }; coerce ErrorStr, from Str, via { $_ || "unspecified error" }; coerce ReadPrefMode, from Str, via { $_ = lc $_; s/_?preferred/Preferred/; $_ }; coerce IxHash, from HashRef, via { Tie::IxHash->new(%$_) }; coerce IxHash, from ArrayRef, via { Tie::IxHash->new(@$_) }; coerce IxHash, from HashLike, via { Tie::IxHash->new(%$_) }; coerce IxHash, from BSONDoc, via { Tie::IxHash->new(@$_) }; coerce OID, from Str, via { lc $_ }; coerce ReadPreference, from HashRef, via { require MongoDB::ReadPreference; MongoDB::ReadPreference->new($_) }; coerce ReadPreference, from Str, via { require MongoDB::ReadPreference; MongoDB::ReadPreference->new( mode => $_ ) }; coerce ReadPreference, from ArrayRef, via { require MongoDB::ReadPreference; MongoDB::ReadPreference->new( mode => $_->[0], tag_sets => $_->[1] ) }; coerce ReadConcern, from Str, via { require MongoDB::ReadConcern; MongoDB::ReadConcern->new( level => $_ ) }; coerce ReadConcern, from HashRef, via { require MongoDB::ReadConcern; MongoDB::ReadConcern->new($_) }; coerce WriteConcern, from HashRef, via { require MongoDB::WriteConcern; MongoDB::WriteConcern->new($_) }; 1; MongoDB-v2.2.2/lib/MongoDB/Examples.pod000644 000766 000024 00000034552 13715253235 017757 0ustar00davidstaff000000 000000 # Copyright 2010 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # PODNAME: MongoDB::Examples # ABSTRACT: Some examples of MongoDB syntax __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::Examples - Some examples of MongoDB syntax =head1 VERSION version v2.2.2 =head1 MAPPING SQL TO MONGODB For developers familiar with SQL, the following chart should help you see how many common SQL queries could be expressed in MongoDB. These are Perl-specific examples of translating SQL queries to MongoDB's query language. To see the mappings for JavaScript (or another language), see L. In the following examples, C<$db> is a L object which was retrieved by using C. See L, L and L for more on the methods you see below. =over =item C Implicit, can be done explicitly. =item C $db->get_collection( 'users' )->insert_one( { a => 1, b => 1 } ); =item C $db->get_collection( 'users' )->find; =item C $db->get_collection( 'users' )->find( { age => 33 } )->fields( { a => 1, b => 1 }); =item C $db->get_collection( 'users' )->find( { name => qr/Joe/ } ); =item C $db->get_collection( 'users' )->find->sort( { name => -1 } ); =item C my $indexes = $db->get_collection( 'users' )->indexes; $indexes->create_one( [ name => 1 ] ); =item C my $indexes = $db->get_collection( 'users' )->indexes; $indexes->create_one( [ name => 1, ts => -1 ] ); =item C $db->get_collection( 'users' )->find->limit(10)->skip(20); =item C $db->get_collection( 'users' )->find->limit(1); =item C $db->get_collection( 'users' )->find( { z => 3 } )->explain; =item C $db->get_collection( 'users' )->count_documents; =item C<< SELECT COUNT(*y) FROM users where age > 30 >> $db->get_collection( 'users' )->count_documents( { "age" => { '$gt' => 30 } } ); =item C. After executing the above aggregation query, C<$out> will contain a L, allowing us to iterate through result documents such as the following: ( { '_id' => 'Soho', 'num_coffeshops' => 23 }, { '_id' => 'Chinatown', 'num_coffeshops' => 14 }, { '_id' => 'Upper East Side', 'num_coffeshops' => 10 }, { '_id' => 'East Village', 'num_coffeshops' => 87 } ) Note that L takes an array reference as an argument. Each element of the array is document which specifies a stage in the aggregation pipeline. Here our aggregation query consists of a C<$match> phase followed by a C<$group> phase. Use C<$match> to filter the documents in the collection prior to aggregation. The C<_id> field in the C<$group> stage specifies the key to group by; the C<$> in C<'$neighborhood'> indicates that we are referencing the name of a key. Finally, we use the C<$sum> operator to add one for every document in a particular neighborhood. There are other operators, such as C<$avg>, C<$max>, C<$min>, C<$push>, and C<$addToSet>, which can be used in the C<$group> phase and work much like C<$sum>. =head2 $project and $unwind Now let's look at a more complex example of the aggregation framework that makes use of the C<$project> and C<$unwind> pipeline operators. Suppose we have a collection called 'courses' which contains information on college courses. An example document in the collection looks like this: { '_id' => 'CSCI0170', 'name' => 'Computer Science 17', 'description' => 'An Integrated Introduction to Computer Science', 'instructor_id' => 29823498, 'instructor_name' => 'A. Greenwald', 'students' => [ { 'student_id' => 91736114, 'student_name' => 'D. Storch' }, { 'student_id' => 89100891, 'student_name' => 'J. Rassi' } ] } We wish to generate a report containing one document per student that indicates the courses in which each student is enrolled. The following call to C will do the trick: my $out = $db->get_collection('courses')->aggregate([ {'$unwind' => '$students'}, {'$project' => { '_id' => 0, 'course' => '$_id', 'student_id' => '$students.student_id', } }, {'$group' => { '_id' => '$student_id', 'courses' => {'$addToSet' => '$course'} } } ]); The output documents will each have a student ID number and an array of the courses in which that student is enrolled: ( { '_id' => 91736114, 'courses' => ['CSCI0170', 'CSCI0220', 'APMA1650', 'HIST1230'] }, { '_id' => 89100891, 'courses' => ['CSCI0170', 'CSCI1670', 'CSCI1690'] } ) The C<$unwind> stage of the aggregation query "peels off" elements of the courses array one-by-one and places them in their own documents. After this phase completes, there is a separate document for each (course, student) pair. The C<$project> stage then throws out unnecessary fields and keeps the ones we are interested in. It also pulls the student ID field out of its subdocument and creates a top-level field with the key C. Last, we group by student ID, using C<$addToSet> in order to add the unique courses for each student to the C array. =head2 $sort, $skip, and $limit The C<$sort>, C<$skip>, and C<$limit> pipeline operators work much like their companion methods in L. Returning to the previous students and courses example, suppose that we were particularly interested in the student with the ID that is numerically third-to-highest. We could retrieve the course list for that student by adding C<$sort>, C<$skip>, and C<$limit> phases to the pipeline: my $out = $db->get_collection('courses')->aggregate([ {'$unwind' => '$students'}, {'$project' => { '_id' => 0, 'course' => '$_id', 'student_id' => '$students.student_id', } }, {'$group' => { '_id' => '$student_id', 'courses' => {'$addToSet' => '$course'} } }, {'$sort' => {'_id' => -1}}, {'$skip' => 2}, {'$limit' => 1} ]); =head1 QUERYING =head2 Nested Fields MongoDB allows you to store deeply nested structures and then query for fields within them using I. For example, suppose we have a users collection with documents that look like: { "userId" => 12345, "address" => { "street" => "123 Main St", "city" => "Springfield", "state" => "MN", "zip" => "43213" } } If we want to query for all users from Springfield, we can do: my $cursor = $users->find({"address.city" => "Springfield"}); This will search documents for an "address" field that is a subdocument and a "city" field within the subdocument. =head1 UPDATING =head2 Positional Operator In MongoDB 1.3.4 and later, you can use positional operator, C<$>, to update elements of an array. For instance, suppose you have an array of user information and you want to update a user's name. A sample document in JavaScript: { "users" : [ { "name" : "bill", "age" : 60 }, { "name" : "fred", "age" : 29 }, ] } The update: $coll->update_one({"users.name" => "fred"}, {'users.$.name' => "george"}); This will update the array so that the element containing C<"name" =E "fred"> now has C<"name" =E "george">. =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/Tutorial.pod000644 000766 000024 00000022266 13715253235 020003 0ustar00davidstaff000000 000000 # Copyright 2009 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # PODNAME: MongoDB::Tutorial # ABSTRACT: Getting started with MongoDB __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::Tutorial - Getting started with MongoDB =head1 VERSION version v2.2.2 =head1 DESCRIPTION The tutorial runs through the basic functionality of the MongoDB package. This is a good starting point if you have never used MongoDB before. The tutorial assumes that you are running a B MongoDB database server (i.e. not a replica set) locally on the default port. You can download MongoDB from L. =head1 TERMINOLOGY Document-oriented database terms and their relational equivalents: =over =item Database Database =item Collection Table =item Document Record or row =item L Autoincrementing primary key =back =head1 PREAMBLE To use MongoDB, you'll usually just start with: use MongoDB; The L module loads most of the modules you'll need to interact with MongoDB: =over 4 =item * L =item * L =item * L =item * Query result classes like L and L =item * Write result classes like L and L =back =head1 CONNECTING To get started, we have to connect to the database server. Because it's running locally on the default port, we need not pass any parameters to the L method. my $client = MongoDB->connect(); Now we we have a client connected to the MongoDB server. Next we need a database to work with, we'll call it "tutorial". You need not do anything special to create the database, MongoDB will create it on the fly. my $db = $client->get_database( 'tutorial' ); The last part of the preliminary setup is to choose a collection. We'll be using the "users" collection to start out. my $users = $db->get_collection( 'users' ); Again, there is no need to create the collection in advance, it will be created as needed. The L method is a short cut to get a L object direct from the client. my $users = $client->ns("tutorial.users"); =head1 CRUD =head2 Creating Documents =head3 Inserting To add a document to the collection, we use the L function. It takes a hash reference which is saved to the collection. $users->insert_one( { "name" => "Joe", "age" => 52, "likes" => [qw/skiing math ponies/] }); Now there is a user in the collection. =head3 Ls When a document is inserted, it is given a C<_id> field if one does not already exist. By default, this field is a L, 12 bytes that are guaranteed to be unique. The C<_id> field of the inserted document is returned in a L object by the C method. my $result = $users->insert_one({"name" => "Bill"}); my $id = $result->inserted_id; An efficient way to insert documents is to send many at a time to the database by using L, which returns a L describing the documents inserted. my $result = $users->insert_many(\@many_users); =head2 Retrieving Documents =head3 Queries To retrieve documents that were saved to a collection, we can use the L method. my $all_users = $users->find; To query for certain criteria, say, all users named Joe, pass the query a hash with the key/value pair you wish to match: my $some_users = $users->find({"name" => "Joe"}); You can match array elements in your queries; for example, to find all users who like math: my $geeks = $users->find({"likes" => "math"}); This being Perl, it is important to mention that you can also use regular expressions to search for strings. If you wanted to find all users with the name John and all variations of said name, you could do: my $john = $users->find({"name" => qr/joh?n/i}); See L for more information. =head3 Ranges As queries are hashes, they use a special syntax to express comparisons, such as "x < 4". To make the query a valid hash, MongoDB uses $-prefixed terms. For example, "x < 4" could be expressed by: my $doc321 = $collection->find({'x' => { '$lt' => 4 }}); Comparison operators can be combined to get a range: my $doc32 = $collection->find({'x' => { '$gte' => 2, '$lt' => 4 }}); =head3 Cursors C returns a L, which can be iterated over. It lazily loads results from the database. The following prints all of the users' names: while (my $doc = $all_users->next) { print $doc->{'name'}."\n"; } A cursor can also be converted into an array of hash references. For example, to print the "name" field of the first result: my @arr = $geeks->all; print $arr[0]->{'name'}."\n"; =head2 Updating Documents =head3 C<$>-operators To change a document after it has been saved to the database, you must pass L (or L to change many documents at once) two arguments. The first is a query argument, identical to the previous section, to identify the document you want to change. The second is an argument that describes the change that you wish to make. The change is described by $-prefixed descriptors. For example, to increment a field, we would write: $users->update_one({"_id" => $id}, {'$inc' => {'age' => 1}}); To add an element to an array, we can use C<$push>. So, to add an element to the C<"likes"> array, we write: $users->update_one({"_id" => $id}, {'$push' => {'likes' => 'reading'}}); To add a new field or change the type or value of an existing field, we use C<$set>. For example, to change the C field to a username, we would say: $users->update_one({"_id" => $id}, {'$set' => {'name' => 'joe_schmoe'}}); =head3 Options C and C do nothing if no document matches the query. Sometimes we may want update to create an element if it does not already exist. This is called an 'upsert' (a combination of an update and an insert). For example, the same code could be used for creating and updating a log document: $pageviews->update_one( {"url" => "www.example.com"}, {'$inc' => {"views" => 1}}, {'upsert' => 1} ); If the pageview counter for www.example.com did not exist yet, it would be created and the "views" field would be set to 1. If it did exist, the "views" field would be incremented. =head2 Deleting Documents To delete documents, we use the L or L methods. They take the same type of hash queries do: $users->delete_many({"name" => "Joe"}); It does not delete the collection, though (in that it will still appear if the user lists collections in the database and the indexes will still exist). To remove a collection entirely, call C: $users->drop; C can also be used for whole databases: $db->drop; =head1 MONGODB BASICS =head2 Database Commands There is a large number of useful database commands that can be called directly on C<$db> with the L method. For example, you can use a database command to create a capped collection like so: use boolean; # imports 'true' and 'false' my $cmd = [ create => "posts", capped => true, size => 10240, max => 100 ]; $db->run_command($cmd); This will create a capped collection called "posts" in the current database. It has a maximum size of 10240 bytes and can contain up to 100 documents. The L module must be used whenever the database expects an actual boolean argument (i.e. not "1" or "0"). MongoDB expects commands to have key/value pairs in a certain order, so you must give arguments in an array reference (or L object). =head1 NEXT STEPS Now that you know the basic syntax used by the Perl driver, you should be able to translate the JavaScript examples in the main MongoDB documentation (L) into Perl. Check out L for more examples. =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/CommandResult.pm000644 000766 000024 00000012213 13715253235 020576 0ustar00davidstaff000000 000000 # Copyright 2014 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::CommandResult; # ABSTRACT: MongoDB generic command result document use version; our $VERSION = 'v2.2.2'; use Moo; use MongoDB::Error; use MongoDB::_Constants; use MongoDB::_Types qw( HostAddress ClientSession ); use Types::Standard qw( HashRef Maybe ); use namespace::clean; with $_ for qw( MongoDB::Role::_PrivateConstructor MongoDB::Role::_DatabaseErrorThrower MongoDB::Role::_DeprecationWarner ); #pod =attr output #pod #pod Hash reference with the output document of a database command #pod #pod =cut has output => ( is => 'ro', required => 1, isa => HashRef, ); #pod =attr address #pod #pod Address ("host:port") of server that ran the command #pod #pod =cut has address => ( is => 'ro', required => 1, isa => HostAddress, ); #pod =attr session #pod #pod ClientSession which the command was ran with, if any #pod #pod =cut has session => ( is => 'ro', required => 0, isa => Maybe[ClientSession], ); #pod =method last_code #pod #pod Error code (if any) or 0 if there was no error. #pod #pod =cut sub last_code { my ($self) = @_; my $output = $self->output; if ( $output->{code} ) { return $output->{code}; } elsif ( $output->{lastErrorObject} ) { return $output->{lastErrorObject}{code} || 0; } elsif ( $output->{writeConcernError} ) { return $output->{writeConcernError}{code} || 0; } else { return 0; } } #pod =method last_errmsg #pod #pod Error string (if any) or the empty string if there was no error. #pod #pod =cut sub last_errmsg { my ($self) = @_; my $output = $self->output; for my $err_key (qw/$err err errmsg/) { return $output->{$err_key} if exists $output->{$err_key}; } if ( exists $output->{writeConcernError} ) { return $output->{writeConcernError}{errmsg} } return ""; } #pod =method last_wtimeout #pod #pod True if a write concern error or timeout occurred or false otherwise. #pod #pod =cut sub last_wtimeout { my ($self) = @_; return !!( exists $self->output->{wtimeout} || exists $self->output->{writeConcernError} ); } #pod =method last_error_labels #pod #pod Returns an array of error labels from the command, or an empty array if there #pod are none #pod #pod =cut sub last_error_labels { my ( $self ) = @_; return $self->output->{errorLabels} || []; } #pod =method assert #pod #pod Throws an exception if the command failed. #pod #pod =cut sub assert { my ($self, $default_class) = @_; if ( ! $self->output->{ok} ) { $self->session->_maybe_unpin_address( $self->last_error_labels ) if defined $self->session; $self->_throw_database_error( $default_class ); } return 1; } #pod =method assert_no_write_concern_error #pod #pod Throws an exception if a write concern error occurred #pod #pod =cut sub assert_no_write_concern_error { my ($self) = @_; $self->_throw_database_error( "MongoDB::WriteConcernError" ) if $self->last_wtimeout; return 1; } 1; __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::CommandResult - MongoDB generic command result document =head1 VERSION version v2.2.2 =head1 DESCRIPTION This class encapsulates the results from a database command. Currently, it is only available from the C attribute of C. =head1 ATTRIBUTES =head2 output Hash reference with the output document of a database command =head2 address Address ("host:port") of server that ran the command =head2 session ClientSession which the command was ran with, if any =head1 METHODS =head2 last_code Error code (if any) or 0 if there was no error. =head2 last_errmsg Error string (if any) or the empty string if there was no error. =head2 last_wtimeout True if a write concern error or timeout occurred or false otherwise. =head2 last_error_labels Returns an array of error labels from the command, or an empty array if there are none =head2 assert Throws an exception if the command failed. =head2 assert_no_write_concern_error Throws an exception if a write concern error occurred =for Pod::Coverage result =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/InsertOneResult.pm000644 000766 000024 00000004512 13715253235 021131 0ustar00davidstaff000000 000000 # Copyright 2014 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::InsertOneResult; # ABSTRACT: MongoDB single insert result object use version; our $VERSION = 'v2.2.2'; use Moo; use namespace::clean; with $_ for qw( MongoDB::Role::_PrivateConstructor MongoDB::Role::_WriteResult ); #pod =attr inserted_id #pod #pod The identifier of the inserted document. #pod #pod =cut has inserted_id => ( is => 'ro', required => 1, ); 1; __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::InsertOneResult - MongoDB single insert result object =head1 VERSION version v2.2.2 =head1 SYNOPSIS my $result = $coll->insert( $document ); if ( $result->acknowledged ) { ... } =head1 DESCRIPTION This class encapsulates the result from the insertion of a single document. =head1 ATTRIBUTES =head2 inserted_id The identifier of the inserted document. =head1 METHODS =head2 acknowledged Indicates whether this write result was acknowledged. Always true for this class. =head2 assert Throws an error if write errors or write concern errors occurred. Otherwise, returns the invocant. =head2 assert_no_write_error Throws a MongoDB::WriteError if write errors occurred. Otherwise, returns the invocant. =head2 assert_no_write_concern_error Throws a MongoDB::WriteConcernError if write concern errors occurred. Otherwise, returns the invocant. =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/Monitoring.pod000644 000766 000024 00000016454 13715253235 020327 0ustar00davidstaff000000 000000 # Copyright 2018 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # PODNAME: MongoDB::Monitoring # ABSTRACT: Internal event monitoring API for instrumentation # vim: set ts=4 sts=4 sw=4 et tw=75: __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::Monitoring - Internal event monitoring API for instrumentation =head1 VERSION version v2.2.2 =head1 DESCRIPTION The L takes an optional C attribute, which can be used to monitor events that occur during the operation of the driver. The API is very simple: given a code reference, a hashref for each event is passed to the code reference. Here is a simple example that just accumulates events in an array: our @events; my $cb = sub { push @events, $_[0] }; MongoDB->connect( $uri, { monitoring_callback => $cb } ); =head1 EVENT TYPES Every event is a hash reference, with a C field indicating the type, e.g. C. Each type is described below. =head2 Command Monitoring These events are fired for commands directly to the wire and the response. =head3 command_started This event is sent just before a command is put one the wire. It will be followed by either a C or C event. Fields: =over 4 =item * type: "command_started" =item * databaseName: the name of the database to which the command applies =item * commandName: the name of the command being executed; for legacy operations that don't use commands, the driver will convert them to appear as if they are in command form. =item * command: a hash reference representing the full command to be sent =item * requestId: the request identifier sent to the server =item * connectionId: address and port of the destination server =back =head3 command_succeeded This event is sent just after a command reply is received, but only if the database reply document contains a non-false C field. NOTE: write errors will have C even though they have write errors; for writes, success indicates that the write attempt was valid, not that the write succeeded. Fields: =over 4 =item * type: "command_succeeded" =item * commandName: the name of the command being executed =item * durationSecs: the elapsed time in seconds since the C event. =item * reply: a hash reference representing the full database reply =item * requestId: the request identifier sent to the server =item * connectionId: address and port of the destination server =back =head3 command_failed This event is sent just after a command reply is received, but only if the database reply document contains a false C field or if an exception occurred during send or receive operations. Fields: =over 4 =item * type: "command_failed" =item * commandName: the name of the command being executed =item * durationSecs: the elapsed time in seconds since the C event. =item * failure: a string with a error message about the failure =item * eval_error: if an exception occurs, this contains the value of C<$@> when the exception was caught =item * reply: a hash reference representing the full database reply or an empty hashref if the failure is due to an exception =item * requestId: the request identifier sent to the server =item * connectionId: address and port of the destination server =back =head2 Server Discovery and Monitoring These events are fired when servers and topology are amended. =head3 server_opening_event This event is sent when a new server is added to the topology. Fields: =over 4 =item * type: "server_opening_event" =item * topologyId: The topology refaddr =item * address: address of the server =back =head3 server_closed_event This event is sent when a server is removed from the topology. Fields: =over 4 =item * type: "server_closed_event" =item * topologyId: The topology refaddr =item * address: address of the server =back =head3 server_description_changed_event This event is sent when the server description changes, but does not include changes to the RTT. Fields: =over 4 =item * type: "server_description_changed_event" =item * address: address of the server =item * topologyId: The topology refaddr =item * previousDescription: Server Description before the change =item * newDescription: Server Description after the change =back =head3 topology_opening_event This event is sent when the topology is created. Fields: =over 4 =item * type: "topology_opening_event" =item * topologyId: The topology refaddr =back =head3 topology_closed_event This event is sent when the topology is closed. Fields: =over 4 =item * type: "topology_closed_event" =item * topologyId: The topology refaddr =back =head3 topology_description_changed_event This event is sent when the topology description changes. Fields: =over 4 =item * type: "topology_description_changed_event" =item * topologyId: The topology refaddr =item * previousDescription: Topology Description before the change =item * newDescription: Topology Description after the change =back =head3 server_heartbeat_started_event This event is sent before the ismaster command is sent to the server. Fields: =over 4 =item * type: "server_heartbeat_started_event" =item * connectionId: address of the link to connect to =back =head3 server_heartbeat_succeeded_event This event is sent after the reply from the ismaster command arrives from a successful reply. Fields: =over 4 =item * type: "server_heartbeat_succeeded_event" =item * duration: time it took to send and receive a reply =item * reply: the ismaster command reply =item * connectionId: address of the server =back =head3 server_heartbeat_failed_event This event is sent if there is a failure from the ismaster command, which returns an error string of some sort. Fields: =over 4 =item * type: "server_heartbeat_failed_event" =item * duration: time it took to send and receive a reply =item * failure: Returns an error string of the failure =item * connectionId: address of the server =back =head1 REDACTION Certain commands are considered sensitive. When any of the following commands are seen in monitoring, the command body and database reply body are replaced with an empty document: =over 4 =item * authenticate =item * saslStart =item * saslContinue =item * getnonce =item * createUser =item * updateUser =item * copydbgetnonce =item * copydbsaslstart =back =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/_Constants.pm000644 000766 000024 00000005576 13715253235 020152 0ustar00davidstaff000000 000000 # Copyright 2015 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::_Constants; # Common MongoDB driver constants use version; our $VERSION = 'v2.2.2'; use Exporter 5.57 qw/import/; use Config; my $CONSTANTS; BEGIN { $CONSTANTS = { COOLDOWN_SECS => 5, CURSOR_ZERO => "\0" x 8, EPOCH => 0, HAS_INT64 => $Config{use64bitint}, IDLE_WRITE_PERIOD_SEC => 10, MAX_BSON_OBJECT_SIZE => 4_194_304, MAX_GRIDFS_BATCH_SIZE => 16_777_216, # 16MiB MAX_BSON_WIRE_SIZE => 16_793_600, # 16MiB + 16KiB MAX_WIRE_VERSION => 8, MAX_WRITE_BATCH_SIZE => 1000, MIN_HEARTBEAT_FREQUENCY_SEC => .5, MIN_HEARTBEAT_FREQUENCY_USEC => 500_000, # 500ms, not configurable MIN_KEYED_DOC_LENGTH => 8, MIN_SERVER_VERSION => "2.4.0", MIN_WIRE_VERSION => 0, RESCAN_SRV_FREQUENCY_SEC => $ENV{TEST_MONGO_RESCAN_SRV_FREQUENCY_SEC} || 60, NO_JOURNAL_RE => qr/^journaling not enabled/, NO_REPLICATION_RE => qr/^no replication has been enabled/, P_INT32 => $] lt '5.010' ? 'l' : 'l<', SMALLEST_MAX_STALENESS_SEC => 90, WITH_ASSERTS => $ENV{PERL_MONGO_WITH_ASSERTS}, # Transaction state tracking TXN_NONE => 'none', TXN_STARTING => 'starting', TXN_IN_PROGRESS => 'in_progress', TXN_COMMITTED => 'committed', TXN_ABORTED => 'aborted', TXN_WTIMEOUT_RETRY_DEFAULT => 10_000, # 10 seconds TXN_TRANSIENT_ERROR_MSG => 'TransientTransactionError', TXN_UNKNOWN_COMMIT_MSG => 'UnknownTransactionCommitResult', # From the Convenient API for Transactions spec, with_transaction must # halt retries after 120 seconds. # This limit is non-configurable and was chosen to be twice the 60 second # default value of MongoDB's `transactionLifetimeLimitSeconds` parameter. WITH_TXN_RETRY_TIME_LIMIT => 120, # seconds }; } use constant $CONSTANTS; our @EXPORT = keys %$CONSTANTS; 1; MongoDB-v2.2.2/lib/MongoDB/OID.pm000644 000766 000024 00000004256 13715253235 016444 0ustar00davidstaff000000 000000 # Copyright 2009 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::OID; # ABSTRACT: (DEPRECATED) A Mongo Object ID use version; our $VERSION = 'v2.2.2'; use Moo; extends 'BSON::OID'; use namespace::clean -except => 'meta'; with $_ for qw( MongoDB::Role::_DeprecationWarner ); sub BUILD { my $self = shift; $self->_warn_deprecated_class(__PACKAGE__, ["BSON::OID"], 0); }; around BUILDARGS => sub { my $orig = shift; my $class = shift; if ( @_ == 0 ) { return {}; } if ( @_ == 1 ) { return { oid => pack("H*",$_[0]) }; } # convert 'value' to 'oid' my %args = @_; if ( $args{value} ) { $args{oid} = pack("H*", delete $args{value}); } return $orig->($class, %args); }; # This private constructor bypasses everything Moo does for us and just # jams an OID into a blessed hashref. This is only for use in super-hot # code paths, like document insertion. sub _new_oid { return bless { oid => BSON::OID::_generate_oid() }, "BSON::OID"; } 1; __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::OID - (DEPRECATED) A Mongo Object ID =head1 VERSION version v2.2.2 =head1 DESCRIPTION This class is now an empty subclass of L. =head1 AUTHORS =over 4 =item * David Golden =item * Rassi =item * Mike Friedman =item * Kristina Chodorow =item * Florian Ragwitz =back =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2020 by MongoDB, Inc. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut MongoDB-v2.2.2/lib/MongoDB/_ServerSession.pm000644 000766 000024 00000006640 13715253235 021001 0ustar00davidstaff000000 000000 # Copyright 2018 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::_ServerSession; # MongoDB Server Session object use version; our $VERSION = 'v2.2.2'; use MongoDB::Error; use Moo; use UUID::URandom; use Math::BigInt; use MongoDB::_Types qw( Document ); use Types::Standard qw( Maybe InstanceOf Int Bool ); use constant UUID_TYPE => 4; use namespace::clean -except => 'meta'; # session_id # # $server_session->session_id; # # Returns the session id for this server session as a L object # containing a binary UUID V4. For lower network usage, if not provided on # initialisation this class will generate a new UUID instead of consulting the # server for a new session id. has session_id => ( is => 'lazy', isa => Document, builder => '_build_session_id', ); sub _build_session_id { my ( $self ) = @_; my $uuid = BSON::Bytes->new( data => UUID::URandom::create_uuid(), subtype => UUID_TYPE, ); return { id => $uuid }; } # last_use # # $server_session->last_use; # # Returns the unix time that this server session was last used. Used for checking # expiry of a server session. If undefined, then the session has (probably) not # been used on the server. has last_use => ( is => 'rwp', init_arg => undef, isa => Maybe[Int], ); # transaction_id # # $server_session->transaction_id # # Returns the current transaction id for this server session. This is a ratcheted # incrementing ID number, which when combined with the session id allows for # retrying transactions in the correct order. has transaction_id => ( is => 'rwp', init_arg => undef, default => sub { Math::BigInt->new('0') }, ); # pool_epoch # # tracks which pool the session came from; sessions won't be checked into # a newer pool has pool_epoch => ( is => 'ro', default => -1, ); # # Mark this session as dirty. # A server session is marked dirty when a command fails with a network # error. Dirty sessions are later discarded from the server session pool. # has dirty => ( is => 'rwp', isa => Bool, default => 0, ); sub mark_dirty { my $self = shift; $self->_set_dirty(1); } # update_last_use # # $server_session->update_last_use; # # Updates the value of L to the current unix time. sub update_last_use { my ( $self ) = @_; $self->_set_last_use( time() ); } sub _is_expiring { my ( $self, $session_timeout ) = @_; # if session_timeout is undef, then sessions arent actually supported (this # value should be from logical_session_timeout_minutes). return 1 unless defined $session_timeout; my $timeout = time() - ( ( $session_timeout - 1 ) * 60 ); # Undefined last_use means its never actually been used on the server return 1 if defined $self->last_use && $self->last_use < $timeout; return; } 1; # vim: set ts=4 sts=4 sw=4 et tw=75: MongoDB-v2.2.2/lib/MongoDB/ReadPreference.pm000644 000766 000024 00000021055 13715253235 020677 0ustar00davidstaff000000 000000 # Copyright 2014 - present MongoDB, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. use strict; use warnings; package MongoDB::ReadPreference; # ABSTRACT: Encapsulate and validate read preferences use version; our $VERSION = 'v2.2.2'; use Moo; use MongoDB::Error; use MongoDB::_Types qw( ArrayOfHashRef MaxStalenessNum NonNegNum ReadPrefMode ); use namespace::clean -except => 'meta'; use overload ( q[""] => sub { $_[0]->mode }, fallback => 1, ); #pod =attr mode #pod #pod The read preference mode determines which server types are candidates #pod for a read operation. Valid values are: #pod #pod =for :list #pod * primary #pod * primaryPreferred #pod * secondary #pod * secondaryPreferred #pod * nearest #pod #pod =cut has mode => ( is => 'ro', isa => ReadPrefMode, default => 'primary', coerce => ReadPrefMode->coercion, ); #pod =attr tag_sets #pod #pod The C parameter is an ordered list of tag sets used to restrict the #pod eligibility of servers, such as for data center awareness. #pod #pod The application of C varies depending on the C parameter. If #pod the C is 'primary', then C must not be supplied. #pod #pod =cut has tag_sets => ( is => 'ro', isa => ArrayOfHashRef, default => sub { [ {} ] }, coerce => ArrayOfHashRef->coercion, ); #pod =attr max_staleness_seconds #pod #pod The C parameter represents the maximum replication lag in #pod seconds (wall clock time) that a secondary can suffer and still be #pod eligible for reads. The default is -1, which disables staleness checks. #pod #pod If the C is 'primary', then C must not be supplied. #pod #pod =cut has max_staleness_seconds => ( is => 'ro', isa => MaxStalenessNum, default => -1, ); sub BUILD { my ($self) = @_; if ( $self->mode eq 'primary' && !$self->has_empty_tag_sets ) { MongoDB::UsageError->throw("A tag set list is not allowed with read preference mode 'primary'"); } if ( $self->mode eq 'primary' && $self->max_staleness_seconds > 0 ) { MongoDB::UsageError->throw("A positive max_staleness_seconds is not allowed with read preference mode 'primary'"); } return; } # Returns true if the C array is empty or if it consists only of a # single, empty hash reference. sub has_empty_tag_sets { my ($self) = @_; my $tag_sets = $self->tag_sets; return @$tag_sets == 0 || ( @$tag_sets == 1 && !keys %{ $tag_sets->[0] } ); } # Reformat to the document needed by mongos in $readPreference sub _as_hashref { my ($self) = @_; return { mode => $self->mode, ( $self->has_empty_tag_sets ? () : ( tags => $self->tag_sets ) ), ( $self->max_staleness_seconds > 0 ? ( maxStalenessSeconds => int($self->max_staleness_seconds )) : () ), }; } # Format as a string for error messages sub as_string { my ($self) = @_; my $string = $self->mode; unless ( $self->has_empty_tag_sets ) { my @ts; for my $set ( @{ $self->tag_sets } ) { push @ts, keys(%$set) ? join( ",", map { "$_\:$set->{$_}" } sort keys %$set ) : ""; } $string .= " (" . join( ",", map { "{$_}" } @ts ) . ")"; } if ( $self->max_staleness_seconds > 0) { $string .= " ( maxStalenessSeconds: " . $self->max_staleness_seconds . " )"; } return $string; } 1; __END__ =pod =encoding UTF-8 =head1 NAME MongoDB::ReadPreference - Encapsulate and validate read preferences =head1 VERSION version v2.2.2 =head1 SYNOPSIS use MongoDB::ReadPreference; $rp = MongoDB::ReadPreference->new(); # mode: primary $rp = MongoDB::ReadPreference->new( mode => 'primaryPreferred', tag_sets => [ { dc => 'useast' }, {} ], ); =head1 DESCRIPTION A read preference indicates which servers should be used for read operations. For core documentation on read preference see L. =head1 USAGE Read preferences work via two attributes: C and C. The C parameter controls the types of servers that are candidates for a read operation as well as the logic for applying the C attribute to further restrict the list. The following terminology is used in describing read preferences: =over 4 =item * candidates – based on C, servers that could be suitable, based on C and other logic =item * eligible – these are candidates that match C =item * suitable – servers that meet all criteria for a read operation =back =head2 Read preference modes =head3 primary Only an available primary is suitable. C do not apply and must not be provided or an exception is thrown. =head3 secondary All secondaries (and B secondaries) are candidates, but only eligible candidates (i.e. after applying C) are suitable. =head3 primaryPreferred Try to find a server using mode "primary" (with no C). If that fails, try to find one using mode "secondary" and the C attribute. =head3 secondaryPreferred Try to find a server using mode "secondary" and the C