mongo 2.1.2 → 2.2.0.rc0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (140) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data.tar.gz.sig +0 -0
  4. data/README.md +10 -3
  5. data/Rakefile +1 -7
  6. data/lib/csasl/csasl.bundle +0 -0
  7. data/lib/mongo/auth/user/view.rb +1 -1
  8. data/lib/mongo/bulk_write.rb +7 -1
  9. data/lib/mongo/client.rb +17 -15
  10. data/lib/mongo/cluster.rb +4 -2
  11. data/lib/mongo/collection.rb +36 -2
  12. data/lib/mongo/collection/view.rb +24 -21
  13. data/lib/mongo/collection/view/aggregation.rb +5 -42
  14. data/lib/mongo/collection/view/builder.rb +20 -0
  15. data/lib/mongo/collection/view/builder/aggregation.rb +98 -0
  16. data/lib/mongo/collection/view/builder/find_command.rb +111 -0
  17. data/lib/mongo/collection/view/builder/flags.rb +62 -0
  18. data/lib/mongo/collection/view/builder/map_reduce.rb +134 -0
  19. data/lib/mongo/collection/view/builder/modifiers.rb +80 -0
  20. data/lib/mongo/collection/view/builder/op_query.rb +83 -0
  21. data/lib/mongo/collection/view/explainable.rb +15 -0
  22. data/lib/mongo/collection/view/immutable.rb +5 -12
  23. data/lib/mongo/collection/view/iterable.rb +24 -2
  24. data/lib/mongo/collection/view/map_reduce.rb +18 -27
  25. data/lib/mongo/collection/view/readable.rb +70 -112
  26. data/lib/mongo/collection/view/writable.rb +23 -7
  27. data/lib/mongo/cursor.rb +76 -25
  28. data/lib/mongo/cursor/builder.rb +18 -0
  29. data/lib/mongo/cursor/builder/get_more_command.rb +71 -0
  30. data/lib/mongo/cursor/builder/kill_cursors_command.rb +62 -0
  31. data/lib/mongo/cursor/builder/op_get_more.rb +61 -0
  32. data/lib/mongo/cursor/builder/op_kill_cursors.rb +56 -0
  33. data/lib/mongo/database.rb +2 -2
  34. data/lib/mongo/database/view.rb +9 -5
  35. data/lib/mongo/dbref.rb +3 -3
  36. data/lib/mongo/error.rb +1 -0
  37. data/lib/mongo/error/invalid_write_concern.rb +35 -0
  38. data/lib/mongo/grid/file/chunk.rb +2 -2
  39. data/lib/mongo/index/view.rb +5 -2
  40. data/lib/mongo/operation.rb +1 -0
  41. data/lib/mongo/operation/commands.rb +2 -0
  42. data/lib/mongo/operation/commands/aggregate.rb +39 -45
  43. data/lib/mongo/operation/commands/aggregate/result.rb +54 -68
  44. data/lib/mongo/operation/commands/collections_info.rb +38 -36
  45. data/lib/mongo/operation/commands/collections_info/result.rb +17 -15
  46. data/lib/mongo/operation/commands/command.rb +24 -22
  47. data/lib/mongo/operation/commands/find.rb +27 -0
  48. data/lib/mongo/operation/commands/find/result.rb +62 -0
  49. data/lib/mongo/operation/commands/get_more.rb +27 -0
  50. data/lib/mongo/operation/commands/get_more/result.rb +62 -0
  51. data/lib/mongo/operation/commands/indexes.rb +41 -39
  52. data/lib/mongo/operation/commands/list_collections.rb +25 -31
  53. data/lib/mongo/operation/commands/list_collections/result.rb +63 -81
  54. data/lib/mongo/operation/commands/list_indexes.rb +27 -35
  55. data/lib/mongo/operation/commands/list_indexes/result.rb +67 -85
  56. data/lib/mongo/operation/commands/map_reduce.rb +29 -37
  57. data/lib/mongo/operation/commands/map_reduce/result.rb +85 -88
  58. data/lib/mongo/operation/commands/parallel_scan.rb +29 -33
  59. data/lib/mongo/operation/commands/parallel_scan/result.rb +34 -42
  60. data/lib/mongo/operation/commands/user_query.rb +40 -38
  61. data/lib/mongo/operation/commands/users_info.rb +24 -29
  62. data/lib/mongo/operation/commands/users_info/result.rb +13 -11
  63. data/lib/mongo/operation/object_id_generator.rb +36 -0
  64. data/lib/mongo/operation/result.rb +30 -0
  65. data/lib/mongo/operation/specifiable.rb +35 -1
  66. data/lib/mongo/operation/write/bulk/bulkable.rb +4 -3
  67. data/lib/mongo/operation/write/bulk/delete/result.rb +18 -25
  68. data/lib/mongo/operation/write/bulk/legacy_mergable.rb +2 -2
  69. data/lib/mongo/operation/write/command/delete.rb +3 -2
  70. data/lib/mongo/operation/write/command/insert.rb +4 -2
  71. data/lib/mongo/operation/write/command/update.rb +6 -3
  72. data/lib/mongo/operation/write/gle.rb +2 -1
  73. data/lib/mongo/operation/write/idable.rb +19 -2
  74. data/lib/mongo/options/mapper.rb +22 -0
  75. data/lib/mongo/protocol/bit_vector.rb +3 -3
  76. data/lib/mongo/protocol/delete.rb +15 -5
  77. data/lib/mongo/protocol/get_more.rb +10 -5
  78. data/lib/mongo/protocol/insert.rb +1 -6
  79. data/lib/mongo/protocol/kill_cursors.rb +14 -1
  80. data/lib/mongo/protocol/message.rb +32 -8
  81. data/lib/mongo/protocol/serializers.rb +15 -16
  82. data/lib/mongo/protocol/update.rb +35 -12
  83. data/lib/mongo/server/connectable.rb +3 -1
  84. data/lib/mongo/server/connection.rb +5 -5
  85. data/lib/mongo/server/description.rb +8 -2
  86. data/lib/mongo/server/description/features.rb +2 -1
  87. data/lib/mongo/server/monitor.rb +1 -12
  88. data/lib/mongo/server/monitor/connection.rb +30 -26
  89. data/lib/mongo/server_selector/selectable.rb +21 -4
  90. data/lib/mongo/uri.rb +2 -0
  91. data/lib/mongo/version.rb +1 -1
  92. data/lib/mongo/write_concern.rb +21 -6
  93. data/mongo.gemspec +1 -2
  94. data/spec/mongo/bulk_write/ordered_combiner_spec.rb +13 -0
  95. data/spec/mongo/bulk_write_spec.rb +58 -0
  96. data/spec/mongo/client_spec.rb +6 -4
  97. data/spec/mongo/collection/view/builder/find_command_spec.rb +167 -0
  98. data/spec/mongo/collection/view/builder/flags_spec.rb +106 -0
  99. data/spec/mongo/collection/view/builder/modifiers_spec.rb +210 -0
  100. data/spec/mongo/collection/view/builder/op_query_spec.rb +154 -0
  101. data/spec/mongo/collection/view/explainable_spec.rb +1 -2
  102. data/spec/mongo/collection/view/immutable_spec.rb +3 -52
  103. data/spec/mongo/collection/view/map_reduce_spec.rb +12 -12
  104. data/spec/mongo/collection/view/readable_spec.rb +86 -80
  105. data/spec/mongo/collection/view_spec.rb +109 -703
  106. data/spec/mongo/collection_spec.rb +594 -11
  107. data/spec/mongo/command_monitoring_spec.rb +40 -27
  108. data/spec/mongo/cursor/builder/get_more_command_spec.rb +160 -0
  109. data/spec/mongo/cursor/builder/op_get_more_spec.rb +52 -0
  110. data/spec/mongo/cursor_spec.rb +10 -60
  111. data/spec/mongo/database_spec.rb +24 -3
  112. data/spec/mongo/dbref_spec.rb +4 -4
  113. data/spec/mongo/grid/file/chunk_spec.rb +1 -1
  114. data/spec/mongo/grid/fs_bucket_spec.rb +3 -3
  115. data/spec/mongo/index/view_spec.rb +41 -0
  116. data/spec/mongo/operation/{aggregate → commands/aggregate}/result_spec.rb +1 -1
  117. data/spec/mongo/operation/commands/aggregate_spec.rb +1 -1
  118. data/spec/mongo/operation/commands/collections_info_spec.rb +1 -1
  119. data/spec/mongo/operation/commands/command_spec.rb +1 -1
  120. data/spec/mongo/operation/commands/indexes_spec.rb +1 -1
  121. data/spec/mongo/operation/commands/map_reduce_spec.rb +1 -1
  122. data/spec/mongo/operation/write/command/delete_spec.rb +25 -0
  123. data/spec/mongo/operation/write/command/insert_spec.rb +25 -0
  124. data/spec/mongo/operation/write/command/update_spec.rb +25 -0
  125. data/spec/mongo/protocol/delete_spec.rb +4 -4
  126. data/spec/mongo/protocol/get_more_spec.rb +4 -4
  127. data/spec/mongo/protocol/insert_spec.rb +3 -3
  128. data/spec/mongo/protocol/kill_cursors_spec.rb +3 -3
  129. data/spec/mongo/protocol/query_spec.rb +7 -7
  130. data/spec/mongo/protocol/update_spec.rb +5 -5
  131. data/spec/mongo/server/description/features_spec.rb +25 -0
  132. data/spec/mongo/write_concern_spec.rb +126 -0
  133. data/spec/spec_helper.rb +9 -19
  134. data/spec/support/command_monitoring.rb +8 -0
  135. data/spec/support/command_monitoring/find.yml +53 -4
  136. data/spec/support/matchers.rb +1 -1
  137. data/spec/support/shared/protocol.rb +5 -5
  138. data/spec/support/travis.rb +1 -1
  139. metadata +43 -10
  140. metadata.gz.sig +0 -0
