teamworkpm 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c413f43deba985a73fdd5018cc17443937216457
+  data.tar.gz: d6e75bb5cd041eb286f4bdb0392a51653e4b3b2b
+SHA512:
+  metadata.gz: acb7c0ce9217d67f59759268c2db3ae278bfa9ef6cf6fe4915e57acbddb498d607eb975816d33fd4128b8fbfa140e19926c8b529f124d10d71a327e946b8a68a
+  data.tar.gz: 3b35842ad4704ff3f221169db6785d879b27ca8105f9c7772cd96aec0410b59af8d907d561913de9d4a19ca56baacc6f3098cdf4e93f35ca4bec12610ede383a

data/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org>

data/README.md

@@ -0,0 +1,39 @@
+# Teamwork Gem
+
+Teamwork is project management software for teams.  This gem attempts to get as close to 100% coverage for the API as possible,
+with a few notable holes being uploading files and managing companies.  I would welcome any pull-request that add these capabilities.
+
+## Usage
+
+To get started add `gem "teamworkpm"` to your `Gemfile` (if using Bundler) or run `gem install teamworkpm`.
+
+In order to use the `teamworkpm` gem you will need to have an active teamwork account with full API access.  You can read the docs
+on getting your API key [here](http://developer.teamwork.com/enabletheapiandgetyourkey).
+
+### Authentication
+
+Authentication to the API is done through the class method `authenticate`.  `Teamwork.authenticate(api_key)` will log you in.  Failed authentication will return a `401`, else the account for the authenticated user.
+
+### Capabilites
+
+#### Account
+
+    # GET the authenticated users's information
+    # Return Teamwork::Thing
+    Teamwork.account_info
+
+
+    # GET an authenticated user
+    # This part is unique to the rest of the lib
+    # in that it uses a different path for the API call.
+    # What we can get from this, however, is the subdomain that the
+    # user is a part of and store that for future API calls.
+    # http://authenticate.teamworkpm.net/authenticate.json
+    # Return Teamwork::Thing (or 401 if auth fails)
+    Teamwwork.authenticate(api_key)
+
+#### Activity
+
+  # GET the recent activity stream across all projects
+  # Return [Teamwork::Thing]
+  Teamwork.recent_activity(options) # Defaults to returning 60 items

data/Rakefile

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

data/lib/teamwork.rb

@@ -0,0 +1,26 @@
+require "teamwork/client"
+
+module Teamwork
+
+  class << self
+
+    attr_accessor :api_key, :subdomain
+
+    def client
+      @client ||= Teamwork::Client.new
+    end
+
+    def respond_to?(method_name, include_private = false)
+      client.respond_to?(method_name, include_private) || super
+    end
+
+    private
+
+    def method_missing(method_name, *args, &block)
+      return super unless client.respond_to?(method_name)
+      client.send(method_name, *args, &block)
+    end
+
+  end
+
+end

data/lib/teamwork/client.rb

@@ -0,0 +1,84 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'json'
+Dir[File.dirname(__FILE__) + '/client/*.rb'].each {|file| require file }
+
+module Teamwork
+
+  class Client
+
+    include Teamwork::Client::Account
+    include Teamwork::Client::Activity
+    include Teamwork::Client::Comment
+    include Teamwork::Client::Company
+    include Teamwork::Client::File
+    include Teamwork::Client::Message
+    include Teamwork::Client::Notebook
+    include Teamwork::Client::People
+    include Teamwork::Client::Project
+    include Teamwork::Client::Task
+    include Teamwork::Client::Timer
+
+    def api_endpoint
+      @api_endpoint ||= "http://#{Teamwork.subdomain}.teamworkpm.net/"
+    end
+
+    def self.authenticated?
+      !Teamwork.subdomain.nil? || !Teamwork.api_key.nil?
+    end
+
+    def resources
+      %w{links milestones files notebooks tasks}
+    end
+
+    private
+
+    def objects_from_response(method, path, key, params = nil, format = ".json")
+      res = response(method, path, key, params, format)[key]
+      return [] if res.nil?
+      res.map { |item| Teamwork::Thing.new(item) }
+    end
+
+    def object_from_response(method, path, key, params = nil, format = ".json")
+      Teamwork::Thing.new(response(method, path, key, params, format)[key])
+    end
+
+    def response(method, path, key, params, format)
+      send(method.to_sym, "#{path}#{format}", params).body
+    end
+
+    def get(path, params = nil)
+      request(:get, path, params)
+    end
+
+    def post(path, params = nil)
+      request(:post, path, params)
+    end
+
+    def put(path, params = nil)
+      request(:put, path, params)
+    end
+
+    def delete_path(path, params = nil)
+      request(:delete, path, params)
+    end
+
+    def request(method, path, parameters = {})
+      connection.send(method.to_sym, path, parameters).env
+    end
+
+    def connection(endpoint = api_endpoint)
+      Faraday.new endpoint do |c|
+        c.request :multipart
+        c.request :json
+        c.request :url_encoded
+        c.response :json, content_type: /\bjson$/
+        c.adapter :net_http
+        c.headers[:cache_control] = 'no-cache'
+        c.basic_auth(Teamwork.api_key, '')
+      end
+    end
+
+  end
+
+end

data/lib/teamwork/client/account.rb

@@ -0,0 +1,34 @@
+require 'uri'
+
+module Teamwork
+  class Client
+
+    module Account
+
+      # GET the authenticated users's information
+      # Return Teamwork::Thing
+      def account_info
+        object_from_response(:get, "account", "account")
+      end
+
+      # GET an authenticated user
+      # This part is unique to the rest of the lib
+      # in that it uses a different path for the API call.
+      # What we can get from this, however, is the subdomain that the
+      # user is a part of and store that for future API calls.
+      # http://authenticate.teamworkpm.net/authenticate.json
+      # Return Teamwork::Thing (or 401 if auth fails)
+      def authenticate(api_key)
+        Teamwork.api_key = api_key
+        result = connection("http://authenticate.teamworkpm.net").send(:get, "authenticate.json").env
+        return result.status if result.status == 401
+
+        thing = Thing.new(result.body["account"])
+        Teamwork.subdomain = thing.code
+        thing
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/activity.rb

@@ -0,0 +1,15 @@
+module Teamwork
+  class Client
+
+    module Activity
+
+      # GET the recent activity stream across all projects
+      # Return [Teamwork::Thing]
+      def recent_activity(options = {})
+        objects_from_response(:get, "latestActivity", "activity", options.merge({maxItems: 60, onlyStarred: false}))
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/comment.rb

@@ -0,0 +1,73 @@
+module Teamwork
+  class Client
+
+    module Comment
+
+      # GET comments for a given resource
+      # params:
+      #   resource: String (links, milestones, files, notebooks, tasks)
+      #   id: UnsignedInt (the id of the resource that you want to get comments on)
+      # options:
+      #   page: UnsignedInt
+      #   pageSize: UnsignedInt (default 50)
+      # return: [Teamwork::Thing]
+      def get_comments(resource, id, options = {})
+        validate_resource(resource)
+        objects_from_response(:get, "#{resource}/#{id}/comments", "comments", options)
+      end
+
+      # GET a single comment by ID
+      # params:
+      #   id: UnsignedInt
+      # return Teamwork::Thing
+      def get_comment(id)
+        object_from_response(:get, "comments/#{id}", "comment")
+      end
+
+      # POST a new comment
+      # params:
+      #   resource: String (links, milestones, files, notebooks, tasks)
+      #   id: UnsignedInt (the id of the resource that you want to post comments to)
+      # options:
+      #   body: String
+      #   notify: String (who should we notify of this comment?)
+      #   ispprivate: Boolean (default false)
+      #   pendingFileAttachments: String (see http://developer.teamwork.com/uploadingfiles for more info)
+      # return Teamwork::Thing
+      def post_comment(resource, id, options)
+        validate_resource(resource)
+        get_comment(send(:post, "#{resource}/#{id}/comments.json", comment: options).body["commentId"])
+      end
+
+      # PUT an update to a comment
+      # params:
+      #   id: UnsignedInt (the id of the comment that you want update)
+      # options:
+      #   body: String
+      #   notify: String (who should we notify of this comment?)
+      #   ispprivate: Boolean (default false)
+      #   pendingFileAttachments: String (see http://developer.teamwork.com/uploadingfiles for more info)
+      # return Integer (status code)
+      def update_comment(id, options)
+        send(:put, "comments/#{id}.json", comment: options).status
+      end
+
+      # DELETE a comment
+      # params:
+      #   id: UnsignedInt (the comment id to delete)
+      # return Int (status code)
+      def delete_comment(id)
+        send(:delete, "coments/#{id}")
+      end
+
+
+      private
+
+      def validate_resource(resource)
+        raise TypeError, "Valid resources are #{resources.join(", ")}" unless resources.include?(resource)
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/company.rb

@@ -0,0 +1,15 @@
+module Teamwork
+  class Client
+
+    module Company
+
+      # GET a list of companies
+      # Return [Teamwork::Thing]
+      def get_companies
+        objects_from_response(:get, "companies", "companies")
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/file.rb

@@ -0,0 +1,15 @@
+module Teamwork
+  class Client
+
+    module File
+
+      # GET a single message
+      # return Teamwork::Thing
+      def get_file(id)
+        object_from_response(:get, "files/#{id}", "file")
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/message.rb

@@ -0,0 +1,15 @@
+module Teamwork
+  class Client
+
+    module Message
+
+      # GET a single message
+      # return Teamwork::Thing
+      def get_message(id)
+        object_from_response(:get, "posts/#{id}", "post")
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/notebook.rb

@@ -0,0 +1,21 @@
+module Teamwork
+  class Client
+
+    module Notebook
+
+      # GET all notebooks
+      # This method is a bit different as the response nests notebooks under
+      # projects, which itself is an array.  Once the projects are parsed,
+      # lets map those and save the notebooks to an array
+      # options:
+      #   includeContent: Boolean (default false)
+      # return: [Teamwork::Thing]
+      def get_notebooks(options = {})
+        objects_from_response(:get, "notebooks", "projects", options)
+          .map { |project| project.notebooks.map { |notebook| Teamwork::Thing.new(notebook) }}.flatten
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/people.rb

@@ -0,0 +1,19 @@
+module Teamwork
+  class Client
+
+    module People
+
+      # GET all people
+      # options:
+      #   page: UnsignedInt
+      #   pageSize: UnsignedInt (default 50)
+      # return: [Teamwork::Thing]
+      def get_people(options = {})
+        objects_from_response(:get, "people", "people", options)
+      end
+
+
+    end
+
+  end
+end

data/lib/teamwork/client/project.rb

@@ -0,0 +1,111 @@
+module Teamwork
+  class Client
+
+    module Project
+
+      # GET the recent activity stream for a given project
+      # Return [Teamwork::Thing]
+      def project_activity(project_id, options = {})
+        objects_from_response(:get, "projects/#{project_id}/latestActivity", "activity", options.merge({maxItems: 50}))
+      end
+
+      # GET time entries for the project
+      # options:
+      #   page: UnsignedInt
+      #   fromdate: YYYYMMDD
+      #   fromtime: HH:MM
+      #   todate: YYYYMMDD
+      #   totime: HH:MM
+      #   sortorder: (ASC, DESC) (defaults to ascending order by date (oldest to newest))
+      # Return [Teamwork::Thing]
+      def project_timers(project_id, options = {})
+        objects_from_response(:get, "projects/#{project_id}/time_entries", "time-entries", options)
+      end
+
+      # GET people on a project
+      # params:
+      #   project_id: UnsignedInt
+      # Return [Teamwork::Thing]
+      def project_people(project_id)
+        objects_from_response(:get, "projects/#{project_id}/people", "people")
+      end
+
+      # GET files on a project
+      # Unfortunately the API returns a project with the associated files as a key
+      # in the hash. So lets get the files out after.
+      # params:
+      #   project_id: UnsignedInt
+      # Return [Teamwork::Thing]
+      def project_files(project_id)
+        object_from_response(:get, "projects/#{project_id}/files", "project").files.map { |file| Teamwork::Thing.new(file) }
+      end
+
+      # GET messages on a project
+      # params:
+      #   project_id: UnsignedInt
+      # Return [Teamwork::Thing]
+      def project_messages(project_id)
+        objects_from_response(:get, "projects/#{project_id}/posts", "posts")
+      end
+
+      # GET companies on a project
+      # params:
+      #   project_id: UnsignedInt
+      # Return [Teamwork::Thing]
+      def project_companies(project_id)
+        objects_from_response(:get, "projects/#{project_id}/companies", "people")
+      end
+
+      # GET a list of projects
+      # Options: 
+      #   status: (ALL, ACTIVE, ARCHIVED)
+      #   updatedAfterDate: YYYYMMDD
+      #   updatedAfterTime: HH:MM
+      #   createdAfterDate: YYYYMMDD
+      #   createdAfterTime: HH:MM
+      #   includePeople: boolean
+      #   orderby: (name, companyName, lastActivityDate)
+      #   starred: true
+      #   page: UnsignedInt
+      # Return [Teamwork::Thing]
+      def projects(options = {})
+        url = options[:starred].nil? ? "projects" : "projects/starred"
+        objects_from_response(:get, url, "projects", options)
+      end
+
+      # GET a single project
+      # Return Teamwork::Thing
+      def project(id)
+        object_from_response(:get, "project/#{id}", "project")
+      end
+
+      # PUT a start to a project
+      # Return Boolean
+      def toggle_project_star(id, star: true)
+        url = star ? "projects/#{id}/star" : "projects/#{id}/unstar"
+        object_from_response(:put, url, "project", project: options)
+      end
+
+
+      # POST a new project
+      # Return Teamwork::Thing
+      def create_project(options = {})
+        object_from_response(:post, "projects", "project", project: options)
+      end
+
+      # PUT a current project
+      # Return Teamwork::Thing
+      def update_project(id, options = {})
+        object_from_response(:put, "projects/#{id}", "project", project: options)
+      end
+
+      # DELETE a current project
+      # Return Boolean
+      def delete_project(id)
+        send(:delete, "projects/#{id}")
+      end
+
+    end
+    
+  end
+end

data/lib/teamwork/client/task.rb

@@ -0,0 +1,48 @@
+module Teamwork
+  class Client
+
+    module Task
+
+      # GET time entries for the project
+      # options:
+      #   page: UnsignedInt
+      #   fromdate: YYYYMMDD
+      #   fromtime: HH:MM
+      #   todate: YYYYMMDD
+      #   totime: HH:MM
+      #   sortorder: (ASC, DESC) (defaults to ascending order by date (oldest to newest))
+      # Return [Teamwork::Thing]
+      def task_timers(task_id, options)
+        objects_from_response(:get, "todo_items/#{task_id}/time_entries", "time-entries", options)
+      end
+
+      # GET all tasks across all projects
+      # options:
+      #   filter: (all, anytime, overdue, today, tomorrow, thisweek, within7, within14, within30, within365, nodate, nostartdate, completed)
+      #   page: UnsignedInt
+      #   pageSize: 250 (the amount of tasks to return per page)
+      #   startdate: YYYYMMDD
+      #   endDate: YYYYMMDD
+      #   updatedAfterDate: YYYYMMDD
+      #   showDeleted: Boolean (default false)
+      #   includeCompletedTasks: Boolean (default false)
+      #   includeCompletedSubtasks: Boolean (default false)
+      #   creator-ids: Comma-delimited list of user ids
+      #   include: (nodate, nostartdate, noduedate, overdue)
+      #   responsible-party-ids (-1 (all assigned), 0 (all unassigned), or specific user ids as a comma-delimited-list)
+      #   sort (duedate, startdate, dateadded, priority, project, company)
+      #   getSubTasks: Boolean (default true)
+      #   nestSubTasks: Boolean (default false)
+      #   getFiles: Boolean (default false)
+      #   dataSet: String (default full) (options: full, newTaskDefaults)
+      #   includeToday: Boolean (default true) (When using the filter option with any of the following options; within7,within14,within30,within365. You can choose to exclude deadlines for today by passing this parameter as false.)
+      #   ignore-start-dates: Boolean (default false) (When using the filter option, you can choose to include start dates matching the filtering critera by passing this parameter as true. By default, only due dates are checked against the filter.)
+      # Return [Teamwork::Thing]
+      def all_tasks(options = {})
+        objects_from_response(:get, "tasks", "todo-items", options)
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/client/thing.rb

@@ -0,0 +1,15 @@
+module Teamwork
+
+  class Thing
+
+    def initialize(item)
+      item.each_pair do |key, value|
+        key = key.split(/[\s-]/).join('_').downcase
+        singleton_class.class_eval do; attr_accessor key; end
+        send("#{key}=", value)
+      end
+    end
+
+  end
+
+end

data/lib/teamwork/client/timer.rb

@@ -0,0 +1,41 @@
+module Teamwork
+  class Client
+
+    module Timer
+
+      # GET recent time entries
+      # options:
+      #   page: UnsignedInt
+      #   fromdate: YYYYMMDD
+      #   fromtime: HH:MM
+      #   todate: YYYYMMDD
+      #   totime: HH:MM
+      #   sortorder: (ASC, DESC) (defaults to ascending order by date (oldest to newest))
+      # Return [Teamwork::Thing]
+      def time_entries(options = {})
+        objects_from_response(:get, "time_entries", "time-entries", options)
+      end
+
+
+      # GET a single time entry
+      # Return Teamwork::Thing
+      def time_entry(id)
+        object_from_response(:get, "time_entries/#{id}", "time-entry")
+      end
+
+      # PUT a single time entry
+      # Return Teamwork::Thing
+      def update_time_entry(options = {})
+        object_from_response(:put, "time_entries/#{id}", "time-entry", "time-entry" => options)
+      end
+
+      # DELETE a single time entry
+      # Return boolean
+      def delete_time_entry(id)
+        send(:delete, "time_entries/#{id}")
+      end
+
+    end
+
+  end
+end

data/lib/teamwork/version.rb

@@ -0,0 +1,3 @@
+module Teamwork
+  VERSION = "2.0.0"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require_relative '../lib/teamwork'
+require_relative 'support/helpers.rb'
+require 'rspec'
+require 'dotenv'
+
+Dotenv.load
+
+RSpec.configure do |config|
+
+  config.filter_run focus: true
+  config.run_all_when_everything_filtered = true
+  config.include Helpers
+
+end

data/spec/support/helpers.rb

@@ -0,0 +1,7 @@
+module Helpers
+
+  def authenticate
+    Teamwork.authenticate(ENV["API_KEY"])
+  end
+
+end

data/spec/teamwork/client/account_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Account do
+
+  context "#authenticate" do
+
+    before(:each) do
+      Teamwork.api_key = ''
+      Teamwork.subdomain = ''
+    end
+
+    it "responds" do
+      expect(Teamwork.authenticate(ENV["API_KEY"])).to be_a(Teamwork::Thing)
+    end
+
+    it "sets subdomain" do
+      expect { Teamwork.authenticate(ENV["API_KEY"]) }.to change{Teamwork.subdomain}.to ENV["SUBDOMAIN"]
+    end
+
+    it "sets api key" do
+      expect { Teamwork.authenticate(ENV["API_KEY"]) }.to change{Teamwork.api_key}.to ENV["API_KEY"]
+    end
+
+    context "bad keys" do
+
+      it "raises error" do
+        expect(Teamwork.authenticate("this-should-blow-up")).to eq(401)
+      end
+
+    end
+
+  end
+
+  context "#account_info" do
+
+    before(:each) { authenticate }
+
+    it "is a thing" do
+      expect(Teamwork.account_info).to be_a(Teamwork::Thing)
+    end
+
+    it "fails if not authenticated" do
+      Teamwork.authenticate("no-good-key")
+      expect { Teamwork.account_info }.to raise_error
+    end
+
+    it "fills out the name" do
+      expect(Teamwork.account_info.name).to_not be_nil
+    end
+
+  end
+
+end

data/spec/teamwork/client/comment_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Comment do
+
+  before(:each) { authenticate }
+
+  let(:comment_body) { {body: "Hey", notify: "", isprivate: false, pendingFileAttachments: ""} }
+  let(:comment_id) { ENV["COMMENT_ID"] }
+  let(:task) { ENV["TASK_ID"] }
+
+  context "#get_comments" do
+
+    it "responds" do
+      expect(Teamwork.respond_to?(:get_comments)).to eq(true)
+    end
+
+    it "raises exception on invalid option" do
+      expect { Teamwork.get_comments("sports", 14) }.to raise_error
+    end
+
+    it "builds array" do
+      expect(Teamwork.get_comments("tasks", Teamwork.all_tasks.first.id)).to be_a(Array)
+    end
+
+  end
+
+  context "#get_comment" do
+
+    let(:comments) { Teamwork.get_comments("tasks", task) }
+
+    it "responds" do
+      expect(Teamwork.respond_to?(:get_comment)).to eq(true)
+    end
+
+    it "is a thing" do
+      expect(Teamwork.get_comment(comments.first.id)).to be_a(Teamwork::Thing)
+    end
+
+  end
+
+  context "#post_comment" do
+
+    it "creates a comment" do
+      expect(Teamwork.respond_to?(:post_comment)).to eq(true)
+    end
+
+    it "returns 201 on success" do
+      expect(Teamwork.client.send(:post, "tasks/#{task}/comments.json", comment: comment_body).status).to eq(201)
+    end
+
+    it "returns the new comment" do
+      expect(Teamwork.post_comment("tasks", task, comment_body)).to be_a(Teamwork::Thing)
+    end
+
+  end
+
+  context "#update_comment" do
+
+    it "creates a comment" do
+      expect(Teamwork.respond_to?(:update_comment)).to eq(true)
+    end
+
+    it "returns 200 on success" do
+      expect(Teamwork.update_comment(comment_id, comment_body)).to eq(200)
+    end
+
+  end
+
+  context "#delete_comment" do
+
+    it "deletes a comment" do
+      expect(Teamwork.respond_to?(:delete_comment)).to eq(true)
+    end
+
+  end
+
+end

data/spec/teamwork/client/company_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Company do
+
+  before(:each) { authenticate }
+
+  context "#get_companies" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:get_companies)).to eq(true)
+    end
+
+    it "should get people" do
+      expect(Teamwork.get_companies).to be_a(Array)
+    end
+
+  end
+
+  context "#project_companies" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:project_companies)).to eq(true)
+    end
+
+    it "should get companies" do
+      expect(Teamwork.project_companies(Teamwork.projects.first.id)).to be_a(Array)
+    end
+
+  end
+
+end

