odsl 0.1.0 → 0.3.0

data/lib/odsl/methods.rb

@@ -1,19 +1,70 @@
+# lib/odsl/methods.rb
 module Odsl
   module Methods
+
+    def use(object)
+      @delegated = instance_variable_get("@#{object}")
+      self
+    end
+
     def call(methodo)
-      
-      @last_results = send(methodo, *@with_attributes.map { |attribute| instance_variable_get("@#{attribute}") })
-      @last_results = [@last_results] unless @last_results.is_a? Array
-  
+      run_method(methodo)
+      restore_delegate
       self
     end
-  
+
     def to(*variables)
       variables.each_with_index do |variable, index|
-        instance_variable_set("@#{variable}", @last_results[index])
+        value = @last_results[index]
+
+        if @_resuming_steps&.include?(variable.to_s)
+          stored = @_execution_context
+                     .step_records
+                     .find_by(name: variable.to_s)
+                     &.deserialized_result
+          instance_variable_set("@#{variable}", stored)
+        else
+          instance_variable_set("@#{variable}", value)
+          _record_step(variable, value)
+        end
       end
-  
       self
     end
+
+    private
+
+    def run_method(methodo)
+      @last_results = @delegated.send(methodo, *with_attributes_resolver)
+      @last_results = [@last_results] unless @last_results.is_a?(Array)
+    end
+
+    def restore_delegate
+      @delegated = self
+    end
+
+    def with_attributes_resolver
+      return [] if @with_attributes.nil?
+      @with_attributes.map { |attribute| instance_variable_get("@#{attribute}") }
+    end
+
+    def _record_step(name, value)
+      return unless @_execution_context
+
+      @_step_index ||= 0
+      serializable = Odsl::Audit::Serializer.serializable?(value)
+
+      Odsl::Audit::StepRecord.create!(
+        execution_context: @_execution_context,
+        name:              name.to_s,
+        step_index:        @_step_index,
+        status:            "completed",
+        result:            serializable ? Odsl::Audit::Serializer.dump(value) : nil,
+        non_resumable:     !serializable,
+        started_at:        Time.now,
+        completed_at:      Time.now
+      )
+
+      @_step_index += 1
+    end
   end
-end
+end

data/lib/odsl/railtie.rb

@@ -0,0 +1,15 @@
+require "rails/railtie"
+
+module Odsl
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      namespace :odsl do
+        desc "Remove expired audit records"
+        task cleanup: :environment do
+          count = Odsl.cleanup_expired!
+          puts "Removed #{count} expired execution context(s)"
+        end
+      end
+    end
+  end
+end

data/lib/odsl/runners.rb

@@ -1,9 +1,126 @@
+# lib/odsl/runners.rb
+require "json"
+
 module Odsl
   module Runners
