servactory

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 36 Open GitHub ↗

Powerful Service Object for Ruby applications

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A set of tools for building reliable services of any complexity.

## 📚 Documentation

See [servactory.com](https://servactory.com) for comprehensive documentation, including:

- Detailed guides for all features
- Advanced configuration options
- Best practices and patterns
- Migration guides
- API reference

## 💡 Why Servactory?

Building reliable services shouldn't be complicated. Servactory provides a battle-tested framework for creating service objects with:

- 🛡️ **Type Safety** - Enforce types on inputs and outputs, catch errors early
- ✅ **Built-in Validation** - Rich validation DSL with custom rules
- 🧪 **Test-Friendly** - RSpec matchers and service mocking helpers
- 📊 **Structured Output** - Consistent Result object pattern
- 🔧 **Highly Configurable** - Extensions, helpers, and custom options
- 📚 **Well Documented** - Comprehensive guides and examples

## 🚀 Quick Start

### Installation

```ruby
gem "servactory"
```

### Define service

```ruby
class Users::Authenticate < Servactory::Base
 input :email, type: String
 input :password, type: String

output :user, type: User

make :authenticate!

private

def authenticate!
    if (user = User.authenticate_by(email: inputs.email, password: inputs.password)).present?
      outputs.user = user
    else
      fail!(message: "Authentication failed", meta: { email: inputs.email })
    end
  end
end
```

### Usage in controller

```ruby
class SessionsController < ApplicationController
 def create
 service = Users::Authenticate.call(**session_params)

if service.success?
      session[:current_user_id] = service.user.id
      redirect_to service.user
    else
      flash.now[:alert] = service.error.message
      render :new, status: :unprocessable_entity
    end
  end

private

def session_params
    params.require(:session).permit(:email, :password)
  end
end
```

## 🧩 Ecosystem

- [**Stroma**](https://github.com/servactory/stroma) — A foundation for building modular, extensible DSLs in Ruby
- [**OpenTelemetry Instrumentation**](https://github.com/servactory/opentelemetry-instrumentation-servactory) — Automatic tracing of service calls and actions with span attributes and failure detection

## 🤝 Contributing

We love contributions! Check out our [Contributing Guide](https://servactory.com/CONTRIBUTING) to get started.

**Ways to contribute:**
- 🐛 Report bugs and issues
- 💡 Suggest new features
- 📝 Improve documentation
- 🧪 Add test cases
- 🔧 Submit pull requests

## 🙏 Acknowledgments

Special thanks to all our [contributors](https://github.com/servactory/servactory/graphs/contributors)!

## 📄 License

Servactory is available as open source under the terms of the [MIT License](./LICENSE).

servactory

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README