ticketmaster-mingle 0.1.0

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.8.7@ticketmaster-mingle

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem "ticketmaster", "0.5.2"
+
+group :development do
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+  gem "rspec", "= 1.2.9"
+end

data/Gemfile.lock

@@ -0,0 +1,36 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activeresource (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+    activesupport (3.0.3)
+    builder (2.1.2)
+    git (1.2.5)
+    hashie (0.3.0)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (1.2.9)
+    ticketmaster (0.5.2)
+      activeresource (>= 2.3.2)
+      activesupport (>= 2.3.2)
+      hashie (<= 0.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.1)
+  rcov
+  rspec (= 1.2.9)
+  ticketmaster (= 0.5.2)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 anymoto
+
+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,74 @@
+# ticketmaster-mingle
+
+This is a provider for [ticketmaster](http://ticketrb.com). It provides interoperability with [Mingle](http://www.thoughtworks-studios.com/mingle-agile-project-management/) and it's issue tracking system through the ticketmaster gem.
+
+# Usage and Examples
+
+First we have to instantiate a new ticketmaster instance, your Mingle installation should have api access enable:
+    mingle = TicketMaster.new(:mingle, {:server => 'myserver', :username=> 'foo', :password => 'bar')
+If you do not pass in the server name, username and password, you won't get any information.
+
+Also you have to enable basic authentication, set the basic_authentication_enabled configuration option to true in the Mingle data directory/config/auth_config.yml file, where Mingle data directory is the path to the Mingle data directory:
+    basic_authentication_enabled: true
+
+## Finding Projects
+
+You can find your own projects by doing:
+
+    projects = mingle.projects # Will return all your projects
+    projects = mingle.projects(["project1", "project2"]) # You must use your projects identifier 
+    project = mingle.project("your_project") # Also use project identifier in here
+
+## Creating a project
+
+    project = mingle.project!(:name => "New Project", :identifier => "new_project", :description => "This is a new project")
+	
+## Finding Tickets(Cards)
+
+    tickets = project.tickets # All tickets
+    ticket = project.ticket(<ticket_number>)
+
+## Open Tickets
+
+	ticket = project.ticket!({:name => "New ticket", :description=> "Body for the very new ticket"})
+
+
+## Finding comments
+      
+        comments = project.ticket.comments 
+
+## Creating a comment
+
+        comment = ticket.comment!(:content => 'New comment created.')
+
+## Requirements
+
+* rubygems (obviously)
+* ticketmaster gem (latest version preferred)
+* jeweler gem (only if you want to repackage and develop)
+* Mingle
+
+The ticketmaster gem should automatically be installed during the installation of this gem if it is not already installed.
+
+## Other Notes
+
+Since this and the ticketmaster 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 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "ticketmaster-mingle"
+  gem.homepage = "http://ticket.rb"
+  gem.summary = %Q{Ticketmaster Provider for Mingle}
+  gem.description = %Q{Allows ticketmaster to interact with Mingle}
+  gem.email = "ana@hybridgroup.com"
+  gem.authors = ["Hybridgroup"]
+  gem.add_dependency "activesupport", ">= 3.0.4"
+  gem.add_dependency "activeresource", ">= 3.0.4"
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "ticketmaster-mingle #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/mingle/mingle-api.rb

@@ -0,0 +1,228 @@
+require 'rubygems'
+require 'active_support'
+require 'active_resource'
+
+# Ruby lib for working with the Mingle API's XML interface.
+# You should set the authentication using your login
+# credentials with HTTP Basic Authentication.
+
+# This library is a small wrapper around the REST interface
+
+module MingleAPI
+  class Error < StandardError; end
+  class << self
+
+    #Sets up basic authentication credentials for all the resources.
+    def authenticate(server, login, password)
+      @server    = server
+      @username  = login
+      @password  = password
+      self::Base.user = login
+      self::Base.password = password
+
+      resources.each do |klass|
+        klass.site = klass.site_format % "http://#{login}:#{password}@#{server}/api/v2"
+      end
+    end
+
+    def resources
+      @resources ||= []
+    end
+  end
+
+  class Base < ActiveResource::Base
+    def self.inherited(base)
+      MingleAPI.resources << base
+      class << base
+        attr_accessor :site_format
+      end  
+      base.site_format = '%s'
+      super
+    end
+  end
+
+  # Find projects
+  #
+  #   MingleAPI::Project.find(:all) # find all projects for the current account.
+  #   MingleAPI::Project.find('my_project')   # find individual project by ID
+  #
+  # Creating a Project
+  #
+  #   project = MingleAPI::Project.new(:name => 'Ninja Whammy Jammy')
+  #   project.save
+  #   # => true
+  #
+  #
+  # Updating a Project
+  #
+  #   project = MingleAPI::Project.find('my_project')
+  #   project.name = "A new name"
+  #   project.save
+  #
+  # Finding tickets
+  # 
+  #   project = MingleAPI::Project.find('my_project')
+  #   project.tickets
+  #
+
+
+  class Project < Base
+
+    #begin monkey patches
+
+    def exists?(id, options = {})
+      begin
+        self.class.find(id)
+        true
+      rescue ActiveResource::ResourceNotFound, ActiveResource::ResourceGone
+        false
+      end
+    end
+    
+    def new?
+      !self.exists?(id)
+    end
+
+    def element_path(options = nil)
+       self.class.element_path(self.id, options)
+    end
+
+    def encode(options={})
+       val = []
+       attributes.each_pair do |key, value|
+         val << "project[#{URI.escape key}]=#{URI.escape value}" rescue nil
+       end  
+       val.join('&')
+    end
+   
+    def create
+        connection.post(collection_path + '?' + encode, nil, self.class.headers).tap do |response|
+          self.id = id_from_response(response)
+          load_attributes_from_response(response)
+        end
+    end
+
+    #end monkey patches
+ 
+    def tickets(options = {})
+      Card.find(:all, :params => options.update(:identifier => id))
+    end
+    
+    def id
+      @attributes['identifier']
+    end
+
+  end
+
+  # Find tickets
+  #
+  #  MingleAPI::Ticket.find(:all, :params => { :identifier => 'my_project' })
+  #
+  #  project = UnfuddleAPI::Project.find('my_project')
+  #  project.tickets
+  #  project.tickets(:name => 'a new name')
+  #
+
+
+  class Card < Base
+    self.site_format << '/projects/:identifier/'
+
+    #begin monkey patches
+
+    def element_path(options = nil)
+      self.class.element_path(self.number, options)
+    end
+
+    def encode(options={})
+      val = []
+      attributes.each_pair do |key, value|
+        unless value.nil?
+          case key 
+          when 'card_type'
+            if value.is_a? Hash
+              name = value[:name]
+            else
+              name = value.name
+            end
+            val << "card[card_type_name]=#{URI.escape name}"
+          when 'properties' 
+            value.each {|property| 
+              val << "card[properties][][name]=#{URI.escape property[0]}
+                      &card[properties][][value]=#{URI.escape property[1]}"} rescue NoMethodError
+          else
+            val << "card[#{URI.escape key.to_s}]=#{URI.escape value.to_s}" rescue nil
+          end
+        end
+      end
+      val.join('&')
+    end
+
+    def update
+      connection.put(element_path(prefix_options) + '?' + encode, nil, self.class.headers).tap do |response|
+        load_attributes_from_response(response)
+      end
+    end
+
+    def create
+      connection.post(collection_path + '?' + encode, nil, self.class.headers).tap do |response|
+        self.number = id_from_response(response)
+        load_attributes_from_response(response)
+      end
+    end
+
+    #end monkey patches
+
+    def number
+      @attributes['number']
+    end
+
+    def id
+      @attributes['id']
+    end
+
+    def name
+      @attributes['name']
+    end
+
+    def created_on
+      @attributes['created_on']
+    end
+
+    def modified_on
+      @attributes['modified_on']
+    end
+
+    def description
+      @attributes['description']
+    end
+
+    def card_type
+      @attributes['card_type']
+    end
+
+    def properties
+      @attributes['properties']
+    end
+
+  end
+
+  class Comment < Base
+    self.site_format << '/projects/:identifier/cards/:number'
+
+    def create
+      connection.post(collection_path + '?' + encode, nil, self.class.headers).tap do |response|
+        load_attributes_from_response(response)
+      end
+    end
+
+    def encode(options={})
+      val=[]
+      attributes.each_pair do |key, value|
+        val << "comment[#{URI.escape key}]=#{URI.escape value}" rescue nil
+      end
+      val.join('&')
+    end
+
+  end
+
+end

data/lib/provider/comment.rb

@@ -0,0 +1,47 @@
+module TicketMaster::Provider
+  module Mingle
+    # The comment class for ticketmaster-mingle
+    #
+    # Do any mapping between Ticketmaster and your system's comment model here
+    # versions of the ticket.
+    #
+    class Comment < TicketMaster::Provider::Base::Comment
+    API = MingleAPI::Comment # The class to access the api's comments
+      # declare needed overloaded methods here
+      
+      def initialize(*object)
+        if object.first
+          object = object.first
+          @system_data = {:client => object}
+          unless object.is_a? Hash
+            hash = {:content => object.content,
+                    :created_at => object.created_at,
+                    :created_by => object.created_by,
+                    :ticket_id => object.prefix_options[:number],
+                    :project_id => object.prefix_options[:identifier]}
+          else
+            hash = object
+          end
+          super hash
+        end
+      end
+
+      def created_by
+        self[:created_by]
+      end
+      
+      def created_at
+        self[:created_at]
+      end
+
+      def project_id
+        self[:identifier]
+      end
+
+      def ticket_id
+        self[:number]
+      end
+
+    end
+  end
+end

data/lib/provider/mingle.rb

@@ -0,0 +1,29 @@
+module TicketMaster::Provider
+  # This is the Mingle Provider for ticketmaster
+  module Mingle
+    include TicketMaster::Provider::Base
+    TICKET_API = MingleAPI::Card # The class to access the api's cards
+    PROJECT_API = MingleAPI::Project # The class to access the api's projects
+    
+    # This is for cases when you want to instantiate using TicketMaster::Provider::Mingle.new(auth)
+    def self.new(auth = {})
+      TicketMaster.new(:mingle, auth)
+    end
+    
+    # Providers must define an authorize method. This is used to initialize and set authentication
+    # parameters to access the API
+    
+    def authorize(auth = {})
+      @authentication ||= TicketMaster::Authenticator.new(auth)
+      auth = @authentication
+      if auth.server.blank? and auth.login.blank? and auth.password.blank?
+        raise "Please provide server, login and password"
+      end
+      MingleAPI.authenticate(auth.server, auth.login, auth.password)
+    end
+      # declare needed overloaded methods here
+    
+  end
+end
+
+

data/lib/provider/project.rb

@@ -0,0 +1,53 @@
+module TicketMaster::Provider
+  module Mingle
+    # Project class for ticketmaster-mingle
+    #
+    #
+    class Project < TicketMaster::Provider::Base::Project
+      API = MingleAPI::Project # The class to access the api's projects
+      # declare needed overloaded methods here
+     
+      def id
+        self[:identifier]
+      end
+
+      def initialize(*options)
+        super(*options)
+      end
+
+      def tickets(*options)
+        begin
+          if options.first.is_a? Hash
+            #options[0].merge!(:params => {:id => id})
+            super(*options)
+          elsif options.empty?
+            tickets = MingleAPI::Card.find(:all, :params => {:identifier => id}).collect { |ticket| TicketMaster::Provider::Mingle::Ticket.new ticket }
+          else
+            super(*options)
+          end
+        rescue
+          []
+        end
+      end
+
+      def ticket!(*options)
+        options[0].merge!(:identifier => id) if options.first.is_a?(Hash)
+        provider_parent(self.class)::Ticket.create(*options)
+      end
+
+      # copy from this.copy(that) copies that into this
+      def copy(project)
+        project.tickets.each do |ticket|
+          copy_ticket = self.ticket!(:name => ticket.title, :description => ticket.description)
+          ticket.comments.each do |comment|
+            copy_ticket.comment!(:content => comment.body)
+            sleep 1
+          end
+        end
+      end
+
+    end
+  end
+end
+
+

data/lib/provider/ticket.rb

@@ -0,0 +1,102 @@
+module TicketMaster::Provider
+  module Mingle
+    # Ticket class for ticketmaster-mingle
+    #
+    API = MingleAPI::Card
+
+    class Ticket < TicketMaster::Provider::Base::Ticket
+      # declare needed overloaded methods herea
+      
+      def initialize(*object)
+        if object.first
+          args = object
+          object = args.shift
+          identifier = args.shift
+          @system_data = {:client => object}
+          unless object.is_a? Hash
+           hash = {:number => object.number,
+                   :name => object.name,
+                   :description => object.description,
+                   :card_type_name => object.card_type.nil? ? "Card" : object.card_type.name,
+                   :identifier => identifier,
+                   :created_on => object.created_on,
+                   :modified_on => object.modified_on,
+                   :properties => object.properties}
+          else
+            hash = object
+          end
+          super hash
+        end
+      end
+
+      def self.create(*options)
+        card = API.new(*options)
+        ticket = self.new card
+        card.save
+        ticket
+      end
+
+      def self.find_by_id(identifier, number)
+        self.search(identifier, {'number' => number}).first
+      end
+
+      def self.search(identifier, options = {}, limit = 1000)
+        tickets = API.find(:all, :params => {:identifier => identifier}).collect { |ticket| self.new ticket, identifier }
+        search_by_attribute(tickets, options, limit)
+      end
+
+      def self.find_by_attributes(identifier, attributes = {})
+        self.search(identifier, attributes)
+      end
+
+      def number
+       self[:number].to_i
+      end
+
+      def id
+        self[:id].to_i
+      end
+
+      def name
+        self[:name]
+      end
+
+      def identifier
+        self[:identifier]
+      end
+
+      def title
+        self[:name]
+      end
+
+      def description
+        self[:description]
+      end
+
+      def status
+        self.properties[1].value
+      end
+
+      def comments(*options)
+        begin
+          if options.empty?
+            comments = MingleAPI::Comment.find(:all, :params => {:identifier => identifier, :number => number}).collect { |comment| TicketMaster::Provider::Mingle::Comment.new comment }
+          else
+            super(*options)
+          end
+        rescue
+         [] 
+        end
+      end
+
+      #def comment(*options)
+
+      def comment!(*options)
+        options[0].update(:identifier => identifier, :number => number) if options.first.is_a?(Hash)
+        Comment.create(*options)
+      end
+    
+    end
+
+  end
+end

data/lib/ticketmaster-mingle.rb

@@ -0,0 +1,5 @@
+require  File.dirname(__FILE__) + '/mingle/mingle-api'
+
+%w{ mingle ticket project comment }.each do |f|
+  require File.dirname(__FILE__) + '/provider/' + f + '.rb';
+end