lite-command 1.0.6 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d87e7d29724662cbe21a43b565e0452d97acbd9556bbf4b55689c773e91b73d4
-  data.tar.gz: 3eeca99338dfcdb01d82946c24dc1477c712af81f1400b02bc6758a114cae68f
+  metadata.gz: 1832d3973ed0b408d8c4c11d6fb0e53ab9184080bc5eca37d99c69ec7a29c09c
+  data.tar.gz: a7f5dc00b4b00587a8f4f9115637d02f69ad7218112b1a1b066a994e477be93d
 SHA512:
-  metadata.gz: '092dde4f9c34f13e7f5df9fd848f8e77363636ba8ca7ac11cf90e1b86762f6730828d1243f6d32aa08422094c614463f1f5a8dd3e8d2fc34d77374ea3f7df0ae'
-  data.tar.gz: 21506fbf38db972e141b3bd638c883818304703e8d049ea571227bde7580e341fbaa73bd5b62eb02a17c17c2488258536b5eb40bd9f00a18b17989a299d6c361
+  metadata.gz: 235acc1478d53eeb81f16419a3c53eaa1ca743f472872508e433d4031b1a5fbc19f6a1cdee11d1fa7f35b44031ef8cd6d36510646e5c8cf58748f8866e365bd3
+  data.tar.gz: eebb89a36eac24e2836c5742a78039c575bda0915696588da8cdbd1c0e4a40af976e6ab8412ab1e2d36790d422191aa2440f0d2fbdb3341b5c17d3679b32f8ac

data/.rubocop.yml

@@ -2,11 +2,14 @@ require:
   - rubocop-performance
   - rubocop-rspec
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 2.7
+  NewCops: enable
   DisplayCopNames: true
   DisplayStyleGuide: true
-LineLength:
-  Max: 100
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+Layout/EmptyLinesAroundAttributeAccessor:
+  Enabled: true
 Layout/EmptyLinesAroundBlockBody:
   Exclude:
     - 'spec/**/**/*'
@@ -14,6 +17,14 @@ Layout/EmptyLinesAroundClassBody:
   EnforcedStyle: empty_lines_except_namespace
 Layout/EmptyLinesAroundModuleBody:
   EnforcedStyle: empty_lines_except_namespace
+Layout/LineLength:
+  Max: 100
+Layout/SpaceAroundMethodCallOperator:
+  Enabled: true
+Lint/RaiseException:
+  Enabled: true
+Lint/StructNewOverride:
+  Enabled: true
 Metrics/BlockLength:
   Exclude:
     - 'spec/**/**/*'

data/.travis.yml

@@ -4,6 +4,7 @@ cache: bundler
 rvm:
 - 2.5
 - 2.6
+- 2.7
 - ruby-head
 matrix:
   fast_finish: true

data/CHANGELOG.md

@@ -6,6 +6,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2019-06-06
+### Added
+- Added procedure support for running multiple commands
+
+## [1.0.10] - 2019-12-21
+### Added
+- Added Ruby 2.7 support
+### Removed
+- Removed generator empty directory check
+
+## [1.0.9] - 2019-12-20
+### Removed
+- Removed lite-command generator
+- Removed rspec file from rails generator
+
+## [1.0.8] - 2019-09-16
+### Changed
+- Changed create propagation to check errors instead of persistence
+
+## [1.0.7] - 2019-09-12
+### Added
+- Add propagation mixin
+
 ## [1.0.6] - 2019-09-07
 ### Added
 - Raise error when class `call` if class doesn't respond_to `execute`

data/Gemfile.lock

@@ -1,117 +1,133 @@
 PATH
   remote: .
   specs:
