taskmapper-trac 0.6.0

data/.rbenv-gemsets

@@ -0,0 +1 @@
+ticketmaster-trac

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@taskmapper-trac --create

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2

data/Gemfile

@@ -0,0 +1,13 @@
+source :rubygems
+
+gem "taskmapper", "~> 0.8"
+gem "trac4r", "~> 1.2"
+gem "nokogiri", "~> 1.5"
+
+group :development do 
+  gem "rspec", "~> 2.8"
+  gem "bundler", "~> 1.1"
+  gem "jeweler", "~> 1.6"
+  gem "simplecov", "~> 0.5", :platform => :ruby_19
+  gem "rcov", "~> 1.0", :platform => :ruby_18
+end

data/Gemfile.lock

@@ -0,0 +1,75 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.2.3)
+      activesupport (= 3.2.3)
+      builder (~> 3.0.0)
+    activeresource (3.2.3)
+      activemodel (= 3.2.3)
+      activesupport (= 3.2.3)
+    activesupport (3.2.3)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    builder (3.0.0)
+    diff-lcs (1.1.3)
+    gash (0.1.3)
+      open4 (>= 0, = 0.9.6)
+    git (1.2.5)
+    gli (1.4.0)
+    grancher (0.1.5)
+      gash
+    hashie (1.2.0)
+    i18n (0.6.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    json (1.6.5)
+    multi_json (1.0.4)
+    nokogiri (1.5.0)
+    open4 (0.9.6)
+    rainbow (1.1.3)
+    rake (0.9.2.2)
+    rcov (1.0.0)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    sdoc (0.3.16)
+      json (>= 1.1.3)
+      rdoc (~> 3.10)
+    simplecov (0.5.4)
+      multi_json (~> 1.0.3)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    taskmapper (0.8.0)
+      activeresource (~> 3.0)
+      activesupport (~> 3.0)
+      hashie (~> 1.2)
+    trac4r (1.2.4)
+      gli
+      gli (>= 1.1.0)
+      grancher
+      jeweler
+      rainbow
+      rainbow (>= 1.0.4)
+      sdoc
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.1)
+  jeweler (~> 1.6)
+  nokogiri (~> 1.5)
+  rcov (~> 1.0)
+  rspec (~> 2.8)
+  simplecov (~> 0.5)
+  taskmapper (~> 0.8)
+  trac4r (~> 1.2)

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2010 YOU
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+NONE
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,60 @@
+# taskmapper-trac
+
+This is a provider for [taskmapper](http://ticketrb.com). It provides interoperability with [Trac](http://trac.edgewall.org) and it's issue tracking system through the taskmapper gem.
+
+# Usage and Examples
+
+First we have to instantiate a new taskmapper instance, your trac installation should have api access enable:
+    trac = taskmapper.new(:trac, {:username=> 'foo', :password => "bar", :url => "http://tracserver/username/project/trac"}) 
+
+If you do not pass in the url, username and password, you won't get any information.
+
+## Finding Projects(Repositories)
+
+Right now Trac doesn't support project handling, that's why you will use a project holder which consist of your username and url for the Trac instance.
+	
+## Finding Tickets(Issues)
+
+    tickets = project.tickets # All tickets
+    ticket = project.tickets(:status => '!closed') # All non closed tickets, you can specified any type of attributes field based on Trac scheme. ex. :component => 'Web' 
+
+## Open Tickets
+    
+	ticket = project.ticket!({:summary => "New ticket", :description=> "Body for the very new ticket"}, attributes) # summary and description are mandatory fields the attributes hash will contain all the optional info that you need for your ticket, have to use the fields provided by Trac api.
+
+## Finding comments
+      
+        comments = project.tickets.first.comments # All the tickets facility for searchs are available for comments as well
+
+
+## Requirements
+
+* rubygems (obviously)
+* taskmapper gem (latest version preferred)
+* jeweler gem (only if you want to repackage and develop)
+* trac4r
+
+The taskmapper gem should automatically be installed during the installation of this gem if it is not already installed.
+
+## Other Notes
+
+Since this and the taskmapper gem is still primarily a work-in-progress, minor changes may be incompatible with previous versions. Please be careful about using and updating this gem in production.
+
+If you see or find any issues, feel free to open up an issue report.
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so we don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself so we can ignore when I pull)
+* Send us a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 The Hybrid Group. See LICENSE for details.
+
+

