djanowski-helm 0.0.2

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2008 Damian Janowski
+
+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.textile

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

data/Rakefile

@@ -0,0 +1,36 @@
+require 'rake'
+require 'rake/gempackagetask'
+require 'rake/clean'
+require 'spec/rake/spectask'
+
+gem_spec_file = 'helm.gemspec'
+
+gem_spec = eval(File.read(gem_spec_file)) rescue nil
+
+Rake::GemPackageTask.new(gem_spec) do |pkg|
+  pkg.need_zip = false
+  pkg.need_tar = false
+  rm_f FileList['pkg/**/*.*']
+end if gem_spec
+
+task :default => :spec
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "\"spec/spec.opts\""]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+desc "Generate the gemspec file."
+task :gemspec do
+  require 'erb'
+
+  File.open(gem_spec_file, 'w') do |f|
+    f.write ERB.new(File.read("#{gem_spec_file}.erb")).result(binding)
+  end
+end
+
+desc "Builds and installs the gem."
+task :install => :repackage do
+  `sudo gem install pkg/#{gem_spec.name}-#{gem_spec.version}.gem`
+end

data/bin/helm

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+
+require File.dirname(__FILE__) + '/../lib/helm'
+
+require 'yaml'
+
+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|
+    ARGV << "--#{k}=#{v}"
+  end if yaml
+
+  yaml
+end
+
+def argv(key)
+  start = "--#{key}="
+
+  value = ARGV.detect do |v|
+    v =~ /^#{Regexp.escape(start)}/
+  end
+
+  value[start.size..-1] if value
+end
+
+local_config = load_config('.helm_config')
+
+load_config('~/.helm_config') do |opts|
+  opts[argv(:url)]
+end
+
+Helm::Commands.const_get(ARGV.first.capitalize).new(Helm::Session.new).run

data/lib/helm.rb

@@ -0,0 +1,8 @@
+require File.dirname(__FILE__) + '/helm/lighthouse'
+require File.dirname(__FILE__) + '/helm/session'
+
+require File.dirname(__FILE__) + '/helm/commands/command'
+require File.dirname(__FILE__) + '/helm/commands/info'
+require File.dirname(__FILE__) + '/helm/commands/assign'
+require File.dirname(__FILE__) + '/helm/commands/create'
+require File.dirname(__FILE__) + '/helm/commands/resolve'

data/lib/helm/commands/assign.rb

@@ -0,0 +1,29 @@
+module Helm
+  module Commands
+    class Assign < Command
+      def run
+        ticket = session.ticket
+
+        if session.milestone
+          ticket.milestone_id = session.milestone.id
+          
+          if ticket.save
+            puts "##{ticket.id} Milestone changed: #{session.milestone || '(none)'} => #{session.milestone}"
+          end
+        else
+          new_assignee = session.user
+
+          assignee = session.user(ticket.assigned_user_id) if ticket.assigned_user_id
+
+          unless ticket.assigned_user_id && ticket.assigned_user_id == new_assignee.id
+            ticket.assigned_user_id = new_assignee.id
+
+            if ticket.save
+              puts "##{ticket.id} Assigned user changed: #{assignee || '(none)'} => #{new_assignee}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/helm/commands/command.rb

@@ -0,0 +1,11 @@
+module Helm
+  module Commands
+    class Command
+      attr_reader :session
+      
+      def initialize(session)
+        @session = session
+      end
+    end
+  end
+end

data/lib/helm/commands/create.rb

@@ -0,0 +1,58 @@
+module Lighthouse
+  class Ticket < Base
+    def body
+      attributes['body'] ||= ''
+    end
+
+    def body=(value)
+      attributes['body'] = value
+    end
+  end
+end
+
+module Helm
+  module Commands
+    class Create < Command
+      def run
+        ticket = nil
+
+        while line = $stdin.gets
+          line.strip!
+
+          if line.empty?
+            save(ticket)
+            ticket = nil
+            next
+          end
+
+          if ticket.nil?
+            ticket = session.new_ticket
+            ticket.title = line
+          else
+            unless line.empty?
+              ticket.body << line
+              ticket.body << "\n"
+            end
+          end
+        end
+
+        save(ticket)
+      end
+
+      protected
+
+        def save(ticket)
+          return unless ticket
+          ticket.title = ticket.title.sub(/^- ?/, '')
+          ticket.title = ticket.title.sub(/\.$/, '')
+          ticket.body = ticket.body.strip
+          ticket.save
+          puts "##{ticket.id} Created"
+          # puts "Title: #{ticket.title}"
+          # puts "Description: #{ticket.body}"
+          # puts "URL: http://citrusbyte.lighthouseapp.com/projects/18337/tickets/#{ticket.id}"
+        end
+      
+    end
+  end
+end

data/lib/helm/commands/info.rb

@@ -0,0 +1,16 @@
+module Helm
+  module Commands
+    class Info < Command
+      def run
+        ticket = session.ticket
+
+        puts "##{ticket.id} #{ticket.title}"
+
+        if ticket.description
+          puts "=="
+          puts ticket.description
+        end
+      end
+    end
+  end
+end

data/lib/helm/commands/resolve.rb

@@ -0,0 +1,15 @@
+module Helm
+  module Commands
+    class Resolve < Command
+      def run
+        ticket = session.ticket
+
+        ticket.state = 'resolved'
+        
+        if ticket.save
+          puts "##{ticket.id} Resolved"
+        end
+      end
+    end
+  end
+end

data/lib/helm/lighthouse.rb

@@ -0,0 +1,289 @@
+require 'rubygems'
+require 'activesupport'
+require 'activeresource'
+
+# Ruby lib for working with the Lighthouse API's XML interface.  
+# The first thing you need to set is the account name.  This is the same
+# as the web address for your account.
+#
+#   Lighthouse.account = 'activereload'
+#
+# Then, you should set the authentication.  You can either use your login
+# credentials with HTTP Basic Authentication or with an API Tokens.  You can
+# find more info on tokens at http://lighthouseapp.com/help/using-beacons.
+#
+#   # with basic authentication
+#   Lighthouse.authenticate('rick@techno-weenie.net', 'spacemonkey')
+#
+#   # or, use a token
+#   Lighthouse.token = 'abcdefg'
+#
+# If no token or authentication info is given, you'll only be granted public access.
+#
+# This library is a small wrapper around the REST interface.  You should read the docs at
+# http://lighthouseapp.com/api.
+#
+module Lighthouse
+  class Error < StandardError; end
+  class << self
+    attr_accessor :email, :password, :host_format, :domain_format, :protocol, :port
+    attr_reader :account, :token
+
+    # Sets the account name, and updates all the resources with the new domain.
+    def account=(name)
+      resources.each do |klass|
+        klass.site = klass.site_format % (host_format % [protocol, domain_format % name, ":#{port}"])
+      end
+      @account = name
+    end
+
+    # Sets up basic authentication credentials for all the resources.
+    def authenticate(email, password)
+      @email    = email
+      @password = password
+    end
+
+    # Sets the API token for all the resources.
+    def token=(value)
+      resources.each do |klass|
+        klass.headers['X-LighthouseToken'] = value
+      end
+      @token = value
+    end
+
+    def resources
+      @resources ||= []
+    end
+  end
+  
+  self.host_format   = '%s://%s%s'
+  self.domain_format = '%s.lighthouseapp.com'
+  self.protocol      = 'http'
+  self.port          = ''
+
+  class Base < ActiveResource::Base
+    def self.inherited(base)
+      Lighthouse.resources << base
+      class << base
+        attr_accessor :site_format
+      end
+      base.site_format = '%s'
+      super
+    end
+  end
+  
+  # Find projects
+  #
+  #   Lighthouse::Project.find(:all) # find all projects for the current account.
+  #   Lighthouse::Project.find(44)   # find individual project by ID
+  #
+  # Creating a Project
+  #
+  #   project = Lighthouse::Project.new(:name => 'Ninja Whammy Jammy')
+  #   project.save
+  #   # => true
+  #
+  # Creating an OSS project
+  # 
+  #   project = Lighthouse::Project.new(:name => 'OSS Project')
+  #   project.access = 'oss'
+  #   project.license = 'mit'
+  #   project.save
+  # 
+  # OSS License Mappings
+  # 
+  #   'mit' => "MIT License",
+  #   'apache-2-0' => "Apache License 2.0",
+  #   'artistic-gpl-2' => "Artistic License/GPLv2",
+  #   'gpl-2' => "GNU General Public License v2",
+  #   'gpl-3' => "GNU General Public License v3",
+  #   'lgpl' => "GNU Lesser General Public License"
+  #   'mozilla-1-1' => "Mozilla Public License 1.1"
+  #   'new-bsd' => "New BSD License",
+  #   'afl-3' => "Academic Free License v. 3.0"
+  
+  #
+  # Updating a Project
+  #
+  #   project = Lighthouse::Project.find(44)
+  #   project.name = "Lighthouse Issues"
+  #   project.public = false
+  #   project.save
+  #
+  # Finding tickets
+  # 
+  #   project = Lighthouse::Project.find(44)
+  #   project.tickets
+  #
+  class Project < Base
+    def tickets(options = {})
+      Ticket.find(:all, :params => options.update(:project_id => id))
+    end
+  
+    def messages(options = {})
+      Message.find(:all, :params => options.update(:project_id => id))
+    end
+  
+    def milestones(options = {})
+      Milestone.find(:all, :params => options.update(:project_id => id))
+    end
+  
+    def bins(options = {})
+      Bin.find(:all, :params => options.update(:project_id => id))
+    end
+    
+    def changesets(options = {})
+      Changeset.find(:all, :params => options.update(:project_id => id))
+    end
+
+    def to_s
+      name
+    end
+  end
+
+  class User < Base
+    def memberships
+      Membership.find(:all, :params => {:user_id => id})
+    end
+
+    def to_s
+      name
+    end
+  end
+  
+  class Membership < Base
+    site_format << '/users/:user_id'
+    def save
+      raise Error, "Cannot modify memberships from the API"
+    end
+  end
+  
+  class Token < Base
+    def save
+      raise Error, "Cannot modify Tokens from the API"
+    end
+  end
+
+  # Find tickets
+  #
+  #  Lighthouse::Ticket.find(:all, :params => { :project_id => 44 })
+  #  Lighthouse::Ticket.find(:all, :params => { :project_id => 44, :q => "state:closed tagged:committed" })
+  #
+  #  project = Lighthouse::Project.find(44)
+  #  project.tickets
+  #  project.tickets(:q => "state:closed tagged:committed")
+  #
+  # Creating a Ticket
+  #
+  #  ticket = Lighthouse::Ticket.new(:project_id => 44)
+  #  ticket.title = 'asdf'
+  #  ...
+  #  ticket.tags << 'ruby' << 'rails' << '@high'
+  #  ticket.save
+  #
+  # Updating a Ticket
+  #
+  #  ticket = Lighthouse::Ticket.find(20, :params => { :project_id => 44 })
+  #  ticket.state = 'resolved'
+  #  ticket.tags.delete '@high'
+  #  ticket.save
+  #
+  class Ticket < Base
+    attr_writer :tags
+    site_format << '/projects/:project_id'
+
+    def id
+      attributes['number'] ||= nil
+      number
+    end
+
+    def to_s
+      title
+    end
+
+    def tags
+      attributes['tag'] ||= nil
+      @tags ||= tag.blank? ? [] : parse_with_spaces(tag)
+    end
+    
+    def description
+      @description ||= version_body
+    end
+
+    def save_with_tags
+      self.tag = @tags.collect do |tag|
+        tag.include?(' ') ? tag.inspect : tag
+      end.join(" ") if @tags.is_a?(Array)
+      @tags = nil ; save_without_tags
+    end
+    
+    alias_method_chain :save, :tags
+
+    private
+      # taken from Lighthouse Tag code
+      def parse_with_spaces(list)
+        tags = []
+
+        # first, pull out the quoted tags
+        list.gsub!(/\"(.*?)\"\s*/ ) { tags << $1; "" }
+        
+        # then, get whatever's left
+        tags.concat list.split(/\s/)
+
+        cleanup_tags(tags)
+      end
+    
+      def cleanup_tags(tags)
+        returning tags do |tag|
+          tag.collect! do |t|
+            unless tag.blank?
+              t.downcase!
+              t.gsub! /(^')|('$)/, ''
+              t.gsub! /[^a-z0-9 \-_@\!']/, ''
+              t.strip!
+              t
+            end
+          end
+          tag.compact!
+          tag.uniq!
+        end
+      end
+
+      def version_body
+        version = versions.detect do |v|
+          v.body and v.body.any?
+        end and version.body
+      end
+  end
+  
+  class Message < Base
+    site_format << '/projects/:project_id'
+  end
+  
+  class Milestone < Base
+    site_format << '/projects/:project_id'
+
+    def to_s
+      title
+    end
+  end
+  
+  class Bin < Base
+    site_format << '/projects/:project_id'
+  end
+  
+  class Changeset < Base
+    site_format << '/projects/:project_id'
+  end
+  
+  class Change < Array; end
+end
+
+module ActiveResource
+  class Connection
+    private
+      def authorization_header
+        (Lighthouse.email || Lighthouse.password ? { 'Authorization' => 'Basic ' + ["#{Lighthouse.email}:#{Lighthouse.password}"].pack('m').delete("\r\n") } : {})
+      end
+  end
+end

data/lib/helm/project.rb

@@ -0,0 +1,28 @@
+require 'uri'
+require 'lib/lighthouse'
+
+module Helm
+  class Project
+    attr_accessor :url, :title, :token
+
+    def initialize(url)
+      @url = url
+    end
+
+    protected
+
+      def account
+        @account ||= uri.host.split('.').first
+      end
+      
+      def uri
+        @uri ||= URI.parse(url)
+      end
+
+      def configure
+        Lighthouse.account = account
+        Lighthouse.token = token
+      end
+
+  end
+end

data/lib/helm/session.rb

@@ -0,0 +1,88 @@
+gem 'choice'
+require 'choice'
+
+module Helm
+  class Session
+    attr_reader :options
+
+    def initialize
+      Choice.options do
+        option :url do
+          long '--url'
+          desc 'The project URL'
+        end
+
+        option :token do
+          long '--token'
+          desc 'The token to authenticate against the server'
+        end
+
+        option :project do
+          long '--project'
+          short '-p'
+          desc 'The project title'
+        end
+      end
+
+      @options = Choice.choices
+
+      configure
+    end
+
+    def project
+      @project ||= Lighthouse::Project.find(:all).detect {|p| p.name == options.project }
+    end
+
+    def new_ticket
+      Lighthouse::Ticket.new(:project_id => project.id)
+    end
+
+    def ticket(id = nil)
+      Lighthouse::Ticket.find(id || ticket_id, :params => {:project_id => project.id})
+    end
+
+    def milestone(id = nil)
+      if id
+        Lighthouse::Milestone.find(id)
+      else
+        @milestone ||= Lighthouse::Milestone.find(:all, :params => {:project_id => project.id}).detect {|m| m.title == ARGV[2] }
+      end
+    end
+
+    def ticket_id
+      ARGV[1].to_i
+    end
+
+    def user(id = nil)
+      if id
+        Lighthouse::User.find(id)
+      else
+        @user ||= Lighthouse::User.find(Lighthouse::Token.find(token).user_id)
+      end
+    end
+
+    protected
+
+      def account
+        @account ||= uri.host.split('.').first
+      end
+      
+      def uri
+        @uri ||= URI.parse(url)
+      end
+
+      def url
+        options.url
+      end
+
+      def token
+        options.token
+      end
+
+      def configure
+        Lighthouse.account = account
+        Lighthouse.token = token
+      end
+
+  end
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: djanowski-helm
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Damian Janowski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-06 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: choice
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 0.1.2
+    version: 
+description: 
+email: damian.janowski@gmail.com
+executables: 
+- helm
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- lib/helm/commands/assign.rb
+- lib/helm/commands/command.rb
+- lib/helm/commands/create.rb
+- lib/helm/commands/info.rb
+- lib/helm/commands/resolve.rb
+- lib/helm/lighthouse.rb
+- lib/helm/project.rb
+- lib/helm/session.rb
+- lib/helm.rb
+- README.textile
+- LICENSE
+- Rakefile
+has_rdoc: false
+homepage: 
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- helm
+- --main
+- README.textile
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A command-line tool for Lighthouse.
+test_files: []
+