ticketmaster-pivotal 0.0.1

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 HybridGroup
+
+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.markdown

@@ -0,0 +1,17 @@
+# ticketmaster-pivotal
+
+Description goes here.
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I 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 I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 HybridGroup. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "ticketmaster-pivotal"
+    gem.summary = %Q{This is a ticketmaster provider for interacting with Pivotal Tracker}
+    gem.description = %Q{This is a ticketmaster provider for interacting with Pivotal Tracker .}
+    gem.email = "hong.quach@abigfisch.com"
+    gem.homepage = "http://ticket.rb"
+    gem.authors = ["HybridGroup"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "activesupport", ">= 2.3.2"
+    gem.add_dependency "activeresource", ">= 2.3.2"
+    # 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 '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 :spec => :check_dependencies
+
+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-pivotal #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/pivotal/pivotal-api.rb

@@ -0,0 +1,73 @@
+require 'rubygems'
+require 'active_support'
+require 'active_resource'
+
+module PivotalAPI
+  class Error < StandardError; end
+  class << self
+    # Sets up basic authentication credentials for all the resources.
+    def authenticate(user, password)
+      Token.user = user
+      Token.password = password
+      self.token = Token.get(:active)['guid']
+      Token.user = nil
+      Token.password = nil
+    end
+
+    # Sets the API token for all the resources.
+    def token=(value)
+      resources.each do |klass|
+        klass.headers['X-TrackerToken'] = value
+      end
+      @token = value
+    end
+
+    def resources
+      @resources ||= []
+    end
+  end
+
+  class Base < ActiveResource::Base
+    self.site = 'http://www.pivotaltracker.com/services/v3/'
+    def self.inherited(base)
+      PivotalAPI.resources << base
+      super
+    end
+  end
+
+  class Project < Base
+    def stories(options = {})
+      Story.find(:all, :params => options.merge!(:project_id => self.id))
+    end
+  end
+  
+  class Token < Base
+  end
+  
+  class Activity < Base
+    self.site += 'projects/:project_id/'
+  end
+  
+  class Membership < Base
+    self.site += 'projects/:project_id/'
+  end
+  
+  class Iteration < Base
+    self.site += 'projects/:project_id/'
+  end
+  
+  class Story < Base
+    self.site += 'projects/:project_id/'
+  end
+  
+  class Note < Base
+    self.site += 'projects/:project_id/stories/:story_id/'
+  end
+  
+  class Task < Base
+    self.site += 'projects/:project_id/stories/:story_id/'
+  end
+  
+  class AllActivity < Base
+  end
+end

data/lib/provider/pivotal.rb

@@ -0,0 +1,86 @@
+module TicketMaster::Provider
+  # This is the Pivotal Tracker Provider for ticketmaster
+  module Pivotal
+    include TicketMaster::Provider::Base
+    
+    # This is for cases when you want to instantiate using TicketMaster::Provider::Lighthouse.new(auth)
+    def self.new(auth = {})
+      TicketMaster.new(:pivotal, auth)
+    end
+    
+    # The authorize and initializer for this provider
+    def authorize(auth = {})
+      @authentication ||= TicketMaster::Authenticator.new(auth)
+      auth = @authentication
+      if auth.token
+        PivotalAPI.token = auth.token
+      elsif auth.username && auth.password
+        PivotalAPI.authenticate(auth.username, auth.password)
+      end
+    end
+    
+    # The projects
+    #
+    # We have to merge in the auth information because, due to the class-based authentication
+    # mechanism, if we don't reset the authorize information for every request, it would 
+    # end up using whatever the previous instantiated object's account info is.
+    def projects(*options)
+      authorize
+      projects = if options.length > 0
+        Project.find(*options)
+        else
+        Project.find(:all)
+        end
+      set_master_data(projects)
+    end
+    
+    # The project
+    def project(*options)
+      authorize
+      return set_master_data(Project.find(:first, *options)) if options.length > 0
+      Project
+    end
+    
+    # The tickets
+    #
+    # Due to the nature of pivotal, we must have the project_id to pull tickets. You can
+    # pass in the id through this format:
+    # 
+    #    .tickets(22)
+    #    .tickets(:project_id => 22)
+    # 
+    # To conform to ticketmaster's standard of returning all tickets on a call to this method
+    # without any parameters, if no parameters are passed, it will return all tickets for whatever
+    # the first project is.
+    def tickets(*options)
+      authorize
+      arg = options.shift
+      tickets = if arg.nil?
+        Ticket.find
+        elsif arg.is_a?(Fixnum)
+        Ticket.find(:all, :params => {:project_id => arg})
+        elsif arg.is_a?(Hash)
+        Ticket.find(:all, :params => arg) if arg.is_a?(Hash)
+        else
+        []
+        end
+      set_master_data(tickets)
+    end
+    
+    # the ticket
+    def ticket(*options)
+      authorize
+      return set_master_data(Ticket.find(*options)) if options.length > 0
+      Ticket
+    end
+    
+    def set_master_data(data)
+      if data.is_a?(Array)
+        data.collect! { |p| p.system_data.merge!(:master => self); p }
+      else
+        data.system_data.merge!(:master => self)
+      end
+      data
+    end
+  end
+end

data/lib/provider/project.rb

@@ -0,0 +1,108 @@
+module TicketMaster::Provider
+  module Pivotal
+    # Project class for ticketmaster-pivotal
+    # 
+    # 
+    class Project < TicketMaster::Provider::Base::Project
+      # The finder method
+      # 
+      # It accepts all the find functionalities defined by ticketmaster
+      #
+      # + find() and find(:all) - Returns all projects on the account
+      # + find(<project_id>) - Returns the project based on the id
+      # + find(:first, :name => <project_name>) - Returns the first project based on the attribute
+      # + find(:name => <project name>) - Returns all projects based on the attribute
+      attr_accessor :prefix_options
+      alias_method :stories, :tickets
+      alias_method :story, :ticket
+      
+      def self.find(*options)
+        first = options.shift
+        if first.nil? or first == :all
+          PivotalAPI::Project.find(:all).collect do |p|
+            self.new p
+          end
+        elsif first.is_a?(Fixnum)
+          self.new PivotalAPI::Project.find(first)
+        elsif first == :first
+          self.new self.search(options.shift || {}, 1).first
+        elsif first.is_a?(Hash)
+          self.search(first).collect { |p| self.new p }
+        end
+      end
+      
+      # This is a helper method to find
+      def self.search(options = {}, limit = 1000)
+        projects = PivotalAPI::Project.find(:all)
+        projects.find_all do |p|
+          options.keys.reduce(true) do |memo, key|
+            p.send(key) == options[key] and (limit-=1) >= 0
+          end
+        end
+      end
+      
+      # Create a project
+      def self.create(*options)
+        project = PivotalAPI::Project.new(options.shift)
+        project.save
+        self.new project
+      end
+      
+      # The initializer
+      #
+      # A side effect of Hashie causes prefix_options to become an instance of TicketMaster::Provider::Pivotal::Project
+      def initialize(*options)
+        @system = :pivotal
+        @system_data = {}
+        first = options.shift
+        if first.is_a?(PivotalAPI::Project)
+          @system_data[:client] = first
+          @prefix_options = first.prefix_options
+          super(first.attributes)
+        else
+          super(first)
+        end
+      end
+      
+      # All tickets for this project
+      def tickets(*options)
+        if options.length == 0
+          Ticket.find(:project_id => self.id)
+        else
+          first = options.first
+          if first.is_a?(Fixnum)
+            [Ticket.find(first, {:project_id => self.id})]
+          else
+            Ticket.find({:project_id => self.id}.merge(:q => options.first))
+          end
+        end
+      end
+      
+      # The ticket finder
+      # returns only one ticket
+      def ticket(*options)
+        first = options.shift
+        if first.nil?
+          return Ticket
+        elsif first.is_a?(Fixnum)
+          return Ticket.find(first, :project_id => self.id)
+        else
+          Ticket.find(:first, {:project_id => self.id}.merge(:q => first))
+        end
+      end
+      
+      # Save this project
+      def save
+        warn 'Warning: Pivotal does not allow editing of project attributes. This method does nothing.'
+        true
+      end
+      
+      # Delete this project
+      def destroy
+        result = self.system_data[:client].destroy
+        result.is_a?(Net::HTTPOK)
+      end
+
+    end
+  end
+end

data/lib/provider/ticket.rb

@@ -0,0 +1,107 @@
+module TicketMaster::Provider
+  module Pivotal
+    # Ticket class for ticketmaster-pivotal
+    class Ticket < TicketMaster::Provider::Base::Ticket
+      @@allowed_states = ['new', 'open', 'resolved', 'hold', 'invalid']
+      attr_accessor :prefix_options
+      
+      # The finder
+      #
+      # It tries to implement all the ticketmaster calls, but since the project id is required as the
+      # parent key, it doesnt really make sense to call find(:all) or find(##)
+      # 
+      # * find(:all) - Returns an array of all tickets
+      # * find(##, ##) - Returns a ticket based on that id or some other primary (unique) attribute
+      # * find(:first, :summary => 'Ticket title') - Returns a ticket based on the ticket's attributes
+      # * find(:summary => 'Test Ticket') - Returns all tickets based on the given attributes
+      def self.find(*options)
+        first = options.shift
+        if first.nil? or first == :all
+          tickets = []
+          PivotalAPI::Project.find(:all).each do |p|
+            tickets |= p.stories
+          end
+          tickets.collect { |t| self.new t }
+        elsif first.is_a?(Fixnum)
+          second = options.shift
+          if second.is_a?(Fixnum)
+            self.new PivotalAPI::Story.find(first, :params => { :project_id => second })
+          elsif second.is_a?(Hash)
+            self.new PivotalAPI::Story.find(first, :params => qize(second))
+          end
+        elsif first == :first
+          self.new self.search(options.shift, 1).first
+        elsif first.is_a?(Hash)
+          self.search(first).collect do |t| self.new t end
+        end
+      end
+      
+      def self.qize(params)
+        return params unless params[:filter] and params[:filter].is_a?(Hash)
+        q = ''
+        params[:filter].keys.each do |key|
+          value = params[:q][key]
+          value = "\"#{value}\"" if value.to_s.include?(' ')
+          q += "#{key}:#{value} "
+        end
+        params[:filter] = q
+        params
+      end
+      
+      # The find helper
+      def self.search(options, limit = 1000)
+        tickets = PivotalAPI::Story.find(:all, :params => ({:project_id => (options.delete(:project_id) || options.delete('project_id')).to_i}.merge(qize(:filter => options))))
+        tickets.find_all do |t|
+          options.keys.reduce(true) do |memo, key|
+            t.send(key) == options[key] and (limit-=1) > 0
+          end
+        end
+      end
+      
+      # The initializer
+      def initialize(*options)
+        @system = :pivotal
+        @system_data = {}
+        first = options.shift
+        if first.is_a?(PivotalAPI::Story)
+          @system_data[:client] = first
+          @prefix_options = first.prefix_options
+          super(first.attributes)
+        else
+          super(first)
+        end
+      end
+      
+      # The creator
+      def self.create(*options)
+        new_ticket = PivotalAPI::Story.new(:project_id => (options.first.delete(:project_id) || options.first.delete('project_id')).to_i)
+        ticket_attr.each do |k, v|
+          new_ticket.send(k + '=', v)
+        end
+        new_ticket.save
+        self.new new_ticket
+      end
+      
+      # The saver
+      def save(*options)
+        pt_ticket = @system_data[:client]
+        self.keys.each do |key|
+          pt_ticket.send(key + '=', self.send(key)) if self.send(key) != pt_ticket.send(key)
+        end
+        pt_ticket.save
+      end
+      
+      def destroy(*options)
+        @system_data[:client].destroy.is_a?(Net::HTTPOK)
+      end
+      
+      # The closer
+      def close(resolution = 'resolved')
+        resolution = 'resolved' unless @@allowed_states.include?(resolution)
+        ticket = PivotalAPI::Ticket.find(self.id, :params => {:project_id => self.prefix_options[:project_id]})
+        ticket.state = resolution
+        ticket.save
+      end
+    end
+  end
+end

data/lib/ticketmaster-pivotal.rb

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

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'ticketmaster-pivotal'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/ticketmaster-pivotal_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "TicketmasterPivotal" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: ticketmaster-pivotal
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- HybridGroup
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-26 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 3
+        - 2
+        version: 2.3.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: activeresource
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 3
+        - 2
+        version: 2.3.2
+  type: :runtime
+  version_requirements: *id003
+description: This is a ticketmaster provider for interacting with Pivotal Tracker .
+email: hong.quach@abigfisch.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/pivotal/pivotal-api.rb
+- lib/provider/pivotal.rb
+- lib/provider/project.rb
+- lib/provider/ticket.rb
+- lib/ticketmaster-pivotal.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/ticketmaster-pivotal_spec.rb
+has_rdoc: true
+homepage: http://ticket.rb
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: This is a ticketmaster provider for interacting with Pivotal Tracker
+test_files: 
+- spec/spec_helper.rb
+- spec/ticketmaster-pivotal_spec.rb