Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
P

promiscuous

> 编程语言
Open source

Replicate data across your applications

394 stars0 likes4 views
WebsiteGitHub

About

Replicate data across your applications

Promiscuous

Promiscuous is a pub-sub framework for easily replicating data across your Ruby applications. Promiscuous guarantees that a subscriber never sees out of order updates and that all updates are eventually replicated.

Benefits over database replication

  • Hetrogenous replication. e.g. replicate from Mongo -> Postgres | ElasticSearch | Redis ...
  • "Remote observers". The ability to observe model changes in one application from another.
  • Publish virtual attributes

Rails Quick Tutorial

1. Preparation

We need a few things for the promiscuous tutorial:

  • The AMQP broker RabbitMQ up and running.
  • The key-value storage system Redis (at least 2.6) up and running.
  • Two Rails applications with the promiscuous gem installed.
  • Both applications must be running on separate databases.
  • Both applications must have a User model (ActiveRecord or Mongoid) with two attributes name and email.

2. Publishing

By including the Promiscuous publisher mixin, we can publish the model attributes:

ruby
# app/models/user.rb on the publisher app
class User
  include Promiscuous::Publisher
  publish :name, :email
end

3. Subscribing

Similarly to the publisher app, we can subscribe to the attributes:

ruby
# app/models/user.rb on the subscriber app
class User
  include Promiscuous::Subscriber
  subscribe :name, :email

  after_create { Rails.logger.info "Hi #{name}!" }
end

4. Replication

The subscriber must listen for new data to arrive. Promiscuous has a worker that we can launch with the following command:

bundle exec promiscuous subscribe

You should start the subscriber first, otherwise the appropriate queues will not be created. From now on, you should see the queue in the RabbitMQ web admin page. Create a new user in the publisher's Rails console with:

ruby
User.create(:name => 'Yoda')`

You should see the message "Hi Yoda!" appearing in the log file of the subscriber.

Promiscuous in Depth

Features and Recipes

  • Attributes
  • Ephemerals & Observers
  • Polymorphism
  • Embedded Documents
  • Foreign Keys
  • Namespace Mapping
  • Promiscuous DSL

Configuration

  • Configuration Options
  • Subscriber CLI Options

Testing

  • Exporting Publishers Definitions
  • Unit Testing
  • Integration Testing
  • Gemify your Apps

Going to Production

  • RabbitMQ & Redis
  • Initial Sync
  • Error Handling
  • Instrumentation
  • Managing Deploys
  • Setup with Unicorn, Resque, etc.

Miscellaneous

  • Roadmap
  • Coding Restrictions
  • Limitations
  • FAQs
  • License

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Ruby

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言