RubyGems - mislav-ticgit - Versions diffs - 0.3.6 - Mend

mislav-ticgit 0.3.6

Files changed (8) hide show

data/bin/ti ADDED

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# This is a command line client that does all the actual tic commands
+#
+# authors: Scott Chacon <schacon@gmail.com>
+#          Mislav Marohnić <mislav.marohnic@gmail.com>
+require File.dirname(__FILE__) + "/../lib/ticgit"
+TicGit::CLI::start()

data/bin/ticgitweb ADDED

@@ -0,0 +1,403 @@
+#!/usr/bin/env ruby
+# starts a sinatra based web server that provides an interface to
+# your ticgit tickets
+#
+# some of the sinatra code borrowed from sr's git-wiki
+#
+# author: Flurin Egger
+# original author : Scott Chacon (schacon@gmail.com)
+#
+%w(rubygems sinatra git ticgit haml sass).each do |dependency|
+  begin
+    require dependency
+  rescue LoadError => e
+    puts "You need to install #{dependency} before we can proceed"
+  end
+end
+# !! TODO : if ARGV[1] is a path to a git repo, use that
+# otherwise, look in ~/.ticgit
+$ticgit = TicGit.open('.')
+# Always load saved searches. (used in navigation)
+before do
+  @saved = $ticgit.config['list_options'].keys rescue []
+end
+# Stylesheets
+get('/_stylesheet.css') do
+  header("Content-Type" =>  "text/css;charset=utf-8")
+  sass :stylesheet_all
+end
+get('/_print.css') do
+  header("Content-Type" =>  "text/css;charset=utf-8")
+  sass :stylesheet_print
+end
+# ticket list view
+get '/' do
+  @tickets = $ticgit.ticket_list(:order => 'date.desc')
+  haml :list, :locals => {:title => "All tickets"}
+end
+get '/fs/:state' do
+  @tickets = $ticgit.ticket_list(:state => params[:state], :order => 'date.desc')
+  haml :list, :locals => {:title => "#{params[:state].to_s.capitalize} tickets"}
+end
+get '/tag/:tag' do
+  @tickets = $ticgit.ticket_list(:tag => params[:tag], :order => 'date.desc')
+  haml :list, :locals => {:title => "All tickets with tag '#{params[:tag]}'"}
+end
+get '/sv/:saved_view' do
+  @tickets = $ticgit.ticket_list(:saved => params[:saved_view])
+  haml :list, :locals => {:title => "All tickets in view '#{params[:saved_view]}'"}
+end
+# ticket single view
+get '/ticket/:ticket' do
+  @ticket = $ticgit.ticket_show(params[:ticket])
+  haml :show, :locals => {:title => "Ticket #{@ticket.ticket_id}"}
+end
+# add ticket
+get '/t/new' do
+  haml :new, :locals => {:title => "Create new ticket"}
+end
+# add ticket finalize
+post '/t/new' do
+  title = params[:title].to_s.strip
+  if title.size > 1
+    tags = params[:tags].split(',').map { |t| t.strip } rescue nil
+    t = $ticgit.ticket_new(title, {:description => params[:description].strip, :tags => tags})
+    redirect '/ticket/' + t.ticket_id.to_s
+  else
+    redirect '/t/new'
+  end
+end
+# add comment
+post '/a/add_comment/:ticket' do
+  t = $ticgit.ticket_comment(params[:comment], params[:ticket])
+  redirect '/ticket/' + params[:ticket]
+end
+# add tag
+post '/a/add_tags/:ticket' do
+  t = $ticgit.ticket_tag(params[:tags], params[:ticket])
+  redirect '/ticket/' + params[:ticket]
+end
+# change ticket state
+get '/a/change_state/:ticket/:state' do
+  $ticgit.ticket_change(params[:state], params[:ticket])
+  redirect '/ticket/' + params[:ticket]
+end
+use_in_file_templates!
+__END__
+## layout
+:plain
+  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+%html{:xmlns => "http://www.w3.org/1999/xhtml", "xml:lang" =>  "en", :lang=>"en"}
+  %head
+    %title= title
+    %link{:rel => 'stylesheet', :href => '/_stylesheet.css', :type => 'text/css', :media => 'all'}
+    %link{:rel => 'stylesheet', :href => '/_print.css', :type => 'text/css', :media => 'print'}
+    %meta{'http-equiv' => 'Content-Type', :content => 'text/html; charset=utf-8'}
+  %body
+    #wrapper
+      #action
+        %a{:href => '/t/new'} New Ticket
+      %ul#navigation
+        %li
+          %a{:href => '/'} All
+        %li
+          %a{:href => '/fs/open'} Open
+        %li
+          %a{:href => '/fs/resolved'} Resolved
+        %li
+          %a{:href => '/fs/hold'} Hold
+        %li
+          %a{:href => '/fs/invalid'} Invalid
+        - if @saved && !@saved.empty?
+          %li | Saved:
+          %ul.saved
+          - @saved.each do |s|
+            %li
+              %a{:href => "/sv/\#{s}"}= s
+      = yield
+## list
+%h1= title
+- if @tickets.empty?
+  %p No tickets found.
+- else
+  %table.long
+    %thead
+      %tr
+        %th SHA
+        %th.ticket Ticket
+        %th State
+        %th Created&nbsp;at
+        %th Created&nbsp;by
+        %th Tags
+    %tbody
+      - c = 'even'
+      - @tickets.each do |t|
+        %tr{:class => (c == 'even' ? c = 'odd' : c = 'even') }
+          %td
+            %a{:href => "/ticket/#{t.ticket_id}" }
+              %code= t.ticket_id[0,6]
+          %td
+            %strong
+              %a{:href => "/ticket/#{t.ticket_id}" }= t.title
+            .content~ t.description
+          %td{:class => t.state}= t.state
+          %td= t.opened.strftime("%m/%d")
+          %td= t.assigned_name
+          %td
+            - t.tags.each do |tag|
+              %a.tag{:href => "/tag/#{tag}"}= tag
+## show
+%h1= @ticket.title
+.content~ @ticket.description
+%hr/
+%form{:action => "/a/add_tags/#{@ticket.ticket_id}", :method => 'post'}
+  %table.twocol
+    %tr
+      %th TicId
+      %td
+        %code= @ticket.ticket_id
+    %tr
+      %th Assigned
+      %td= @ticket.assigned
+    %tr
+      %th Opened
+      %td= @ticket.opened
+    %tr
+      %th State
+      %td{:class => @ticket.state}
+        %table{:width => '300'}
+          %tr
+            %td{:width=>'90%'}= @ticket.state
+            - $ticgit.tic_states.select { |s| s != @ticket.state}.each do |st|
+              %td{:class => st}
+                %a{:href => "/a/change_state/#{@ticket.ticket_id}/#{st}"}= st[0,2]
+    %tr
+      %th Tags
+      %td
+        - @ticket.tags.each do |t|
+          %a.tag{:href => "/tag/#{t}"}= t
+        %div.addtag
+          %input{:name => 'tags'}
+          %input{:type => 'submit', :value => 'add tag'}
+%h3 Comments
+%form{:action => "/a/add_comment/#{@ticket.ticket_id}", :method => 'post'}
+  %div
+    %textarea{:name => 'comment', :cols => 50}
+    %br
+    %input{:type => 'submit', :value => 'add comment'}
+%div.comments
+  - @ticket.comments.reverse.each do |t|
+    %div.comment
+      %span.head
+        Added
+        = t.added.strftime("%m/%d %H:%M")
+        by
+        = t.user
+    %div.comment-text
+      = t.comment
+    %br
+## new
+%h1 Create a New Ticket
+%form{:action => '/t/new', :method => 'post'}
+  %table
+    %tr
+      %th Title
+      %td
+        %input{:type => 'text', :name => 'title', :size => 30}
+    %tr
+      %th Description
+      %td
+        %textarea{:rows => 15, :cols => 30, :name => 'description'}
+    %tr
+      %th Tags
+      %td
+        %input{:name => 'tags', :size => 30}
+        %small (comma delimited)
+    %tr
+      %td
+      %td
+        %input{:type => 'submit', :value => 'Create Ticket'}
+## stylesheet_all
+body
+  :font
+    family: Verdana, Arial, "Bitstream Vera Sans", Helvetica, sans-serif
+    color: black
+    size: 62.5%
+  line-height: 1.2
+  background-color: white
+  margin: 2em
+#wrapper
+  font-size: 1.2em
+  width: 90%
+  margin: 0 auto
+// Autoclearing
+#navigation:after
+  content: "."
+  visibility:  hidden
+  clear: both
+  display: block
+  height: 0px
+// IE autoclearing
+#navigation
+  zoom: 1
+#navigation
+  li
+    float: left
+    margin-right: 0.5em
+    a
+      background-color: #e0e0e0
+      color: black
+      text-decoration: none
+      padding: 2px
+  margin: 0
+  list-style: none
+  padding: 5px
+  border-bottom: 1px black solid
+#action
+  text-align: right
+  float: right
+  a
+    background: #005
+    padding: 5px 10px
+    font-weight: bold
+    color: #fff
+    float: left
+.addtag
+  padding: 5px 0
+h1
+  display: block
+  padding-bottom: 5px
+a
+  color: black
+a.exists
+  font-weight: bold
+a.unknown
+  font-style: italic
+a.tag
+  padding: 2px 5px
+  background: #888
+  color: #fff
+  font-weight: normal
+  font-size: 80%
+  float: left
+  margin: 1px 2px
+  text-decoration: none
+.comments
+  margin: 10px 20px
+  .comment
+    .head
+      background: #eee
+      padding: 4px
+    .comment-text
+      padding: 10px
+      color: #333
+table.long
+  width: 100%
+table.twocol
+  background: #f2f2f2
+  th
+    width: 30%
+table
+  font-size: 100%
+  border-collapse: collapse
+  td,th
+    vertical-align: top
+  tr.even
+    td
+      background: #eee
+  tr.odd
+    td
+      background: #fff
+table
+  tr
+    td,th
+      padding: 3px 5px
+      border-bottom: 1px solid #fff
+    th
+      text-align: left
+      vertical-align: top
+    th.ticket
+      width: 50%
+    td.open
+      background: #ada
+    td.resolved
+      background: #abd
+    td.hold
+      background: #dda
+    td.invalid
+      background: #aaa
+strong a
+  text-decoration: none
+table
+  thead
+    tr
+      td,th
+        border-bottom: 1px solid #000
+.submit
+  font-size: large
+  font-weight: bold
+.page_title
+  font-size: xx-large
+.edit_link
+  color: black
+  font-size: 14px
+  font-weight: bold
+  background-color: #e0e0e0
+  font-variant: small-caps
+  text-decoration: none
+## stylesheet_print
+#navigation, #action
+  display: none
+table
+  tr.odd, tr.even
+    td
+      border-bottom: 1px solid #ddd

