resque-pool-diet 0.3.1

data/man/resque-pool.1

@@ -0,0 +1,79 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "RESQUE\-POOL" "1" "May 2012" "RESQUE-POOL 0.3.0.DEV" "RESQUE-POOL"
+.
+.SH "NAME"
+\fBresque\-pool\fR \- resque worker pool management
+.
+.SH "SYNOPSIS"
+\fBresque\-pool\fR \fIoptions\fR
+.
+.SH "DESCRIPTION"
+\fBResque\-pool\fR is the best way to manage a group (pool) of resque workers\.
+.
+.P
+When resque\-pool(1) is daemonized the \fBstdout\fR and \fBstderr\fR output streams are redirected to \fBresque\-pool\.stdxxx\.log\fR log files in the \fBlog\fR directory\. Additionally the PID file defaults to \fBresque\-pool\.pid\fR in the \fBtmp/pids\fR directory\.
+.
+.SH "OPTIONS"
+.
+.IP "\(bu" 4
+\fB\-c, \-\-config\fR \fIfile\fR: Uses the configuration specified in the \fIfile\fR provided instead of searching in the current and \fBconfig\fR directories for \fBresque\-pool\.yml\fR\.
+.
+.IP "\(bu" 4
+\fB\-d, \-\-daemon\fR: Runs \fBresque\-pool\fR in the background as a daemon process\. This will redirect \fBstdout\fR and \fBstderr\fR to log files and write a PID file\.
+.
+.IP "\(bu" 4
+\fB\-o, \-\-stdout\fR \fIfile\fR: Writes the normal log output to \fIfile\fR instead of printing to the terminal\. When running as a daemon this defaults to the path \fBlog/resque\-pool\.stdout\.log\fR\.
+.
+.IP "\(bu" 4
+\fB\-e, \-\-stderr\fR \fIfile\fR: Writes the standard error output to \fIfile\fR instead of printing to the terminal\. When running as a daemon this defaults to the path \fBlog/resque\-pool\.stderr\.log\fR\.
+.
+.IP "\(bu" 4
+\fB\-\-nosync\fR Allows writes to \fBstdout\fR and \fBstderr\fR to be buffered by the OS\.
+.
+.IP "\(bu" 4
+\fB\-p, \-\-pidfile\fR \fIfile\fR: Writes the PID to the \fIfile\fR\. When running as a daemon this defaults to \fBtmp/pids/resque\-pool\.pid\fR\.
+.
+.IP "\(bu" 4
+\fB\-E, \-\-environment\fR \fIname\fR: Specifies the environment \fIname\fR to be set for \fBRAILS_ENV\fR, \fBRACK_ENV\fR and \fBRESQUE_ENV\fR which will be passed on to the pooled resque workers\.
+.
+.IP "\(bu" 4
+\fB\-a, \-\-appname\fR \fIname\fR: Specifies the app name to be used for logging and procline\. If not specified, this defaults to the current working directory\.
+.
+.IP "" 0
+.
+.SH "HISTORY"
+.
+.TP
+\fBv0\.3\.0\fR
+Support for ruby 1\.9, resque 1\.20\.
+.
+.br
+Added appname for logging\.
+.
+.br
+Minor bugfixes\.
+.
+.TP
+\fBv0\.2\.0\fR
+Support for reloading logs and workers with \fBHUP\fR signal
+.
+.br
+Cleans up PID file on startup
+.
+.br
+Fixed \fB\-c, \-\-config\fR option\.
+.
+.TP
+\fBv0\.1\.0\fR
+\fBresque\-pool\fR command line interface added
+.
+.SH "AUTHOR"
+Nicholas Evans
+.
+.SH "COPYRIGHT"
+Copyright (C) 2010 by Nicholas Evans \fInick@ekenosen\.net\fR, et al\.
+.
+.SH "SEE ALSO"
+resque\-pool\.yml(5)

data/man/resque-pool.1.ronn