data/spec/teamwork/client/file_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Teamwork::Client::File do
+
+  before(:each) { authenticate }
+
+  context "#get_file" do
+
+    let(:file_id) { ENV["FILE_ID"] }
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:get_file)).to eq(true)
+    end
+
+    it "should get files" do
+      expect(Teamwork.get_file(file_id)).to be_a(Teamwork::Thing)
+    end
+
+  end
+
+  context "#project_files" do
+
+    let(:project_id) { ENV["PROJECT_ID"] }
+    let(:files) { Teamwork.project_files(project_id) }
+
+    it "retrieves files" do
+      expect(files).to be_a(Array)
+    end
+
+    it "isn't empty" do
+      expect(files).to_not be_empty
+    end
+
+  end
+
+end

data/spec/teamwork/client/message_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Message do
+
+  before(:each) { authenticate }
+
+  context "#project_messages" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:project_messages)).to eq(true)
+    end
+
+    it "should get messages" do
+      expect(Teamwork.project_messages(Teamwork.projects.first.id)).to be_a(Array)
+    end
+
+  end
+
+  context "#get_message" do
+
+    let(:message_id) { ENV["MESSAGE_ID"] }
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:get_message)).to eq(true)
+    end
+
+    it "should get messages" do
+      expect(Teamwork.get_message(message_id)).to be_a(Teamwork::Thing)
+    end
+
+  end
+
+end