data/lib/ticgit.rb ADDED

@@ -0,0 +1,28 @@
+# Add the directory containing this file to the start of the load path if it
+# isn't there already.
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+require 'rubygems'
+# requires git >= 1.0.5
+require 'git'
+require 'ticgit/base'
+require 'ticgit/ticket'
+require 'ticgit/comment'
+require 'ticgit/cli'
+# TicGit Library
+#
+# This library implements a git based ticketing system in a git repo
+#
+# Author::    Scott Chacon (mailto:schacon@gmail.com)
+# License::   MIT License
+#
+module TicGit
+  # options
+  #   :logger => Logger.new(STDOUT)
+  def self.open(git_dir, options = {})
+    Base.new(git_dir, options)
+  end
+end

data/lib/ticgit/base.rb ADDED

@@ -0,0 +1,308 @@
+require 'logger'
+require 'fileutils'
+require 'yaml'
+module TicGit
+  class NoRepoFound < StandardError;end
+  class Base
+    attr_reader :git, :logger
+    attr_reader :tic_working, :tic_index
+    attr_reader :tickets, :last_tickets, :current_ticket  # saved in state
+    attr_reader :config
+    attr_reader :state, :config_file
+    def initialize(git_dir, opts = {})
+      @git = Git.open(find_repo(git_dir))
+      @logger = opts[:logger] || Logger.new(STDOUT)
+      proj = Ticket.clean_string(@git.dir.path)
+      @tic_dir = opts[:tic_dir] || '~/.ticgit'
+      @tic_working = opts[:working_directory] || File.expand_path(File.join(@tic_dir, proj, 'working'))
+      @tic_index = opts[:index_file] || File.expand_path(File.join(@tic_dir, proj, 'index'))
+      # load config file
+      @config_file = File.expand_path(File.join(@tic_dir, proj, 'config.yml'))
+      if File.exists?(config_file)
+        @config = YAML.load(File.read(config_file))
+      else
+        @config = {}
+      end
+      @state = File.expand_path(File.join(@tic_dir, proj, 'state'))
+      if File.exists?(@state)
+        load_state
+      else
+        reset_ticgit
+      end
+    end
+    def find_repo(dir)
+      full = File.expand_path(dir)
+      ENV["GIT_WORKING_DIR"] || loop do
+        return full if File.directory?(File.join(full, ".git"))
+        raise NoRepoFound if full == full=File.dirname(full)
+      end
+    end
+    def save_state
+      # marshal dump the internals
+      File.open(@state, 'w') { |f| Marshal.dump([@tickets, @last_tickets, @current_ticket], f) } rescue nil
+      # save config file
+      File.open(@config_file, 'w') { |f| f.write(config.to_yaml) }
+    end
+    def load_state
+      # read in the internals
+      if(File.exists?(@state))
+        @tickets, @last_tickets, @current_ticket = File.open(@state) { |f| Marshal.load(f) } rescue nil
+      end
+    end
+    # returns new Ticket
+    def ticket_new(title, options = {})
+      t = TicGit::Ticket.create(self, title, options)
+      reset_ticgit
+      TicGit::Ticket.open(self, t.ticket_name, @tickets[t.ticket_name])
+    end
+    def reset_ticgit
+      load_tickets
+      save_state
+    end
+    # returns new Ticket
+    def ticket_comment(comment, ticket_id = nil)
+      if t = ticket_revparse(ticket_id)
+        ticket = TicGit::Ticket.open(self, t, @tickets[t])
+        ticket.add_comment(comment)
+        reset_ticgit
+      end
+    end
+    # returns array of Tickets
+    def ticket_list(options = {})
+      ts = []
+      @last_tickets = []
+      @config['list_options'] ||= {}
+      @tickets.to_a.each do |name, t|
+        ts << TicGit::Ticket.open(self, name, t)
+      end
+      if name = options[:saved]
+         if c = config['list_options'][name]
+           options = c.merge(options)
+         end
+      end
+      if options[:list]
+        # TODO : this is a hack and i need to fix it
+        config['list_options'].each do |name, opts|
+          puts name + "\t" + opts.inspect
+        end
+        return false
+      end
+      # SORTING
+      if field = options[:order]
+        field, type = field.split('.')
+        field = "opened" if field == "date" || field.nil?
+        ts = sort_list_by_keys(ts,[field,:ticket_id])
+        ts = ts.reverse if type == 'desc'
+      else
+        # default list
+        ts = ts.sort { |a, b| a.opened <=> b.opened }
+      end
+      if options.size == 0
+        # default list
+        options[:state] = 'open'
+      end
+      # :tag, :state, :assigned
+      if t = options[:tag]
+        ts = ts.select { |tag| tag.tags.include?(t) }
+      end
+      if s = options[:state]
+        ts = ts.select { |tag| tag.state =~ /#{s}/ }
+      end
+      if a = options[:assigned]
+        ts = ts.select { |tag| tag.assigned =~ /#{a}/ }
+      end
+      if save = options[:save]
+        options.delete(:save)
+        @config['list_options'][save] = options
+      end
+      @last_tickets = ts.map { |t| t.ticket_name }
+      # :save
+      save_state
+      ts
+    end
+    def sort_list_by_keys(list,keys)
+      return list if keys.find{|k| !list.first.respond_to?(k) }
+      list.sort do |a,b|
+        value,i = 0,0
+        while (keys.size > i && value == 0) do
+          value = a.send(keys[i]) <=> b.send(keys[i])
+          i += 1
+        end
+        value
+      end
+    end
+    # returns single Ticket
+    def ticket_show(ticket_id = nil)
+      # ticket_id can be index of last_tickets, partial sha or nil => last ticket
+      if t = ticket_revparse(ticket_id)
+        return TicGit::Ticket.open(self, t, @tickets[t])
+      end
+    end
+    # returns recent ticgit activity
+    # uses the git logs for this
+    def ticket_recent(ticket_id = nil)
+      if ticket_id
+        t = ticket_revparse(ticket_id)
+        return git.log.object('ticgit').path(t)
+      else
+        return git.log.object('ticgit')
+      end
+    end
+    def ticket_revparse(ticket_id)
+      if ticket_id
+        if /^[0-9]*$/ =~ ticket_id
+          if t = @last_tickets[ticket_id.to_i - 1]
+            return t
+          end
+        else
+          # partial or full sha
+          if ch = @tickets.select { |name, t| t['files'].assoc('TICKET_ID')[1] =~ /^#{ticket_id}/ }
+            return ch.first[0]
+          end
+        end
+      elsif(@current_ticket)
+        return @current_ticket
+      end
+    end
+    def ticket_tag(tag, ticket_id = nil, options = {})
+      if t = ticket_revparse(ticket_id)
+        ticket = TicGit::Ticket.open(self, t, @tickets[t])
+        if options[:remove]
+          ticket.remove_tag(tag)
+        else
+          ticket.add_tag(tag)
+        end
+        reset_ticgit
+      end
+    end
+    def ticket_change(new_state, ticket_id = nil)
+      if t = ticket_revparse(ticket_id)
+        if tic_states.include?(new_state)
+          ticket = TicGit::Ticket.open(self, t, @tickets[t])
+          ticket.change_state(new_state)
+          reset_ticgit
+        end
+      end
+    end
+    def ticket_assign(new_assigned = nil, ticket_id = nil)
+      if t = ticket_revparse(ticket_id)
+        ticket = TicGit::Ticket.open(self, t, @tickets[t])
+        ticket.change_assigned(new_assigned)
+        reset_ticgit
+      end
+    end
+    def ticket_checkout(ticket_id)
+      if t = ticket_revparse(ticket_id)
+        ticket = TicGit::Ticket.open(self, t, @tickets[t])
+        @current_ticket = ticket.ticket_name
+        save_state
+      end
+    end
+    def comment_add(ticket_id, comment, options = {})
+    end
+    def comment_list(ticket_id)
+    end
+    def tic_states
+      ['open', 'resolved', 'invalid', 'hold']
+    end
+    def load_tickets
+      @tickets = {}
+      bs = git.lib.branches_all.map { |b| b[0] }
+      init_ticgit_branch(bs.include?('ticgit')) if !(bs.include?('ticgit') && File.directory?(@tic_working))
+      tree = git.lib.full_tree('ticgit')
+      tree.each do |t|
+        data, file = t.split("\t")
+        mode, type, sha = data.split(" ")
+        tic = file.split('/')
+        if tic.size == 2  # directory depth
+          ticket, info = tic
+          @tickets[ticket] ||= { 'files' => [] }
+          @tickets[ticket]['files'] << [info, sha]
+        end
+      end
+    end
+    def init_ticgit_branch(ticgit_branch = false)
+      @logger.info 'creating ticgit repo branch'
+      in_branch(ticgit_branch) do
+        new_file('.hold', 'hold')
+        if !ticgit_branch
+          git.add
+          git.commit('creating the ticgit branch')
+        end
+      end
+    end
+    # temporarlily switches to ticgit branch for tic work
+    def in_branch(branch_exists = true)
+      needs_checkout = false
+      if !File.directory?(@tic_working)
+        FileUtils.mkdir_p(@tic_working)
+        needs_checkout = true
+      end
+      if !File.exists?('.hold')
+        needs_checkout = true
+      end
+      old_current = git.lib.branch_current
+      begin
+        git.lib.change_head_branch('ticgit')
+        git.with_index(@tic_index) do
+          git.with_working(@tic_working) do |wd|
+            git.lib.checkout('ticgit') if needs_checkout && branch_exists
+            yield wd
+          end
+        end
+      ensure
+        git.lib.change_head_branch(old_current)
+      end
+    end
+    def new_file(name, contents)
+      File.open(name, 'w') do |f|
+        f.puts contents
+      end
+    end
+  end
+end

data/lib/ticgit/cli.rb ADDED

@@ -0,0 +1,280 @@
+require 'ticgit'
+require 'thor'
+module TicGit
+  class CLI < Thor
+    attr_reader :tic
+    def initialize(opts = {}, *args)
+      @tic = TicGit.open('.', :keep_state => true)
+      $stdout.sync = true # so that Net::SSH prompts show up
+    rescue NoRepoFound
+      puts "No repo found"
+      exit
+    end
+    # tic milestone
+    # tic milestone migration1 (list tickets)
+    # tic milestone -n migration1 3/4/08 (new milestone)
+    # tic milestone -a {1} (add ticket to milestone)
+    # tic milestone -d migration1 (delete)
+    desc "milestone [<name>]", %(Add a new milestone to this project)
+    method_options :new => :optional, :add => :optional, :delete => :optional
+    def milestone(name = nil)
+      raise NotImplementedError
+    end
+    desc "recent [<ticket-id>]", %(Recent ticgit activity)
+    def recent(ticket_id = nil)
+      tic.ticket_recent(ticket_id).each do |commit|
+        puts commit.sha[0, 7] + "  " + commit.date.strftime("%m/%d %H:%M") + "\t" + commit.message
+      end
+    end
+    desc "tag [<ticket-id>] [<tag1,tag2...>]", %(Add or remove ticket tags)
+    method_options %w(--remove -d) => :boolean
+    def tag(*args)
+      puts 'remove' if options[:remove]
+      tid = args.size > 1 && args.shift
+      tags = args.first
+      if tags
+        tic.ticket_tag(tags, tid, options)
+      else
+        puts 'You need to at least specify one tag to add'
+      end
+    end
+    desc "comment [<ticket-id>]", %(Comment on a ticket)
+    method_options :message => :optional, :file => :optional
+    def comment(ticket_id = nil)
+      if options[:file]
+        raise ArgumentError, "Only 1 of -f/--file and -m/--message can be specified" if options[:message]
+        file = options[:file]
+        raise ArgumentError, "File #{file} doesn't exist" unless File.file?(file)
+        raise ArgumentError, "File #{file} must be <= 2048 bytes" unless File.size(file) <= 2048
+        tic.ticket_comment(File.read(file), ticket_id)
+      elsif m = options[:message]
+        tic.ticket_comment(m, ticket_id)
+      else
+        message, meta = get_editor_message
+        if message
+          tic.ticket_comment(message.join(''), ticket_id)
+        end
+      end
+    end
+    desc "checkout <ticket-id>", %(Checkout a ticket)
+    def checkout(ticket_id)
+      tic.ticket_checkout(ticket_id)
+    end
+    desc "state [<ticket-id>] <state>", %(Change state of a ticket)
+    def state(id_or_state, state = nil)
+      if state.nil?
+        state = id_or_state
+        ticket_id = nil
+      else
+        ticket_id = id_or_state
+      end
+      if valid_state(state)
+        tic.ticket_change(state, ticket_id)
+      else
+        puts 'Invalid State - please choose from : ' + tic.tic_states.join(", ")
+      end
+    end
+    # Assigns a ticket to someone
+    #
+    # Usage:
+    # ti assign             (assign checked out ticket to current user)
+    # ti assign {1}         (assign ticket to current user)
+    # ti assign -c {1}      (assign ticket to current user and checkout the ticket)
+    # ti assign -u {name}   (assign ticket to specified user)
+    desc "assign [<ticket-id>]", %(Assign ticket to user)
+    method_options :user => :optional, :checkout => :optional
+    def assign(ticket_id = nil)
+      tic.ticket_checkout(options[:checkout]) if options[:checkout]
+      tic.ticket_assign(options[:user], ticket_id)
+    end
+    # "-o ORDER", "--order ORDER", "Field to order by - one of : assigned,state,date"
+    # "-t TAG", "--tag TAG", "List only tickets with specific tag"
+    # "-s STATE", "--state STATE", "List only tickets in a specific state"
+    # "-a ASSIGNED", "--assigned ASSIGNED", "List only tickets assigned to someone"
+    # "-S SAVENAME", "--saveas SAVENAME", "Save this list as a saved name"
+    # "-l", "--list", "Show the saved queries"
+    desc "list [<saved-query>]", %(Show existing tickets)
+    method_options :order => :optional, :tag => :optional, :state => :optional,
+                   :assigned => :optional, :list => :optional, %w(--save-as -S) => :optional
+    def list(saved_query = nil)
+      opts = options.dup
+      opts[:saved] = saved_query if saved_query
+      if tickets = tic.ticket_list(opts)
+        output_ticket_list(tickets)
+      end
+    end
+    ## SHOW TICKETS ##
+    desc 'show <ticket-id>', %(Show a single ticket)
+    def show(ticket_id = nil)
+      if t = @tic.ticket_show(ticket_id)
+        ticket_show(t)
+      end
+    end
+    desc 'new', %(Create a new ticket)
+    method_options :title => :optional
+    def new
+      if title = options[:title]
+        ticket_show(@tic.ticket_new(title, options))
+      else
+        # interactive
+        message_file = Tempfile.new('ticgit_message').path
+        File.open(message_file, 'w') do |f|
+          f.puts "\n# ---"
+          f.puts "tags:"
+          f.puts "# The first line will be the title of the ticket,"
+          f.puts "# the rest will be the description. If you would like to add initial tags,"
+          f.puts "# put them on the 'tags:' line, comma delimited"
+        end
+        message, meta = get_editor_message(message_file)
+        if message
+          title, description, tags = parse_editor_message(message,meta)
+          if title and !title.empty?
+            ticket_show(@tic.ticket_new(title, :description => description, :tags => tags))
+          else
+            puts "You need to at least enter a title"
+          end
+        else
+          puts "It seems you wrote nothing"
+        end
+      end
+    end
+    protected
+    def valid_state(state)
+      tic.tic_states.include?(state)
+    end
+    def ticket_show(t)
+      days_ago = ((Time.now - t.opened) / (60 * 60 * 24)).round.to_s
+      puts
+      puts just('Title', 10) + ': ' + t.title
+      puts just('TicId', 10) + ': ' + t.ticket_id
+      if t.description
+        desc = t.description.split("\n").map{|l| " "*12 + l.strip}.join("\n").lstrip
+        puts just('Descr.',10) + ': ' + desc
+      end
+      puts
+      puts just('Assigned', 10) + ': ' + t.assigned.to_s
+      puts just('Opened', 10) + ': ' + t.opened.to_s + ' (' + days_ago + ' days)'
+      puts just('State', 10) + ': ' + t.state.upcase
+      if !t.tags.empty?
+        puts just('Tags', 10) + ': ' + t.tags.join(', ')
+      end
+      puts
+      if !t.comments.empty?
+        puts 'Comments (' + t.comments.size.to_s + '):'
+        t.comments.reverse.each do |c|
+          puts '  * Added ' + c.added.strftime("%m/%d %H:%M") + ' by ' + c.user
+          wrapped = c.comment.split("\n").collect do |line|
+            line.length > 80 ? line.gsub(/(.{1,80})(\s+|$)/, "\\1\n").strip : line
+          end * "\n"
+          wrapped = wrapped.split("\n").map { |line| "\t" + line }
+          if wrapped.size > 6
+            puts wrapped[0, 6].join("\n")
+            puts "\t** more... **"
+          else
+            puts wrapped.join("\n")
+          end
+          puts
+        end
+      end
+    end
+    def get_editor_message(message_file = nil)
+      message_file = Tempfile.new('ticgit_message').path if !message_file
+      editor = ENV["EDITOR"] || 'vim'
+      system("#{editor} #{message_file}");
+      message = File.read(message_file)
+      # We must have some content before the # --- line
+      message, meta  = message.split("# ---")
+      if message =~ /[^\s]+/m
+        return [message,meta]
+      else
+        return [false,false]
+      end
+    end
+    def parse_editor_message(message, meta)
+      message.strip!
+      puts message.inspect
+      title, description = message.split(/\r?\n/,2).map { |t| t.strip }
+      tags = []
+      # Strip comments from meta block
+      meta.gsub!(/^\s*#.*$/, "")
+      meta.split("\n").each do |line|
+        if line[0, 5] == 'tags:'
+          tags = line.gsub('tags:', '')
+          tags = tags.split(',').map { |t| t.strip }
+        end
+      end
+      [title, description, tags]
+    end
+    def just(value, size, side = 'l')
+      value = value.to_s
+      if value.size > size
+        value = value[0, size]
+      end
+      if side == 'r'
+        return value.rjust(size)
+      else
+        return value.ljust(size)
+      end
+    end
+    def output_ticket_list(tickets)
+      counter = 0
+      puts
+      puts [' ', just('#', 4, 'r'),
+            just('TicId', 6),
+            just('Title', 25),
+            just('State', 5),
+            just('Date', 5),
+            just('Assgn', 8),
+            just('Tags', 20) ].join(" ")
+      a = []
+      80.times { a << '-'}
+      puts a.join('')
+      tickets.each do |t|
+        counter += 1
+        tic.current_ticket == t.ticket_name ? add = '*' : add = ' '
+        puts [add, just(counter, 4, 'r'),
+              t.ticket_id[0,6],
+              just(t.title, 25),
+              just(t.state, 5),
+              t.opened.strftime("%m/%d"),
+              just(t.assigned_name, 8),
+              just(t.tags.join(','), 20) ].join(" ")
+      end
+      puts
+    end
+  end
+end

data/lib/ticgit/comment.rb ADDED

@@ -0,0 +1,17 @@
+module TicGit
+  class Comment
+    attr_reader :base, :user, :added, :comment
+    def initialize(base, file_name, sha)
+      @base = base
+      @comment = base.git.gblob(sha).contents rescue nil
+      type, date, user = file_name.split('_')
+      @added = Time.at(date.to_i)
+      @user = user
+    end
+  end
+end

data/lib/ticgit/ticket.rb ADDED

@@ -0,0 +1,224 @@
+module TicGit
+  class Ticket
+    attr_reader :base, :opts
+    attr_accessor :ticket_id, :ticket_name
+    attr_accessor :title, :description, :state, :milestone, :assigned, :opened
+    attr_accessor :comments, :tags, :attachments # arrays
+    def initialize(base, options = {})
+      options[:user_name] ||= base.git.config('user.name')
+      options[:user_email] ||= base.git.config('user.email')
+      @base = base
+      @opts = options || {}
+      @description = options.delete(:description)
+      @state = 'open' # by default
+      @comments = []
+      @tags = []
+      @attachments = []
+    end
+    def self.create(base, title, options = {})
+      t = Ticket.new(base, options)
+      t.title = title
+      t.ticket_name = self.create_ticket_name(title)
+      t.save_new
+      t
+    end
+    def self.open(base, ticket_name, ticket_hash, options = {})
+      tid = nil
+      t = Ticket.new(base, options)
+      t.ticket_name = ticket_name
+      basic_title, date = self.parse_ticket_name(ticket_name)
+      # t.title will be overridden below if the file TICKET_TITLE exists
+      t.title = basic_title
+      t.opened = date
+      ticket_hash['files'].each do |fname, value|
+        if fname == 'TICKET_ID'
+          t.ticket_id = value
+        elsif fname == 'TICKET_TITLE'
+          t.title = base.git.gblob(value).contents rescue nil
+        elsif fname == 'TICKET_DESCRIPTION'
+          t.description = base.git.gblob(value).contents rescue nil
+        else
+          # matching
+          data = fname.split('_')
+          if data[0] == 'ASSIGNED'
+            t.assigned = data[1]
+          end
+          if data[0] == 'COMMENT'
+            t.comments << TicGit::Comment.new(base, fname, value)
+          end
+          if data[0] == 'TAG'
+            t.tags << data[1]
+          end
+          if data[0] == 'STATE'
+            t.state = data[1]
+          end
+        end
+      end
+      t
+    end
+    def self.parse_ticket_name(name)
+      unless name =~ /^([^_]+)_(.+)_([^_]+)$/
+        raise "invalid ticket name #{name.inspect}"
+      end
+      epoch, title, rand = $1, $2.gsub('-', ' '), $3
+      return [title, Time.at(epoch.to_i)]
+    end
+    # write this ticket to the git database
+    def save_new
+      base.in_branch do |wd|
+        base.logger.info "saving #{ticket_name}"
+        Dir.mkdir(ticket_name)
+        Dir.chdir(ticket_name) do
+          base.new_file('TICKET_ID', ticket_name)
+          base.new_file('ASSIGNED_' + email, email)
+          base.new_file('STATE_' + state, state)
+          base.new_file('TICKET_TITLE',self.title)
+          base.new_file('TICKET_DESCRIPTION',self.description) if self.description
+          # add initial comment
+          #COMMENT_080315060503045__schacon_at_gmail
+          base.new_file(comment_name(email), opts[:comment]) if opts[:comment]
+          # add initial tags
+          if opts[:tags] && opts[:tags].size > 0
+            opts[:tags] = opts[:tags].map { |t| t.strip }.compact
+            opts[:tags].each do |tag|
+              if tag.size > 0
+                tag_filename = 'TAG_' + Ticket.clean_string(tag)
+                if !File.exists?(tag_filename)
+                  base.new_file(tag_filename, tag_filename)
+                end
+              end
+            end
+          end
+        end
+        base.git.add
+        base.git.commit("added ticket #{ticket_name}")
+      end
+      # ticket_id
+    end
+    def self.clean_string(string)
+      string.downcase.gsub(/[^a-zA-Z0-9_:;,.]+/, '-')
+    end
+    def add_comment(comment)
+      return false if !comment
+      base.in_branch do |wd|
+        Dir.chdir(ticket_name) do
+          base.new_file(comment_name(email), comment)
+        end
+        base.git.add
+        base.git.commit("added comment to ticket #{ticket_name}")
+      end
+    end
+    def change_state(new_state)
+      return false if !new_state
+      return false if new_state == state
+      base.in_branch do |wd|
+        Dir.chdir(ticket_name) do
+          base.new_file('STATE_' + new_state, new_state)
+        end
+        base.git.remove(File.join(ticket_name,'STATE_' + state))
+        base.git.add
+        base.git.commit("added state (#{new_state}) to ticket #{ticket_name}")
+      end
+    end
+    def change_assigned(new_assigned)
+      new_assigned ||= email
+      return false if new_assigned == assigned
+      base.in_branch do |wd|
+        Dir.chdir(ticket_name) do
+          base.new_file('ASSIGNED_' + new_assigned, new_assigned)
+        end
+        base.git.remove(File.join(ticket_name,'ASSIGNED_' + assigned))
+        base.git.add
+        base.git.commit("assigned #{new_assigned} to ticket #{ticket_name}")
+      end
+    end
+    def add_tag(tag)
+      return false if !tag
+      added = false
+      tags = tag.split(',').map { |t| t.strip }
+      base.in_branch do |wd|
+        Dir.chdir(ticket_name) do
+          tags.each do |add_tag|
+            if add_tag.size > 0
+              tag_filename = 'TAG_' + Ticket.clean_string(add_tag)
+              if !File.exists?(tag_filename)
+                base.new_file(tag_filename, tag_filename)
+                added = true
+              end
+            end
+          end
+        end
+        if added
+          base.git.add
+          base.git.commit("added tags (#{tag}) to ticket #{ticket_name}")
+        end
+      end
+    end
+    def remove_tag(tag)
+      return false if !tag
+      removed = false
+      tags = tag.split(',').map { |t| t.strip }
+      base.in_branch do |wd|
+        tags.each do |add_tag|
+          tag_filename = File.join(ticket_name, 'TAG_' + Ticket.clean_string(add_tag))
+          if File.exists?(tag_filename)
+            base.git.remove(tag_filename)
+            removed = true
+          end
+        end
+        if removed
+          base.git.commit("removed tags (#{tag}) from ticket #{ticket_name}")
+        end
+      end
+    end
+    def path
+      File.join(state, ticket_name)
+    end
+    def comment_name(email)
+      'COMMENT_' + Time.now.to_i.to_s + '_' + email
+    end
+    def email
+      opts[:user_email] || 'anon'
+    end
+    def assigned_name
+      assigned.split('@').first rescue ''
+    end
+    def self.create_ticket_name(title)
+      [Time.now.to_i.to_s, Ticket.clean_string(title), rand(999).to_i.to_s].join('_')
+    end
+  end
+end

metadata ADDED

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: mislav-ticgit
+version: !ruby/object:Gem::Version
+  version: 0.3.6
+platform: ruby
+authors:
+- Scott Chacon
+- "Mislav Marohni\xC4\x87"
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2008-09-11 00:00:00 -07:00
+default_executable:
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: schacon-git
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.5
+    version:
+- !ruby/object:Gem::Dependency
+  name: wycats-thor
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+    version:
+description:
+email: schacon@gmail.com
+executables:
+- ti
+- ticgitweb
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ticgit/base.rb
+- lib/ticgit/cli.rb
+- lib/ticgit/comment.rb
+- lib/ticgit/ticket.rb
+- lib/ticgit.rb
+- bin/ti
+- bin/ticgitweb
+has_rdoc: false
+homepage: http://github.com/schacon/ticgit/wikis
+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:
+rubygems_version: 1.2.0
+signing_key:
+specification_version: 2
+summary: A distributed ticketing system for Git projects.
+test_files: []