facio 0.1.11

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5f58925ad262f641e798bae5733d68b32ec51b1501386c9feced448901e8e551
+  data.tar.gz: c4c7e9d879b8c61783435acdaf60eb0c6c6c6aef56b115637c2173e8b8417a4d
+SHA512:
+  metadata.gz: 40fae9340200e51cfbaab3543dd41cc5eb0e7909d41273eee70f5249f1cb3a505f6c3b9faa81092b780bc826569291e55357fc384abda2d5450c663e1dfaeb49
+  data.tar.gz: 1a89e4752315ca730bf34bcb3f6644360f66b103f4ad85edf3e3b1e9dee588abbfbe0fac4d9ba19b72550853a79c7a376bc77c82e74c63f690777062586d1eca

data/.rubocop.yml

@@ -0,0 +1,14 @@
+# https://www.fastruby.io/blog/ruby/code-quality/how-we-use-rubocop-and-standardrb.html
+require:
+  - standard
+
+inherit_gem:
+  standard: config/base.yml
+
+AllCops:
+  TargetRubyVersion: 3.3
+  NewCops: enable
+  Exclude:
+    - node_modules/**/*
+    - public/**/*
+    - vendor/**/*

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2024-05-16
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,84 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at tom@degrunt.nl. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
+available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Tom de Grunt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,143 @@
+# Facio
+
+Command pattern for Ruby (on Rails). From Wikipedia:
+
+> In object-oriented programming, the command pattern is a behavioral design pattern in which an object is used to encapsulate all information needed to perform an action or trigger an event at a later time. This information includes the method name, the object that owns the method and values for the method parameters.
+
+It basically allows you to encapsulate bits of code for a specific purpose. It's also nicely explained by [refactoring.guru](https://refactoring.guru/design-patterns/command)
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add facio
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install facio
+
+## Generator
+
+Facio comes with a handy generator to generate a service and context:
+
+```shell
+rails g facio:service module/my_service
+```
+
+this will do the following:
+
+```
+create  app/services/module/my_service_service.rb
+create  app/services/module/my_service_context.rb
+create  test/services/module/my_service_test.rb
+```
+
+## Usage
+
+### Service
+
+Every service has a context, which encapsulates all the information to perform the action. The perform method on the service should be your main point of entry.
+
+```ruby
+# simple_service.rb
+class SimpleService < Facio::Service
+  context do
+    attribute :value
+    attribute :result
+  end
+  def perform
+    context.result = context.value.to_s.reverse
+  end
+end
+
+# You can perform the service as follows:
+SimpleService.perform(value: "no lemon, no melon").result 
+# => "nolem on ,nomel on"
+```
+
+You can also have the service perform at a later time:
+```ruby
+# later_service.rb
+class LaterService < Facio::Service
+  context do
+    attribute :message
+    attribute :result
+  end
+  def perform
+    context.message.text.reverse
+    context.message.save!
+  end
+end
+
+# This will perform the service at a later time:
+SimpleService.perform_later(message: Message.find(1))
+```
+In this case, once the service is done, you should see the Message's text being reversed.
+
+Services are subclasses of ActiveJob::Base, which basically gives you things like concurrency control and retry logic.
+
+### Context
+
+A context is just an PORO, which includes the ActiveModel::API, which includes validation. You can add validation to the context, 
+Facio will check the validity of the context before performing the service. Context can be created in separate files, but also inline in the service. 
+
+It has some useful extra's allowing for associations (has_one/has_many), it also has a type caster for models, so that you can pass the id or the model itself into an attribute.
+
+Using context like below (inline) will then construct a Class, with Facio::Context as a base_class. You can also use external context classes and refer to the in the inline class using the base_class.
+```ruby
+# some_context.rb
+class SomeContext < Facio::Context
+  attribute :special
+end
+
+# simple_service.rb
+class OtherService < Facio::Service
+  context base_class: "SomeContext" do
+    attribute :value
+    attribute :result
+  end
+  def perform
+    context.result = context.value.to_s.reverse
+    context.result += "special" if context.special.present?
+  end
+end
+```
+
+Next to this, you can have your service-class be accompanied by a context-class, if that's your preference. The service will find the matching context:
+
+```ruby
+# fancy_context.rb
+class FancyContext < Facio::Context
+  attribute :fancy
+end
+
+# fancy_service.rb
+class FancyService < Facio::Service
+  def perform
+    context.result = context.fancy.to_s.reverse
+  end
+end
+```
+
+### Result
+
+When the context model includes a result attribute, you can (and should) use that to return the outcome of the service. Facio will set it to the last value of the perform if you don't. Additionally, when the return value is more complex, or you need validation on the return, you can use the result object. This works as follows:
+
+```ruby
+class InlineResultService < Facio::Service
+  context do
+    attribute :value
+  end
+  result do
+    attribute :text
+  end
+  def perform
+    result.text = context.value.to_s.reverse
+  end
+end
+
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/facio.gemspec

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative "lib/facio/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "facio"
+  spec.version = Facio::VERSION
+  spec.authors = ["Tom de Grunt"]
+  spec.email = ["tom@degrunt.nl"]
+
+  spec.summary = "Command pattern"
+  spec.description = "Command pattern for Ruby"
+  spec.homepage = "https://github.com/entdec/facio"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/entdec/facio"
+
+  # 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 .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  rails_deps_version = "> 7"
+
+  # Uncomment to register a new dependency of your gem
+  spec.add_dependency "actionpack", rails_deps_version
+  spec.add_dependency "activemodel", rails_deps_version
+  spec.add_dependency "activejob", rails_deps_version
+  spec.add_dependency "activesupport", rails_deps_version
+  spec.add_dependency "railties", rails_deps_version
+
+  spec.add_development_dependency "activerecord", rails_deps_version
+  spec.add_development_dependency "globalid", "~> 1.2"
+  spec.add_development_dependency "debug", "~> 1.9"
+  spec.add_development_dependency "rubocop", "~> 1"
+  spec.add_development_dependency "standard", "~> 1"
+  spec.add_development_dependency "sqlite3", "~> 1.4"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/lib/facio/active_model/associations.rb

@@ -0,0 +1,51 @@
+
+module ActiveModel
+  module Associations
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def has_one(association_id, options = {})
+        class_name = options[:class_name] || association_id.to_s.classify
+
+        define_method(association_id) do
+          instance_variable_get("@#{association_id}") || begin
+            instance_variable_set("@#{association_id}", class_name.constantize.new)
+          end
+        end
+
+        define_method("#{association_id}=") do |new_value|
+          instance_variable_set("@#{association_id}", new_value)
+        end
+      end
+
+      def has_many(association_id, options = {})
+        class_name = options[:class_name] || association_id.to_s.singularize.classify
+        klass = class_name.constantize
+
+        define_method(association_id) do
+          instance_variable_get("@#{association_id}") || begin
+            instance_variable_set("@#{association_id}", [])
+          end
+        end
+
+        # Assignment using models
+        define_method("#{association_id}=") do |attributes|
+          instance_variable_set("@#{association_id}", attributes)
+        end
+
+        # Assignment using attributes, e.g. from a form
+        define_method("#{association_id}_attributes=") do |attributes|
+          if attributes.is_a?(Hash) || attributes.is_a?(ActionController::Parameters)
+            # Reject any attributes that have the are a non-numeric key, e.g. things like "TEMPLATE"
+            attributes = attributes.reject { |k, v| k.to_i.to_s != k }.values
+            # Reject any attributes that have the _destroy flag set
+            attributes = attributes.reject { |v| v["_destroy"] == "1" || v[:_destroy] == "1" }
+            attributes = attributes.map { |params| klass.new(params) }
+
+            instance_variable_set("@#{association_id}", attributes)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/facio/active_model/type/model.rb

@@ -0,0 +1,24 @@
+module ActiveModel
+  module Type
+    class Model < ActiveModel::Type::Value
+      attr_reader :class_name
+      def initialize(**options)
+        @class_name = options.delete(:class_name)
+        super()
+      end
+
+      def cast(value)
+        return nil if value.nil?
+
+        klass = class_name.constantize
+        if value.is_a?(::Integer) || value.is_a?(::String)
+          klass.find(value)
+        elsif value.is_a?(klass)
+          value
+        end
+      end
+    end
+  end
+end
+
+ActiveModel::Type.register(:model, ActiveModel::Type::Model)

data/lib/facio/base_model.rb

@@ -0,0 +1,9 @@
+module Facio
+  class BaseModel
+    include ActiveModel::API
+    include ActiveModel::Serializers::JSON
+    include ActiveModel::Associations
+    include ActiveModel::Attributes
+    include ActiveModel::Validations
+  end
+end

data/lib/facio/concerns/callbacks.rb

@@ -0,0 +1,37 @@
+module Callbacks
+  extend ActiveSupport::Concern
+
+  included do
+    around_perform do |job, block|
+      @context = self.class.context_class.new(arguments.first)
+      @result = self.class.result_class&.new
+      @performed = false
+
+      if @context.valid?
+        result = nil
+        if transactional && defined?(ActiveRecord::Base)
+          ActiveRecord::Base.transaction(requires_new: true) do
+            result = block.call
+            # This will only rollback the changes of the service, SILENTLY, however the context will be failed? already.
+            # This is the most close to expected behaviour this can get.
+            raise ActiveRecord::Rollback if context.failed?
+          end
+
+        else
+          result = block.call
+        end
+
+        @performed = true
+        # Purely as a convenience, but also to enforce a standard
+        context.result ||= result if @result.nil?
+      end
+      # self
+    end
+
+    before_enqueue do |job|
+      @performed = false
+      @context = self.class.context_class.new(arguments.first)
+      @result = self.class.result_class&.new
+    end
+  end
+end

data/lib/facio/concerns/execution.rb

@@ -0,0 +1,21 @@
+module Execution
+  extend ActiveSupport::Concern
+
+  def facio_perform_with_arguments(*args)
+    facio_perform_without_arguments
+  end
+
+  included do
+    if self < ActiveJob::Base
+      def self.method_added(method_name)
+        if method_name == :perform
+          # Avoid reentrance
+          unless method_defined?(:facio_perform_without_arguments)
+            alias_method :facio_perform_without_arguments, :perform
+            alias_method :perform, :facio_perform_with_arguments # This invokes method_added(:perform)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/facio/concerns/service_context.rb

@@ -0,0 +1,46 @@
+module ServiceContext
+  extend ActiveSupport::Concern
+
+  included do
+    attr_accessor :context
+  end
+
+  class_methods do
+    # Allows you to define the context of the service inline:
+    #
+    # context do
+    #   attr_accessor :value
+    # end
+    #
+    # Under normal circumstances the context class is subclassed from Facio::Context, but if you want to override
+    # this behaviour you can pass a base_class as an argument.
+    #
+    def context(base_class: context_base_class, &)
+      # This is to be able to define the context class in a sensible module name
+      module_obj = derived_context_name.deconstantize.present? ? derived_context_name.deconstantize.safe_constantize : Object
+      @context_class = module_obj.const_set(derived_context_name.demodulize, Class.new(base_class))
+      @context_class.instance_exec(&)
+    end
+
+    # Allows you to define the context class name for this service, when it's different than the default.
+    def context_class_name(name = nil)
+      @context_class_name = name if name
+      @context_class_name || derived_context_name
+    end
+
+    # Helpers
+
+    def context_base_class
+      defined?(ApplicationContext) ? ApplicationContext : Facio::Context
+    end
+
+    def context_class
+      @context_class || context_class_name.safe_constantize
+    end
+
+    def derived_context_name
+      name = self.name
+      name.gsub(/Service\z/, "Context")
+    end
+  end
+end

data/lib/facio/concerns/service_result.rb

@@ -0,0 +1,42 @@
+module ServiceResult
+  extend ActiveSupport::Concern
+
+  class_methods do
+    # Allows you to define the result of the service inline:
+    #
+    # result do
+    #   attr_accessor :value
+    # end
+    #
+    # Under normal circumstances the result class is subclassed from Facio::Result, but if you want to override
+    # this behaviour you can pass a base_class as an argument.
+    #
+    def result(base_class: result_base_class, &)
+      mdl = derived_context_name.deconstantize.present? ? derived_context_name.deconstantize.safe_constantize : Object
+      @result_class = mdl.const_set(derived_result_name.demodulize, Class.new(base_class))
+      @result_class.instance_exec(&)
+    end
+
+    # Allows you to define the result class name for this service, when it's different than the default.
+    def result_class_name(name = nil)
+      @result_class_name = name if name
+      @result_class_name || derived_result_name
+    end
+
+    # Helpers
+
+    def result_base_class
+      # FIXME: This doesn't work sadly
+      Object.const_defined?("ApplicationResult") ? Object.const_get("ApplicationResult") : Facio::Result
+    end
+
+    def result_class
+      @result_class || result_class_name.safe_constantize
+    end
+
+    def derived_result_name
+      name = self.name
+      name.gsub(/Service\z/, "Result")
+    end
+  end
+end

data/lib/facio/concerns/transactional.rb

@@ -0,0 +1,27 @@
+module Transactional
+  extend ActiveSupport::Concern
+
+  included do
+    delegate :transactional, to: :class
+  end
+
+  class_methods do
+    # Allows you to define whether the service should be transactional or not.
+    # Setting this to true will run the complete perform method in a transaction.
+    #
+    # If you do not define this, it will default to false, unless a superclass
+    # defines it as true.
+    def transactional(value = nil)
+      @transactional = value if value
+      @transactional = nil unless defined?(@transactional)
+      if @transactional.nil?
+        @transactional = if superclass < Facio::Service
+          superclass.transactional
+        else
+          false
+        end
+      end
+      @transactional
+    end
+  end
+end

data/lib/facio/concerns/translations.rb

@@ -0,0 +1,21 @@
+module Translations
+  extend ActiveSupport::Concern
+
+  included do
+    def t(key, passed_options = {})
+      @service_scope ||= nil
+
+      unless @service_scope.present?
+        parts = (is_a?(Class) ? self : self.class).to_s.underscore.tr("/", ".").split(".")
+        parts[-1] = "#{parts.last.gsub("_service", "").pluralize}.service" if parts.last.end_with?("_service")
+        parts[-1] = "#{parts.last.gsub("_context", "").pluralize}.context" if parts.last.end_with?("_context")
+        @service_scope = parts.compact.join(".")
+      end
+
+      options = {scope: @service_scope}
+      options[:default] = ::I18n.t(key) unless key.start_with?(".")
+
+      ::I18n.t(key, **options.merge(passed_options))
+    end
+  end
+end

data/lib/facio/context.rb

@@ -0,0 +1,25 @@
+module Facio
+  class Context < BaseModel
+    attribute :result
+
+    def fail!(attr = nil, message = :invalid, options = {})
+      @success = false
+      merge_errors!(attr, message, options)
+      raise Facio::ContextFailure, self
+    end
+
+    private
+
+    def merge_errors!(attr, message = :invalid, options = {})
+      return unless attr
+
+      if attr.is_a? String
+        errors.add(:base, attr)
+      elsif attr.is_a? ActiveModel::Errors
+        errors.merge!(attr)
+      elsif attr.is_a? Symbol
+        errors.add(attr, message, **options)
+      end
+    end
+  end
+end

data/lib/facio/context_failure.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Facio
+  class ContextFailure < Facio::Error
+    attr_reader :context
+
+    def initialize(context)
+      @context = context
+      super(context.errors.full_messages.join(", "))
+    end
+  end
+end

data/lib/facio/error.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Facio
+  class Error < StandardError
+  end
+end

data/lib/facio/result.rb

@@ -0,0 +1,4 @@
+module Facio
+  class Result < BaseModel
+  end
+end

data/lib/facio/service.rb

@@ -0,0 +1,57 @@
+require_relative "concerns/service_context"
+require_relative "concerns/service_result"
+require_relative "concerns/transactional"
+require_relative "concerns/translations"
+require_relative "concerns/callbacks"
+require_relative "concerns/execution"
+
+module Facio
+  class Service < ActiveJob::Base
+    include ServiceContext
+    include ServiceResult
+    include Transactional
+    include Translations
+    include Callbacks
+    include Execution
+
+    class << self
+      def perform(...)
+        job = job_or_instantiate(...)
+        job.perform_now
+        job
+      end
+
+      alias_method :perform_now, :perform
+    end
+
+    # Returns the result, be it the result object or the context object
+    def result
+      @result || context.result
+    end
+
+    # Returns the errors on the context object
+    delegate :errors, to: :@context
+
+    # Returns whether the context is valid
+    delegate :valid?, to: :@context
+    # Returns whether the coentext is invalid
+    delegate :invalid?, to: :@context
+
+    # Returns whether the service has been performed (only when using perform)
+    def performed?
+      @performed
+    end
+
+    # Returns whether the service was successfully performed
+    def success?
+      success = performed? && valid?
+      success &&= @result.valid? if @result
+      success
+    end
+
+    # Returns whether the service failed to perform
+    def failed?
+      !success?
+    end
+  end
+end

data/lib/facio/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Facio
+  VERSION = "0.1.11"
+end

data/lib/facio.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "active_job"
+require "active_model"
+require "active_support"
+require "action_controller"
+
+require_relative "facio/version"
+require_relative "facio/active_model/associations"
+require_relative "facio/active_model/type/model"
+require_relative "facio/base_model"
+require_relative "facio/error"
+require_relative "facio/context"
+require_relative "facio/context_failure"
+require_relative "facio/result"
+require_relative "facio/service"
+
+module Facio
+  class Error < StandardError; end
+  # Your code goes here...
+end

data/lib/generators/facio/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Generates a service and context
+
+Example:
+    rails g facio:service thing
+
+    This will create:
+        app/services/your_service.rb
+        app/services/your_context.rb

data/lib/generators/facio/service_generator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Facio
+  class ServiceGenerator < ::Rails::Generators::NamedBase
+    desc "Generates a service and context"
+
+    source_root File.expand_path("templates", __dir__)
+
+    def copy_initializer_file
+      template "service.rb", "app/services/#{name}_service.rb"
+      template "context.rb", "app/services/#{name}_context.rb"
+      template "service_test.rb", "test/services/#{name}_service_test.rb"
+    end
+  end
+end

data/lib/generators/facio/templates/context.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class <%= name.camelize %>Context < ApplicationContext
+  attribute :some, type: String, default: 'new'
+
+  validates :some, presence: true
+
+  before_validation do
+  end
+
+  after_validation do
+  end
+end

data/lib/generators/facio/templates/service.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class <%= name.camelize %>Service < ApplicationService
+  before_perform do
+  end
+
+  after_perform do
+  end
+
+  def perform
+    context.some.reverse!
+  end
+end

data/lib/generators/facio/templates/service_test.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class <%= name.camelize %>ServiceTest < ActiveSupport::TestCase
+  test 'service context result is success' do
+    context = <%=name.camelize%>Service.perform(some: 'some')
+    assert context.success?
+    assert_equal 'emos', context.some
+  end
+end

data/sig/mando.rbs

@@ -0,0 +1,4 @@
+module Facio
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,228 @@
+--- !ruby/object:Gem::Specification
+name: facio
+version: !ruby/object:Gem::Version
+  version: 0.1.11
+platform: ruby
+authors:
+- Tom de Grunt
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-11-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: globalid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: Command pattern for Ruby
+email:
+- tom@degrunt.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- facio.gemspec
+- lib/facio.rb
+- lib/facio/active_model/associations.rb
+- lib/facio/active_model/type/model.rb
+- lib/facio/base_model.rb
+- lib/facio/concerns/callbacks.rb
+- lib/facio/concerns/execution.rb
+- lib/facio/concerns/service_context.rb
+- lib/facio/concerns/service_result.rb
+- lib/facio/concerns/transactional.rb
+- lib/facio/concerns/translations.rb
+- lib/facio/context.rb
+- lib/facio/context_failure.rb
+- lib/facio/error.rb
+- lib/facio/result.rb
+- lib/facio/service.rb
+- lib/facio/version.rb
+- lib/generators/facio/USAGE
+- lib/generators/facio/service_generator.rb
+- lib/generators/facio/templates/context.rb
+- lib/generators/facio/templates/service.rb
+- lib/generators/facio/templates/service_test.rb
+- sig/mando.rbs
+homepage: https://github.com/entdec/facio
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/entdec/facio
+  source_code_uri: https://github.com/entdec/facio
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Command pattern
+test_files: []