data/spec/teamwork/client/notebook_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Notebook do
+
+  before(:each) { authenticate }
+
+  context "#get_notebooks" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:get_notebooks)).to eq(true)
+    end
+
+    it "should get notebooks" do
+      expect(Teamwork.get_notebooks).to be_a(Array)
+    end
+
+  end
+
+end

data/spec/teamwork/client/people_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Teamwork::Client::People do
+
+  before(:each) { authenticate }
+
+  context "#get_people" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:get_people)).to eq(true)
+    end
+
+    it "should get people" do
+      expect(Teamwork.get_people).to be_a(Array)
+    end
+
+  end
+
+  context "#project_people" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:project_people)).to eq(true)
+    end
+
+    it "should get people" do
+      expect(Teamwork.project_people(Teamwork.projects.first.id)).to be_a(Array)
+    end
+
+  end
+
+end

data/spec/teamwork/client/project_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Project do
+
+  before(:each) { authenticate }
+
+  context "#project_activity" do
+
+    let(:project_id) { ENV["PROJECT_ID"] }
+    let(:activity) { Teamwork.project_activity(project_id) }
+
+    it "retrieves activity" do
+      expect(activity).to be_a(Array)
+    end
+
+    it "isn't empty" do
+      expect(activity).to_not be_empty
+    end
+
+  end
+
+  context "#project_timers" do
+
+    # This one is interesting as if timers have not been enabled for
+    # the project the API returns a 404 rather than an empty array.
+    # The difficulty here is that listing all the projects doesn't show whether
+    # the project has enabled a timer or not.  We will need to set something
+    # up with VCR here.
+    let(:project_id) { ENV["PROJECT_ID"] }
+    let(:timers) { Teamwork.project_timers(project_id) }
+
+    it "retrieves activity" do
+      expect(timers).to be_a(Array)
+    end
+
+  end
+
+end

