Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fnordfish/teckel
Ruby operations with enforced contracts for input/output/error data structures
https://github.com/fnordfish/teckel
interactors ruby service-objects
Last synced: about 2 months ago
JSON representation
Ruby operations with enforced contracts for input/output/error data structures
- Host: GitHub
- URL: https://github.com/fnordfish/teckel
- Owner: fnordfish
- License: apache-2.0
- Created: 2019-12-17T19:06:56.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-12-25T16:08:30.000Z (almost 3 years ago)
- Last Synced: 2024-07-19T22:27:54.793Z (3 months ago)
- Topics: interactors, ruby, service-objects
- Language: Ruby
- Homepage: https://fnordfish.github.io/teckel/
- Size: 2.11 MB
- Stars: 6
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Teckel
Ruby service classes with enforced[1](#footnote-1) input, output and error data structure definition.
[][gem]
[][ci]
[](https://codeclimate.com/github/fnordfish/teckel/maintainability)
[](https://codeclimate.com/github/fnordfish/teckel/test_coverage)
[][inch]
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'teckel'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install teckel
## Motivation
Working with [Interactor](https://github.com/collectiveidea/interactor), [Trailblazer's Operation](http://trailblazer.to/gems/operation) and [Dry-rb's Transaction](https://dry-rb.org/gems/dry-transaction) and probably a hand full of inconsistent "service objects", I missed a system that:
1. provides and enforces well defined input, output and error structures
2. makes chaining multiple operation easy and reliable
3. is easy to debug
## Usage
For a full overview please see the Docs:
* [Operations](https://fnordfish.github.io/teckel/operations/basics/)
* [Result Objects](https://fnordfish.github.io/teckel/operations/result_objects/)
* [Chains](https://fnordfish.github.io/teckel/chains/basics/)
```ruby
class CreateUser
include Teckel::Operation
# DSL style declaration
input Struct.new(:name, :age, keyword_init: true)
# Constant style declaration
Output = ::User
# Well, also Constant style, but using classic `class` notation
class Error
def initialize(message:, status_code:, meta:)
@message, @status_code, @meta = message, status_code, meta
end
attr_reader :message, :status_code, :meta
end
error_constructor :new
def call(input)
user = User.new(name: input.name, age: input.age)
if user.save
success!(user)
else
fail!(
message: "Could not create User",
status_code: 400,
meta: { validation: user.errors }
)
end
end
end
CreateUser.call(name: "Bob", age: 23) #=> #
CreateUser.call(name: "Bob", age: 5) #=> #[{:age=>"underage"}]}, @status_code=400>
```
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/fnordfish/teckel.
Feature requests should provide a detailed explanation of the missing or changed behavior, if possible including some sample code.
Please also see [DEVELOPMENT.md](DEVELOPMENT.md) for planned features and general guidelines.
## Footnotes
- 1: Obviously, it's still Ruby and you can cheat. Don’t! [↩](#footnote-1-source)
[gem]: https://rubygems.org/gems/teckel
[ci]: https://github.com/fnordfish/teckel/actions/workflows/specs.yml
[inch]: http://inch-ci.org/github/fnordfish/teckel