werk 0.0.3

data/README.md

@@ -0,0 +1,16 @@
+I Go To Werk
+============
+
+Werk is a wrapper that combines the ability to query and manipulate tickets in 
+Trac with the ability to create and manage repository branches in git. Behaviour is defined largely via .werkrc files, which are scanned in order up the filesystem from your current location. This makes it possible to define workflow via .werkrc files located in-project, with sensible per-user definitions for defaults. 
+
+TODO
+====
+
+- start using trac actions
+- come up with a better way of baking branch / ticket names
+- start using optparse
+- add more workflows to wrap add
+- add documentation for the various commands (possibly generate this from doc?)
+- move definitions out to .werkrc files
+- factor trac and git out from global namespace

data/Rakefile

@@ -0,0 +1,7 @@
+require 'rspec/core/rake_task'
+desc "Run all tests"
+RSpec::Core::RakeTask.new('spec') do |t|
+  t.pattern = 'spec/**/*.rb'
+end
+
+task :default => :spec

data/bin/werk

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'werk/cli'
+
+Werk::CLI.start

data/lib/werk.rb

@@ -0,0 +1 @@
+require 'werk/base'

data/lib/werk/base.rb

@@ -0,0 +1,63 @@
+require 'rubygems'
+require 'yaml'
+
+require 'werk/trac'
+require 'werk/git'
+require 'werk/commands'
+
+module Werk
+  class Base
+    include Werk::Trac
+    include Werk::Git
+    include Werk::Commands
+
+    def initialize(runtime_options = {})
+      if runtime_options[:rcfile] && File.file?(runtime_options[:rcfile])
+        # If the user explicitly specified an rcfile, just use that instead
+        options = YAML.load_file(File.expand_path(runtime_options[:rcfile]))
+      else
+        # Go all the way to the root looking for .werkrcs, then apply them in 
+        # reverse order to ensure local changes trump more global ones
+        current = Dir.pwd
+        options = {}
+
+        loop do
+          %w( .werkrc ).each do |file|
+            if File.file?(file)
+              # Do this backwards so we give more nested files precendece
+              puts "Loading options from #{File.join(Dir.pwd,file)}" if runtime_options[:verbose]
+              options = YAML.load_file(file).merge(options)
+            end
+          end
+          pwd = Dir.pwd
+          Dir.chdir("..")
+          break if pwd == Dir.pwd # if changing the directory made no difference, then we're at the top
+        end
+        Dir.chdir(current)
+      end
+
+      # Now read in any explicitly specified arguments
+      options.merge!(runtime_options)
+      options.each do |option, value|
+        self.instance_variable_set "@#{option.to_s}", value
+      end
+    end
+
+    def requires_variables(vars)
+      vars.each do |option|
+        if !self.instance_variable_defined? "@#{option}"
+          puts(<<-EOM)
+
+You need to specify a value for #{option}. To do so, add a line like
+
+#{option}: <value>
+
+to your ~/.werkrc file (or any other .werkrc up the directory hierarchy)
+
+EOM
+          exit
+        end
+      end
+    end
+  end
+end

data/lib/werk/cli.rb

@@ -0,0 +1,43 @@
+require 'optparse'
+require 'werk/base'
+
+module Werk
+  module CLI
+    module Options
+      def self.order!(args)
+        options = {}
+        optparse = OptionParser.new do |opts|
+          opts.banner = "Usage: werk [options] <command> [arguments]"
+
+          opts.on( '-f', '--rcfile FILE', 'Load the specified werkrc file (in lieu of .werkrc files)' ) do |file|
+            options[:rcfile] = file
+          end
+
+          opts.on( '-v', '--verbose', 'Be verbose' ) do
+            options[:verbose] = true
+          end
+
+          opts.on( '-h', '--help', 'Display this screen' ) do
+            puts opts
+            exit
+          end
+        end
+        begin
+          optparse.order!(args)
+          raise "You need to specify a command" if args.empty?
+        rescue
+          puts $!
+          puts optparse
+          exit
+        end
+        options
+      end
+    end
+
+    def self.start
+      inst = Werk::Base.new(Options.order!(ARGV))
+      result = inst.send ARGV.shift, *ARGV
+      puts result unless result.nil?
+    end
+  end
+end

data/lib/werk/commands.rb

@@ -0,0 +1,97 @@
+module Werk
+  module Commands
+    def list
+      ticket_list
+    end
+    
+    def show(branch=nil)
+      branch = repo_current_head unless branch
+      
+      # This'll throw if we can't get a ticket out
+      ticket = branch2ticket(branch)
+      system "open #{@trac_url.sub('xmlrpc', 'ticket/' + ticket)}"
+    end
+
+    def start(ticket, *args)
+      # Are we starting a hotfix?
+      hotfix = args.include? "--hotfix"
+      
+      # Start a ticket named 'ticket', branching from the correct place if needed
+      repo_branch(ticket2branch(ticket, hotfix), (hotfix)? "production" : "master")
+      
+      # Push the branch up to origin
+      repo_push
+      
+      # Annotate the ticket
+      take_action(branch2ticket(ticket), "start")
+    end
+    
+    def markfortest(branch = nil)
+      take_action(branch, "testing")
+    end
+    
+    def markrejected(branch = nil)
+      take_action(branch, "reject")
+    end
+    
+    def markaccepted(branch = nil)
+      take_action(branch, "pass")
+    end
+    
+    def mergeandclose(branch = nil)
+      branch = repo_current_head unless branch
+      
+
+      # This'll throw if we can't get a ticket out
+      ticket = branch2ticket(branch)
+
+      # Push the branch
+      repo_checkout(branch)
+      repo_pull
+      repo_push
+      
+      # Pull a new master / production
+      targets = ["master"]
+      targets << "production" if branch.include? "hotfix"
+      targets.each do |target|
+        repo_checkout(target)
+        repo_pull
+        repo_merge(branch)
+        repo_push
+      end
+
+      # Annotate the ticket
+      take_action(ticket, "merged")
+    end
+    
+    private
+    def take_action(branch, action)
+      branch = repo_current_head unless branch
+
+      # This'll throw if we can't get a ticket out
+      ticket = branch2ticket(branch)
+      
+      # Push the branch
+      repo_push
+
+      # Annotate the ticket according to the action
+      actions = ticket_actions(ticket).map { |x| x[0] }
+
+      raise "#{action} is not a valid action for ticket #{ticket}. Valid actions are #{actions.join ', '}" unless actions.include? action
+      ticket_annotate(ticket, "Changed via werk", :action => action)
+
+      nil
+    end
+    
+    def ticket2branch(name, hotfix = false)
+      prefix = (hotfix)? "hotfix" : "ticket"
+      "#{prefix}_#{branch2ticket(name)}"
+    end
+    
+    def branch2ticket(name)
+      result = /\D*(\d*).*/.match(name)[1]
+      raise "Not on a ticket branch" if result.nil?
+      result
+    end
+  end
+end

data/lib/werk/git.rb

@@ -0,0 +1,36 @@
+module Werk
+  module Git
+    def repo_checkout(new_branch, *args)
+      system "git co #{new_branch}"
+    end
+
+    def repo_branch(new_branch, source_branch = "HEAD", *args)
+      require_clean
+      system "git co -b #{new_branch} #{source_branch}"
+    end
+
+    def repo_merge(from_branch, *args)
+      require_clean
+      system "git merge --no-ff #{from_branch}"
+    end
+
+    def repo_push(remote = "origin")
+      require_clean
+      system "git push #{remote} HEAD"
+    end
+
+    def repo_pull(remote = "origin")
+      require_clean
+      system "git pull #{remote}"
+    end
+    
+    def repo_current_head
+      `git symbolic-ref HEAD`.gsub("refs/heads/", "")
+    end
+    
+    private
+    def require_clean
+      raise "Your working copy isn't clean" unless system "git diff --quiet"
+    end
+  end
+end

data/lib/werk/trac.rb

@@ -0,0 +1,49 @@
+require 'trac4r'
+require 'erb'
+
+module Werk
+  module Trac
+    def ticket_list(*args)
+      setup_trac
+      conditions = {}
+      conditions[:owner] = @trac_user unless args.include? "--everyone"
+      conditions[:status] = "!closed" unless args.include? "--all"
+      @trac.tickets.query(conditions).each do |ticket_id|
+        ticket_show(ticket_id, :oneline)
+      end
+    end
+    
+    def ticket_show(ticket_id, format = :long)
+      setup_trac
+      ticket = ticket_get(ticket_id)
+      case format
+      when :long
+        template = File.read(File.join(File.dirname(__FILE__), '..', '..', 'templates', 'ticket_show.erb'))
+        ERB.new(template).result(ticket.send :binding)
+      when :oneline
+        "#{ticket.id}: #{ticket.summary} (#{ticket.status})"
+      end
+    end
+    
+    def ticket_actions(ticket_id)
+      setup_trac
+      @trac.tickets.actions(ticket_id)
+    end
+
+    def ticket_annotate(ticket_id, comment, attributes = {})
+      setup_trac
+      @trac.tickets.update ticket_id.to_i, comment, attributes, false
+    end
+    
+    private
+    def ticket_get(ticket_id)
+      setup_trac
+      @trac.tickets.get ticket_id
+    end
+    
+    def setup_trac
+      requires_variables %w( trac_url trac_user trac_password )
+      @trac = ::Trac.new(@trac_url, @trac_user, @trac_password) unless defined? @trac
+    end
+  end
+end

data/templates/ticket_show.erb

@@ -0,0 +1,13 @@
+ID:            <%= id %>
+Owner:         <%= owner %>
+Reported By:   <%= reporter %>
+Created:       <%= created_at.to_time %>
+Last Updated:  <%= updated_at.to_time %>
+Status:        <%= status %>
+Summary:       <%= summary %>
+Type:          <%= type %>
+Priority:      <%= priority %>
+
+Description:
+
+<%= description %>

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: werk
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 3
+  version: 0.0.3
+platform: ruby
+authors: 
+- Mat Trudel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-30 00:00:00 -05:00
+default_executable: werk
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: trac4r
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: "werk combines ticketing and repos into definable workflows. I go to werk. "
+email: 
+- mat@geeky.net
+executables: 
+- werk
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- README.md
+- Rakefile
+- bin/werk
+- lib/werk.rb
+- lib/werk/base.rb
+- lib/werk/cli.rb
+- lib/werk/commands.rb
+- lib/werk/git.rb
+- lib/werk/trac.rb
+- templates/ticket_show.erb
+has_rdoc: true
+homepage: http://github.com/mtrudel/werk
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: werk is a developer workflow tool that makes teams happy
+test_files: []
+