@@ -14,107 +14,104 @@
14
14
 
15
15
  module Mongo
16
16
  module Operation
17
- class MapReduce
17
+ module Commands
18
+ class MapReduce
18
19
 
19
- # Defines custom behaviour of results for a map reduce operation.
20
- #
21
- # @since 2.0.0
22
- class Result < Operation::Result
23
-
24
- # The counts field for the map/reduce.
20
+ # Defines custom behaviour of results for a map reduce operation.
25
21
  #
26
22
  # @since 2.0.0
27
- COUNTS = 'counts'.freeze
23
+ class Result < Operation::Result
28
24
 
29
- # The result field for when output is a collection.
30
- #
31
- # @since 2.0.0
32
- RESULT = 'result'.freeze
25
+ # The counts field for the map/reduce.
26
+ #
27
+ # @since 2.0.0
28
+ COUNTS = 'counts'.freeze
33
29
 
34
- # The field name for a result without a cursor.
35
- #
36
- # @since 2.0.0
37
- RESULTS = 'results'.freeze
30
+ # The field name for a result without a cursor.
31
+ #
32
+ # @since 2.0.0
33
+ RESULTS = 'results'.freeze
38
34
 
39
- # The time the operation took constant.
40
- #
41
- # @since 2.0.0
42
- TIME = 'timeMillis'.freeze
35
+ # The time the operation took constant.
36
+ #
37
+ # @since 2.0.0
38
+ TIME = 'timeMillis'.freeze
43
39
 
