maestro 0.0.1

data/bin/maestro

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'maestro'
+Maestro::CLI.run

data/lib/cli.rb

@@ -0,0 +1,75 @@
+require 'dispatcher'
+require 'commands/command'
+
+module Maestro
+  class CLI
+    class << self
+      def run
+        parse_options
+        read_config
+        
+        ActiveResource::Base.logger = Logger.new($stdout) if Config[:verbose]
+        abort("API Key is required") unless Config[:api_key]
+        
+        [ Story, Project ].each do |resource|
+          resource.headers['X-APIKey'] = Config[:api_key]
+        end
+        
+        puts Maestro::Dispatcher.invoke(ARGV.shift, ARGV)
+      rescue Maestro::Command::RuntimeError => e
+        puts e.message
+      rescue Maestro::Command::ArgumentError => e
+        puts e.message
+      end
+      
+      private
+    
+      def read_config
+        maestro = nil
+        if File.exist?('.maestro.yml')
+          verbose "Reading options from .maestro.yml"
+          maestro = YAML::load(File.read('.maestro.yml'))
+          
+          Config[:project_id] = maestro['project_id']
+        else
+          verbose "No options file .maestro.yml"
+        end
+        verbose "Using project ID #{Config[:project_id]}"
+      end
+    
+      def parse_options
+        option_parser = OptionParser.new do |opts|
+          opts.banner = "Usage: maestro [options] <command> [arguments]"
+          opts.on("-a", "--api-key=abc123", "Specify an API key to use for access (default: ENV['MAESTRO_API_KEY'])") { |o| Config[:api_key] = o }
+          opts.on("-p", "--project=13", "Specify project ID (default: read from ./.maestro.yml)") { |o| Config[:project_id] = o }
+          opts.on("-v", "--[no-]verbose", "Verbose output") { |o| Config[:verbose] = o }
+
+          opts.on_tail("--version", "Show version") do
+            puts 'Maestro CLI: 0.0.1'
+            exit
+          end
+
+          opts.on_tail("-h", "--help", "Show this message") do
+            puts opts
+            puts ""
+            Dispatcher.commands.each do |name, command|
+              puts command.describe
+              puts ""
+            end
+            exit
+          end
+        end
+      
+        begin
+          option_parser.parse!
+        rescue OptionParser::ParseError
+          abort("Error: #{$!}\noption_parser")
+        end
+      end
+    
+      def verbose(message)
+        puts messages if Config[:verbose]
+      end
+    end
+  end
+end

data/lib/commands/command.rb

@@ -0,0 +1,33 @@
+module Maestro
+  class Command
+    # to differentiate between where the error originated, we only want to
+    # rescue from ones that are raised from a Maestro::Command
+    class ArgumentError < ::ArgumentError;end;
+    class RuntimeError < ::RuntimeError;end;
+    
+    class << self
+      attr_reader :name
+      attr_reader :description
+      attr_reader :arguments
+      
+      def command(description=nil, arguments=nil)
+        @name        = self.to_s.split("::").last.downcase.to_sym
+        @description = description || ''
+        @arguments   = arguments || {}
+        
+        Maestro::Dispatcher.register self
+      end
+      
+      def describe
+        "#{name} #{arguments.collect{ |a, d| "<#{a}>"}}\n\t#{description}\n\t#{arguments.collect{ |a, desc| "<#{a}> - #{desc}" }.join(", ")}"
+      end
+    end
+    
+    def initialize(*args)
+    end
+    
+    def invoke
+      raise RuntimeError.new("#{self.class} has no invocation!")
+    end
+  end
+end

data/lib/commands/project_commands.rb

@@ -0,0 +1,26 @@
+class Maestro::Command::Info < Maestro::Command
+  command "Show info about the project"
+  
+  def invoke
+    project = Maestro::Project.find(Maestro::Config[:project_id], :params => { :context => 'user' })
+    [ "#{project.name}", "#{project.email}" ].join("\n")
+  end
+end
+
+class Maestro::Command::Init < Maestro::Command
+  command "Initialize the given project in the current directory", { "project" => "Name of project to initialize" }
+  
+  def initialize(project)
+    @project = project
+  end
+  
+  def invoke
+    project = Maestro::Project.find(@project, :params => { :context => 'user' })
+    File.open(".maestro.yml", "w") do |io|
+      io.puts "project_id: #{project.id}"
+    end
+    Dir.pwd + "/.maestro.yml written successfully"
+  rescue ActiveResource::ResourceNotFound
+    raise RuntimeError.new("Could not find project \"#{@project}\". Please double-check the name on Maestro.")
+  end
+end

data/lib/commands/story_commands.rb

@@ -0,0 +1,97 @@
+class Maestro::Command::List < Maestro::Command
+  command "List project stories"
+  
+  def invoke
+    Maestro::Story.find(:all, :params => { :context => 'user', :project_id => Maestro::Config[:project_id] }).collect do |story|
+      story.to_s
+    end.join("\n")
+  end
+end
+
+class Maestro::Command::Find < Maestro::Command
+  command "Find stories matching a regular expression", { 'query' => "Regular expression to use" }
+  
+  def initialize(query)
+    @query = query
+  end
+  
+  def invoke
+    stories = Maestro::Story.find(:all, :params => { :context => 'user', :project_id => Maestro::Config[:project_id] })
+    stories.select{ |s| s.title =~ Regexp.new(@query) }.collect do |story|
+      story.to_s
+    end.join("\n")
+  end
+end
+
+class Maestro::Command::StoryUpdater < Maestro::Command
+  private
+
+  def update(attribute, value)
+    story = Maestro::Story.find(@id, :params => { :context => 'user', :project_id => Maestro::Config[:project_id] })
+    story.update_attributes(attribute => value)
+    story
+  end
+end
+
+class Maestro::Command::Time < Maestro::Command::StoryUpdater
+  command "Update the actual time on the story", { 'time' => "Time spent working on story (HH:MM)" }
+  
+  def initialize(id, time)
+    @id   = id
+    @time = time
+  end
+  
+  def invoke
+    hours, minutes = @time.split(":")
+    story = update :time, (hours.to_i * 60 + (minutes.to_i || 0))
+    story.to_s + " time: #{(story.time / 60).to_i}:#{(story.time % 60).to_i}"
+  end
+end
+
+class Maestro::Command::StateUpdater < Maestro::Command::StoryUpdater
+  class << self;attr_reader :state;end;
+  
+  def initialize(id)
+    @id = id
+  end
+
+  def invoke
+    update_state
+  end
+  
+  private
+  
+  def update_state
+    update :state, self.class.state
+  end
+end
+
+class Maestro::Command::Start < Maestro::Command::StateUpdater
+  command "Start the story", { 'id' => "ID of story to start" }
+  @state = 'started'
+end
+
+class Maestro::Command::Finish < Maestro::Command::StateUpdater
+  command "Finish the story", { 'id' => "ID of story to finish" }
+  @state = 'finished'
+end
+
+class Maestro::Command::Deliver < Maestro::Command::StateUpdater
+  command "Deliver the story", { 'id' => "ID of story to deliver" }
+  @state = 'delivered'
+end
+
+class Maestro::Command::Accept < Maestro::Command::StateUpdater
+  command "Accept the story", { 'id' => "ID of story to accept" }
+  @state = 'accepted'
+end
+
+class Maestro::Command::Reject < Maestro::Command::StateUpdater
+  command "Reject the story", { 'id' => "ID of story to reject" }
+  @state = 'rejected'
+end
+
+class Maestro::Command::Cancel < Maestro::Command::StateUpdater
+  command "Cancel the story", { 'id' => "ID of story to cancel" }
+  @state = 'cancelled'
+end

data/lib/dispatcher.rb

@@ -0,0 +1,24 @@
+module Maestro
+  class Dispatcher
+    cattr_reader :commands
+    @@commands = {}
+    
+    class << self
+      def register(command)
+        commands[command.name] = command
+      end
+      
+      def invoke(name, args)
+        return false unless commands.has_key?(name.to_sym)
+        commands[name.to_sym].new(*args).invoke
+      end
+    end
+  end
+end
+
+Dir.glob(File.dirname(__FILE__) + '/commands/*.rb').each do |requirement|
+  require requirement
+end
+Dir.glob(File.dirname(__FILE__) + '/resources/*.rb').each do |requirement|
+  require requirement
+end

data/lib/maestro.rb

@@ -0,0 +1,18 @@
+require 'optparse'
+require 'rubygems'
+require 'logger'
+require 'activeresource'
+require 'yaml'
+
+$: << File.dirname(__FILE__)
+
+module Maestro
+  Config = {
+    :api_key    => ENV['MAESTRO_API_KEY'],
+    :project_id => nil,
+    :verbose    => false,
+    :host       => 'http://maestro.citrusbyte.com'
+  }
+end
+
+require 'cli'

data/lib/resources/project.rb

@@ -0,0 +1,5 @@
+module Maestro
+  class Project < ActiveResource::Base
+    self.site = Maestro::Config[:host] + "/:context"
+  end
+end

data/lib/resources/story.rb

@@ -0,0 +1,17 @@
+module Maestro
+  class Story < ActiveResource::Base
+    self.site = Maestro::Config[:host] + "/:context/projects/:project_id"
+    
+    def update_attributes(attributes={})
+      prefix_options[:context] = 'writer'
+      attributes.each do |attribute, value|
+        send "#{attribute}=", value
+      end
+      save
+    end
+    
+    def to_s
+      "#{id}\t#{title} (#{state})" + (owner_id ? " (#{self.owner_id})" : "")
+    end
+  end
+end

data/maestro.gemspec

@@ -0,0 +1,17 @@
+Gem::Specification.new do |s|
+  s.name              = "maestro"
+  s.version           = "0.0.1"
+  s.summary           = "A command line interface for Maestro project management."
+  s.description       = "A command line interface for Maestro project management."
+  s.authors           = ["Ben Alavi"]
+  s.email             = ["ben.alavi@citrusbyte.com"]
+  s.homepage          = "http://maestro.citrusbyte.com/"
+
+  s.rubyforge_project = "maestro"
+
+  s.executables << "maestro"
+
+  s.add_dependency("activeresource")
+
+  s.files = ["bin/maestro", "lib/cli.rb", "lib/commands/command.rb", "lib/commands/project_commands.rb", "lib/commands/story_commands.rb", "lib/dispatcher.rb", "lib/maestro.rb", "lib/resources/project.rb", "lib/resources/story.rb", "maestro.gemspec"]
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: maestro
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ben Alavi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-01 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activeresource
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A command line interface for Maestro project management.
+email: 
+- ben.alavi@citrusbyte.com
+executables: 
+- maestro
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/maestro
+- lib/cli.rb
+- lib/commands/command.rb
+- lib/commands/project_commands.rb
+- lib/commands/story_commands.rb
+- lib/dispatcher.rb
+- lib/maestro.rb
+- lib/resources/project.rb
+- lib/resources/story.rb
+- maestro.gemspec
+has_rdoc: true
+homepage: http://maestro.citrusbyte.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: maestro
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A command line interface for Maestro project management.
+test_files: []
+