frontkick 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 72aa979e5f8b0fcc7424d0db082038483f84dfdc
-  data.tar.gz: 255712e57011e231886af33fc424185380a65d2b
+  metadata.gz: e888a0eeabcd74cf8b17b95b4b8e2caa56eaef29
+  data.tar.gz: bf94899be04073e6e1e5a85843c18372c60bbc57
 SHA512:
-  metadata.gz: 0e972160b2aba8082fcd4583a36e1694959f10913f4970afe6b10b346e2201f3de6c8d8ae1b878752b22ff09122d8d6787eba8645af377be7fe13b713ecda8fa
-  data.tar.gz: c22c2214ab5e7f7cf427b1096d00445cea8d6e573e92aeb3317e55ad8e398926b16d01154cf1ebed2a52f5274ead6592f6e24e53e04dd075a982df0baf03fe49
+  metadata.gz: c499e15431e89473e96a438f0c06ba84cf3900522a503822e107c24695c5401cac62d0a8066bd4afbc4f784d71766b4be0b550bbf9cd72c9d44a00529f987da2
+  data.tar.gz: 3263adc248acab1001ee893ffdadfbe8dcca6037660838800b6035d382f69b82bb2cd4193fd0d2ba9e7dc315ffea575cc124545ab795725e9a94864d68ca144d

data/CHANGELOG.md

@@ -1,4 +1,10 @@
-# 0.0.3 (2013/06/23)
+# 0.2.0 (2013/09/13)
+
+Changes:
+
+- Support exclusive option
+
+# 0.1.0 (2013/06/23)
 
 Changes:
 

data/README.md

@@ -2,7 +2,7 @@
 
 testing ruby: 1.9.2, 1.9.3, 2.0.0;
 
-frontkick is a wrapper of Open3#popen3 to execute a command easily.
+Frontkick is a gem to execute a command and obtain status code, stdout, stderr simply, wheres, `system` does not provide it. 
 
 ## USAGE
 
@@ -25,6 +25,12 @@ frontkick is a wrapper of Open3#popen3 to execute a command easily.
 
     Frontkick::Command.exec("sleep 2 && ls /hoge", :timeout => 1)
 
+### Exclusive Option
+
+Prohibit another process to run a command concurrently
+
+    Frontkick::Command.exec("sleep 2 && ls /hoge", :exclusive => "/tmp/frontkick.lock") # raises Fontkick::Locked if locked
+
 ## Contributing
 
 1. Fork it

data/frontkick.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |gem|
   gem.authors       = ["Naotoshi Seo"]
   gem.email         = ["sonots@gmail.com"]
   gem.homepage      = "https://github.com/sonots/frontkick"
-  gem.summary       = "A wrapper of Open3#popen3 to execute a command easily"
+  gem.summary       = "Execute a command simply!"
   gem.description   = gem.summary
 
   gem.files         = `git ls-files`.split($\)

data/lib/frontkick/command.rb

@@ -1,6 +1,11 @@
 require 'benchmark'
 require 'open3'
 
+module Frontkick
+  class Locked < StandardError
+  end
+end
+
 module Frontkick
   class Command
     def self.exec(cmd, opts = {})
@@ -8,6 +13,7 @@ module Frontkick
       stdin, out, err, wait_thr, pid = nil
 
       cmd_array = cmd.kind_of?(Array) ? cmd : [cmd]
+      lock_fd = file_lock(opts[:exclusive]) if opts[:exclusive]
       begin
         timeout(opts[:timeout]) do # nil is for no timeout
           duration = Benchmark.realtime do
@@ -32,6 +38,7 @@ module Frontkick
         out.close if out and !out.closed?
         err.close if err and !err.closed?
         wait_thr.kill if wait_thr and !wait_thr.stop?
+        lock_fd.flock(File::LOCK_UN)
       end
       
       CommandResult.new(stdout, stderr, exit_code, duration)
@@ -44,5 +51,20 @@ module Frontkick
         # no child process
       end
     end
+
+    # Use file lock to perfome exclusive operation
+    #
+    # @param lock_file file path used to lock
+    # @return file descriptor
+    # @raise Fontkick::Locked if locked
+    def self.file_lock(lock_file)
+      lock_fd = File.open(lock_file, File::RDWR|File::CREAT, 0644)
+      success = lock_fd.flock(File::LOCK_EX|File::LOCK_NB)
+      unless success
+        lock_fd.flock(File::LOCK_UN)
+        raise Frontkick::Locked
+      end
+      lock_fd
+    end
   end
 end

data/lib/frontkick/version.rb

@@ -1,3 +1,3 @@
 module Frontkick
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: frontkick
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Naotoshi Seo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-23 00:00:00.000000000 Z
+date: 2013-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -52,7 +52,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: A wrapper of Open3#popen3 to execute a command easily
+description: Execute a command simply!
 email:
 - sonots@gmail.com
 executables: []
@@ -92,9 +92,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.0
+rubygems_version: 2.0.2
 signing_key: 
 specification_version: 4
-summary: A wrapper of Open3#popen3 to execute a command easily
+summary: Execute a command simply!
 test_files:
 - spec/spec_helper.rb
+has_rdoc: