djanowski-helm 0.0.3 → 0.0.4

data/README.markdown

@@ -0,0 +1,65 @@
+Helm – a command line tool for Lighthouse
+=========================================
+
+_Disclaimer_: This is alpha software. Seriously. Expect breakages and changes in the way configuration is made. We'll do our best to alert you and keep things as backwards-compatible as possible.
+
+Lighthouse is pretty cool, but it'd be nice if we had a way to interact with it from the command line.
+
+Configuration
+-------------
+
+Although Helm can receive all the parameters it needs from the command line, usually you'll want to use the configuration files. Our recommended usage is that you have a `.helm_config` in your home directory, where you store your Lighthouse credentials, and another `.helm_config` that lives in the root of your project's directory (this file contains general information about the project and can be pushed to your SCM of choice.
+
+1. Edit `~/.helm_config` and add your credentials for the account. You can provide a token (recommended) or your username and password (this is necessary if you want to use scraping commands like `upload`).
+
+        http://account.lighthouseapp.com:
+          token: API token
+          username: username
+          password: password
+
+2. Edit your project's `.helm_config`.
+
+        url: http://account.lighthouseapp.com
+        project: "Your project's full name"
+
+3. Try it.
+
+        $ helm list
+
+Commands
+--------
+
+This *will* change.
+
+### `helm list` ###
+  
+Examples:
+
+    $ helm list state:open
+    $ helm list "responsible:me state:open"
+
+### `helm create` ###
+
+Parses STDIN and creates tickets.
+
+Examples:
+
+    $ echo "As a User I want a UI" | helm create
+    $ cat stories.txt | helm create
+
+### `helm show` ###
+
+Displays information about a ticket.
+
+Examples:
+
+    $ helm show 13
+
+### `helm assign` ###
+
+Changes the assignee of a ticket. If no user is provided, assign to self.
+
+Examples:
+
+    $ helm assign 13
+    $ helm assign 13 [Lighthouse user ID]

data/bin/helm

@@ -1,41 +1,27 @@
 #!/usr/bin/env ruby
 
 require 'rubygems'
-
-require File.dirname(__FILE__) + '/../lib/helm'
-
-require 'yaml'
+require 'drawer'
+require 'helm'
 
 def argv(key)
   start = "--#{key}="
-
-  value = ARGV.detect do |v|
-    v =~ /^#{Regexp.escape(start)}/
-  end
-
+  value = ARGV.detect { |v| v =~ /^#{Regexp.escape(start)}/ }
   value[start.size..-1] if value
 end
 
-def load_config(file)
-  file = File.expand_path(file)
-
-  return {} unless File.exist?(file)
-
-  yaml = YAML::load_file(file)
-  
-  yaml = yield(yaml) if block_given?
-
-  yaml.each do |k,v|
+def append_arguments(args)
+  args.each do |k, v|
     ARGV << "--#{k}=#{v}" unless argv(k)
-  end if yaml
-
-  yaml
+  end
 end
 
-local_config = load_config('.helm_config')
+Drawer.open('.helm/config') do |config|
+  append_arguments(config.cache)
+end
 
-load_config('~/.helm_config') do |opts|
-  opts[argv(:url)]
+Drawer.open('~/.helm_config') do |config|
+  append_arguments(config.get(argv(:url)))
 end
 
 Helm::Commands.const_get(ARGV.first.capitalize).new(Helm::Session.new).run

data/lib/helm/commands/command.rb

@@ -2,6 +2,10 @@ module Helm
   module Commands
     class Command
       attr_reader :session
+
+      def cache
+        session.cache
+      end
       
       def parameters(*names)
         session.configure_params(*names)

data/lib/helm/commands/list.rb

@@ -8,9 +8,16 @@ module Helm
 
         puts "Tickets with filter \"#{filter}\""
         session.tickets(filter).each do |ticket|
-          puts "  ##{ticket.id} #{ticket.title}"
+          assignee = ticket.assigned_user_id ?
+            find_user(ticket.assigned_user_id).name : "Unassigned"
+          puts "  ##{ticket.id} #{ticket.title} (#{assignee})"
         end
       end
+
+      def find_user(id)
+        user_id = "user-%s" % id
+        cache.get(user_id) || cache.set(user_id, session.user(id))
+      end
     end
   end
 end

data/lib/helm/commands/upload.rb

@@ -14,9 +14,7 @@ module Helm
           form.file_uploads.first.file_name = filename
 
           agent.submit(form)
-        end if false
-
-        puts "EMBED" if argv('--embed')
+        end
       end
 
       protected

data/lib/helm/lighthouse.rb

@@ -1,5 +1,7 @@
 require 'rubygems'
-require 'activesupport'
+
+gem 'activeresource', '>= 2.2.2'
+
 require 'activeresource'
 
 # Ruby lib for working with the Lighthouse API's XML interface.  

data/lib/helm/session.rb

@@ -4,6 +4,7 @@ require 'choice'
 module Helm
   class Session
     attr_reader :options
+    attr_reader :cache
 
     def initialize
       Choice.options do
@@ -35,6 +36,7 @@ module Helm
       end
 
       @options = Choice.choices
+      @cache = Drawer.open!('.helm/cache')
 
       configure
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: djanowski-helm
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Damian Janowski
@@ -21,6 +21,24 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.1.2
     version: 
+- !ruby/object:Gem::Dependency 
+  name: soveran-drawer
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.4
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activeresource
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.2.2
+    version: 
 description: 
 email: damian.janowski@gmail.com
 executables: 
@@ -28,7 +46,7 @@ executables:
 extensions: []
 
 extra_rdoc_files: 
-- README.textile
+- README.markdown
 files: 
 - lib/helm/commands/assign.rb
 - lib/helm/commands/command.rb
@@ -42,7 +60,8 @@ files:
 - lib/helm/project.rb
 - lib/helm/session.rb
 - lib/helm.rb
-- README.textile
+- README.html
+- README.markdown
 - LICENSE
 - Rakefile
 has_rdoc: false
@@ -54,7 +73,7 @@ rdoc_options:
 - --title
 - helm
 - --main
-- README.textile
+- README.markdown
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 

data/README.textile

@@ -1 +0,0 @@
-Helm