taskmapper-bcx 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 76364ca93d18edf8820a34fbb399c801b7baecc1
+  data.tar.gz: 43a7fa1e2daa97823e37ff1a341cd7f516938eeb
+SHA512:
+  metadata.gz: 59a4f1ce9de5e0f4ad3269de65b8657503704a441197474f7e7396f7622de4dd3dba0c855f4f73bb8592854d73108db46858c6577194eff66f3c96c1625f1f8b
+  data.tar.gz: 24ef5d1916a8229e4ecb402aecad85331fd1efab7f178313eba5d06e5faeaa9d7ed9988c1b562124d53bf5c0e34f3ea407a04ecd59892016a7ad55a3403e5d8c

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Andrew Stewart
+
+MIT License
+
+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,104 @@
+# taskmapper-bcx
+
+This is the [TaskMapper][] adapter for interaction with [Basecamp Next][]
+
+## Usage
+
+Initialize the taskmapper-bcx instance using your username, password, and
+account ID:
+
+```ruby
+bcx = TaskMapper.new(
+  :bcx,
+  :account_id => "123456789",
+  :username => "YOUR_USERNAME",
+  :username => "YOUR_PASSWORD",
+)
+```
+
+## Finding Projects
+
+You can find your own projects by using:
+
+```ruby
+projects = bcx.projects # will return all projects
+projects = bcx.projects ["project_id", "another_project_id"]
+project = bcx.projects.find :first, "project_id"
+projects = bcx.projects.find :all, ["project_id", "another_project_id"]
+```
+
+## Finding Tickets
+
+```ruby
+tickets = project.tickets # All open tickets
+tickets = project.tickets :all, :status => 'closed' # all closed tickets
+ticket = project.ticket 981234
+```
+
+## Opening A Ticket
+
+```ruby
+ticket = project.ticket!(
+  :description => "Content of the new ticket."
+)
+```
+
+## Closing Tickets
+
+```ruby
+ticket.close
+```
+
+## Reopening Tickets
+
+```ruby
+ticket.reopen
+```
+
+## Updating Tickets
+
+```ruby
+ticket.description = "New description"
+ticket.save
+```
+
+## Finding Comments
+
+```ruby
+ticket.comments # all comments for a ticket
+ticket.comments 90210
+```
+
+## Creating a Comment
+
+```ruby
+ticket.comment! :body => "New Comment!"
+```
+
+## Dependencies
+
+- rubygems
+- [taskmapper][]
+- [httparty][]
+
+## Contributing
+
+The main way you can contribute is with some code! Here's how:
+
+- Fork `taskmapper-bcx`
+- Create a topic branch: git checkout -b my_awesome_feature
+- Push to your branch - git push origin my_awesome_feature
+- Create a Pull Request from your branch
+- That's it!
+
+We use RSpec for testing. Please include tests with your pull request. A simple
+`bundle exec rake` will run the suite. Also, please try to TomDoc your methods,
+it makes it easier to see what the code does and makes it easier for future
+contributors to get started.
+
+(c) 2013 The Hybrid Group
+
+
+[taskmapper]: http://ticketrb.com
+[basecamp next]: https://basecamp.com
+[httparty]: https://github.com/jnunemaker/httparty

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler"
+require 'rspec/core/rake_task'
+
+task :default => :spec
+
+Bundler::GemHelper.install_tasks
+RSpec::Core::RakeTask.new :spec

data/lib/provider/api.rb

@@ -0,0 +1,26 @@
+require 'httparty'
+
+module TaskMapper::Provider
+  module Bcx
+    class API
+      include HTTParty
+
+      attr_reader :account_id, :username, :password
+
+      headers "Content-Type" => "Content-Type: application/json; charset=utf-8"
+
+      def initialize(account_id, username, password)
+        @username = username
+        @password = password
+        @account_id = account_id
+        self.class.base_uri "https://basecamp.com/#{account_id}/api/v1"
+        self.class.basic_auth username, password
+      end
+    end
+  end
+end
+
+require 'provider/api/auth'
+require 'provider/api/projects'
+require 'provider/api/todos'
+require 'provider/api/comments'

data/lib/provider/api/auth.rb

@@ -0,0 +1,12 @@
+module TaskMapper::Provider
+  module Bcx
+    class API
+      def authenticated?
+        @auth ||= begin
+          me = self.class.get "/people/me.json"
+          me.is_a?(Hash) && !me['id'].nil?
+        end
+      end
+    end
+  end
+end

data/lib/provider/api/comments.rb

@@ -0,0 +1,14 @@
+module TaskMapper::Provider
+  module Bcx
+    class API
+      def create_comment(attributes)
+        project = attributes.delete(:project_id)
+        todo = attributes.delete(:ticket_id)
+        body = { "content" => attributes[:body] }
+
+        url = "/projects#{project}/todos/#{todo}/comments.json"
+        self.class.post url, :body => body.to_json
+      end
+    end
+  end
+end

data/lib/provider/api/projects.rb

@@ -0,0 +1,13 @@
+module TaskMapper::Provider
+  module Bcx
+    class API
+      def projects
+        self.class.get "/projects.json"
+      end
+
+      def project(id)
+        self.class.get "/projects/#{id}.json"
+      end
+    end
+  end
+end

data/lib/provider/api/todos.rb

@@ -0,0 +1,61 @@
+module TaskMapper::Provider
+  module Bcx
+    class API
+      def todos(project_id)
+        ids = get_todolist_ids project_id
+        todo_ids = ids.collect do |id|
+          get_todo_ids_from_list project_id, id 
+        end.flatten
+
+        todos = []
+        todo_ids.each do |id|
+          todo = self.class.get "/projects/#{project_id}/todos/#{id}.json"
+          todos << Hash[todo]
+        end
+        todos.flatten
+      end
+
+      def todo(project_id, todo_id)
+        self.class.get "/projects/#{project_id}/todos/#{todo_id}.json"
+      end
+
+      def create_todo(attributes)
+        project = attributes.delete(:project_id)
+        todolist = attributes.delete(:todolist_id)
+        due_at = attributes.delete(:due_at)
+
+        body = { "content" => attributes[:description] }
+        body.merge({ "due_at" => due_at.utc.iso8601 }) if due_at
+
+        url = "/projects/#{project}/todolists/#{todolist}/todos.json"
+        self.class.post url, :body => body.to_json
+      end
+
+      def update_todo(todo)
+        body = {
+           :content => todo['content'],
+           :due_at => todo['due_at'],
+           :completed => todo['completed']
+        }
+
+        url = "/projects/#{todo['project_id']}/todos/#{todo['id']}.json"
+        self.class.put url, :body => body.to_json
+      end
+
+      private
+      def get_todolist_ids(project_id)
+        lists = self.class.get "/projects/#{project_id}/todolists.json"
+        lists.collect { |t| t['id'] }
+      end
+
+      def get_todo_ids_from_list(project_id, list)
+        list = self.class.get "/projects/#{project_id}/todolists/#{list}.json"
+        return [] if !list.is_a?(Hash) || list["todos"].nil?
+        ids = []
+        ids << list["todos"]["remaining"].map { |t| t['id'] }
+        ids << list["todos"]["completed"].map { |t| t['id'] }
+        ids.flatten
+      end
+    end
+  end
+end

data/lib/provider/bcx.rb

@@ -0,0 +1,44 @@
+module TaskMapper::Provider
+  module Bcx
+    include TaskMapper::Provider::Base
+
+    class << self
+      attr_accessor :username, :password, :account_id, :api
+
+      def new(auth = {})
+        TaskMapper.new(:bcx, auth)
+      end
+    end
+
+    def provider
+      TaskMapper::Provider::Bcx
+    end
+
+    def authorize(auth = {})
+      @authenticator ||= TaskMapper::Authenticator.new(auth)
+
+      unless auth[:username] && auth[:password]
+        message = "Please provide a username and password."
+        raise TaskMapper::Exception.new message
+      end
+
+      unless auth[:account_id]
+        message = "Please provide a Basecamp account_id"
+        raise TaskMapper::Exception.new message
+      end
+
+      provider.username = auth[:username]
+      provider.password = auth[:password]
+      provider.account_id = auth[:account_id]
+      configure auth
+    end
+
+    def configure(auth)
+      provider.api = API.new auth[:account_id], auth[:username], auth[:password]
+    end
+
+    def valid?
+      provider.api.authenticated?
+    end
+  end
+end

data/lib/provider/comment.rb

@@ -0,0 +1,78 @@
+module TaskMapper::Provider
+  module Bcx
+    class Comment < TaskMapper::Provider::Base::Comment
+      def initialize(*object)
+        object = object.first if object.is_a?(Array)
+        super object if object.is_a?(Hash)
+      end
+
+      def body
+        self[:content]
+      end
+
+      def updated_at
+        begin
+          Time.parse(self[:updated_at])
+        rescue
+          self[:updated_at]
+        end
+      end
+
+      def created_at
+        begin
+          Time.parse(self[:created_at])
+        rescue
+          self[:created_at]
+        end
+      end
+
+      class << self
+        def find_by_attributes(project_id, ticket_id, attributes = {})
+          search_by_attribute(self.find_all(project_id, ticket_id), attributes)
+        end
+
+        def find_by_id(project_id, ticket_id, comment_id)
+          ticket = Ticket.find_by_id project_id, ticket_id
+          if comment = ticket[:comments].find { |c| c[:id] == comment_id }
+            comment = comment.merge({
+              :ticket_id => ticket_id,
+              :project_id => project_id
+            })
+            return self.new comment
+          else
+            return false
+          end
+        end
+
+        def find_all(project_id, ticket_id)
+          ticket = Ticket.find_by_id project_id, ticket_id
+          ticket[:comments].collect do |comment|
+            comment = comment.merge({
+              :ticket_id => ticket_id,
+              :project_id => project_id
+            })
+            self.new comment
+          end
+        end
+
+        def create(attributes)
+          project = attributes[:project_id]
+          ticket = attributes[:ticket_id]
+
+          comment = api.create_comment attributes
+          comment = comment.merge({
+            :project_id => project,
+            :ticket_id => ticket
+          })
+
+          self.new comment
+        end
+
+        private
+        def api
+          TaskMapper::Provider::Bcx.api
+        end
+      end
+    end
+  end
+end

data/lib/provider/project.rb

@@ -0,0 +1,48 @@
+module TaskMapper::Provider
+  module Bcx
+    class Project < TaskMapper::Provider::Base::Project
+      def initialize(*object)
+        object = object.first if object.is_a?(Array)
+        super object if object.is_a?(Hash)
+      end
+
+      def updated_at
+        begin
+          Time.parse(self[:updated_at])
+        rescue
+          self[:updated_at]
+        end
+      end
+
+      def created_at
+        begin
+          Time.parse(self[:created_at])
+        rescue
+          self[:created_at]
+        end
+      end
+
+      class << self
+        def find_by_attributes(attributes = {})
+          search_by_attribute(self.find_all, attributes)
+        end
+
+        def find_all
+          projects = api.projects
+          projects = projects.select { |project| project.is_a?(Hash) }
+          projects.collect { |project| self.new project }
+        end
+
+        def find_by_id(id)
+          project = api.project(id)
+          self.new Hash[project]
+        end
+
+        private
+        def api
+          TaskMapper::Provider::Bcx.api
+        end
+      end
+    end
+  end
+end