44
- # Gets the map/reduce counts from the reply.
45
- #
46
- # @example Get the counts.
47
- # result.counts
48
- #
49
- # @return [ Hash ] A hash of the result counts.
50
- #
51
- # @since 2.0.0
52
- def counts
53
- reply.documents[0][COUNTS]
54
- end
40
+ # Gets the map/reduce counts from the reply.
41
+ #
42
+ # @example Get the counts.
43
+ # result.counts
44
+ #
45
+ # @return [ Hash ] A hash of the result counts.
46
+ #
47
+ # @since 2.0.0
48
+ def counts
49
+ reply.documents[0][COUNTS]
50
+ end
55
51
 
56
- # Get the documents from the map/reduce.
57
- #
58
- # @example Get the documents.
59
- # result.documents
60
- #
61
- # @return [ Array<BSON::Document> ] The documents.
62
- #
63
- # @since 2.0.0
64
- def documents
65
- reply.documents[0][RESULTS] || reply.documents[0][RESULT]
66
- end
52
+ # Get the documents from the map/reduce.
53
+ #
54
+ # @example Get the documents.
55
+ # result.documents
56
+ #
57
+ # @return [ Array<BSON::Document> ] The documents.
58
+ #
59
+ # @since 2.0.0
60
+ def documents
61
+ reply.documents[0][RESULTS] || reply.documents[0][RESULT]
62
+ end
67
63
 
