Dep-inject is a simple Ruby gem that allows for clean and flexible dependency injection in Ruby classes. It provides a constructor method (build) and enforces a single public method (execute) to encourage well-structured use cases and services. The gem raises errors if other public methods are defined, ensuring that classes stay focused on a single responsibility. By injecting dependencies, the design becomes more flexible and maintainable, allowing for easier updates and replacements of components.
- Dependency Injection: Easily inject dependencies such as repositories, service objects, etc.
- Enforced Interface: Ensures that only the
executemethod is public. - Error Handling: Raises specific errors when expected conventions are not followed.
Add this line to your application's Gemfile:
gem 'dep-inject'Then bundle install
To use DepInject, include the module in your class, specify your dependencies, and define the execution method. DepInject will handle the injection of the specified dependencies and enforce that only a valid execution method is exposed as a public method. The execution or trigger methods are execute and call, use one or the other in your class.
Dependencies can be any class or object. DepInject will initialize and inject them into your use case at runtime. The dependencies are injected as instance variables with the same name as the keys passed in provide.
class MockLogger
def log(message)
"Logged: #{message}"
end
end
class MockTaskManager
def create_task(name)
"Task #{name} created"
end
end
require 'dep_inject'
class TaskUseCase
include DepInject
provide(
logger: MockLogger,
task_manager: MockTaskManager
)
def execute(task_name)
task = @task_manager.create_task(task_name)
@logger.log("Executing #{task}")
end
end
# Instantiate using constructor method and execute
usecase = TaskUseCase.build
usecase.execute("Test Task")This project is intended to be a welcoming space for contribution. Pull requests are welcome.
The gem is available as open source under the terms of the MIT License.