iprog_base 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b5b60b075b0af0667872c51f4fe6cb8dc91751de5ff1805723af73d8c577b848
+  data.tar.gz: 85701bfd87a2b11762d56015c3555bbd44ff67486f0148276299ede50ca2fed5
+SHA512:
+  metadata.gz: 70a8f1191228a3a4ac1a0251ffbe03de1a4f2ed0244023e3e089526bf0254c95cdfb8d0ab13ecb6c324c361f9e243114cea11c6aba123af4d2f08a82494f5323
+  data.tar.gz: 55888ad8c028aa5ed20fa242291ab7565de3e51698dab25d92d0acc6324d31c5798a5ee119ba7c2ab4606df36ffb6f97a2109ad77f4142c6818099717d33bd30

data/lib/iprog/base.rb

@@ -0,0 +1,93 @@
+module Iprog
+   class Error < StandardError; end
+
+  # The core base class for command/service objects using the Template Method Pattern.
+  # Override `process_data`, `check_errors`, and other hooks to build reusable logic.
+  class Base
+    attr_writer :data
+    attr_reader :result, :errors, :params
+
+    def self.call(*args, **kwargs)
+      if kwargs.any?
+        new(**kwargs).call
+      elsif args.length == 1 && args.first.is_a?(Hash)
+        new(**args.first).call
+      else
+        raise ArgumentError, "❌ Expected keyword args or a single hash"
+      end
+    end
+
+    def initialize(**kwargs)
+      @params = kwargs.transform_keys(&:to_sym)
+      @data   = {}
+
+      set_params_data
+      set_static_data
+      extract_and_initialize_instance_variables
+    end
+
+    def call
+      check_errors
+      return self if errors?
+
+      process_data
+      send_result filtered_response
+    end
+
+    def process_data
+      {}
+    end
+
+    def filtered_response
+      filtered_fields.any? ? result_data.slice(*filtered_fields) : result_data
+    end
+
+    def filtered_fields
+      []
+    end
+
+    def check_errors
+      nil
+    end
+
+    def set(key, value)
+      result_data[key] = value
+    end
+
+    def result_data
+      @data
+    end
+
+    def set_params_data
+      {}
+    end
+
+    def set_static_data
+      {}
+    end
+
+    def extract_and_initialize_instance_variables
+      result_data.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+    end
+
+    def success?
+      errors.nil?
+    end
+
+    def errors?
+      !errors.nil?
+    end
+
+    def send_result(data)
+      @result = data || []
+      self
+    end
+
+    def send_error(data)
+      @errors = data || []
+      self
+    end
+  end
+end

data/lib/iprog/version.rb

@@ -0,0 +1,3 @@
+module Iprog
+  VERSION = "0.1.0"
+end

data/lib/iprog_base.rb

@@ -0,0 +1,2 @@
+require_relative "iprog/version"
+require_relative "iprog/base"

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: iprog_base
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jayson Presto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Provides a reusable, extensible base class for service or command objects
+  in Ruby applications, following the Template Method Pattern. Includes lifecycle
+  hooks for parameter handling, static data setup, error checking, data processing,
+  and response filtering. Designed for clean, maintainable, and testable business
+  logic.
+email:
+- jaysonpresto.iprog21@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/iprog/base.rb
+- lib/iprog/version.rb
+- lib/iprog_base.rb
+homepage: https://iprogtech.com/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://iprogtech.com/
+  source_code_uri: https://github.com/iprog21/iprog_base.git
+  changelog_uri: https://github.com/iprog21/iprog_base/blob/master/CHANGELOG.md
+  code_of_conduct_uri: https://github.com/iprog21/iprog_base/blob/main/CODE_OF_CONDUCT.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.0
+specification_version: 4
+summary: Base service/command class using the Template Method Pattern.
+test_files: []