-    def run(method)
+    def run(method, key: nil)
+      if self.class.inmutable_mode
+        _run_immutable(method, key: key)
+      else
+        _run_method(method, key: key)
+      end
+    end
+
+    def run_in_background(method, key: nil)
+      _background_adapter.enqueue(
+        service_class: self.class.name,
+        method_name:   method.to_s,
+        kwargs:        @kwargs,
+        key:           key
+      )
+    end
+
+    def run_in_parallel(*methods_and_opts)
+      key     = methods_and_opts.last.is_a?(Hash) ? methods_and_opts.pop[:key] : nil
+      handles = methods_and_opts.map { |m| run_in_background(m, key: key) }
+      handles.map { |h| h.respond_to?(:value) ? h.value : h }
+    end
+
+    private
+
+    def _background_adapter
+      case Odsl.config.background_adapter
+      when :thread     then Odsl::Adapters::Thread
+      when :active_job then Odsl::Adapters::ActiveJob
+      else raise Odsl::Error, "Unknown background adapter: #{Odsl.config.background_adapter.inspect}"
+      end
+    end
+
+    def _run_method(method, key: nil)
+      ctx_result          = _setup_context(method, key)
+      return nil if ctx_result == :already_completed
+
+      @_execution_context = ctx_result
+      @_current_lock      = nil
+      @_step_index        = 0
+      @_current_method    = method.to_s
+
+      begin
+        instance_eval(method.to_s)
+        @_execution_context&.update!(status: "completed")
+        _finish_result
+      rescue Odsl::LockError
+        raise
+      rescue
+        @_execution_context&.update!(status: "failed")
+        raise
+      ensure
+        @_current_lock&.unlock rescue nil
+        @_current_lock = nil
+      end
+    end
+
+    def _run_immutable(method, key: nil)
+      copy = dup
+      copy.instance_variable_set(:@context,         @context.dup)
+      copy.instance_variable_set(:@last_results,    [])
+      copy.instance_variable_set(:@with_attributes, nil)
+      copy.instance_variable_set(:@finish_with,     nil)
+      copy.send(:_run_method, method, key: key)
+    end
+
+    def _resume_method(method, key: nil)
+      @_current_lock   = nil
+      @_step_index     = @_execution_context.step_records.count
+      @_current_method = method.to_s
+
+      @_execution_context&.update!(status: "running")
+
+      begin
+        instance_eval(method.to_s)
+        @_execution_context&.update!(status: "completed")
+        _finish_result
+      rescue Odsl::LockError
+        raise
+      rescue
+        @_execution_context&.update!(status: "failed")
+        raise
+      ensure
+        @_current_lock&.unlock rescue nil
+        @_current_lock = nil
+      end
+    end
+
+    def _setup_context(method, key)
+      return nil unless key && defined?(Odsl::Audit::ExecutionContext)
+
+      ctx = Odsl::Audit::ExecutionContext.find_by(idempotency_key: key)
+
+      if ctx
+        return :already_completed if ctx.completed?
+        raise Odsl::AlreadyRunningError, "Job with key '#{key}' is already running" if ctx.running?
+      else
+        ttl = Odsl.config.audit_ttl
+        ctx = Odsl::Audit::ExecutionContext.create!(
+          idempotency_key: key,
+          service_class:   self.class.name,
+          method_name:     method.to_s,
+          kwargs:          JSON.generate(@kwargs),
+          status:          "pending",
+          expires_at:      ttl ? Time.now + ttl : nil
+        )
+      end
+
+      ctx.update!(status: "running")
+      ctx
+    end
 
-      instance_eval(method.to_s)
-      instance_variable_get "@#{@finish_with}"
+    def _finish_result
+      if @finish_with.is_a?(Array)
+        @finish_with.map { |variable| instance_variable_get("@#{variable}") }
+      else
+        instance_variable_get("@#{@finish_with}")
+      end
     end
   end
-end
+end

data/lib/odsl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Odsl
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/odsl.rb

@@ -1,2 +1,12 @@
-require 'odsl/version'
-require 'odsl/dsl'
+require "odsl/version"
+require "odsl/errors"
+require "odsl/configuration"
+require "odsl/adapters/base"
+require "odsl/adapters/thread"
+require "odsl/adapters/active_job"
+require "odsl/audit/serializer"
+require "odsl/audit/execution_context"
+require "odsl/audit/step_record"
+require "odsl/locking/lock_handle"
+require "odsl/dsl"
+require "odsl/railtie" if defined?(Rails::Railtie)

data/odsl.gemspec

