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

mislav-ticgit 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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: []