@@ -0,0 +1,77 @@
+resque-pool(1) -- resque worker pool management
+================================================
+
+## SYNOPSIS
+
+`resque-pool` [options]
+
+## DESCRIPTION
+
+**Resque-pool** is the best way to manage a group (pool) of resque workers.
+
+When resque-pool(1) is daemonized the `stdout` and `stderr` output streams
+are redirected to `resque-pool.stdxxx.log` log files in the `log` directory.
+Additionally the PID file defaults to `resque-pool.pid` in the `tmp/pids`
+directory.
+
+## OPTIONS
+
+  * `-c, --config` <file>:
+    Uses the configuration specified in the <file> provided instead of
+    searching in the current and `config` directories for `resque-pool.yml`.
+
+  * `-d, --daemon`:
+    Runs `resque-pool` in the background as a daemon process. This will
+    redirect `stdout` and `stderr` to log files and write a PID file.
+
+  * `-o, --stdout` <file>:
+    Writes the normal log output to <file> instead of printing to the
+    terminal. When running as a daemon this defaults to the path
+    `log/resque-pool.stdout.log`.
+
+  * `-e, --stderr` <file>:
+    Writes the standard error output to <file> instead of printing to the
+    terminal. When running as a daemon this defaults to the path
+    `log/resque-pool.stderr.log`.
+
+  * `--nosync`
+    Allows writes to `stdout` and `stderr` to be buffered by the OS.
+
+  * `-p, --pidfile` <file>:
+    Writes the PID to the <file>. When running as a daemon this defaults
+    to `tmp/pids/resque-pool.pid`.
+
+  * `-E, --environment` <name>:
+    Specifies the environment <name> to be set for `RAILS_ENV`, `RACK_ENV`
+    and `RESQUE_ENV` which will be passed on to the pooled resque workers.
+
+  * `-a, --appname` <name>:
+    Specifies the app name to be used for logging and procline.  If not
+    specified, this defaults to the current working directory.
+
+## HISTORY
+
+  * `v0.3.0`:
+    Support for ruby 1.9, resque 1.20.<br>
+    Added appname for logging.<br>
+    Minor bugfixes.
+
+  * `v0.2.0`:
+    Support for reloading logs and workers with `HUP` signal<br>
+    Cleans up PID file on startup<br>
+    Fixed `-c, --config` option.
+
+  * `v0.1.0`:
+    `resque-pool` command line interface added
+
+## AUTHOR
+
+Nicholas Evans
+
+## COPYRIGHT
+
+Copyright (C) 2010 by Nicholas Evans <nick@ekenosen.net>, et al.
+
+## SEE ALSO
+
+resque-pool.yml(5)

data/man/resque-pool.yml.5

@@ -0,0 +1,46 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "RESQUE\-POOL\.YML" "5" "May 2012" "RESQUE-POOL 0.3.0.DEV" "RESQUE-POOL"
+.
+.SH "NAME"
+\fBresque\-pool\.yml\fR \- resque\-pool pool configuration
+.
+.SH "SYNOPSIS"
+\fBresque\-pool\.yml\fR
+.
+.br
+\fBconfig/resque\-pool\.yml\fR
+.
+.SH "DESCRIPTION"
+resque\-pool(1) reads pool configuration data from \fBresque\-pool\.yml\fR (or the file specified with \fB\-c\fR on the command line)\. The file contains queue\-worker\-count pairs, one per line\. The configuration file supports both using root level defaults as well as environment specific overrides (\fBRACK_ENV\fR, \fBRAILS_ENV\fR, and \fBRESQUE_ENV\fR environment variables can be used to determine environment)\.
+.
+.P
+An example configuration
+.
+.IP "" 4
+.
+.nf
+
+foo: 1
+bar: 2
+"foo,bar,baz": 1
+
+production:
+  "foo,bar,baz": 4
+.
+.fi
+.
+.IP "" 0
+.
+.P
+will create 7 workers in production and 4 in other environment configurations\. The simpler worker definition \fBfoo: 1\fR will create 1 worker for the \fBfoo\fR queue, the more complicated \fBfoo,bar,baz: 1\fR will create 1 worker for the queues \fBfoo\fR, \fBbar\fR and \fBbaz\fR\.
+.
+.SH "AUTHOR"
+Nicholas Evans
+.
+.SH "COPYRIGHT"
+Copyright (C) 2010 by Nicholas Evans \fInick@ekenosen\.net\fR, et al\.
+.
+.SH "SEE ALSO"
+resque\-pool(1)

