flurin-ticgit 0.3.7

data/lib/ticgit/ticket.rb

@@ -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

data/lib/ticgit.rb

@@ -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

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: flurin-ticgit
+version: !ruby/object:Gem::Version 
+  version: 0.3.7
+platform: ruby
+authors: 
+- Scott Chacon
+- "Mislav Marohni\xC4\x87"
+- Flurin Egger
+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: sinatra
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.1
+    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: []
+