Rsodx

rsodx is a minimal, modular framework for building fast and maintainable Ruby microservices.
Inspired by the best of Rails, Sinatra, and Sequel — it gives you just enough structure to scale, without the overhead.

No magic. Just clean code and powerful tools.

$ rsodx new my_rail_company
🛤️  Initializing Transport Empire...
📦 Creating folders...
✅ Done! Start building your microservice railway!

• Micro-first — focus on small, single-purpose services
• Explicit over implicit — no hidden behavior, no global state
• Modular by design — include only what you need
• Ruby-native — use familiar patterns, no learning curve
• Production-oriented — simple to develop, easy to deploy

✅ rsodx includes routing, interactors, validation, and service structure —
all wrapped into a fast and lightweight toolkit made for modern Ruby apps.

gem 'rsodx', github: 'eugene-ruby/rsodx'

You can install the gem directly from RubyGems.org after release:

bundle add rsodx

gem install rsodx

rsodx ships with a powerful and lightweight CLI tool for generating services and scaffolding applications.

You can run CLI commands via:

bin/rsodx [command] [args]

Конечно! Вот секция для README.md на английском — про команды db:migrate и db:rollback:

The rsodx CLI provides simple tools for running Sequel migrations:

Runs all pending migrations in db/migrations.

bin/rsodx db:migrate

• Automatically creates the schema_migrations table if it doesn't exist.
• Supports timestamped migrations (e.g. 20250417061127_create_users.rb).
• Prints a success message on completion.

Rolls back the last executed migration.

bin/rsodx db:rollback

• Determines the current version from the schema_migrations table.
• Rolls back to the previous migration based on timestamp.
• Skips rollback if only one migration is applied.

Generate various application components using simple commands:

bin/rsodx generate controller v1/users/index
bin/rsodx generate presenter v1/users/index
bin/rsodx generate serializer v1/users/index

Or using aliases:

bin/rsodx g controller v1/users/index

To generate all three at once (controller, presenter, serializer):

bin/rsodx g action v1/users/index

This creates:

• app/controllers/v1/users/index_controller.rb
• app/presenters/v1/users/index_presenter.rb
• app/serializers/v1/users/index_serializer.rb

Create a full Rsodx project with:

bin/rsodx new my_app

Or using alias:

bin/rsodx n my_app

This will create a new directory my_app with:

• Gemfile, .env, .ruby-version
• config.ru, Rakefile, environment loader
• app/ structure (controllers, services, etc.)
• bin/console and bin/rsodx CLI entrypoints

It will be immediately runnable:

cd my_app
bundle install
bin/rsodx server

Run a local Rack-based Puma server:

bin/rsodx server

Available options:

• --port=PORT – default: 9292
• --env=ENV – default: development

Example:

bin/rsodx server --port=3000 --env=production

This command launches Puma via rackup:

pid = spawn("bundle exec rackup --port=#{port} --host=0.0.0.0")
Process.wait(pid)

It ensures that your config.ru is used correctly and delegates the full startup to Rack.

my_app/
├── app/
│   ├── controllers/
│   ├── presenters/
│   ├── serializers/
│   ├── services/
├── bin/
│   ├── console
│   └── rsodx
├── config/
│   ├── environment.rb
│   └── environments/
├── db/
│   └── migrations/
├── spec/
├── config.ru
├── .env
├── Gemfile
└── Rakefile

Your application connects to PostgreSQL using the DATABASE_URL defined in .env:

DATABASE_URL=postgres://rsodx:paSs4321@localhost:5432/rsodx_development

1. Open your terminal and run the PostgreSQL client:

psql -U postgres

2. Then, execute the following SQL commands:

-- Create the user
CREATE USER rsodx WITH PASSWORD 'paSs4321';

-- Create the database
CREATE DATABASE rsodx_development;

-- Grant privileges
GRANT ALL PRIVILEGES ON DATABASE rsodx_development TO rsodx;

📍 If your system uses a different PostgreSQL superuser, adjust -U postgres accordingly.

You can test the connection:

psql postgres://rsodx:paSs4321@localhost:5432/rsodx_development

If it connects successfully, your database is ready for development!

class Router < Rsodx::Router
  namespace "/v1" do
    post "/users", V1::Users::Create
  end
end

You can define your own DB.connect logic and use built-in tasks:

# config/environment.rb
require "rsodx"
require "rsodx/db"
Rsodx::DB.connect

rake db:migrate

rake db:rollback

bin/console

Inside IRB:

reload!  # reload environment
CreateUser.call(params: {...})

Planned features and improvements for upcoming versions of rsodx.

• ✅ Add RabbitMQ support for event-driven microservices
  • CLI: rsodx g subscriber user/created
  • DSL: on_event "user.created", with: HandleUserCreated

• ✅ Dockerfile and docker-compose.yml templates
• PostgreSQL, RabbitMQ, App

• rsodx g worker fetch_data
• rsodx g subscriber event_name
• CLI flags: --dry-run, --force, --skip
• Generate test stubs with each component

• Auto-discovery of config.ru or App class
• rsodx server --daemon, --log

• Auto-generate OpenAPI / Swagger docs from declared routes and schemas
• DRY validation + schema → Swagger with types and examples
• rsodx g docs or rsodx docs generate

• rsodx console (IRB + app preload)
• rsodx doctor for environment diagnostics
• Starter project templates (--template=api, --template=evented)

If you’d like to contribute or suggest new features — feel free to open an issue or PR. Let’s make rsodx fast, lean and production-ready together! ❤️

MIT — created by Eugene Pervushin