68
- # If the result was a command then determine if it was considered a
69
- # success.
70
- #
71
- # @note If the write was unacknowledged, then this will always return
72
- # true.
73
- #
74
- # @example Was the command successful?
75
- # result.successful?
76
- #
77
- # @return [ true, false ] If the command was successful.
78
- #
79
- # @since 2.0.0
80
- def successful?
81
- !documents.nil?
82
- end
64
+ # If the result was a command then determine if it was considered a
65
+ # success.
66
+ #
67
+ # @note If the write was unacknowledged, then this will always return
68
+ # true.
69
+ #
70
+ # @example Was the command successful?
71
+ # result.successful?
72
+ #
73
+ # @return [ true, false ] If the command was successful.
74
+ #
75
+ # @since 2.0.0
76
+ def successful?
77
+ !documents.nil?
78
+ end
83
79
 
84
- # Get the execution time of the map/reduce.
85
- #
86
- # @example Get the execution time.
87
- # result.time
88
- #
89
- # @return [ Integer ] The executiong time in milliseconds.
90
- #
91
- # @since 2.0.0
92
- def time
93
- reply.documents[0][TIME]
94
- end
80
+ # Get the execution time of the map/reduce.
81
+ #
82
+ # @example Get the execution time.
83
+ # result.time
84
+ #
85
+ # @return [ Integer ] The executiong time in milliseconds.
86
+ #
87
+ # @since 2.0.0
88
+ def time
89
+ reply.documents[0][TIME]
90
+ end
95
91
 
96
- # Validate the result by checking for any errors.
97
- #
98
- # @note This only checks for errors with writes since authentication is
99
- # handled at the connection level and any authentication errors would
100
- # be raised there, before a Result is ever created.
101
- #
102
- # @example Validate the result.
103
- # result.validate!
104
- #
105
- # @raise [ Error::OperationFailure ] If an error is in the result.
106
- #
107
- # @return [ Result ] The result if verification passed.
108
- #
109
- # @since 2.0.0
110
- def validate!
111
- documents.nil? ? raise(Error::OperationFailure.new(parser.message)) : self
112
- end
92
+ # Validate the result by checking for any errors.
93
+ #
94
+ # @note This only checks for errors with writes since authentication is
95
+ # handled at the connection level and any authentication errors would
96
+ # be raised there, before a Result is ever created.
97
+ #
98
+ # @example Validate the result.
99
+ # result.validate!
100
+ #
101
+ # @raise [ Error::OperationFailure ] If an error is in the result.
102
+ #
103
+ # @return [ Result ] The result if verification passed.
104
+ #
105
+ # @since 2.0.0
106
+ def validate!
107
+ documents.nil? ? raise(Error::OperationFailure.new(parser.message)) : self
108
+ end
113
109
 
114
- private
110
+ private
115
111
 
116
- def first_document
117
- @first_document ||= reply.documents[0]
112
+ def first_document
113
+ @first_document ||= reply.documents[0]
114
+ end
118
115
  end
119
116
  end
120
117
  end
@@ -12,45 +12,41 @@
12
12
  # See the License for the specific language governing permissions and
13
13
  # limitations under the License.
14
14
 
15
- require 'mongo/operation/commands/parallel_scan/result'
16
-
17
15
  module Mongo
18
16
  module Operation
17
+ module Commands
19
18
 
