carrot_rpc 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f73f5b969d7493688ef3d27e5c25033da3ca1dbb
-  data.tar.gz: 6acc6663440edbc5656743c7f65e5a0504624d47
+  metadata.gz: 97329124a088c7a7628e5613ce2059874097a8db
+  data.tar.gz: 216bf02e2bf6e657c1a3938329069af10f6380c2
 SHA512:
-  metadata.gz: 89f7ba93bc81ebffc4a48e7b2bc5064d55e8221355ce0b82d478df387f5deab61e5889f7b0f2793c606b0cdebe5523dc2261db821a8a0f942bc630d990366a2e
-  data.tar.gz: 8a754d6fc92c81227e00a8be6d6ef8311a6ab2f2a15eedc57304517855c3fc0c0a64c12110eb309fc0c20e39f9478a91f5efd953b7d03b98c2d98995d1f3e948
+  metadata.gz: 8f6171315d5e230225a1062be1e46d97fe102f942407c0725c8331734137be6428598d675021ff808a2428009397c2beee07031632dbc0745bcb1c5fd7b70864
+  data.tar.gz: 4abfd002d0ea5d4b5c5704dac547c0076143c2dcfbbc3c46a7cf030b6105d275977ec95c649778ea08269aaae5b310b73cf00948257e8ac7a48951af76cb0aa3

data/CHANGELOG.md

@@ -47,6 +47,12 @@
 # Changelog
 All significant changes in the project are documented here.
 
+## v0.8.0
+### Enchancements
+* Don't assume that Bunny already has a connection to RabbitMQ.
+* Attempt to start Bunny for the servers
+* This allows the implementing application to decide when to start the connection when using a forking web server
+
 ## v0.7.1
 ### Bug Fixes
 * [#40](https://github.com/C-S-D/carrot_rpc/pull/41) - Deletes Queues immediately after the last consumer is unsubscribed. Reduces memory load. API remains the same. - [@shamil614](https://github.com/C-S-D/carrot_rpc/pull/34)

data/Gemfile

@@ -1,6 +1,6 @@
 source "https://rubygems.org"
 
-ruby "2.2.3"
+ruby "2.2.5"
 # Specify your gem's dependencies in carrot_rpc.gemspec
 gemspec
 

data/README.md

@@ -43,7 +43,7 @@ Or install it yourself as:
 ## Configuration
 There's two modes for CarrotRpc: server and client. The server is run via command line, and the client is run in your ruby application during the request / response lifecycle (like your Rails Controller).
 ### Server
-The server is configured via command line and run in it's own process.
+The server is configured via command line and run in it's own process. Note: the server process will attempt to start a connection with Bunny automatically.
 
 Carrot is easy to run via command line:
 ```bash
@@ -80,7 +80,7 @@ Clients are configured by initializing `CarrotRpc::Configuration`. The most comm
 CarrotRpc.configure do |config|
   # Required on the client to connect to RabbitMQ.
   # Bunny defaults to connecting to ENV['RABBITMQ_URL']. See Bunny docs.
-  config.bunny = Bunny.new.start
+  config.bunny = Bunny.new
   # Set the log level. Ruby Logger Docs http://ruby-doc.org/stdlib-2.2.0/libdoc/logger/rdoc/Logger.html
   config.loglevel = Logger::INFO
   # Create a new logger or use the Rails logger.
@@ -102,6 +102,45 @@ CarrotRpc.configure do |config|
 end
 ```
 
+Depending upon your webserver of choice you'll want to make sure that the conneciton to RabbitMQ via Bunny is made after the server Process forks because Bunny immediately threads after the `start()` method.
+
+Here's an example of how to do so with Puma.
+
+```ruby
+# config/puma.rb
+
+on_worker_boot do
+  CarrotRpc.configure do |config|
+    # Each worker should have it's own connection to RabbitMQ.
+    config.bunny = Bunny.new
+  end
+  CarrotRpc.connect
+end
+```
+
+Similarly with Sidekiq
+```ruby
+# config/initializers/sidekiq.rb
+
+Sidekiq.configure_server do |config|
+  CarrotRpc.connect
+end
+```
+
+If you want to run RpcClient in the rails console, you'll want to make a connection only on Rails console start.
+```ruby
+# config/application.rb
+
+module FooApplication
+  class Application < Rails::Application
+    # Only attempt to connect with Bunny in the console!!!
+    console do
+      CarrotRpc.connect
+    end
+  end
+end
+```
+
 ## Usage
 ### Writing Servers
 Carrot CLI will look for your servers in `app/servers` directory. This directory should not be autoloaded by the host application. Very important to declare the name of the queue with `queue_name`. The name must be the same as what's implemented in the `Client`.

data/lib/carrot_rpc/server_runner.rb

@@ -37,6 +37,8 @@ class CarrotRpc::ServerRunner
 
   # Start the servers and the run loop.
   def run!
+    CarrotRpc.connect
+
     signal.trap
 
     pid.check

data/lib/carrot_rpc/version.rb

@@ -1,3 +1,3 @@
 module CarrotRpc
-  VERSION = "0.7.1".freeze
+  VERSION = "0.8.0".freeze
 end

data/lib/carrot_rpc.rb

@@ -48,4 +48,11 @@ module CarrotRpc
   def self.configure
     yield configuration
   end
+
+  # Attempts to start a connection to the existing Bunny object.
+  # @return [Bunny::Session]
+  def self.connect
+    bunny = configuration.bunny
+    bunny.start unless bunny.open?
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carrot_rpc
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Scott Hamilton
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-18 00:00:00.000000000 Z
+date: 2016-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -195,7 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5.1
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Remote Procedure Call (RPC) using the Bunny Gem over RabbitMQ