data/Rakefile

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "taskmapper-trac"
+    gem.summary = %Q{taskmapper Provider for Trac}
+    gem.description = %Q{Allows taskmapper to interact with Your System.}
+    gem.email = "rafael@hybridgroup.com"
+    gem.homepage = "http://github.com/hybridgroup/taskmapper-trac"
+    gem.authors = ["Rafael George"]
+    gem.add_dependency "trac4r"
+    gem.add_dependency "nokogiri"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+      spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+      spec.pattern = 'spec/**/*_spec.rb'
+            spec.rcov = true
+end
+
+task :default => :spec
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+      spec.pattern = 'spec/**/*_spec.rb'
+            spec.rcov = true
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "taskmapper-trac #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.6.0

data/lib/provider/comment.rb

@@ -0,0 +1,79 @@
+module TaskMapper::Provider
+  module Trac
+    # The comment class for taskmapper-yoursystem
+    #
+    # Do any mapping between taskmapper and your system's comment model here
+    # versions of the ticket.
+    #
+    class Comment < TaskMapper::Provider::Base::Comment
+      # declare needed overloaded methods here
+
+      def initialize(*object)
+        if object.first
+          object = object.first
+          unless object.is_a? Hash
+            @system_data = {:client => object}
+            hash = {:id => object[:id],
+              :author => object.author,
+              :body => object.body,
+              :ticket_id => object.ticket_id,
+              :created_at => object.created_at,
+              :updated_at => object.updated_at}
+          else
+            hash = object
+          end
+          super(hash)
+        end
+      end
+
+      def created_at
+        begin
+          Time.parse(self[:created_at])
+        rescue
+          self[:created_at]
+        end
+      end
+
+      def updated_at
+        begin
+          Time.parse(self[:updated_at])
+        rescue
+          self[:updated_at]
+        end
+      end
+
+      def id
+        self[:id]
+      end
+
+      def self.find_by_attributes(project_id, ticket_id, attributes = {})
+        comments = self.find_all(ticket_id)
+        search_by_attribute(comments, attributes)
+      end
+
+      def self.find(project_id, ticket_id, *options)
+        if options[0].first.is_a? Array
+          self.find_all(ticket_id).select do |comment|
+            comment if options[0].any? { |id| id == comment.id }
+          end
+        elsif options[0].first.is_a? Hash
+          self.find_by_attributes(project_id, ticket_id, options[0].first)
+        else
+          self.find_all(ticket_id)
+        end
+      end
+
+      def self.find_by_id(project_id, ticket_id, id)
+        self.find_all(ticket_id).select { |comment| comment[:id] == id }.first
+      end
+
+      def self.find_all(ticket_id)
+        comments = CommentUtil.new(ticket_id,TaskMapper::Provider::Trac.api).comments
+        comments.compact.collect do |comment| 
+          TaskMapper::Provider::Trac::Comment.new comment 
+        end
+      end
+
+    end
+  end
+end

data/lib/provider/project.rb

@@ -0,0 +1,72 @@
+module TaskMapper::Provider
+  module Trac 
+    # Project class for taskmapper-yoursystem
+    # 
+    # 
+    class Project < TaskMapper::Provider::Base::Project
+      # declare needed overloaded methods here
+      
+      attr_reader :created_at, :updated_at
+      def initialize(*object)
+        if object.first
+          object = object.first
+          @system_data = {:client => object}
+          unless object.is_a? Hash
+            hash = {:repository => object.url,
+                    :owner => object.username,
+                    :name => object.name,
+                    :id => object.name}
+          else
+            hash = object
+          end
+          super hash
+        end
+      end
+      
+      # copy from this.copy(that) copies that into this
+      def copy(project)
+        project.tickets.each do |ticket|
+          copy_ticket = self.ticket!(:title => ticket.title, :description => ticket.description)
+          ticket.comments.each do |comment|
+            copy_ticket.comment!(:body => comment.body)
+            sleep 1
+          end
+        end
+      end
+
+      def self.find(*options)
+        mode = options.first
+        trac = TaskMapper::Provider::Trac.api
+        if mode.is_a? String
+          self.new({:url => trac[:url], :username => trac[:username], :name=> "#{trac[:username]}-project"})
+        end
+      end
+
+      def id
+        1
+      end
+
+      def ticket(*options)
+        unless options.empty?
+          options = options.first
+          trac = TaskMapper::Provider::Trac.api
+          if options.is_a? Hash
+            Ticket.find_by_id(trac[:trac].tickets.query(options).first, self[:name])
+          end
+        else
+          TaskMapper::Provider::Trac::Ticket
+        end
+      end
+
+      def ticket!(*options)
+        options = options.first
+        Ticket.create options
+      end
+
+      def tickets(*options)
+        Ticket.find(self.name, options)
+      end
+
+    end
+  end
+end

data/lib/provider/ticket.rb

@@ -0,0 +1,126 @@
+module TaskMapper::Provider
+  module Trac
+    # Ticket class for taskmapper-yoursystem
+    #
+
+    class Ticket < TaskMapper::Provider::Base::Ticket
+      # declare needed overloaded methods here
+
+      def initialize(*object)
+        if object.first
+          args = object
+          object = args.shift
+          project_id = args.shift
+          unless object.is_a? Hash
+            @system_data = {:client => object}
+            hash = {:id => object.id,
+              :severity => object.severity,
+              :milestone => object.milestone,
+              :status => object.status,
+              :type => object.type, 
+              :priority => object.priority,
+              :version => object.version,
+              :reporter => object.reporter,
+              :owner => object.owner,
+              :cc => object.cc,
+              :summary => object.summary,
+              :assignee => object.owner,
+              :requestor => object.reporter,
+              :title => object.summary,
+              :project_id => project_id,
+              :description => object.description,
+              :keywords => object.keywords,
+              :created_at => object.created_at,
+              :updated_at => object.updated_at}
+          else
+            hash = object
+          end
+          super(hash)
+        end
+      end
+
+      def created_at
+        normalize_datetime(self[:created_at]) 
+      end
+
+      def updated_at
+        normalize_datetime(self[:updated_at])
+      end
+
+      def self.find_by_id(id, project_id)
+        trac = TaskMapper::Provider::Trac.api
+        retryable(:tries => 10) do 
+          self.new trac[:trac].tickets.get(id), project_id
+        end
+      end
+
+      def self.find(project_id, *options)
+        mode = options[0].first
+        trac = TaskMapper::Provider::Trac.api
+        if options[0].empty?
+          self.find_all(project_id, trac[:trac].tickets.list)
+        elsif mode.is_a? Array
+          self.find_all(project_id, mode)
+        elsif mode.is_a? Hash
+          self.find_all(project_id, trac[:trac].tickets.query(mode))
+        end
+      end
+
+      def self.find_all(project_id, tickets)
+        tickets.collect do |ticket_id| 
+          self.find_by_id(ticket_id, project_id) 
+        end
+      end
+
+      def self.create(*options)
+        mandatory = options.shift
+        attributes = {}
+        attributes ||= options.shift
+        trac = TaskMapper::Provider::Trac.api
+        begin
+          self.find_by_id trac[:trac].tickets.create(mandatory[:summary], mandatory[:description], attributes)
+        rescue
+          self
+        end
+      end
+
+      def comments(*options)
+        Comment.find(self.project_id, self.id, options)
+      end
+
+      def comment(*options)
+        if options.empty?
+          TaskMapper::Provider::Trac::Comment.new
+        elsif options.first.is_a? Fixnum
+          Comment.find_by_id(self.project_id, self.id, options.first)  
+        elsif options.first.is_a? Hash
+          Comment.find_by_attributes(self.project_id, self.id, options.first).first
+        end
+      end
+
+      def comment!
+        warn "Trac doesn't support creation of comments"
+        [] 
+      end
+
+      private
+      def normalize_datetime(datetime)
+        datetime = datetime.to_time
+      end
+
+      # Extracted this code from facet http://api.mackframework.com/mack-facets/classes/Kernel.html
+      def self.retryable(options = {}, &block)
+        opts = { :tries => 5, :on => Exception }.merge(options)
+
+        retry_exception, retries = opts[:on], opts[:tries]
+
+        begin
+          return yield
+        rescue retry_exception
+          retry if (retries -= 1) > 0
+        end
+        yield
+      end
+    end
+  end
+end