Slayer: A Killer Service Layer

Gem Version Build Status Code Climate

Slayer is intended to operate as a minimal service layer for your ruby application. To achieve this, Slayer provides base classes for business logic.

Application Structure

Slayer provides 3 base classes for organizing your business logic: Forms, Commands, and Services. Each of these has a distinct role in your application's structure.


Slayer::Forms are objects for wrapping a set of data, usually to be passed as a parameter to a Command or Service.


Slayer::Commands are the bread and butter of your application's business logic. Commands are where you compose services, and perform one-off business logic tasks. In our applications, we usually create a single Command per Controller endpoint.

Commands should call Services, but Services should never call Commands.


Services are the building blocks of Commands, and encapsulate re-usable chunks of application logic.


Add this line to your application's Gemfile:

gem 'slayer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install slayer



Slayer Commands should implement call, which will pass or fail the service based on input. Commands return a Slayer::Result which has a predictable interface for determining success? or failure?, a message, and a result payload object.

# A Command that passes when given the string "foo"
# and fails if given anything else.
class FooCommand < Slayer::Command
  def call(foo:)
    if foo == "foo"
      pass! result: foo, message: "Passing FooCommand"
      fail! result: foo, message: "Failing FooCommand"

result = "foo")
result.success? # => true

result = "bar")
result.success? # => false



Slayer Services are objects that should implement re-usable pieces of application logic or common tasks. To prevent circular dependencies Services are required to declare which other Service classes they depend on. If a circular dependency is detected an error is raised.

In order to enforce the lack of circular dependencies, Service objects can only call other Services that are declared in their dependencies.

class NetworkService < Slayer::Service

class StripeService < Slayer::Service
  dependencies NetworkService

    ... "", body: my_payload)


After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to

To generate documentation run yard. To view undocumented files run yard stats --list-undoc.


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.