taskmapper-github 0.10.0

data/.bundle/config

@@ -0,0 +1,2 @@
+--- 
+BUNDLE_WITHOUT: ""

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.rbenv-gemsets

@@ -0,0 +1 @@
+ticketmaster-github

data/.rbenv-version

@@ -0,0 +1 @@
+1.9.2-p290

data/.travis.yml

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

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+gem "taskmapper", "~> 0.8" 
+gem "octokit", "~> 0.6"
+group :development do 
+  gem "jeweler", "~> 1.6"
+  gem "rspec", "~> 2.3"
+  gem "fakeweb", "~> 1.3"
+  gem "simplecov", "~> 0.5", :platforms => :ruby_19
+  gem "rcov", "~> 1.0", :platforms => :ruby_18
+end

data/Gemfile.lock

@@ -0,0 +1,72 @@
+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)
+    addressable (2.2.7)
+    builder (3.0.0)
+    diff-lcs (1.1.3)
+    fakeweb (1.3.0)
+    faraday (0.7.6)
+      addressable (~> 2.2)
+      multipart-post (~> 1.1)
+      rack (~> 1.1)
+    faraday_middleware (0.7.0)
+      faraday (~> 0.7.3)
+    git (1.2.5)
+    hashie (1.2.0)
+    i18n (0.6.0)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    multi_json (1.0.4)
+    multipart-post (1.1.5)
+    octokit (0.6.5)
+      addressable (~> 2.2.6)
+      faraday (~> 0.7.4)
+      faraday_middleware (~> 0.7.0)
+      hashie (~> 1.2.0)
+      multi_json (~> 1.0.2)
+    rack (1.4.1)
+    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)
+    simplecov (0.6.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    taskmapper (0.8.0)
+      activeresource (~> 3.0)
+      activesupport (~> 3.0)
+      hashie (~> 1.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fakeweb (~> 1.3)
+  jeweler (~> 1.6)
+  octokit (~> 0.6)
+  rcov (~> 1.0)
+  rspec (~> 2.3)
+  simplecov (~> 0.5)
+  taskmapper (~> 0.8)

data/Guardfile

@@ -0,0 +1,19 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^app/(.*)(\.erb|\.haml)$})                 { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  # Capybara request specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/requests/#{m[1]}_spec.rb" }
+end
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2010 The Hybrid Group
+
+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:
+
+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,86 @@
+# taskmapper-github
+
+This is a provider for [taskmapper](http://ticketrb.com). It provides interoperability with [Github](http://www.github.com/) and its issue tracking system through the taskmapper gem.
+
+# Usage and Examples
+
+First we have to instantiate a new taskmapper instance:
+  github = TaskMapper.new(:github, {:login => "coder", :token => "m4st3r!"})
+
+If you do not pass in the token and the username, it will only access public information for the account.
+
+== Finding Projects(Repositories)
+
+You can find your own projects by doing:
+
+	projects = github.projects # Will return all your repositories
+  projects = github.projects(['your_repo1', 'your_repo2'])
+  project = github.project('your_repo')
+
+Also you can access other users repos
+	
+	project = github.project.find(:first, {:user => 'other_user', :repo => 'his_repo'})
+
+Or even make a search with an array
+
+	projects = github.project.find(:all, ['ruby','git'])
+	
+== Finding Tickets(Issues)
+
+  tickets = project.tickets # All open issues
+	tickets = project.tickets(:all, {:state => 'closed'}) # All closed tickets
+	ticket = project.ticket(<issue_number>)
+
+== Open Tickets
+    
+	ticket = project.ticket!({:title => "New ticket", :body => "Body for the very new ticket"})
+
+== Close a ticket
+	
+	ticket = ticket.close
+	
+== Reopen a ticket
+
+	ticket = ticket.reopen
+	
+= Update a ticket
+	
+	ticket.title = "New title"
+	ticket.body =  "New body"
+	ticket.save
+
+== Finding Comments
+	comments = ticket.comments
+
+== Create Comment
+	comment = ticket.comment!("your comment goes here")
+
+## Requirements
+
+* rubygems (obviously)
+* taskmapper gem (latest version preferred)
+* jeweler gem (only if you want to repackage and develop)
+* Octopi gem provdes interface to Github
+
+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-2011 The Hybrid Group. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "taskmapper-github"
+    gem.summary = %Q{The github provider for taskmapper}
+    gem.description = %Q{This provides an interface with github through the taskmapper gem.}
+    gem.email = "hong.quach@abigfisch.com"
+    gem.homepage = "http://github.com/kiafaldorius/taskmapper-github"
+    gem.authors = ["HybridGroup"]
+    # 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

data/VERSION

@@ -0,0 +1 @@
+0.10.0

data/lib/provider/comment.rb

@@ -0,0 +1,91 @@
+module TaskMapper::Provider
+  module Github
+    # The comment class for taskmapper-github
+    #
+    # Do any mapping between TaskMapper and your system's comment model here
+    # versions of the ticket.
+    #
+    class Comment < TaskMapper::Provider::Base::Comment
+      attr_accessor :prefix_options
+
+      def initialize(*object) 
+        if object.first 
+          object = object.first
+          unless object.is_a? Hash
+            hash = {:id => object.id,
+                    :body => object.body,
+                    :created_at => object.created_at,
+                    :author => object.user.login}
+          else
+            hash = object
+          end
+          super hash
+        end
+      end
+
+      def author
+        self.user.login
+      end
+
+      def created_at
+        @created_at ||= begin
+                          Time.parse(self[:created_at])
+                        rescue
+                          self[:created_at]
+                        end
+      end
+
+      def updated_at
+        @updated_at ||= begin
+                          Time.parse(self[:updated_at])
+                        rescue
+                          self[:updated_at]
+                        end
+      end
+
+      # declare needed overloaded methods here
+
+      def self.find_by_attributes(project_id, ticket_id, attributes = {})
+        search_by_attribute(self.find_all(project_id, ticket_id), attributes)
+      end
+
+      def self.find_all(project_id, ticket_id)
+        TaskMapper::Provider::Github.api.issue_comments(project_id, ticket_id).collect do |comment|
+          comment.merge!(:project_id => project_id, :ticket_id => ticket_id)
+          clean_body! comment
+          self.new comment
+        end
+      end
+
+      def self.create(project_id, ticket_id, comment)
+        github_comment = TaskMapper::Provider::Github.api.add_comment(project_id, ticket_id, comment)
+        github_comment.merge!(:project_id => project_id, :ticket_id => ticket_id)
+        flat_body github_comment
+        self.new github_comment
+      end
+
+      #See https://www.kanbanpad.com/projects/31edb8d134e7967c1f0d#!xt-4f994d17014289000707433f
+      def self.flat_body(comment_hashie)
+        comment_hashie.body = comment_hashie.body.body
+        comment_hashie
+      end
+
+      # See https://www.kanbanpad.com/projects/31edb8d134e7967c1f0d#!xt-4f994f2101428900070759fd
+      def self.clean_body!(comment)
+        comment.body = comment.body.sub(/\A---\s\sbody:\s/, '').gsub(/\s\z/, '')
+      end
+
+      def save
+        update_comment(project_id, id, body)
+      end
+
+      private
+      def update_comment(repo, number, comment, options = {})
+        TaskMapper::Provider::Github.api.update_comment repo, number, comment, options
+        true
+      end
+
+
+    end
+  end
+end

data/lib/provider/github.rb

@@ -0,0 +1,60 @@
+module TaskMapper::Provider
+  # This is the Github Provider for taskmapper
+  module Github
+    include TaskMapper::Provider::Base
+
+    class << self
+      attr_accessor :login, :api, :user_token, :valid_user
+    end
+    
+    # This is for cases when you want to instantiate using TaskMapper::Provider::Github.new(auth)
+    def self.new(auth = {})
+      TaskMapper.new(:github, auth)
+    end
+    
+    # declare needed overloaded methods here
+    def authorize(auth = {})
+      @authentication ||= TaskMapper::Authenticator.new(auth)
+      auth = @authentication
+      login = auth.login || auth.username
+      if auth.login.blank? and auth.username.blank?
+        raise TaskMapper::Exception.new('Please provide at least a username')
+      elsif auth.token
+        TaskMapper::Provider::Github.login = login
+        TaskMapper::Provider::Github.user_token = auth.token
+        TaskMapper::Provider::Github.api = Octokit::Client.new(:login => login, :token => auth.token)
+      elsif auth.password
+        TaskMapper::Provider::Github.login = login
+        TaskMapper::Provider::Github.user_token = auth.token
+        TaskMapper::Provider::Github.api = Octokit::Client.new(:login => login, :password => auth.password)
+      else 
+        TaskMapper::Provider::Github.login = login
+        TaskMapper::Provider::Github.user_token = nil
+        TaskMapper::Provider::Github.api = Octokit::Client.new(:login => login)
+      end
+    end
+
+    def valid?
+      begin
+        TaskMapper::Provider::Github.valid_user = TaskMapper::Provider::Github.api.user.total_private_repos >= 0
+      rescue
+        false
+      end
+    end
+
+    def projects(*options)
+      Project.find(options)
+    end
+
+    def project(*project)
+      unless project.empty?
+        Project.find_by_id(project.first)
+      else
+        super
+      end
+    end
+
+  end
+end
+
+

data/lib/provider/project.rb

@@ -0,0 +1,110 @@
+module TaskMapper::Provider
+  module Github
+    # Project class for taskmapper-github
+    #
+    #
+    class Project < TaskMapper::Provider::Base::Project
+      
+      # declare needed overloaded methods here
+      def initialize(*object) 
+        if object.first
+          object = object.first
+          @system_data = {:client => object} 
+          unless object.is_a? Hash
+            hash = {:description => object.description,
+                    :created_at => object.created_at,
+                    :updated_at => object.created_at,
+                    :name => object.name,
+                    :id => object.name,
+                    :owner => object.owner}
+          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[:created_at]) 
+        rescue
+          self[:created_at]
+        end
+      end
+
+      def id
+        "#{self.owner.login}/#{self[:name]}"
+      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)
+        if options[0].empty?
+          projects = self.find_all
+        elsif options[0].first.is_a? Array
+          options[0].first.collect { |name| self.find_by_id(name) }
+        elsif options[0].first.is_a? String
+          self.find_by_id(options[0].first)
+        elsif options[0].first.is_a? Hash
+          self.find_by_attributes(options[0].first)
+        end
+      end
+
+      def self.find_by_attributes(attributes = {})
+        search_by_attribute(self.find_all, attributes)
+      end
+
+      def self.find_by_id(id)
+        id = "#{TaskMapper::Provider::Github.login}/#{id}" unless id.include?("/")
+        self.new TaskMapper::Provider::Github.api.repository(id) 
+      end
+
+      def self.find_all
+        repos = []
+        user_repos = TaskMapper::Provider::Github.api.repositories(TaskMapper::Provider::Github.login).collect { |repository| 
+          self.new repository }
+          repos = repos + user_repos
+          if TaskMapper::Provider::Github.valid_user
+            org_repos = TaskMapper::Provider::Github.api.organization_repositories.collect { |repository| 
+              self.new repository }
+              repos = repos + org_repos
+          end
+          repos
+      end
+
+      def tickets(*options)
+        TaskMapper::Provider::Github::Ticket.find(self.id, options)
+      end
+
+      def ticket(*options)
+        unless options.empty?
+          TaskMapper::Provider::Github::Ticket.find_by_id(self.id, options.first)
+        else
+          TaskMapper::Provider::Github::Ticket
+        end
+      end
+
+      def ticket!(*options)
+        TaskMapper::Provider::Github::Ticket.open(self.id, options.first)
+      end
+    end
+
+  end
+end