rom-core 4.0.0.rc1 → 4.0.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dd842da91b8eff4e935f9bc0064b7225fbc41d6a
-  data.tar.gz: b949c0798bbddfb9bb49b52b0e4137759accc1f7
+  metadata.gz: bbc8460e253bf0a3520abb95d611577ec40b4974
+  data.tar.gz: 3dbda2f926ccd90f50ef326798ed0420cafe2b0f
 SHA512:
-  metadata.gz: c95c856d8c205db0013f905ad72e4e8bcecc243f227410d05607c8e2f1280e5d7cf8943c607cd6b45f5926e55e8febadab4e809cb847efe3e96c48e8c4873200
-  data.tar.gz: bf2277dae18e48950740d93a6478cf4d0d56eda97065b797edb5d88d8ab9327f871ab99d2207a909ae80663ae0a654b2495485be7ddf071ab5da6105737b9db8
+  metadata.gz: d081489a27d141a741efc64e8119e92247e7d9bc196f24b18e150182b395d893e90804a90c275930065aba2d34b26ae91121b9413752d75eb6d2b541b586325a
+  data.tar.gz: 42b21a86b93e53f190f1aa439336b15c9ea1e4454c35ec37a19e6313ddec2e26d9f0b98f5b4f3b6a47266aa9fa0bafdb559a94c031f70e98ed8c3a3592b9a7ad

data/CHANGELOG.md

@@ -23,7 +23,7 @@ Previous `rom` gem was renamed to `rom-core`
 
 ## Changed
 
-* Works with MRI >= 2.2
+* Works with MRI >= 2.3
 * [BREAKING] Inferring relations from database schema **has been removed**. You need to define relations explicitly now (solnic)
 * [BREAKING] Relations have `auto_map` **turned on by default**. This means that wraps and graphs return nested data structures automatically (solnic)
 * [BREAKING] `Relation#combine` behavior from previous versions is now provided by `Relation#combine_with` (solnic)

data/lib/rom/relation/combined.rb

@@ -77,7 +77,7 @@ module ROM
       #
       # @param [Symbol] name The node relation name
       #
-      # @yieldparam [Relation] The relation node
+      # @yieldparam [Relation] relation The relation node
       # @yieldreturn [Relation] The new relation node
       #
       # @return [Relation]
@@ -107,6 +107,26 @@ module ROM
         with_nodes(new_nodes)
       end
 
+      # Return a `:create` command that can insert data from a nested hash.
+      #
+      # This is limited to `:create` commands only, because automatic restriction
+      # for `:update` commands would be quite complex. It's possible that in the
+      # future support for `:update` commands will be added though.
+      #
+      # Another limitation is that it can only work when you're composing
+      # parent and its child(ren), which follows canonical hierarchy from your
+      # database, so that parents are created first, then their PKs are set
+      # as FKs in child tuples. It should be possible to make it work with
+      # both directions (parent => child or child => parent), and it would
+      # require converting input tuples based on how they depend on each other,
+      # which we could do in the future.
+      #
+      # Expanding functionality of this method is planned for rom 5.0.
+      #
+      # @see Relation#command
+      #
+      # @raise NotImplementedError when type is not `:create`
+      #
       # @api public
       def command(type, *args)
         if type == :create

data/lib/rom/relation/commands.rb

@@ -6,20 +6,37 @@ module ROM
     module Commands
       # Return a command for the relation
       #
-      # @example
+      # This method can either return an existing custom command identified
+      # by `type` param, or generate a command dynamically based on relation
+      # AST.
+      #
+      # @example build a simple :create command
       #   users.command(:create)
       #
+      # @example build a command which returns multiple results
+      #   users.command(:create, result: many)
+      #
+      # @example build a command which uses a specific plugin
+      #   users.command(:create, plugin: :timestamps)
+      #
+      # @example build a command which sends results through a custom mapper
+      #   users.command(:create, mapper: :my_mapper_identifier)
+      #
+      # @example return an existing custom command
+      #   users.command(:my_custom_command_identifier)
+      #
       # @param type [Symbol] The command type (:create, :update or :delete)
-      # @option :mapper [ROM::Mapper] An optional mapper applied to the command result
-      # @option :use [Array<Symbol>] A list of command plugins
-      # @option :result [:one, :many] Whether the command result has one or more rows.
-      #                               :one is default
+      # @param opts [Hash] Additional options
+      # @option opts [Symbol] :mapper (nil) An optional mapper applied to the command result
+      # @option opts [Array<Symbol>] :use ([]) A list of command plugins
+      # @option opts [Symbol] :result (:one) Set how many results the command should return.
+      #                                       Can be `:one` or `:many`
       #
       # @return [ROM::Command]
       #
       # @api public
       def command(type, mapper: nil, use: EMPTY_ARRAY, **opts)
-        base_command = commands[type, adapter, to_ast, use, opts]
+        base_command = commands.key?(type) ? commands[type] : commands[type, adapter, to_ast, use, opts]
 
         command =
           if mapper

data/lib/rom/version.rb

@@ -1,5 +1,5 @@
 module ROM
   module Core
-    VERSION = '4.0.0.rc1'.freeze
+    VERSION = '4.0.0.rc2'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rom-core
 version: !ruby/object:Gem::Version
-  version: 4.0.0.rc1
+  version: 4.0.0.rc2
 platform: ruby
 authors:
 - Piotr Solnica
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-15 00:00:00.000000000 Z
+date: 2017-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -59,6 +59,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -66,6 +69,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.1
 - !ruby/object:Gem::Dependency
   name: dry-core
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +106,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.beta
+        version: 1.0.0.rc
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.beta
+        version: 1.0.0.rc
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement