processable 0.0.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 705d27371b77cdc00c484f92db94f67a7e94cdc04862ebad2c61089e9a183267
-  data.tar.gz: c5ebc893d17dc9d3f70129a7ca840be4d5dcd7277d97214e9e29c09ce1c00771
+  metadata.gz: ec61896c8cf47fe86e818a6c6aa4a188763603ec6eeaf7fd7cbb6d8331896995
+  data.tar.gz: 81fe69af1a31eb0014883fb7c149492dddb103aad7a2a5b7bc40961d506a9452
 SHA512:
-  metadata.gz: 76663b37e4ed8c24df609e5a0749250bd82111e0a9659a78dd955cc1f52476635883664e2f6fa800bba80aa5dddc92e5960cf5143cb78bd570a0ceff7f764ed7
-  data.tar.gz: be1cc7b3986091c40635c16ca504ea000071e4d5bb5ad02cad3e3198f3c8ca83845d6db8a7e0a7924eec04643a7fae76e38b47721c4b51b22b4ef76b7244e09d
+  metadata.gz: c58eeb9c2e4a3c88431a28aff883e90ed340448c4708f6c7ed05a99de80bb0b4932a911e35208997220e87936608eddccdf5135b3d7d7804a21be5615fd38741
+  data.tar.gz: 0c57d85af3ed9c69a244be3d7051f948f1145742d67758cf3dd1799faf7a3dedc3f665f05643114fe2b329a44947bc908503996c22cb21a082c7af439e983a6f

data/.gitignore

@@ -10,4 +10,5 @@
 # rspec failure tracking
 .rspec_status
 .idea
-.byebug_history
+.byebug_history
+*.gem

data/.rubocop_todo.yml

@@ -1,11 +1,22 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config --auto-gen-only-exclude`
-# on 2022-07-16 11:38:10 UTC using RuboCop version 0.93.1.
+# on 2023-10-20 07:00:15 UTC using RuboCop version 0.93.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
+# Offense count: 1
+Lint/ShadowingOuterLocalVariable:
+  Exclude:
+    - 'lib/processable.rb'
+
+# Offense count: 1
+# Configuration parameters: IgnoredMethods, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/processable.rb'
+
 # Offense count: 1
 # Configuration parameters: CountComments, Max, CountAsOne, ExcludedMethods.
 # ExcludedMethods: refine
@@ -14,6 +25,12 @@ Metrics/BlockLength:
     - '**/*.gemspec'
     - 'spec/processable_spec.rb'
 
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne, ExcludedMethods.
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/processable.rb'
+
 # Offense count: 2
 Style/ClassVars:
   Exclude:

data/.ruby-version

@@ -0,0 +1 @@
+3.0.5

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    processable (0.0.1)
+    processable (1.0.0)
 
 GEM
   remote: https://rubygems.org/
@@ -10,26 +10,28 @@ GEM
     byebug (11.1.3)
     diff-lcs (1.5.0)
     docile (1.4.0)
-    parallel (1.22.1)
-    parser (3.1.2.0)
+    parallel (1.23.0)
+    parser (3.2.2.4)
       ast (~> 2.4.1)
+      racc
+    racc (1.7.1)
     rainbow (3.1.1)
     rake (13.0.6)
-    regexp_parser (2.5.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    regexp_parser (2.8.2)
+    rexml (3.2.6)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.1)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
     rubocop (0.93.1)
       parallel (~> 1.10)
       parser (>= 2.7.1.5)
@@ -39,12 +41,12 @@ GEM
       rubocop-ast (>= 0.6.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (1.18.0)
-      parser (>= 3.1.1.0)
+    rubocop-ast (1.29.0)
+      parser (>= 3.2.1.0)
     rubocop-rspec (1.44.1)
       rubocop (~> 0.87)
       rubocop-ast (>= 0.7.1)
-    ruby-progressbar (1.11.0)
+    ruby-progressbar (1.13.0)
     simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
@@ -66,4 +68,4 @@ DEPENDENCIES
   simplecov (~> 0.21.2)
 
 BUNDLED WITH
-   2.2.3
+   2.4.20

data/README.md

@@ -13,10 +13,12 @@ class PrintGithubRepos < Processable
     repos_json.except(:title, :description)
   end
   
-  step :print_to_console do |repos_json|
-    print repos_json
+  step :print_to_console do |result_from_prev_step, current_step, list_of_steps|
+    print result_from_prev_step
   end
 end
+
+PrintGithubRepos.new.process
 ```
 
 ## Installation
@@ -28,13 +30,14 @@ gem 'processable'
 ```
 
 And then execute:
-
-    $ bundle install
+```shell
+bundle install
+```
 
 Or install it yourself as:
-
-    $ gem install processable
-
+```shell
+gem install processable
+```
 ## Usage
 
 **Define new class with required behavior**
@@ -62,7 +65,7 @@ class SiteScrapper < Processable
 end
 ```
 
-**Add steps to the process**
+**Trigger the process**
 
 To start the process simply call... 
 
@@ -70,6 +73,19 @@ To start the process simply call...
 SiteScrapper.new.process
 ```
 
+To run the process until some certain step you can pass the name of the step as an argument. Also keep in mind the step defined in run_until will not be executed as well.
+
+```ruby
+SiteScrapper.new.process(run_until: :save_to_database)
+```
+
+To exec only one particular step you can pass the name of the step as an argument. 
+
+```ruby
+SiteScrapper.new.process(exec_step: :save_to_database)
+```
+
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/processable.rb

@@ -19,7 +19,7 @@ class Processable
   #  Collections of steps like
   # @type [String]
   @@registered_steps = []
-  class Error < StandardError; end
+  class StepNotFoundError < StandardError; end
 
   class << self
     # Adding new step to the process
@@ -31,21 +31,40 @@ class Processable
   end
 
   # Run steps in order as they were defined
-  def process
-    @@registered_steps.each_with_index do |step, index|
-      previous_step = index.zero? ? {} : @@registered_steps[index - 1]
+  def process(run_until: nil)
+    steps_to_run = if run_until
+                     run_until_index = @@registered_steps.find_index { |step_hash| step_hash[:name] == run_until }
+                     raise StepNotFoundError, "Step '#{run_until}' not found" unless run_until_index
+
+                     @@registered_steps[0..run_until_index]
+                   else
+                     @@registered_steps
+                   end
+
+    steps_to_run.each_with_index do |step, index|
+      previous_step = index.zero? ? {} : steps_to_run[index - 1]
 
       result = instance_exec(previous_step[:result],
                              step,
-                             @@registered_steps,
+                             steps_to_run,
                              &step[:block])
 
       step[:result] = result
     end
 
-    @@registered_steps.last[:result]
+    steps_to_run.last[:result]
   end
 
+  def exec_step(step_name:, options:)
+    step = @@registered_steps.find { |step| step[:name] == step_name }
+
+    raise StepNotFoundError, "Step '#{step_name}' not found" unless step
+
+    instance_exec(options, step, @@registered_steps, &step[:block])
+  end
+
+  def initialize(*arguments); end
+
   private
 
   attr_accessor :registered_steps

data/processable.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = "processable"
-  spec.version       = "0.0.1"
+  spec.version       = "1.0.0"
   spec.authors       = ["Max Rukomoynikov"]
   spec.email         = ["rukomoynikov@gmail.com"]
 

data/processable.idea

@@ -20,6 +20,8 @@ class LocationsUploaderStep < Processable::Step
 end
 
 # Order of steps as it's been defined
+# Run process until
+# Pass arguments to each step manually for test purpose
 # In the result you will get either result of the last step
 # Print every step (option to disable)
 # How to validate?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: processable
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Max Rukomoynikov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-07-16 00:00:00.000000000 Z
+date: 2023-10-20 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -23,6 +23,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
+- ".ruby-version"
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
@@ -55,7 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: Ruby gem to help you organize any process into series of steps