ps 0.0.7 → 0.0.8

data/README.md

@@ -0,0 +1,43 @@
+# PS Gem
+A gem for interacting with the **p**rocess **s**tatus utility on unix systems.
+
+### Getting information on a specific process
+
+    [proc1,proc2] = PS.pid(1234,321)
+
+or for shorthand
+
+    proc1 = PS(1234)
+    process_list = [proc1,proc2] = PS(1234,321)
+
+### Finding process based on name
+
+    process_list = PS(/Firefox.app/)
+
+### Finding process based on attached port
+
+To return any processes attached to port 80.
+
+    process_list = PS(':80')
+
+## Process
+
+Processes have methods for every value listed in `ps -L` with `%` aliased to `pct`. The method `mem` was added which gives the megabytes of memory used by the process. The method `kill!(sig="INT")` was also added to send a kill command to the process. And you can call `alive?` to poll if the process is still alive.
+
+## Example
+
+If I wanted to kill firefox if it got more than 50% cpu or 600mb of memory.
+
+    fx = PS(/Firefox.app/).first
+    # only kill if taking up more than 50% cpu or 600mb of memory
+    exit unless fx.pcpu > 50 || fx.mem > 600
+    retries = 0
+    fx.kill!
+    while fx.alive?
+      retries += 1
+      if retries > 5
+        # If sigint hasn't worked after .5 sec try SIGTERM
+        fx.kill!("TERM")
+      end
+      sleep 0.1
+    end

data/lib/ps.rb

@@ -49,7 +49,7 @@ module PS
   def from_lsof match, args={}
     lines = `lsof -i #{match} -sTCP:LISTEN`.chomp.split("\n")
     lines.shift # remove header
-    
+
     pids = lines.collect do |line|
       if m = line.match(/\s*\w+\s+(\d+)/)
         m[1].to_i
@@ -68,6 +68,8 @@ require 'ps/process_list_printer'
 
 def PS *args
   case args[0]
+  when /\:\d+$/
+    PS.from_lsof(*args)
   when Regexp
     opts = args[1] || {}
     procs = PS.all(opts)
@@ -75,10 +77,16 @@ def PS *args
     procs = procs.select {|proc| proc.pid != Process.pid} unless opts[:include_self]
     procs
   when Integer
-    PS.pid(*args).first
+    if args[1].is_a?(Integer)
+      PS.pid(*args)
+    else
+      PS.pid(*args).first
+    end
+  when Array
+    pids = args[0]
+    pids << args[1] || {}
+    PS.pid(*pids)
   when Hash
     PS.all(*args)
-  when /\:\d+$/
-    PS.from_lsof(*args)
   end
 end

data/lib/ps/process.rb

@@ -42,7 +42,7 @@ module PS
 
     def alive?
       return unless pid
-      Process.getpgid(pid)
+      ::Process.getpgid(pid)
       true
     rescue Errno::ESRCH
       false

data/lib/ps/process_list.rb

@@ -28,6 +28,8 @@ module PS
       to.send :puts, printer.to_s
     end
 
+    # Print out all the processes and accept user input to return
+    # the process objects selected.
     def choose question=nil
       if empty?
         puts "No processes found."
@@ -76,7 +78,7 @@ module PS
     # it to work any other way.
     def method_missing(*args, &blk)
       new_target = @target.send(*args, &blk)
-       
+
       new_target.class == @target.class ? self.class.new(new_target) : new_target
     end
   end

data/lib/ps/version.rb

@@ -1,3 +1,3 @@
 module PS
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

metadata

@@ -1,64 +1,60 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: ps
-version: !ruby/object:Gem::Version 
-  hash: 17
+version: !ruby/object:Gem::Version
+  version: 0.0.8
   prerelease: 
-  segments: 
-  - 0
-  - 0
-  - 7
-  version: 0.0.7
 platform: ruby
-authors: 
+authors:
 - Tal Atlas
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-12-01 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-08-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rspec
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: ansi
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ansi
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id002
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A ruby utility for interacting with the unix tool 'ps'
-email: 
+email:
 - me@tal.by
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - .irbrc
 - .rspec
 - Gemfile
+- README.md
 - Rakefile
 - lib/ps.rb
 - lib/ps/command.rb
@@ -73,39 +69,29 @@ files:
 - test
 homepage: https://github.com/Talby/ps
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: ps
-rubygems_version: 1.8.8
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A ruby wrapper for the unix tool 'ps'
-test_files: 
+test_files:
 - spec/command_spec.rb
 - spec/ps_spec.rb
 - spec/spec_helper.rb
-has_rdoc: