rom-changeset 1.0.0.beta2 → 1.0.0.beta3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4bf7b154ea5fdf816ecac29171738cdd8511296b
-  data.tar.gz: 00b0f1be4b5192e212eac8c01a9565ba393809bc
+  metadata.gz: 3e974c1c36fcff82e3b23b9f2a3cfea2e6b8de4a
+  data.tar.gz: c87a7913578f4091f9496b9b7676ebb8d797963e
 SHA512:
-  metadata.gz: 7d86686d0cfc452654422dc2b79d9c14a042653347ad1c72fd83508c8faaefec8ba3241a47832c53a966111fec99be1b095b5e3298b871f64b5825dcc6939816
-  data.tar.gz: 3b778dd54cf853b93cb8e36f423b12bad522031595575ce4e52b62f5c430c6acf8a5d655c1d7f5d42422726291414f452cfd9171d92f55730e36c4a6e450d7f1
+  metadata.gz: 63d0b84a39845c77a5ca20a2806cb736b010867549290d8a41a132f16703278d02e4d9ed75bf34c30c9dca7510e920cbfc9371ab6b2d62211a3f8d0a33ebb18f
+  data.tar.gz: dd10e1c4f3b82c80b576aa77c46b122e2355e7979df82a69e70f9b29518a6b060ed0d69f50e07f2b52f28731d1808e986a5cc372cac47889040f4acba46a728b

data/lib/rom/changeset/delete.rb

@@ -1,5 +1,3 @@
-require 'rom/changeset/restricted'
-
 module ROM
   class Changeset
     # Changeset specialization for delete commands
@@ -9,8 +7,6 @@ module ROM
     #
     # @api public
     class Delete < Changeset
-      include Restricted
-
       command_type :delete
     end
   end

data/lib/rom/changeset/pipe.rb

@@ -76,16 +76,8 @@ module ROM
         end
       end
 
-      def with(opts)
-        if opts.empty?
-          self
-        else
-          Pipe.new(processor, options.merge(opts))
-        end
-      end
-
       def new(processor, opts = EMPTY_HASH)
-        Pipe.new(processor, options.merge(opts))
+        Pipe.new(processor, opts.empty? ? options : options.merge(opts))
       end
     end
   end

data/lib/rom/changeset/stateful.rb

@@ -92,13 +92,14 @@ module ROM
       def self.inherited(klass)
         return if klass == ROM::Changeset
         super
-        klass.instance_variable_set(:@__pipes__, pipes ? pipes.dup : EMPTY_ARRAY)
+        klass.instance_variable_set(:@__pipes__, pipes.dup)
       end
 
       # @api private
       def self.pipes
         @__pipes__
       end
+      @__pipes__ = EMPTY_ARRAY
 
       # Pipe changeset's data using custom steps define on the pipe
       #

data/lib/rom/changeset/update.rb

@@ -1,5 +1,3 @@
-require 'rom/changeset/restricted'
-
 module ROM
   class Changeset
     # Changeset specialization for update commands
@@ -15,8 +13,6 @@ module ROM
     #
     # @api public
     class Update < Stateful
-      include Restricted
-
       command_type :update
 
       # Commit update changeset if there's a diff

data/lib/rom/changeset/version.rb

@@ -1,5 +1,5 @@
 module ROM
   class Changeset
-    VERSION = '1.0.0.beta2'.freeze
+    VERSION = '1.0.0.beta3'.freeze
   end
 end

data/lib/rom/changeset.rb

@@ -71,24 +71,6 @@ module ROM
       }
     end
 
-    # Return a new changeset with updated options
-    #
-    # @example
-    #   class NewUser < ROM::Changeset::Create[:users]
-    #     option :token_generator
-    #   end
-    #
-    #   changeset = user_repo.changeset(NewUser).with(token_generator: my_token_gen)
-    #
-    # @param [Hash] new_options The new options
-    #
-    # @return [Changeset]
-    #
-    # @api public
-    def with(new_options)
-      self.class.new(relation, options.merge(new_options))
-    end
-
     # Return a new changeset with provided relation
     #
     # New options can be provided too

data/lib/rom/plugins/relation/changeset.rb

@@ -24,7 +24,51 @@ module ROM
 
           # Create a changeset for a relation
           #
-          # @return [Changeset]
+          # @overload changeset(type, data)
+          #   Create a changeset of one of predefined types
+          #
+          #   @example creating a record
+          #     users.
+          #       changeset(:create, name: 'Jane').
+          #       commit
+          #     # => #<ROM::Struct::User id=1 name="Jane">
+          #
+          #   @example updating a record
+          #     users.
+          #       by_pk(1).
+          #       changeset(:update, name: 'Jack').
+          #       commit
+          #     # => #<ROM::Struct::User id=1 name="Jane">
+          #
+          #   @example providing data as a separate step
+          #     changeset = users.changeset(:create)
+          #     jack = changeset.data(name: 'Jack').commit
+          #     jane = changeset.data(name: 'Jane').commit
+          #
+          #   @example using a command graph
+          #     users.
+          #       changeset(
+          #         :create,
+          #         name: "Jane",
+          #         posts: [{ title: "Something about aliens" }]
+          #       )
+          #
+          #   @param [Symbol] type The changeset type
+          #   @param [Hash] data
+          #   @return [Changeset]
+          #
+          # @overload changeset(changeset_class, data)
+          #   @example using a custom changeset class
+          #     class NewUser < ROM::Changeset::Create
+          #       map do |tuple|
+          #         { **tuple, name: tuple.values_at(:first_name, :last_name).join(' ') }
+          #       end
+          #     end
+          #
+          #     users.changeset(NewUser, first_name: 'John', last_name: 'Doe').commit
+          #
+          #   @param [Class] changeset_class A custom changeset class
+          #   @return [Changeset]
           #
           # @api public
           def changeset(type, data = EMPTY_HASH)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rom-changeset
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta2
+  version: 1.0.0.beta3
 platform: ruby
 authors:
 - Piotr Solnica
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-07-04 00:00:00.000000000 Z
+date: 2017-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-core
@@ -101,7 +101,6 @@ files:
 - lib/rom/changeset/create.rb
 - lib/rom/changeset/delete.rb
 - lib/rom/changeset/pipe.rb
-- lib/rom/changeset/restricted.rb
 - lib/rom/changeset/stateful.rb
 - lib/rom/changeset/update.rb
 - lib/rom/changeset/version.rb
@@ -126,7 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.12
+rubygems_version: 2.6.11
 signing_key: 
 specification_version: 4
 summary: Changeset abstraction for rom-rb

data/lib/rom/changeset/restricted.rb

@@ -1,28 +0,0 @@
-module ROM
-  class Changeset
-    module Restricted
-      # Return a command restricted by the changeset's relation
-      #
-      # @see Changeset#command
-      #
-      # @api private
-      def command
-        super.new(relation)
-      end
-
-      # Restrict changeset's relation by its PK
-      #
-      # @example
-      #   repo.changeset(UpdateUser).by_pk(1).data(name: "Jane")
-      #
-      # @param [Object] pk
-      #
-      # @return [Changeset]
-      #
-      # @api public
-      def by_pk(pk, data = EMPTY_HASH)
-        new(relation.by_pk(pk), __data__: data)
-      end
-    end
-  end
-end