20
- # A MongoDB parallel scan operation.
21
- #
22
- # @example Create the parallel scan operation.
23
- # ParallelScan.new({
24
- # :db_name => 'test_db',
25
- # :coll_name = > 'test_collection',
26
- # :cursor_count => 5
27
- # })
28
- #
29
- # Initialization:
30
- # param [ Hash ] spec The specifications for the operation.
31
- #
32
- # option spec :db_name [ String ] The name of the database on which
33
- # the operation should be executed.
34
- # option spec :coll_name [ String ] The collection to scan.
35
- # option spec :cursor_count [ Integer ] The number of cursors to use.
36
- # option spec :options [ Hash ] Options for the command.
37
- #
38
- # @since 2.0.0
39
- class ParallelScan
40
- include Specifiable
41
- include Limited
42
- include ReadPreference
43
- include Executable
44
-
45
- private
19
+ # A MongoDB parallel scan operation.
20
+ #
21
+ # @example Create the parallel scan operation.
22
+ # ParallelScan.new({
23
+ # :db_name => 'test_db',
24
+ # :coll_name = > 'test_collection',
25
+ # :cursor_count => 5
26
+ # })
27
+ #
28
+ # Initialization:
29
+ # param [ Hash ] spec The specifications for the operation.
30
+ #
31
+ # option spec :db_name [ String ] The name of the database on which
32
+ # the operation should be executed.
33
+ # option spec :coll_name [ String ] The collection to scan.
34
+ # option spec :cursor_count [ Integer ] The number of cursors to use.
35
+ # option spec :options [ Hash ] Options for the command.
36
+ #
37
+ # @since 2.0.0
38
+ class ParallelScan < Command
46
39
 
47
- def selector
48
- { :parallelCollectionScan => coll_name, :numCursors => cursor_count }
49
- end
40
+ private
50
41
 
51
- def query_coll
52
- Database::COMMAND
42
+ def selector
43
+ command = { :parallelCollectionScan => coll_name, :numCursors => cursor_count }
44
+ command[:readConcern] = read_concern if read_concern
45
+ command
46
+ end
53
47
  end
54
48
  end
55
49
  end
56
50
  end
51
+
52
+ require 'mongo/operation/commands/parallel_scan/result'
@@ -15,56 +15,48 @@
15
15
 
16
16
  module Mongo
17
17
  module Operation
18
- class ParallelScan
18
+ module Commands
19
+ class ParallelScan
19
20
 
20
- # Defines custom behaviour of results in a parallel scan.
21
- #
22
- # @since 2.0.0
23
- class Result < Operation::Result
24
-
25
- # Get the name of the cursor field.
26
- #
27
- # @since 2.0.0
28
- CURSOR = 'cursor'.freeze
29
-
30
- # The name of the cursors field in the result.
21
+ # Defines custom behaviour of results in a parallel scan.
31
22
  #
32
23
  # @since 2.0.0
33
- CURSORS = 'cursors'.freeze
24
+ class Result < Operation::Result
34
25
 
35
- # Get the name of the id field.
36
- #
37
- # @since 2.0.0
38
- ID = 'id'.freeze
26
+ # The name of the cursors field in the result.
27
+ #
28
+ # @since 2.0.0
29
+ CURSORS = 'cursors'.freeze
39
30
 
40
- # Get all the cursor ids from the result.
41
- #
42
- # @example Get the cursor ids.
43
- # result.cursor_ids
44
- #
45
- # @return [ Array<Integer> ] The cursor ids.
46
- #
47
- # @since 2.0.0
48
- def cursor_ids
49
- documents.map{ |doc| doc[CURSOR][ID] }
50
- end
31
+ # Get all the cursor ids from the result.
32
+ #
33
+ # @example Get the cursor ids.
34
+ # result.cursor_ids
35
+ #
36
+ # @return [ Array<Integer> ] The cursor ids.
37
+ #
38
+ # @since 2.0.0
39
+ def cursor_ids
40
+ documents.map{ |doc| doc[CURSOR][CURSOR_ID] }
41
+ end
51
42
 