data/spec/teamwork/client/task_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Task do
+
+  before(:each) { authenticate }
+
+  context "#all_tasks" do
+
+    it "should respond" do
+      expect(Teamwork.respond_to?(:all_tasks)).to eq(true)
+    end
+
+    it "should build an array" do
+      expect(Teamwork.all_tasks).to be_a(Array)
+    end
+
+  end
+
+end

data/spec/teamwork/client/timer_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe Teamwork::Client::Timer do
+
+  before(:each) { authenticate }
+
+  context "#time_entries" do
+
+    it "responds" do
+      expect(Teamwork.respond_to?(:time_entries)).to be true
+    end
+
+    it "Array" do
+      expect(Teamwork.time_entries).to be_a(Array)
+    end
+
+  end
+
+  context "#time_entry" do
+
+    it "fetches a single item" do
+      expect(Teamwork.time_entry(Teamwork.time_entries.first.id)).to be_a(Teamwork::Thing)
+    end
+
+  end
+
+end

data/spec/teamwork_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Teamwork do
+
+  it "returns a Teamwork::Client" do
+    expect(Teamwork.client).to be_kind_of Teamwork::Client
+  end
+
+  it "forwards methods to its client" do
+    expect(Teamwork.respond_to?(:authenticate)).to be true
+  end
+
+end

data/teamworkpm.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'teamwork/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "teamworkpm"
+  spec.version       = Teamwork::VERSION
+  spec.authors       = [" Brandon Hansen"]
+  spec.email         = ["bh@jesusculture.com"]
+  spec.description   = "A Ruby wrapper to the Teamwork PM API"
+  spec.summary       = "A Ruby wrapper to the Teamwork PM API"
+  spec.homepage      = "http://teamwork.com/"
+  spec.license       = "MIT"
+
+  spec.files = %w(LICENSE README.md Rakefile teamworkpm.gemspec)
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.files += Dir.glob("spec/**/*")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'faraday', "~> 0.8"
+  spec.add_dependency 'faraday_middleware'
+  spec.add_dependency 'htmlentities', "~> 4.3"
+  spec.add_dependency 'multi_json', '~> 1.8'
+  spec.add_dependency 'multipart-post'
+
+  spec.add_development_dependency 'dotenv', '~> 0.9', '>= 0.9.0'
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: teamworkpm
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- " Brandon Hansen"
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: htmlentities
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: multipart-post
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+description: A Ruby wrapper to the Teamwork PM API
+email:
+- bh@jesusculture.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/teamwork.rb
+- lib/teamwork/client.rb
+- lib/teamwork/client/account.rb
+- lib/teamwork/client/activity.rb
+- lib/teamwork/client/comment.rb
+- lib/teamwork/client/company.rb
+- lib/teamwork/client/file.rb
+- lib/teamwork/client/message.rb
+- lib/teamwork/client/notebook.rb
+- lib/teamwork/client/people.rb
+- lib/teamwork/client/project.rb
+- lib/teamwork/client/task.rb
+- lib/teamwork/client/thing.rb
+- lib/teamwork/client/timer.rb
+- lib/teamwork/version.rb
+- spec/spec_helper.rb
+- spec/support/helpers.rb
+- spec/teamwork/client/account_spec.rb
+- spec/teamwork/client/comment_spec.rb
+- spec/teamwork/client/company_spec.rb
+- spec/teamwork/client/file_spec.rb
+- spec/teamwork/client/message_spec.rb
+- spec/teamwork/client/notebook_spec.rb
+- spec/teamwork/client/people_spec.rb
+- spec/teamwork/client/project_spec.rb
+- spec/teamwork/client/task_spec.rb
+- spec/teamwork/client/timer_spec.rb
+- spec/teamwork_spec.rb
+- teamworkpm.gemspec
+homepage: http://teamwork.com/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A Ruby wrapper to the Teamwork PM API
+test_files:
+- spec/spec_helper.rb
+- spec/support/helpers.rb
+- spec/teamwork/client/account_spec.rb
+- spec/teamwork/client/comment_spec.rb
+- spec/teamwork/client/company_spec.rb
+- spec/teamwork/client/file_spec.rb
+- spec/teamwork/client/message_spec.rb
+- spec/teamwork/client/notebook_spec.rb
+- spec/teamwork/client/people_spec.rb
+- spec/teamwork/client/project_spec.rb
+- spec/teamwork/client/task_spec.rb
+- spec/teamwork/client/timer_spec.rb
+- spec/teamwork_spec.rb