taskmapper-mingle 0.2.0

data/lib/provider/mingle.rb

@@ -0,0 +1,38 @@
+module TaskMapper::Provider
+  # This is the Mingle Provider for taskmapper
+  module Mingle
+    include TaskMapper::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 TaskMapper::Provider::Mingle.new(auth)
+    def self.new(auth = {})
+      TaskMapper.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 ||= TaskMapper::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::Base.format = :xml
+      MingleAPI.authenticate(auth.server, auth.login, auth.password)
+    end
+      # declare needed overloaded methods here
+    def valid?
+      begin
+        PROJECT_API.find(:first)
+        true
+      rescue
+        false
+      end
+    end
+    
+  end
+end
+
+

data/lib/provider/project.rb

@@ -0,0 +1,62 @@
+module TaskMapper::Provider
+  module Mingle
+    # Project class for taskmapper-mingle
+    #
+    #
+    class Project < TaskMapper::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)
+        @system_data ||= {}
+        @cache ||= {}
+        first = options.first 
+        case first 
+        when Hash 
+          super first.to_hash
+        else
+          @system_data[:client] = first
+          super first.attributes
+        end
+      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| TaskMapper::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 TaskMapper::Provider
+  module Mingle
+    # Ticket class for taskmapper-mingle
+    #
+    API = MingleAPI::Card
+
+    class Ticket < TaskMapper::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| TaskMapper::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/taskmapper-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

data/spec/comments_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "TaskMapper::Provider::Mingle::Comment" do
+  before(:all) do
+    headers = {'Authorization' => 'Basic MDAwMDAwOg==', 'Accept' => 'application/xml'}
+    headers_post = {'Authorization' => 'Basic MDAwMDAwOg==', 'Content-Type' => 'application/xml'}
+    ActiveResource::HttpMock.respond_to do |mock|
+      mock.get '/api/v2/projects/test_project.xml', headers, fixture_for('projects/test_project'), 200
+      mock.get '/api/v2/projects/test_project/cards.xml', headers, fixture_for('cards'), 200
+      mock.get '/api/v2/projects/test_project/cards/42.xml', headers, fixture_for('cards/42'), 200
+      mock.get '/api/v2/projects/test_project/cards/42/comments.xml', headers, fixture_for('comments'), 200
+      mock.post '/api/v2/projects/test_project/cards/42/comments.xml?comment[content]=New%20comment%20created.', headers_post, fixture_for('comments/create'), 200
+    end
+    @identifier = 'test_project'
+    @number = 42
+  end
+  
+  before(:each) do
+    @taskmapper = TaskMapper.new(:mingle, {:name => 'anymoto', :login => '000000', :server => 'localhost:8080'})
+    @project = @taskmapper.project(@identifier)
+    @ticket = @project.ticket(@number)
+    @ticket.identifier = @project.identifier
+    @klass = TaskMapper::Provider::Mingle::Comment
+  end
+  
+  it "should be able to load all comments" do
+    @comments = @ticket.comments
+    @comments.should be_an_instance_of(Array)
+    @comments.first.should be_an_instance_of(@klass)
+  end
+  
+  it "should return the class" do
+    @ticket.comment.should == @klass
+  end
+  
+  it "should be able to create a comment" do
+    @comment = @ticket.comment!(:content => 'New comment created.')
+    @comment.should be_an_instance_of(@klass)
+  end
+end

data/spec/fixtures/cards.xml

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<cards type="array">
+  <card>
+    <name>Ticket 1</name>
+    <description>
+    </description>
+    <card_type>
+      <name>Story</name>
+    </card_type>
+    <id type="integer">409</id>
+    <number type="integer">42</number>
+    <project url="http://myserver.com/api/v2/projects/test_project.xml">
+      <name>test project</name>
+      <identifier>test_project</identifier>
+    </project>
+    <version type="integer">1</version>
+    <project_card_rank type="integer">1</project_card_rank>
+    <created_on type="datetime">2009-10-14T09:14:54Z</created_on>
+    <modified_on type="datetime">2009-10-14T09:14:54Z</modified_on>
+    <modified_by url="http://myserver.com/api/v2/users/1.xml">
+      <name>anne</name>
+      <login>anne</login>
+    </modified_by>
+    <created_by url="http://myserver.com/api/v2/users/2.xml">
+      <name>jane</name>
+      <login>jane</login>
+    </created_by>
+    <properties type="array">
+      <property type_description="Managed text list" hidden="false">
+        <name>Status</name>
+        <value>Closed</value>
+      </property>
+      <property type_description="Managed number list" hidden="false">
+        <name>Estimate</name>
+        <value>4</value>
+      </property>
+      <property type_description="Managed text list" hidden="false">
+        <name>Priority</name>
+        <value nil="true"/>
+      </property>
+    </properties>
+  </card>
+  <card>
+    <name>Automatically update event status when event date has passed</name>
+    <description>
+    </description>
+    <card_type>
+      <name>Story</name>
+    </card_type>
+    <id type="integer">410</id>
+    <number type="integer">43</number>
+    <project url="http://myserver.com/api/v2/projects/test_project.xml">
+      <name>test project</name>
+      <identifier>test_project</identifier>
+    </project>
+    <version type="integer">1</version>
+    <project_card_rank type="integer">1</project_card_rank>
+    <created_on type="datetime">2009-10-14T09:14:54Z</created_on>
+    <modified_on type="datetime">2009-10-14T09:14:54Z</modified_on>
+    <modified_by url="http://myserver.com/api/v2/users/1.xml">
+      <name>anne</name>
+      <login>anne</login>
+    </modified_by>
+    <created_by url="http://myserver.com/api/v2/users/2.xml">
+      <name>jane</name>
+      <login>jane</login>
+    </created_by>
+    <properties type="array">
+      <property type_description="Managed text list" hidden="false">
+        <name>Status</name>
+        <value>Closed</value>
+      </property>
+      <property type_description="Managed number list" hidden="false">
+        <name>Estimate</name>
+        <value>4</value>
+      </property>
+      <property type_description="Managed text list" hidden="false">
+        <name>Priority</name>
+        <value nil="true"/>
+      </property>
+    </properties>
+  </card>
+</cards>

data/spec/fixtures/cards/42.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <card>
+    <name>As an API user, I would like to lookup a card in Mingle, given that I know the card number.</name>
+    <description>
+    </description>
+    <card_type>
+      <name>Story</name>
+    </card_type>
+    <number type="integer">42</number>
+    <project url="http://myserver.com/api/v2/projects/test_project.xml">
+      <name>test project</name>
+      <identifier>test_project</identifier>
+    </project>
+    <version type="integer">1</version>
+    <project_card_rank type="integer">1</project_card_rank>
+    <created_on type="datetime">2009-10-14T09:14:54Z</created_on>
+    <modified_on type="datetime">2009-10-14T09:14:54Z</modified_on>
+    <modified_by url="http://myserver.com/api/v2/users/1.xml">
+      <name>anne</name>
+      <login>anne</login>
+    </modified_by>
+    <created_by url="http://myserver.com/api/v2/users/2.xml">
+      <name>jane</name>
+      <login>jane</login>
+    </created_by>
+    <properties type="array">
+      <property type_description="Managed text list" hidden="false">
+        <name>Status</name>
+        <value>Closed</value>
+      </property>
+      <property type_description="Managed number list" hidden="false">
+        <name>Estimate</name>
+        <value>4</value>
+      </property>
+      <property type_description="Managed text list" hidden="false">
+        <name>Priority</name>
+        <value nil="true"/>
+      </property>
+    </properties>
+  </card>
+

data/spec/fixtures/cards/43.xml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <card>
+    <name>Automatically update event status when event date has passed</name>
+    <description>
+    </description>
+    <card_type>
+      <name>Story</name>
+    </card_type>
+    <id type="integer">410</id>
+    <number type="integer">43</number>
+    <project url="http://localhost:8080/api/v2/projects/test_project.xml">
+      <name>test project</name>
+      <identifier>test_project</identifier>
+    </project>
+    <version type="integer">1</version>
+    <project_card_rank type="integer">1</project_card_rank>
+    <created_on type="datetime">2009-10-14T09:14:54Z</created_on>
+    <modified_on type="datetime">2009-10-14T09:14:54Z</modified_on>
+    <modified_by url="http://localhost:8080/api/v2/users/1.xml">
+      <name>anne</name>
+      <login>anne</login>
+    </modified_by>
+    <created_by url="http://localhost:8080/api/v2/users/2.xml">
+      <name>jane</name>
+      <login>jane</login>
+    </created_by>
+    <properties type="array">
+      <property type_description="Managed text list" hidden="false">
+        <name>Status</name>
+        <value>Closed</value>
+      </property>
+      <property type_description="Managed number list" hidden="false">
+        <name>Estimate</name>
+        <value>4</value>
+      </property>
+      <property type_description="Managed text list" hidden="false">
+        <name>Priority</name>
+        <value nil="true"/>
+      </property>
+    </properties>
+  </card>
+

data/spec/fixtures/cards/create.xml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <card>
+   <name>Show event details in event list</name>
+    <description>
+    </description>
+    <card_type>
+      <name>Story</name>
+    </card_type>
+    <id type="integer">411</id>
+    <number type="integer">44</number>
+    <project url="http://localhost:8080/api/v2/projects/test_project.xml">
+      <name>test project</name>
+      <identifier>test_project</identifier>
+    </project>
+    <version type="integer">1</version>
+    <project_card_rank type="integer">1</project_card_rank>
+    <created_on type="datetime">2009-10-14T09:14:54Z</created_on>
+    <modified_on type="datetime">2009-10-14T09:14:54Z</modified_on>
+    <modified_by url="http://localhost:8080/api/v2/users/1.xml">
+      <name>anne</name>
+      <login>anne</login>
+    </modified_by>
+    <created_by url="http://localhost:8080/api/v2/users/2.xml">
+      <name>jane</name>
+      <login>jane</login>
+    </created_by>
+    <properties type="array">
+      <property type_description="Managed text list" hidden="false">
+        <name>Status</name>
+        <value>Closed</value>
+      </property>
+      <property type_description="Managed number list" hidden="false">
+        <name>Estimate</name>
+        <value>4</value>
+      </property>
+      <property type_description="Managed text list" hidden="false">
+        <name>Priority</name>
+        <value nil="true"/>
+      </property>
+    </properties>
+  </card>
+