SmartCore::Operation ·

Smart implementation of the most-used programming pattern - Service Object. Powered by smart_injection, smart_container, smart_types and smart_initializer.

previous generation: https://github.com/0exp/smart_core

---

Main features

• multifunctional constructor DSL (powerd by smart_initializer and smart_types);
• result object interface (Success, Failure, Fatal, Callback);
• call.new.call invocation behavior;
• support for dependency injection (powered by smart_injection and smart_container);

---

Installation

gem 'smart_operation'

bundle install
# --- or ---
gem install smart_types

require 'smart_core/operation'

---

Synopsis

class CreateUser < SmartCore::Operation
  register_container(ReposContainer)

  import({ user_repo: 'business.users' }, access: :private)

  option :name, 'value.string'
  option :password, 'value.string'
  option :age, 'value.integer'

  def call
    user = user_repo.create({ name: name, password: password, age: age })
    Success(user: user) # or Callback { puts 'wow o.O' }
  end
end

CreateUser.call(name: 'Rustam', password: 'test123', age: 28) do |result|
  result.success?  { puts 'success!' }
  result.failure?  { puts 'failure!' }
  result.fatal?    { puts 'fatal!' }
  result.callback? { result.call } # or some_object.instance_eval(&result.callback)
end

Pre-requisits:

class UserRepo
  def create(user_creds)
     # ... some code
  end
end

ReposContainer = SmartCore::Container.define do
  namespace(:business) do
    register(:users) { UserRepo.new }
  end
end

---

Roadmap

• pattern matching for result objects (Success, Failure, Fatal, Callback);
• migrate to Github Actions;

---

Build

• run tests:

bundle exec rspec

• run code style checks:

bundle exec rubocop

• run code style checks with auto-correction:

bundle exec rubocop -A

---

Contributing

• Fork it ( https://github.com/smart-rb/smart_operation )
• Create your feature branch (git checkout -b feature/my-new-feature)
• Commit your changes (git commit -am '[feature_context] Add some feature')
• Push to the branch (git push origin feature/my-new-feature)
• Create new Pull Request

License

Released under MIT License.

Authors

Rustam Ibragimov