Permalink
Browse files

Version 0.3.1

  • Loading branch information...
1 parent 06835ec commit 910fcceae38616ec37afa9c2eb37a0c05c379fe8 @jyurek jyurek committed Sep 21, 2012
Showing with 31 additions and 1 deletion.
  1. +6 −0 NEWS.md
  2. +24 −0 README.md
  3. +1 −1 lib/cocaine/version.rb
View
@@ -1,3 +1,9 @@
+New for 0.3.1:
+
+* Made the `Runner` manually swappable, in case `ProcessRunner` doesn't work
+ for some reason.
+* Fixed copyright years.
+
New for 0.3.0:
* Support blank arguments.
View
@@ -125,6 +125,30 @@ processes. For applications with large heaps the gain can be
significant. To include `posix-spawn`, simply add it to your `Gemfile` or,
if you don't use bundler, install the gem.
+## Runners
+
+Cocaine will attempt to choose from among 3 different ways of running commands.
+The simplest is using backticks, and is the default in 1.8. In Ruby 1.9, it
+will attempt to use `Process.spawn`. And, as mentioned above, if the
+`posix-spawn` gem is installed, it will attempt to use that. If for some reason
+one of the `.spawn` runners don't work for you, you can override them manually
+by setting a new runner, like so:
+
+```ruby
+Cocaine::CommandLine.runner = Cocaine::BackticksRunner.new
+```
+
+And if you really want to, you can define your own Runner, though I can't
+imagine why you would.
+
+### JRuby Caveat
+
+If you get `Error::ECHILD` errors and are using JRuby, there is a very good
+chance that the error is actually in JRuby. This was brought to our attention
+in https://github.com/thoughtbot/cocaine/issues/24 and probably fixed in
+http://jira.codehaus.org/browse/JRUBY-6162. You *will* want to use the
+`BackticksRunner` if you are unable to update JRuby.
+
## Feedback
*Security* concerns must be privately emailed to
View
@@ -1,3 +1,3 @@
module Cocaine
- VERSION = "0.3.0".freeze
+ VERSION = "0.3.1".freeze
end

0 comments on commit 910fcce

Please sign in to comment.