rspec-background-process 0.1.1 → 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2ffb6ce1d711fa6429076075b4eb20bf45d564db
+  data.tar.gz: 5de983b0f115d7d4ee68aeb284577f47fa95353b
+SHA512:
+  metadata.gz: 8608cf064bc09e54ba15c37e5ee5ba76af60df8e5a922eda82bf40bd8b5408c956bb37edcd826d54beedb0f5b0b3e779ec947ed7ecf454f6a2a2e3242b8e88f6
+  data.tar.gz: f680418bd3238b4e646d401b456c3aae4141d782f5620a970a6f843e29fcdbf7d676320be01428a5da2ee8f653c9cd6bf757a94c0f18b3fb0e7e8df92f1d8834

data/README.md

@@ -0,0 +1,86 @@
+# rspec-background-process
+
+RSpec and Cucumber DSL that allows definition of processes with their arguments, working directory, time outs, port numbers etc. and start/stop them during test runs.
+Processes with same definitions can be pooled and reused between example runs to save time on startup/shutdown. Pooling supports limiting the number of running processes with LRU to limit memory used.
+
+## Example Usage
+
+```ruby
+background_process('bin/http-worker').with do |process|
+	process.http_port_allocated_form 1200
+
+	process.argument '--listen', '127.0.0.1:<allocated port 1>'
+	process.argument '--foreground'
+	process.argument '--debug'
+
+	process.ready_when_log_includes 'worker=0 ready'
+end
+.start
+.wait_ready
+```
+
+The above example will start up (or reuse) instance of `http-worker` process with given arguments and allocated unique port number. 
+The `#wait_ready` method will return after process logs `worker=0 ready` to standard output or error. This way the process has a chance of starting up fully before we continue with testing.
+
+## Usage with RSpec
+
+Add `require 'rspec-background-process'` to your `spec_helper.rb` and use `with: :background_process` meta tag on example groups that will use `#backgroud_process`.
+
+```ruby
+require_relative 'spec_helper'
+
+describe 'starting background process', with: :background_process do
+	before :all do
+		background_process('bin/test_process').with do |process|
+			process.ready_when_log_includes 'ready'
+		end
+		.start
+		.wait_ready
+	end
+
+	example 'test with process running in background' do
+	end
+end
+```
+
+## Usage with Cucumber
+
+Add `require 'rspec-background-process'` to your `env.rb`.
+
+```ruby
+Given /^my server is running$/ do
+	@server = background_process('bin/server', load: true).with do |process|
+		process.http_port_allocated_form 1200
+
+		process.argument '--listen', '127.0.0.1:<allocated port 1>'
+		process.argument '--dump-log-at-exit'
+		process.argument '--working-directory', '<working directory>'
+		process.argument '--config-prepend', '<project directory>/etc/server.conf'
+
+		process.ready_when_url_response_status 'http://localhost:<allocated port 1>/health.test', 'OK'
+
+		process.refresh_action do |instance|
+			open(instance.render('http://127.0.0.1:<allocated port 1>/_purge'))
+		end
+	end
+end
+```
+
+## More info
+
+See spec files for more usage options.
+
+## Contributing to rspec-background-process
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2014 Global Medical Treatment Ltd trading as WhatClinic.com. 
+See LICENSE.txt for further details.

data/Rakefile

@@ -18,7 +18,7 @@ Jeweler::Tasks.new do |gem|
   gem.homepage = "http://github.com/jpastuszek/rspec-background-process"
   gem.license = "MIT"
   gem.summary = "RSpec and Cucumber DSL library that helps managing background processes during test runs"
-  gem.description = "RSpec and Cucumber DSL that allows definition of processes with their arguments, working directory, time outs, port numbers etc. and start/stop them during test runs. Processes with same definitions can pooled and reused between example runs to save time on startup/shutdown. Pooling supports process number limiting with LRU to limit memory used."
+  gem.description = "RSpec and Cucumber DSL that allows definition of processes with their arguments, working directory, time outs, port numbers etc. and start/stop them during test runs. Processes with same definitions can be pooled and reused between example runs to save time on startup/shutdown. Pooling supports limiting the number of running processes with LRU to limit memory used."
   gem.email = "jpastuszek@gmail.com"
   gem.authors = ["Jakub Pastuszek"]
   # dependencies defined in Gemfile

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/lib/rspec-background-process/background_process.rb

@@ -51,7 +51,7 @@ module RSpecBackgroundProcess
 
 			case working_directory
 			when Array
-				working_directory = Dir.mktmpdir(working_directory)
+				working_directory = Dir.mktmpdir(working_directory.map(&:to_s))
 			when nil
 				working_directory = Dir.mktmpdir(name.to_s)
 			end

data/rspec-background-process.gemspec

@@ -2,19 +2,21 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
+# stub: rspec-background-process 0.1.2 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "rspec-background-process"
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
   s.authors = ["Jakub Pastuszek"]
-  s.date = "2014-09-29"
-  s.description = "RSpec and Cucumber DSL that allows definition of processes with their arguments, working directory, time outs, port numbers etc. and start/stop them during test runs. Processes with same definitions can pooled and reused between example runs to save time on startup/shutdown. Pooling supports process number limiting with LRU to limit memory used."
+  s.date = "2016-11-07"
+  s.description = "RSpec and Cucumber DSL that allows definition of processes with their arguments, working directory, time outs, port numbers etc. and start/stop them during test runs. Processes with same definitions can be pooled and reused between example runs to save time on startup/shutdown. Pooling supports limiting the number of running processes with LRU to limit memory used."
   s.email = "jpastuszek@gmail.com"
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
@@ -22,7 +24,7 @@ Gem::Specification.new do |s|
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "lib/rspec-background-process.rb",
@@ -53,12 +55,11 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "http://github.com/jpastuszek/rspec-background-process"
   s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.23"
+  s.rubygems_version = "2.4.6"
   s.summary = "RSpec and Cucumber DSL library that helps managing background processes during test runs"
 
   if s.respond_to? :specification_version then
-    s.specification_version = 3
+    s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<daemon>, ["~> 1.2"])

metadata

@@ -1,162 +1,145 @@
 --- !ruby/object:Gem::Specification
 name: rspec-background-process
 version: !ruby/object:Gem::Version
-  version: 0.1.1
-  prerelease: 
+  version: 0.1.2
 platform: ruby
 authors:
 - Jakub Pastuszek
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-29 00:00:00.000000000 Z
+date: 2016-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: daemon
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
 - !ruby/object:Gem::Dependency
   name: micromachine
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rufus-lru
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: file-tail
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: retries
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.0.5
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 description: RSpec and Cucumber DSL that allows definition of processes with their
   arguments, working directory, time outs, port numbers etc. and start/stop them during
-  test runs. Processes with same definitions can pooled and reused between example
-  runs to save time on startup/shutdown. Pooling supports process number limiting
-  with LRU to limit memory used.
+  test runs. Processes with same definitions can be pooled and reused between example
+  runs to save time on startup/shutdown. Pooling supports limiting the number of running
+  processes with LRU to limit memory used.
 email: jpastuszek@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
-- README.rdoc
+- README.md
 files:
-- .document
-- .rspec
+- ".document"
+- ".rspec"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - lib/rspec-background-process.rb
@@ -187,30 +170,26 @@ files:
 homepage: http://github.com/jpastuszek/rspec-background-process
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -348650834708870766
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.4.6
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: RSpec and Cucumber DSL library that helps managing background processes during
   test runs
 test_files: []

data/README.rdoc

@@ -1,19 +0,0 @@
-= rspec-background-process
-
-See features.
-
-== Contributing to rspec-background-process
-
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2014 Jakub Pastuszek. See LICENSE.txt for
-further details.
-