-    lite-command (1.0.6)
+    lite-command (1.1.0)
       lite-errors
       lite-memoize
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (6.0.0)
-      actionview (= 6.0.0)
-      activesupport (= 6.0.0)
-      rack (~> 2.0)
+    actionpack (6.0.3.4)
+      actionview (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
+      rack (~> 2.0, >= 2.0.8)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actionview (6.0.0)
-      activesupport (= 6.0.0)
+    actionview (6.0.3.4)
+      activesupport (= 6.0.3.4)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activesupport (6.0.0)
+    activemodel (6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activerecord (6.0.3.4)
+      activemodel (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-      zeitwerk (~> 2.1, >= 2.1.8)
-    ast (2.4.0)
-    builder (3.2.3)
+      zeitwerk (~> 2.2, >= 2.2.2)
+    ast (2.4.1)
+    builder (3.2.4)
     colorize (0.8.1)
-    concurrent-ruby (1.1.5)
-    crass (1.0.4)
-    diff-lcs (1.3)
-    erubi (1.8.0)
-    fasterer (0.6.0)
+    concurrent-ruby (1.1.7)
+    crass (1.0.6)
+    database_cleaner (1.8.5)
+    diff-lcs (1.4.4)
+    erubi (1.9.0)
+    fasterer (0.8.3)
       colorize (~> 0.7)
-      ruby_parser (>= 3.13.0)
+      ruby_parser (>= 3.14.1)
     generator_spec (0.9.4)
       activesupport (>= 3.0.0)
       railties (>= 3.0.0)
-    i18n (1.6.0)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.3)
     lite-errors (1.0.1)
     lite-memoize (1.0.3)
-    loofah (2.2.3)
+    loofah (2.7.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    method_source (0.9.2)
+    method_source (1.0.0)
     mini_portile2 (2.4.0)
-    minitest (5.11.3)
-    nokogiri (1.10.4)
+    minitest (5.14.2)
+    nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
-    parallel (1.17.0)
-    parser (2.6.4.0)
-      ast (~> 2.4.0)
-    rack (2.0.7)
+    parallel (1.19.2)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.2.0)
-      loofah (~> 2.2, >= 2.2.2)
-    railties (6.0.0)
-      actionpack (= 6.0.0)
-      activesupport (= 6.0.0)
+    rails-html-sanitizer (1.3.0)
+      loofah (~> 2.3)
+    railties (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       method_source
       rake (>= 0.8.7)
       thor (>= 0.20.3, < 2.0)
     rainbow (3.0.0)
-    rake (12.3.3)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.2)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.4)
+    rake (13.0.1)
+    regexp_parser (1.8.2)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.2)
-    rubocop (0.74.0)
-      jaro_winkler (~> 1.5.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.2.0)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
+      rexml
+      rubocop-ast (>= 1.0.1)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    rubocop-performance (1.4.1)
-      rubocop (>= 0.71.0)
-    rubocop-rspec (1.35.0)
-      rubocop (>= 0.60.0)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.1.1)
+      parser (>= 2.7.1.5)
+    rubocop-performance (1.8.1)
+      rubocop (>= 0.87.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rspec (2.0.0)
+      rubocop (~> 1.0)
+      rubocop-ast (>= 1.1.0)
     ruby-progressbar (1.10.1)
-    ruby_parser (3.13.1)
+    ruby_parser (3.15.0)
       sexp_processor (~> 4.9)
-    sexp_processor (4.12.1)
-    thor (0.20.3)
+    sexp_processor (4.15.1)
+    sqlite3 (1.4.2)
+    thor (1.0.1)
     thread_safe (0.3.6)
-    tzinfo (1.2.5)
+    tzinfo (1.2.7)
       thread_safe (~> 0.1)
-    unicode-display_width (1.6.0)
-    zeitwerk (2.1.10)
+    unicode-display_width (1.7.0)
+    zeitwerk (2.4.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  activerecord
   bundler
+  database_cleaner
   fasterer
   generator_spec
   lite-command!
@@ -120,6 +136,7 @@ DEPENDENCIES
   rubocop
   rubocop-performance
   rubocop-rspec
+  sqlite3
 
 BUNDLED WITH
-   2.0.1
+   2.1.4

data/README.md

@@ -27,18 +27,21 @@ Or install it yourself as:
 * [Setup](#setup)
 * [Simple](#simple)
 * [Complex](#complex)
+* [Procedure](#procedure)
 * [Extensions](#extensions)
 
 ## Setup
 
-`rails g lite:command:install` will generate the following file:
-`../app/commands/application_command.rb`
+`rails g command NAME` will generate the following file:
 
-```ruby
-class ApplicationCommand < Lite::Command::Complex
-end
+```erb
+app/commands/[NAME]_command.rb
 ```
 
+If a `ApplicationCommand` file in the `app/commands` directory is available, the
+generator will create file that inherit from `ApplicationCommand` if not it will
+fallback to `Lite::Command::Complex`.
+
 ## Simple
 
 Simple commands build quick class based calls but cannot be extended.
@@ -47,13 +50,9 @@ This is more of a traditional command service call as it only exposes a `call` m
 ```ruby
 class SearchMovies < Lite::Command::Simple
 
-  class << self
-    private
-
-    # NOTE: This class method is required
-    def execute(*args)
-      { generate_fingerprint => movies_by_name }
-    end
+  # NOTE: This class method is required
+  def self.execute(*args)
+    { generate_fingerprint => movies_by_name }
   end
 
 end
@@ -62,8 +61,7 @@ end
 **Caller**
 
 ```ruby
-command = SearchMovies.call('Toy Story')
-command.call
+SearchMovies.call('Toy Story')
 ```
 
 ## Complex
@@ -71,9 +69,6 @@ command.call
 Complex commands can be used in instance and class based calls and
 extended with access to errors and memoization.
 
-Use `rails g decorator NAME` will generate the following file:
-`../app/decorators/[name]_decorator.rb`
-
 You will then need to fill this class with the required `execute` method as shown below:
 
 ```ruby
@@ -135,9 +130,39 @@ command.recall! #=> Clears the call, cache, errors, and then re-performs the cal
 command.result  #=> { 'fingerprint_2' => [ 'Toy Story 2', ... ] }
 ```
 
+## Procedure
+
+Procedures run a collection of commands. It uses the the complex procedure API
+so it has access to all the methods. The `execute` method is already defined to
+handle most common procedure steps. It can be use directly or subclassed.
+
+```ruby
+class SearchChannels < Lite::Command::Procedure; end
+
+procedure = SearchChannels.call(
+  DisneyChannel.new,
+  EspnChannel.new,
+  MtvChannel.new
+)
+
+procedure.result #=> ['disney: #3', 'espn: #59', 'mtv: #212']
+procedure.steps  #=> [<DisneyChannel  @result="...">, <EspnChannel @result="...">, <MtvChannel  @result="...">]
+
+# If the errors extension is added you can stop the procedure at first failure.
+procedure = SearchChannels.new(
+  DisneyChannel.new,
+  ErrorChannel.new,
+  MtvChannel.new
+)
+
+procedure.exit_on_failure = true
+procedure.call
+procedure.result #=> ['disney: #3']
+```
+
 ## Extensions
 
-Extend complex base command with any of the following extensions:
+Extend complex (and procedures) base command with any of the following extensions:
 
 ### Errors (optional)
 
@@ -194,6 +219,28 @@ command.merge_errors!(command_2)
 user_model.merge_errors!(command, direction: :to)
 ```
 
+### Propagation (optional)
+
+Propagation methods help you perform an action on an object. If successful is
+returns the result else it adds the object errors to the form object. Available
+propagation methods are:
+`create_and_return!(object, params)`, `update_and_return!(object, params)`,
+`save_and_return!(object)`, and `destroy_and_return!(object)`
+
+```ruby
+class SearchMovies < Lite::Command::Complex
+  include Lite::Command::Extensions::Errors
+  include Lite::Command::Extensions::Propagation
+
+  # ... ommited ...
+
+  def execute
+    create_and_return!(User, name: 'John Doe')
+  end
+
+end
+```
+
 ### Memoize (optional)
 
 Learn more about using [Lite::Memoize](https://github.com/drexed/lite-memoize)

data/lib/generators/rails/USAGE

@@ -6,4 +6,3 @@ Example:
 
     This will create:
         - app/commands/[name]_command.rb
-        - spec/commands/[name]_command_spec.rb

data/lib/generators/rails/command_generator.rb

@@ -10,16 +10,9 @@ module Rails
 
     def copy_files
       path = File.join('app', 'commands', class_path, "#{file_name}_command.rb")
-      empty_directory('app/commands')
       template('command.rb.tt', path)
     end
 
-    def copy_specs
-      path = File.join('spec', 'commands', class_path, "#{file_name}_command_spec.rb")
-      empty_directory('spec/commands')
-      template('spec.rb.tt', path)
-    end
-
     private
 
     def file_name

data/lib/generators/rails/templates/command.rb.tt

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 <% module_namespacing do -%>
-class <%= class_name %>Command < ApplicationCommand
+class <%= class_name %>Command < <%= ApplicationCommand.to_s rescue 'Lite::Command::Complex' %>
 end
 <% end -%>

data/lib/lite/command.rb

@@ -2,13 +2,12 @@
 
 require 'lite/command/version'
 
-%w[errors memoize].each do |name|
+%w[errors memoize propagation].each do |name|
   require "lite/command/extensions/#{name}"
 end
 
-%w[exceptions states complex simple].each do |name|
+%w[exceptions states simple complex procedure].each do |name|
   require "lite/command/#{name}"
 end
 
-require 'generators/lite/command/install_generator'
 require 'generators/rails/command_generator'

data/lib/lite/command/extensions/propagation.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Lite
+  module Command
+    module Extensions
+      module Propagation
+
+        private
+
+        %i[archive destroy save].each do |action|
+          define_method("#{action}_and_return!") do |klass|
+            merge_errors!(klass) unless klass.send(action)
+            klass
+          end
+        end
+
+        def create_and_return!(klass, params)
+          klass = klass.create(params)
+          merge_errors!(klass) unless klass.errors.empty?
+          klass
+        end
+
+        def update_and_return!(klass, params)
+          merge_errors!(klass) unless klass.update(params)
+          klass
+        end
+
+      end
+    end
+  end
+end

data/lib/lite/command/procedure.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Lite
+  module Command
+    class Procedure < Complex
+
+      include Lite::Command::Extensions::Errors
+
+      attr_accessor :exit_on_failure
+
+      def execute
+        steps.each_with_object([]) do |command, results|
+          command.call
+
+          if respond_to?(:errors) && command.respond_to?(:errors) && command.failure?
+            merge_errors!(command)
+            break results if exit_on_failure?
+          else
+            results << command.result
+          end
+        end
+      end
+
+      def exit_on_failure?
+        @exit_on_failure ||= false
+      end
+
+      def steps
+        @steps ||= @args.flatten
+      end
+
+    end
+  end
+end

data/lib/lite/command/version.rb

@@ -3,7 +3,7 @@
 module Lite
   module Command
 
-    VERSION ||= '1.0.6'
+    VERSION ||= '1.1.0'
 
   end
 end

data/lite-command.gemspec

@@ -40,7 +40,9 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'lite-errors'
   spec.add_dependency 'lite-memoize'
 
+  spec.add_development_dependency 'activerecord'
   spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'database_cleaner'
   spec.add_development_dependency 'fasterer'
   spec.add_development_dependency 'generator_spec'
   spec.add_development_dependency 'rake'
@@ -48,4 +50,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-performance'
   spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'sqlite3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lite-command
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.1.0
 platform: ruby
 authors:
 - Juan Gomez
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-09-07 00:00:00.000000000 Z
+date: 2020-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lite-errors
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fasterer
   requirement: !ruby/object:Gem::Requirement
@@ -150,7 +178,21 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
 email:
 - j.gomez@drexed.com
 executables: []
@@ -173,17 +215,16 @@ files:
 - _config.yml
 - bin/console
 - bin/setup
-- lib/generators/lite/command/install_generator.rb
-- lib/generators/lite/command/templates/install.rb
 - lib/generators/rails/USAGE
 - lib/generators/rails/command_generator.rb
 - lib/generators/rails/templates/command.rb.tt
-- lib/generators/rails/templates/spec.rb.tt
 - lib/lite/command.rb
 - lib/lite/command/complex.rb
 - lib/lite/command/exceptions.rb
 - lib/lite/command/extensions/errors.rb
 - lib/lite/command/extensions/memoize.rb
+- lib/lite/command/extensions/propagation.rb
+- lib/lite/command/procedure.rb
 - lib/lite/command/simple.rb
 - lib/lite/command/states.rb
 - lib/lite/command/version.rb
@@ -192,7 +233,7 @@ homepage: http://drexed.github.io/lite-command
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -207,8 +248,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Ruby Command based framework (aka service objects)
 test_files: []

data/lib/generators/lite/command/install_generator.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-require 'rails/generators'
-
-module Lite
-  module Command
-    class InstallGenerator < Rails::Generators::Base
-
-      source_root File.expand_path('../templates', __FILE__)
-
-      def copy_application_query_file
-        copy_file('install.rb', 'app/commands/application_command.rb')
-      end
-
-    end
-  end
-end

data/lib/generators/lite/command/templates/install.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationCommand < Lite::Command::Complex
-end

data/lib/generators/rails/templates/spec.rb.tt

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-require 'rails_helper'
-
-RSpec.describe <%= class_name %>Command, type: :command do
-  pending "add some examples to (or delete) #{__FILE__}"
-end