forked from mongodb-labs/mongo-perl-driver
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Changes
1589 lines (963 loc) · 48.4 KB
/
Changes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
# Change history for the MongoDB Perl driver:
{{ $NEXT }}
[Additions]
- Adds 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.
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<MongoDB::MongoClient>
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