52
- # Get the documents from parallel scan.
53
- #
54
- # @example Get the documents.
55
- # result.documents
56
- #
57
- # @return [ Array<BSON::Document> ] The documents.
58
- #
59
- # @since 2.0.0
60
- def documents
61
- reply.documents[0][CURSORS]
62
- end
43
+ # Get the documents from parallel scan.
44
+ #
45
+ # @example Get the documents.
46
+ # result.documents
47
+ #
48
+ # @return [ Array<BSON::Document> ] The documents.
49
+ #
50
+ # @since 2.0.0
51
+ def documents
52
+ reply.documents[0][CURSORS]
53
+ end
63
54
 
64
- private
55
+ private
65
56
 
66
- def first
67
- @first ||= reply.documents[0] || {}
57
+ def first
58
+ @first ||= reply.documents[0] || {}
59
+ end
68
60
  end
69
61
  end
70
62
  end
@@ -14,55 +14,57 @@
14
14
 
15
15
  module Mongo
16
16
  module Operation
17
+ module Commands
17
18
 
18
- # A MongoDB operation to get info of a particular user in a database.
19
- #
20
- # @example Create the user query operation.
21
- # Read::UserQuery.new(:name => 'emily', :db_name => 'test-db')
22
- #
23
- # Initialization:
24
- # param [ Hash ] spec The specifications for the user query operation.
25
- #
26
- # option spec :user_name [ String ] The name of the user.
27
- # option spec :db_name [ String ] The name of the database where the user exists.
28
- # option spec :options [ Hash ] Options for the operation.
29
- #
30
- # @since 2.1.0
31
- class UserQuery
32
- include Executable
33
- include Specifiable
34
-
35
- # Execute the operation.
36
- # The context gets a connection on which the operation
37
- # is sent in the block.
19
+ # A MongoDB operation to get info of a particular user in a database.
20
+ #
21
+ # @example Create the user query operation.
22
+ # Read::UserQuery.new(:name => 'emily', :db_name => 'test-db')
38
23
  #
39
- # @param [ Mongo::Server::Context ] context The context for this operation.
24
+ # Initialization:
25
+ # param [ Hash ] spec The specifications for the user query operation.
40
26
  #
41
- # @return [ Result ] The operation response, if there is one.
27
+ # option spec :user_name [ String ] The name of the user.
28
+ # option spec :db_name [ String ] The name of the database where the user exists.
29
+ # option spec :options [ Hash ] Options for the operation.
42
30
  #
43
31
  # @since 2.1.0
44
- def execute(context)
45
- if context.features.users_info_enabled?
46
- UsersInfo.new(spec).execute(context)
47
- else
48
- context.with_connection do |connection|
49
- Result.new(connection.dispatch([ message(context) ])).validate!
32
+ class UserQuery
33
+ include Executable
34
+ include Specifiable
35
+
36
+ # Execute the operation.
37
+ # The context gets a connection on which the operation
38
+ # is sent in the block.
39
+ #
40
+ # @param [ Mongo::Server::Context ] context The context for this operation.
41
+ #
42
+ # @return [ Result ] The operation response, if there is one.
43
+ #
44
+ # @since 2.1.0
45
+ def execute(context)
46
+ if context.features.users_info_enabled?
47
+ UsersInfo.new(spec).execute(context)
48
+ else
49
+ context.with_connection do |connection|
50
+ Result.new(connection.dispatch([ message(context) ])).validate!
51
+ end
50
52
  end
51
53
  end
52
- end
53
54
 
54
- private
55
+ private
55
56
 
56
- def selector
57
- { :user => user_name }
58
- end
57
+ def selector
58
+ { :user => user_name }
59
+ end
59
60
 
60
- def query_coll
61
- Auth::User::COLLECTION
62
- end
61
+ def query_coll
62
+ Auth::User::COLLECTION
63
+ end
63
64
 
64
- def message(context)
65
- Protocol::Query.new(db_name, query_coll, selector, options)
65
+ def message(context)
66
+ Protocol::Query.new(db_name, query_coll, selector, options)
67
+ end
66
68
  end
67
69
  end
68
70
  end