@@ -1,44 +1,49 @@
-# frozen_string_literal: true
-
-require File.expand_path(
-  File.join('..', 'lib', 'odsl', 'version'),
-  __FILE__
-)
-
-Gem::Specification.new do |spec|
-  spec.name = "odsl"
-  spec.version = Odsl::VERSION
-  spec.authors = ["alejandro gurovich"]
-  spec.email = ["alejandro.gurovich@gmail.com"]
-
-  spec.summary = "DSL Approach to OOP and functional programming."
-  spec.description = "This is a prototype oriented to use OOP and a functional programming approach by providing a DSL to decouple code logic from coding itself while enforcing good practices and providing  - Design patterns
-  - Inmutability
-  - Dry off
-  - Decouple aspects from code ( background, paralelization )."
-  spec.homepage = "https://github.com/aleguro/ODSL."
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/aleguro/ODSL"
-  spec.metadata["changelog_uri"] = "https://github.com/aleguro/ODSL/blob/master/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "minitest", ">= 5.8"
-  spec.add_development_dependency "minitest-reporters", ">= 1.1"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end
+# frozen_string_literal: true
+
+require File.expand_path(
+  File.join('..', 'lib', 'odsl', 'version'),
+  __FILE__
+)
+
+Gem::Specification.new do |spec|
+  spec.name = "odsl"
+  spec.version = Odsl::VERSION
+  spec.authors = ["alejandro gurovich"]
+  spec.email = ["alejandro.gurovich@gmail.com"]
+
+  spec.summary = "DSL Approach to OOP and functional programming."
+  spec.description = "This is a prototype oriented to use OOP and a functional programming approach by providing a DSL to decouple code logic from coding itself while enforcing good practices and providing  - Design patterns
+  - Inmutability
+  - Dry off
+  - Decouple aspects from code ( background, paralelization )."
+  spec.homepage = "https://github.com/aleguro/ODSL"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"]          = spec.homepage
+  spec.metadata["source_code_uri"]       = "https://github.com/aleguro/ODSL"
+  spec.metadata["changelog_uri"]         = "https://github.com/aleguro/ODSL/blob/master/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = [] #spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "minitest", ">= 5.8"
+  spec.add_development_dependency "minitest-reporters", ">= 1.1"
+  spec.add_development_dependency "activerecord", ">= 7.0"
+  spec.add_development_dependency "sqlite3", ">= 1.7"
+  spec.add_development_dependency "redlock", ">= 1.3"
+  spec.add_development_dependency "railties", ">= 7.0"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: odsl
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - alejandro gurovich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-23 00:00:00.000000000 Z
+date: 2026-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -38,6 +38,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: redlock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
 description: |-
   This is a prototype oriented to use OOP and a functional programming approach by providing a DSL to decouple code logic from coding itself while enforcing good practices and providing  - Design patterns
     - Inmutability
@@ -51,26 +107,43 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- docs/superpowers/plans/2026-10-09-background-adapters-audit-locking.md
+- docs/superpowers/specs/2026-10-09-background-adapters-audit-design.md
+- lib/generators/odsl/install_generator.rb
+- lib/generators/odsl/templates/create_odsl_tables.rb.erb
+- lib/generators/odsl/templates/odsl_initializer.rb.erb
 - lib/odsl.rb
+- lib/odsl/adapters/active_job.rb
+- lib/odsl/adapters/base.rb
+- lib/odsl/adapters/odsl_job.rb
+- lib/odsl/adapters/thread.rb
+- lib/odsl/audit/execution_context.rb
+- lib/odsl/audit/serializer.rb
+- lib/odsl/audit/step_record.rb
 - lib/odsl/builder.rb
 - lib/odsl/configurable.rb
+- lib/odsl/configuration.rb
 - lib/odsl/dsl.rb
-- lib/odsl/error.rb
+- lib/odsl/errors.rb
+- lib/odsl/locking/lock_handle.rb
 - lib/odsl/methods.rb
+- lib/odsl/railtie.rb
 - lib/odsl/runners.rb
 - lib/odsl/version.rb
 - odsl.gemspec
 - sig/odsl.rbs
-homepage: https://github.com/aleguro/ODSL.
+homepage: https://github.com/aleguro/ODSL
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/aleguro/ODSL.
+  homepage_uri: https://github.com/aleguro/ODSL
   source_code_uri: https://github.com/aleguro/ODSL
   changelog_uri: https://github.com/aleguro/ODSL/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -79,14 +152,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: DSL Approach to OOP and functional programming.

data/lib/odsl/error.rb

@@ -1,4 +0,0 @@
-module Odsl
-  class Error < StandardError; end
-  end
-end