hal9000 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hal9000.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 David Rodrigues
+
+MIT License
+
+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,70 @@
+# hal9000
+
+hal maps your commands to an human readable form, you  just need to think what you want to do and hal will do it for you with pleasure! It's like a domain for  a not-easy-to-remember ip but for your commands.
+
+## Motivation
+
+Aliases are extremely helpful and simple but they are not always self descriptive and easy to remember. Hal is an helper for this, it helps manage your aliases, create, delete, keep them on a single location. Finally it maps your actions into your thoughts. Thoughts? What?
+
+I give you an example. I'm currently using a remote server and the access is made directly by the ip address. I found that very boring and hard to remember.
+
+Well, this was before hal. Now i can simply do:
+
+    hal connect to my remote server
+    
+Hal will recognize this and will map to my `ssh user@x.x.x.x` command. I found it helpful.
+
+### Inspiration
+
+I developed hal with some inspiring references in mind.
+
+ 1. [HUBOT](http://hubot.github.com/) from Github.
+ 2. [boom](http://zachholman.com/boom) from Zach Holman.
+ 3. [HAL 9000](http://en.wikipedia.org/wiki/HAL_9000), the super computer from the `2001: A Space Odyssey` movie.
+
+## Installation
+
+Install it via RubyGems:
+
+    $ gem install hal9000
+
+## Usage
+
+    example usage:
+      hal --list                          lists all actions
+      hal --create <thought> <action>     create a new action
+      hal --delete <thought>              delete an action
+
+      hal <thought>                       execute an action
+
+      hal --version                       show hal version
+      hal --help                          show this shiny help
+
+## Examples
+
+    $ hal --create "say hello" "echo 'Hello'"
+    $ hal say hello
+    you - say hello
+    hal - right way sir! running: 'echo 'Hello''
+    Hello
+    
+    $ hal --create "start jenkins" "java -jar /usr/local/opt/jenkins/libexec/jenkins.war"
+    $ hal start jenkins
+    (jenkins starts)
+    ...
+    
+    $ hal --create "copy my ssh key" "pbcopy < ~/.ssh/id_rsa.pub"
+    $ hal copy my ssh key
+    (key copied to clipboard)
+
+## Portability
+
+Hal uses a single JSON file to store all your thoughts and actions. This file is a pure JSON file and is available on your `$HOME` directory with the name `.hal`. Alternatively, it's possible to configure the location of this file using an enviroment variable with the name `HAL_FILE`.
+
+## Contributing
+
+Hal is currently in a very alpha version so any help is very welcome. Just fork it! :)
+
+## Licence
+
+[MIT License](http://en.wikipedia.org/wiki/MIT_License) (c) [David Rodrigues](mailto:david.ndh@gmail.com)

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/hal

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+
+require 'hal9000'
+
+HAL9000::Command.execute(ARGV)

data/hal9000.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hal9000/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hal9000"
+  spec.version       = HAL9000::VERSION
+
+  spec.authors       = ["David Rodrigues"]
+  spec.email         = ["david.ndh@gmail.com"]
+  spec.homepage      = "https://github.com/dmcrodrigues/hal9000"
+  spec.license       = "MIT"
+
+  spec.description   = "hal uses your thoughts as an alias to your commands. 
+  think of what you want to do and hal will run it for you."
+  spec.summary       = "hal maps your commands to an human readable form, you 
+  just need to think what you want to do and hal will do it for you with pleasure!
+  It's like a domain for a not-easy-to-remember ip but for your commands."
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "oj", "~> 2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/hal9000.rb

@@ -0,0 +1,16 @@
+
+require "oj"
+
+require "hal9000/version"
+require "hal9000/command"
+require "hal9000/action"
+require "hal9000/actionstore"
+require "hal9000/manager"
+
+module HAL9000
+  
+  def self.manager
+    @manager ||= Manager.new
+  end
+
+end

data/lib/hal9000/action.rb

@@ -0,0 +1,24 @@
+# coding: utf-8
+
+module HAL9000
+  class Action
+
+    attr_accessor :thought
+
+    attr_accessor :action
+
+    def initialize(thought, action)
+      @thought = thought
+      @action = action
+    end
+
+    def <=>(other)
+      @thought <=> other.thought
+    end
+
+    def to_s
+      "#{thought} => #{action}"
+    end
+
+  end # class Action
+end # module HAL9000

data/lib/hal9000/actionstore.rb

@@ -0,0 +1,35 @@
+# coding: utf-8
+
+module HAL9000
+  class ActionStore
+
+    attr_accessor :actions
+
+    def initialize
+      @actions = []
+    end
+
+    def add_action(action)
+      unless find_action(action.thought) 
+        actions << action
+      end
+    end
+
+    def find_action(thought)
+      actions.find do |action|
+        action.thought.casecmp(thought) == 0
+      end
+    end
+
+    def delete_action(thought)
+      actions.reject! { |action| action.thought == thought }
+    end
+
+    def list
+      actions.sort.each do |action|
+        puts action
+      end
+    end
+
+  end # class ActionStore
+end # module HAL9000

data/lib/hal9000/command.rb

@@ -0,0 +1,94 @@
+# coding: utf-8
+
+module HAL9000
+  class Command
+    class << self
+
+      def manager 
+        HAL9000.manager
+      end
+
+      def execute(args)
+        case args.first when '--help', 'help', '-h', '--usage', nil
+          help
+        when '--version'
+          version
+        when '--list'
+          list
+        when '--create'
+          thought, action = args[1], args[2]
+          return help unless thought && action
+          create(thought, action)
+        when '--delete'
+          thought = args[1]
+          return help unless thought
+          delete(thought)
+        else
+          thought = args.join(' ')
+          return help unless thought
+          execute_action(thought)
+        end
+      end
+
+      def list
+        puts "hal - here are the thoughts that we've shared."
+        puts "----------------------------------------------"
+        manager.list_actions
+      end
+
+      def create(thought, action)
+        if manager.create_action(thought, action)
+          puts "hal - done! i will keep this in mind for you."
+        else
+          puts "hal - clash of thoughts! you already have this thought."
+        end
+      end
+
+      def delete(thought)
+        if manager.delete_action(thought)
+          puts "hal - gone! keep me posted if you think on this again."
+        else
+          puts "hal - maybe you are confused, i don't have this thought."
+        end
+      end
+
+      def execute_action(thought)
+        action_item = manager.find_action(thought)
+        unless action_item
+          puts "you - #{thought}"
+          puts "hal - i don't know what you mean. maybe this will help."
+          help
+        else
+          begin
+            puts "you - #{thought}"
+            puts "hal - right way sir! running: '#{action_item.action}'"
+            system(action_item.action)
+          rescue Exception => e 
+            puts "hal - oops! i can't perform this action. here, maybe this will help."
+            puts e
+          end
+        end
+      end
+
+      def help
+        help_text = <<-EOS
+          example usage:
+            hal --list                          lists all actions
+            hal --create <thought> <action>     create a new action
+            hal --delete <thought>              delete an action
+
+            hal <thought>                       execute an action
+
+            hal --version                       show hal version
+            hal --help                          show this shiny help
+          EOS
+        puts help_text.gsub(/^ {10}/, '')
+      end
+
+      def version
+        puts "hal - i'm currently running the version #{HAL9000::VERSION}"
+      end
+
+    end # class << self
+  end # class Command
+end # module HAL9000

data/lib/hal9000/manager.rb

@@ -0,0 +1,58 @@
+# coding: utf-8
+
+module HAL9000
+  class Manager
+
+    HAL_FILE = "#{ENV['HOME']}/.hal"
+
+    attr_accessor :actionstore
+
+    def initialize
+      @actionstore = ActionStore.new
+      populate
+    end
+
+    def list_actions
+      actionstore.list
+    end
+
+    def create_action(thought, action)
+      action = Action.new(thought, action)
+      return unless actionstore.add_action(action)
+      persist
+    end
+
+    def delete_action(thought)
+      return unless actionstore.delete_action(thought)
+      persist
+    end
+
+    def find_action(thought)
+      actionstore.find_action(thought)
+    end
+
+    # Persistence ==============================================================
+
+    def hal_file
+      ENV['HAL_FILE'] || HAL_FILE
+    end
+
+    def populate
+      unless !File.exist?(hal_file)
+        storage = Oj.load(IO.read(hal_file), { :mode => :compat, :indent => 2 })
+        storage['actions'].each do |action|
+          actionstore.add_action(Action.new(action['thought'], action['action']))
+        end
+      end
+    end
+
+    def persist
+      File.open(hal_file, 'w') { |f| f.write(to_json) }
+    end
+
+    def to_json
+      Oj.dump(actionstore, { :mode => :compat, :indent => 2 })
+    end
+
+  end # class Manager
+end # module HAL9000

data/lib/hal9000/version.rb

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

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: hal9000
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- David Rodrigues
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "hal uses your thoughts as an alias to your commands. \n  think of
+  what you want to do and hal will run it for you."
+email:
+- david.ndh@gmail.com
+executables:
+- hal
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/hal
+- hal9000.gemspec
+- lib/hal9000.rb
+- lib/hal9000/action.rb
+- lib/hal9000/actionstore.rb
+- lib/hal9000/command.rb
+- lib/hal9000/manager.rb
+- lib/hal9000/version.rb
+homepage: https://github.com/dmcrodrigues/hal9000
+licenses:
+- MIT
+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: 1227463475522443602
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1227463475522443602
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: hal maps your commands to an human readable form, you  just need to think
+  what you want to do and hal will do it for you with pleasure! It's like a domain
+  for a not-easy-to-remember ip but for your commands.
+test_files: []