pid 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1c74deaebd61e613000eafe5a657639f31aadfe5
+  data.tar.gz: 5adc0f986456ad6a4efd4a8694f0e14d32339739
+SHA512:
+  metadata.gz: d0b2b6d7a85cce9cca1270a4fb51a5a5c732ce6ea7d6c2f7e383b82da7062493a2dc60ae30b6f524b93d34340346a2519b77cfe7eb33bdb830c8d4ab2c1e7a57
+  data.tar.gz: e58bbcd44d111c082d0c89a4c9f4d7636e8a91b3dd411a700a23ce9ec0a9a34cadea1be42e6d51d7eaead6cc8e062cbbe368766af311a2fd05b1ee68d1f1064f

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 debbbbie
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,20 @@
+= pid
+
+Library for managing pidfiles. It was extracted from Kenneth
+Kalmer's excellent daemon-kit project (http://github.com/kennethkalmer/daemon-kit).
+The daemon-kit framework is amazing for bootstrapping your daemons, but if
+you need something more lightweight (e.g., a single file daemon), then you're
+out of luck (for now). In the mean time, there weren't any obvious, simple
+pid file management libraries that you could trust. This one works well and
+has facilities to ensure the process the pid file is pointing to is still running,
+so you can handle stale pid files easily.
+
+= Usage
+
+Some samples of the most common uses:
+
+ require 'rubygems'
+ require 'pid'
+ 
+ Pid.running?("/path/to/your.pid") # pid filepath
+ Pid.running?(pid) # the pid of process

data/Rakefile

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "pid"
+    gem.summary = %Q{Library for managing pidfiles.}
+    gem.description = %Q{Library for managing pidfiles.}
+    gem.email = "debbbbie@163.com"
+    gem.homepage = "http://github.com/debbbbie/pid_rb"
+    gem.authors = ["debbbbie"]
+    # gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/core_ext.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/core_ext/string'

data/lib/core_ext/string.rb

@@ -0,0 +1,25 @@
+# Extracted from Kenneth Kalmer's excellent daemon-kit project
+# on GitHub: http://github.com/kennethkalmer/daemon-kit
+
+require 'pathname'
+
+class String
+
+  # Assuming the string is a file or path name, convert it into an
+  # absolute path.
+  def to_absolute_path
+    # Pathname is incompatible with Windows, but Windows doesn't have
+    # real symlinks so File.expand_path is safe.
+    if RUBY_PLATFORM =~ /(:?mswin|mingw)/
+      File.expand_path( self )
+
+      # Otherwise use Pathname#realpath which respects symlinks.
+    else
+      begin
+        File.expand_path( Pathname.new( self ).realpath.to_s )
+      rescue Errno::ENOENT
+        File.expand_path( Pathname.new( self ).cleanpath.to_s )
+      end
+    end
+  end
+end

data/lib/pid.rb

@@ -0,0 +1,97 @@
+# Much of this was extracted from Kenneth Kalmer's excellent
+# daemon-kit project on GitHub: http://github.com/kennethkalmer/daemon-kit
+
+require File.dirname(__FILE__) + '/core_ext'
+
+class Pid
+  def initialize(path)
+    @path = path.to_absolute_path
+  end
+  
+  def self.drop(path)
+    p = self.new(path)
+    if p.exists?
+      unless p.running?
+        p.cleanup
+        p.write!
+      end
+    else
+      p.write!
+    end
+  end
+  
+  def self.cleanup(path)
+    p = self.new(path)
+    if p.running?
+      return false
+    else
+      p.cleanup
+      return true
+    end
+  end
+  
+  def self.cleanup!(path)
+    p = self.new(path)
+    p.cleanup if p.exists?
+  end
+  
+  def self.running?(pid_or_filepath)
+    object = self.new(pid_or_filepath)
+    object.running?
+  end   
+
+  def exists?
+    File.exists?(@path)
+  end
+
+  # Returns true if the process is running
+  def running?
+    return false unless self.exists?
+
+    # Check if process is in existence
+    # The simplest way to do this is to send signal '0'
+    # (which is a single system call) that doesn't actually
+    # send a signal
+    begin
+      Process.kill(0, self.pid)
+      return true
+    rescue Errno::ESRCH
+      return false
+    rescue ::Exception   # for example on EPERM (process exists but does not belong to us)
+      return true
+    #rescue Errno::EPERM
+    #  return false
+    end
+  end
+
+  # Return the pid contained in the pidfile, or nil
+  def pid
+    return nil unless self.exists?
+
+    File.open( @path ) { |f| return f.gets.to_i }
+  end
+
+  def ensure_stopped!
+    if self.running?
+      puts "Process already running with id #{self.pid}"
+      exit 1
+    end
+  end
+
+  def cleanup
+    begin
+      File.delete(@path)
+    rescue Errno::ENOENT
+      File.delete("/tmp/#{Pathname.new(@path).basename}")
+    end
+  end
+  alias zap cleanup
+
+  def write!
+    begin
+      File.open(@path, "w") { |f| f.puts Process.pid }
+    rescue Errno::ENOENT, Errno::EACCES
+      File.open("/tmp/#{Pathname.new(@path).basename}", "w") { |f| f.puts Process.pid }
+    end
+  end
+end

data/pid.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name = %q{pid}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["debbbbie"]
+  s.date = %q{2015-08-12}
+  s.description = %q{Library for managing pidfiles.}
+  s.email = %q{debbbbie@163.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/core_ext.rb",
+     "lib/core_ext/string.rb",
+     "lib/pid.rb",
+     "pid.gemspec"
+  ]
+  s.homepage = %q{http://github.com/debbbbie/pid_rb}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  # s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Library for managing pidfiles.}
+  
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: pid
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- debbbbie
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-12 00:00:00.000000000 Z
+dependencies: []
+description: Library for managing pidfiles.
+email: debbbbie@163.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.rdoc
+files:
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/core_ext.rb
+- lib/core_ext/string.rb
+- lib/pid.rb
+- pid.gemspec
+homepage: http://github.com/debbbbie/pid_rb
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+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.4.5
+signing_key: 
+specification_version: 3
+summary: Library for managing pidfiles.
+test_files: []