data/man/resque-pool.yml.5.ronn

@@ -0,0 +1,41 @@
+resque-pool.yml(5) -- resque-pool pool configuration
+=====================================================
+
+## SYNOPSIS
+
+`resque-pool.yml`<br>
+`config/resque-pool.yml`
+
+## DESCRIPTION
+
+resque-pool(1) reads pool configuration data from `resque-pool.yml` (or
+the file specified with `-c` on the command line). The file contains queue-worker-count pairs, one per line. The configuration file supports both 
+using root level defaults as well as environment specific overrides 
+(`RACK_ENV`, `RAILS_ENV`, and `RESQUE_ENV` environment variables can be used 
+to determine environment).
+
+An example configuration
+
+    foo: 1
+    bar: 2
+    "foo,bar,baz": 1
+
+    production:
+      "foo,bar,baz": 4
+
+will create 7 workers in production and 4 in other environment configurations.
+The simpler worker definition `foo: 1` will create 1 worker for the `foo` 
+queue, the more complicated `foo,bar,baz: 1` will create 1 worker for the
+queues `foo`, `bar` and `baz`.
+
+## AUTHOR
+
+Nicholas Evans
+
+## COPYRIGHT
+
+Copyright (C) 2010 by Nicholas Evans <nick@ekenosen.net>, et al.
+
+## SEE ALSO
+
+resque-pool(1)

data/spec/mock_config.rb

@@ -0,0 +1,6 @@
+RESQUE_POOL_CONFIG = {
+  'foo' => 1,
+  'bar' => 1,
+  'baz' => 1,
+  'foo,bar,baz' => 4,
+}

data/spec/resque-pool.yml

@@ -0,0 +1,13 @@
+foo: 1
+
+production:
+  "foo,bar": 10
+
+development:
+  "foo,bar": 4
+  "baz": 23
+  
+test:
+  "bar": 5
+  "foo,bar": 3
+

data/spec/resque_pool_spec.rb

@@ -0,0 +1,134 @@
+require 'spec_helper'
+
+RSpec.configure do |config|
+  config.after {
+    Object.send(:remove_const, :RAILS_ENV) if defined? RAILS_ENV
+    ENV.delete 'RACK_ENV'
+    ENV.delete 'RAILS_ENV'
+    ENV.delete 'RESQUE_ENV'
+  }
+end
+
+describe Resque::Pool, "when loading a simple pool configuration" do
+  let(:config) do
+    { 'foo' => 1, 'bar' => 2, 'foo,bar' => 3, 'bar,foo' => 4, }
+  end
+  subject { Resque::Pool.new(config) }
+
+  context "when ENV['RACK_ENV'] is set" do
+    before { ENV['RACK_ENV'] = 'development' }
+
+    it "should load the values from the Hash" do
+      subject.config["foo"].should == 1
+      subject.config["bar"].should == 2
+      subject.config["foo,bar"].should == 3
+      subject.config["bar,foo"].should == 4
+    end
+  end
+
+end
+
+describe Resque::Pool, "when loading the pool configuration from a Hash" do
+
+  let(:config) do
+    {
+      'foo' => 8,
+      'test'        => { 'bar' => 10, 'foo,bar' => 12 },
+      'development' => { 'baz' => 14, 'foo,bar' => 16 },
+    }
+  end
+
+  subject { Resque::Pool.new(config) }
+
+  context "when RAILS_ENV is set" do
+    before { RAILS_ENV = "test" }
+
+    it "should load the default values from the Hash" do
+      subject.config["foo"].should == 8
+    end
+
+    it "should merge the values for the correct RAILS_ENV" do
+      subject.config["bar"].should == 10
+      subject.config["foo,bar"].should == 12
+    end
+
+    it "should not load the values for the other environments" do
+      subject.config["foo,bar"].should == 12
+      subject.config["baz"].should be_nil
+    end
+
+  end
+
+  context "when ENV['RESQUE_ENV'] is set" do
+    before { ENV['RESQUE_ENV'] = 'development' }
+    it "should load the config for that environment" do
+      subject.config["foo"].should == 8
+      subject.config["foo,bar"].should == 16
+      subject.config["baz"].should == 14
+      subject.config["bar"].should be_nil
+    end
+  end
+
+  context "when there is no environment" do
+    it "should load the default values only" do
+      subject.config["foo"].should == 8
+      subject.config["bar"].should be_nil
+      subject.config["foo,bar"].should be_nil
+      subject.config["baz"].should be_nil
+    end
+  end
+
+end
+
+describe Resque::Pool, "given no configuration" do
+  subject { Resque::Pool.new(nil) }
+  it "should have no worker types" do
+    subject.config.should == {}
+  end
+end
+
+describe Resque::Pool, "when loading the pool configuration from a file" do
+
+  subject { Resque::Pool.new("spec/resque-pool.yml") }
+
+  context "when RAILS_ENV is set" do
+    before { RAILS_ENV = "test" }
+
+    it "should load the default YAML" do
+      subject.config["foo"].should == 1
+    end
+
+    it "should merge the YAML for the correct RAILS_ENV" do
+      subject.config["bar"].should == 5
+      subject.config["foo,bar"].should == 3
+    end
+
+    it "should not load the YAML for the other environments" do
+      subject.config["foo"].should == 1
+      subject.config["bar"].should == 5
+      subject.config["foo,bar"].should == 3
+      subject.config["baz"].should be_nil
+    end
+
+  end
+
+  context "when ENV['RACK_ENV'] is set" do
+    before { ENV['RACK_ENV'] = 'development' }
+    it "should load the config for that environment" do
+      subject.config["foo"].should == 1
+      subject.config["foo,bar"].should == 4
+      subject.config["baz"].should == 23
+      subject.config["bar"].should be_nil
+    end
+  end
+
+  context "when there is no environment" do
+    it "should load the default values only" do
+      subject.config["foo"].should == 1
+      subject.config["bar"].should be_nil
+      subject.config["foo,bar"].should be_nil
+      subject.config["baz"].should be_nil
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require 'rspec'
+$LOAD_PATH << File.expand_path("../lib", File.dirname(__FILE__))
+require 'resque/pool'

metadata

@@ -0,0 +1,191 @@
+--- !ruby/object:Gem::Specification
+name: resque-pool-diet
+version: !ruby/object:Gem::Version
+  version: 0.3.1
+platform: ruby
+authors:
+- nicholas a. evans
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: resque
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.9
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.11
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.11
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: ronn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2
+      quickly and easily fork a pool of resque workers,
+      saving memory (w/REE) and monitoring their uptime
+email:
+- nick@ekenosen.net
+executables:
+- resque-pool
+extensions: []
+extra_rdoc_files: []
+files:
+- Changelog.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/resque-pool
+- features/basic_daemon_config.feature
+- features/step_definitions/daemon_steps.rb
+- features/step_definitions/resque-pool_steps.rb
+- features/support/aruba_daemon_support.rb
+- features/support/env.rb
+- lib/resque/pool.rb
+- lib/resque/pool/cli.rb
+- lib/resque/pool/logging.rb
+- lib/resque/pool/pooled_worker.rb
+- lib/resque/pool/tasks.rb
+- lib/resque/pool/version.rb
+- man/resque-pool.1
+- man/resque-pool.1.ronn
+- man/resque-pool.yml.5
+- man/resque-pool.yml.5.ronn
+- spec/mock_config.rb
+- spec/resque-pool.yml
+- spec/resque_pool_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/nevans/resque-pool
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: quickly and easily fork a pool of resque workers
+test_files:
+- spec/mock_config.rb
+- spec/resque_pool_spec.rb
+- spec/spec_helper.rb
+- spec/resque-pool.yml
+- features/step_definitions/daemon_steps.rb
+- features/step_definitions/resque-pool_steps.rb
+- features/support/aruba_daemon_support.rb
+- features/support/env.rb
+- features/basic_daemon_config.feature