proc_index 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8c2433eaf5d0ea9e807bd35f19d08c6e23795c19
+  data.tar.gz: 5ef96d0299a739a15976c479fba44c1ef5923178
+SHA512:
+  metadata.gz: de8c69313aa18e402612bde4f48fe596a36454e88757c160f253faa86157bc2e7e32fd3e19bf272d6832e1a0aadfbfe90de08612edbf6d51aaa0ee18f03ffe88
+  data.tar.gz: e018530d9ed7f2b775dc6753e229785c1e8cbbdb5f0d254032c7e88859a6fe79bcd6e1e0ecfe48b3464da4d436ce21306b994f55ce6bd46635064f667135b8c4

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+README.md
+ChangeLog.md
+
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,6 @@
+/.bundle
+/*.gem
+/Gemfile.lock
+/html/
+/pkg/
+/vendor/cache/*.gem

data/.rdoc_options

@@ -0,0 +1,16 @@
+--- !ruby/object:RDoc::Options
+encoding: UTF-8
+static_path: []
+rdoc_include:
+  - .
+charset: UTF-8
+exclude: 
+hyperlink_all: false
+line_numbers: false
+main_page: README.md
+markup: markdown
+show_hash: false
+tab_width: 8
+title: proc_index Documentation
+visibility: :protected
+webcvs:

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.ruby-gemset

@@ -0,0 +1 @@
+proc-index

data/.ruby-version

@@ -0,0 +1 @@
+2.2.0

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2

data/ChangeLog.md

@@ -0,0 +1,4 @@
+### 0.1.0 / 2015-11-23
+
+* Initial release:
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2015 Alex Manelis
+
+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.md

@@ -0,0 +1,25 @@
+# ProcIndex
+Simple ORM for your process lists. Currently only supported on OS X or Unix based systems (and even that could be limited).
+
+### Basic Usage
+Printing all processes:
+
+	$> data = ProcIndex.ps
+	...
+	$> data.body
+	=> [<Hashie::Mash command="/System/Library/CoreServices/Dock.app/Contents/MacOS/Dock" cpu="36.0" mem="0.4" pid="354" rss="35780" started="Sat01PM" stat="U" time="8:08.24" tt="??" user="alexmanelis" vsz="2789684">...]
+	
+Searching by command:
+
+	$> results = ProcIndex.search('electron')
+	...
+	=> [#<Hashie::Mash command="/Users/alexmanelis/Development/tmp/node_modules/nightmare/node_modules/electron-prebuilt/dist/Electron.app/Contents/MacOS/Electron" cpu="0.1" mem="0.6" pid="44558" rss="49672" started="1:04PM" stat="S" time="0:00.42" tt="??" user="alexmanelis" vsz="3402532">
+	
+Kill all running processes from search results:
+
+	$> ...
+	$> ProcIndex.kill_by_results(results)
+	=> [1, 1, 1]
+	
+More coming soon...
+	

data/Rakefile

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+require 'rubygems'
+
+begin
+  require 'bundler/setup'
+rescue LoadError => e
+  abort e.message
+end
+
+require 'rake'
+
+require 'awesome_print'
+AwesomePrint.irb!
+
+require 'rubygems/tasks'
+Gem::Tasks.new
+
+require 'rdoc/task'
+RDoc::Task.new
+task doc: :rdoc
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+
+task test:    :spec
+task default: :spec
+
+directory '.'
+task :dgem do
+  system 'rm *.gem'
+end
+
+task :bgem do
+  system 'gem build *.gemspec'
+end

data/lib/proc_index/container.rb

@@ -0,0 +1,50 @@
+module ProcIndex
+  class NoDataError < StandardError
+  end
+
+  class Container
+    include Enumerable
+
+    attr_accessor :body, :key
+
+    def initialize(fields, data)
+      @fields = fields
+      @data   = data
+
+      format_data!
+    end
+
+    def fields
+      @fields
+    end
+
+  private
+    def format_data!
+      raise NoDataError.new('No data has been passed') unless @data
+
+      # Clear out new line characters and split by lines
+      @data = @data.strip.split(/[\r\n]+/)
+
+      # The first line of the data object is the key
+      self.key = @data[0].gsub(/%/, '').strip.squeeze(' ').downcase.split(' ')
+
+      # Sub down the content with no spaces
+      @data.each_with_index { |item, ndx| @data[ndx] = @data[ndx].strip.squeeze(' ') }
+
+      # Assign all the values to their cooresponding keys from the fields
+      temp_body  = []
+      @data.each_with_index do |row, ndx|
+        next if ndx == 0
+
+        holder = {}
+        row.split(' ', @fields.count).each_with_index do |value, ndx2|
+          holder[self.key[ndx2]] = value
+        end
+
+        temp_body << Hashie::Mash.new(holder)
+      end
+
+      self.body = temp_body
+    end
+  end
+end

data/lib/proc_index/util.rb

@@ -0,0 +1,6 @@
+module ProcIndex
+  extend self
+
+  def could_be_user?(attr)
+  end
+end

data/lib/proc_index/version.rb

@@ -0,0 +1,3 @@
+module ProcIndex
+  VERSION = "0.1.0"
+end

data/lib/proc_index.rb

@@ -0,0 +1,117 @@
+require 'proc_index/version'
+require 'proc_index/container'
+
+require 'open3'
+require 'hashie'
+require 'fuzzy_match'
+
+module ProcIndex
+  class Error < StandardError; end
+
+  #
+  # Base fields on OS X Process table -> `ps aux`
+  @fields = [
+    'user',
+    'pid',
+    'cpu',
+    'mem',
+    'vsz',
+    'rss',
+    'tt',
+    'stat',
+    'started',
+    'time',
+    'command'
+  ]
+
+  Fields = @fields
+  ProcTableStruct = Hash[ *@fields.collect { |v| [ v, {position: 0} ] }.flatten ]
+
+  @states = [
+    {code: 'R', desc: 'Running or runnable (on run queue)'},
+    {code: 'D', desc: 'Uninterruptible sleep (usually IO)'},
+    {code: 'S', desc: 'Interruptible sleep (waiting for an event to complete)'},
+    {code: 'Z', desc: 'Defunct/zombie, terminated but not reaped by its parent'},
+    {code: 'T', desc: 'Stopped, either by a job control signal or because it is being traced'}
+  ]
+
+  at_exit do
+    puts 'Exiting' if $!
+  end
+
+  #
+  # self.kill_by_results
+  #
+  def self.kill_by_results(results)
+    results.collect { |node| Process.kill 9, node.pid.to_i }
+  end
+
+  #
+  # self.ps
+  #
+  def self.ps(pid=nil)
+    array  = block_given? ? nil : []
+    struct = nil
+
+    raise TypeError unless pid.is_a?(Fixnum) if pid
+
+    pid.nil? ? get_process_list : get_process_list(pid: pid)
+  end
+
+  #
+  # self.search
+  #   -> (pid: 10238492, command: 'spring isofun rails')
+  #   -> (pid: 382973, user: 'alexmanelis')
+  #   -> ('spring rails server')
+  #
+  def self.search(args)
+    raise ArgumentError.new("Invalid arguments passed: #{args.inspect}") if args.nil?
+
+    process_list = get_process_list
+    process_body = process_list.body
+
+    matcher_instances = []
+    case args.class.to_s
+      when 'Hash'
+        args.map do |k, v|
+          matcher_instances << {instance: FuzzyMatch.new(process_body, read: k), query: v}
+        end
+      when 'String'
+        # matcher_instances << {instance: FuzzyMatch.new(process_body, read: :command),
+        #   query: args.strip.downcase}
+      else
+        raise ArgumentError.new("Invalid search args: #{args.inspect} -> #{args.class.inspect}")
+    end
+
+    if matcher_instances.empty?
+      results = process_body.select { |node| node.command.include?(args.downcase.strip) }
+    else
+      results = matcher_instances.inject([]) do |result, instance|
+        result << instance[:instance].find(instance[:query])
+      end
+    end
+
+    results
+  end
+
+private
+
+  #
+  # self.get_process_list
+  #
+  def self.get_process_list
+    yield if block_given?
+
+    begin
+      stdin, stdout, stderr = Open3.popen3("ps aux")
+
+      stdout = stdout.read
+      stderr = stderr.read
+    rescue => e
+      raise StandardError.new("Error opening stream from process list -> #{e}")
+    end
+
+    ProcIndex::Container.new(@fields, stdout)
+  end
+
+end

data/proc_index.gemspec

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'proc_index/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "proc_index"
+  gem.version       = ProcIndex::VERSION
+  gem.summary       = "Process table ORM"
+  gem.description   = "Map and search all your processes."
+  gem.license       = "MIT"
+  gem.authors       = ["Alex Manelis"]
+  gem.email         = "amanelis@gmail.com"
+  gem.homepage      = "https://rubygems.org/gems/proc_index"
+
+  gem.files         = `git ls-files`.split($/)
+
+  `git submodule --quiet foreach --recursive pwd`.split($/).each do |submodule|
+    submodule.sub!("#{Dir.pwd}/",'')
+
+    Dir.chdir(submodule) do
+      `git ls-files`.split($/).map do |subpath|
+        gem.files << File.join(submodule,subpath)
+      end
+    end
+  end
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_dependency 'awesome_print', '1.6.1'
+  gem.add_dependency 'fuzzy_match', '2.1.0'
+  gem.add_runtime_dependency 'hashie', '~> 3.4', '>= 3.4.3'
+  gem.add_development_dependency 'pry', '~> 0.10.3'
+
+  gem.add_development_dependency 'bundler', '~> 1.10'
+  gem.add_development_dependency 'rake', '~> 10.0'
+  gem.add_development_dependency 'rdoc', '~> 4.0'
+  gem.add_development_dependency 'rspec', '~> 3.0'
+  gem.add_development_dependency 'rubygems-tasks', '~> 0.2'
+end

data/spec/proc_index/container_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+require 'proc_index'
+
+require 'open3'
+
+describe ProcIndex::Container do
+  context '.new' do
+    let(:data) {
+      stdin, stdout, stderr = Open3.popen3("ps aux")
+      data = stdout.read
+      data
+    }
+
+    subject { ProcIndex::Container.new(ProcIndex::Fields, data) }
+
+    it { expect(subject).to_not be_nil }
+    it { expect(subject.body).to_not be_nil }
+    it { expect(subject.key).to_not be_nil }
+    it { expect(subject.fields).to eq(ProcIndex::Fields) }
+  end
+end

data/spec/proc_index_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+require 'proc_index'
+
+describe ProcIndex do
+  describe '.ps' do
+    context 'returns an instance of ProcIndex::Container' do
+      subject { ProcIndex.ps }
+      it { expect(subject).to_not be_nil }
+      it { expect(subject.body).to_not be_nil }
+    end
+  end
+
+  describe '.search' do
+    context 'returns a collection of Hashie::Mash objects' do
+      subject { ProcIndex.search('ruby') }
+      it { expect(subject).to_not be_nil }
+      it { expect(subject.count).to be > 1}
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rspec'
+require 'proc_index/version'
+
+include ProcIndex

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification
+name: proc_index
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alex Manelis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+- !ruby/object:Gem::Dependency
+  name: fuzzy_match
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.3
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Map and search all your processes.
+email: amanelis@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".document"
+- ".gitignore"
+- ".rdoc_options"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- ChangeLog.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/proc_index.rb
+- lib/proc_index/container.rb
+- lib/proc_index/util.rb
+- lib/proc_index/version.rb
+- proc_index.gemspec
+- spec/proc_index/container_spec.rb
+- spec/proc_index_spec.rb
+- spec/spec_helper.rb
+homepage: https://rubygems.org/gems/proc_index
+licenses:
+- MIT
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Process table ORM
+test_files:
+- spec/proc_index/container_spec.rb
+- spec/proc_index_spec.rb
+- spec/spec_helper.rb