bugherd_client 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f346acfb08946d59c1dade9ed8a1b0833635873d
+  data.tar.gz: 6a6cb56ee578115522efb27db7faad2a67a00d0b
+SHA512:
+  metadata.gz: af84b3628df12bf6d67b4ea2abad7512e172264fd677bd01a0f352d9ca8ad9d78a4cbc231de28fc58fe93fbfc1ef06622f8f6cf0a0beee3a202fd739c0e2ea14
+  data.tar.gz: a84dfb06abc083abfc151daa822d604c85515a8e374a626fb429115feb3905862ca342825daeb04469bd34f50ab26755a4cf23d85d847dfdb08e6861739868b6

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bugherd_client.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 John Faucett
+
+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,49 @@
+# BugherdClient
+
+This is a Rest Client for the Bugherd API. It fully covers all methods of the v1 and v2 API Implementations.
+Another nifty feature is that its threadsafe so you could potentially have many instances floating around and don't
+have to worry about collisions as is the case with ActiveResource.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'bugherd_client'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bugherd_client
+
+## Basic Usage
+
+```ruby
+
+client = BugherdClient::Client.new(api_key: 'someapikey', api_version: 2) # api_version 2 is the default
+client.organization.get # => returns your organization information
+client.users.all # => returns a list of all users
+project = client.projects.find(1023)
+user = client.users.all.first
+
+client.tasks.create(project[:id], {
+  description: 'Some description',
+  requester_id: user[:id],
+  status: BugherdClient::Resources::Task::STATUS_BACKLOG,
+  priority: BugherdClient::Resources::Task::PRIORITY_NORMAL,
+  external_id: 'my-external-app-123'
+})
+
+
+
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/bugherd_client/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bugherd_client.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bugherd_client/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bugherd_client"
+  spec.version       = BugherdClient::VERSION::STRING
+  spec.authors       = ["John Faucett"]
+  spec.email         = ["jwaterfaucett@gmail.com"]
+  spec.summary       = %q{Ruby Client for the Bugherd API}
+  spec.description   = %q{Ruby Client for the Bugherd Rest API}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rest-client", "~> 1.6"
+  spec.add_dependency "activesupport", "> 3.0", "< 5.0"
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rspec", "~> 2.14"
+  spec.add_development_dependency "rake"
+end

data/lib/bugherd_client.rb

@@ -0,0 +1,30 @@
+require 'rest_client'
+require 'active_support'
+require 'active_support/core_ext'
+
+module BugherdClient
+  autoload :VERSION, "bugherd_client/version"
+  autoload :Client,  "bugherd_client/client"
+  autoload :Errors,  "bugherd_client/errors"
+  
+  module Resources
+    module V1
+      autoload :Base,           "bugherd_client/resources/v1/base"
+      autoload :Organization,   "bugherd_client/resources/v1/organization"
+      autoload :User,           "bugherd_client/resources/v1/user"
+      autoload :Project,        "bugherd_client/resources/v1/project"
+      autoload :Task,           "bugherd_client/resources/v1/task"
+      autoload :Comment,        "bugherd_client/resources/v1/comment"
+    end
+
+    module V2
+      autoload :Base,           "bugherd_client/resources/v2/base"
+      autoload :Organization,   "bugherd_client/resources/v2/organization"
+      autoload :User,           "bugherd_client/resources/v2/user"
+      autoload :Project,        "bugherd_client/resources/v2/project"
+      autoload :Task,           "bugherd_client/resources/v2/task"
+      autoload :Comment,        "bugherd_client/resources/v2/comment"
+    end
+  end
+
+end

data/lib/bugherd_client/client.rb

@@ -0,0 +1,75 @@
+require 'logger'
+
+module BugherdClient
+  class Client
+
+    VALID_API_VERSIONS = [1,2].freeze
+
+    DEFAULT_OPTIONS = {
+      base_url: 'https://www.bugherd.com',
+      api_version: 2,
+      username: '',
+      password: '',
+      api_key: '',
+      debug: false
+    }
+
+    attr_accessor :options, :connection
+
+    def initialize(options={}, &block)
+      @options = DEFAULT_OPTIONS.merge(options)
+      yield(self) if block_given?
+      establish_connection!
+    end
+
+    def establish_connection!
+      check_options!
+      username, password = build_credentials
+      
+      if @options[:debug]
+        RestClient.log = ::Logger.new($stderr)
+        RestClient.log.level = Logger::DEBUG
+      end
+
+      self.connection = RestClient::Resource.new(base_url, user: username, password: password)
+      
+    end
+    
+    def base_url
+      File.join(options[:base_url], "api_v#{options[:api_version]}")
+    end
+
+    def check_options!
+      if !@options[:api_key] && !(@options[:username] && @options[:password])
+        raise BugherdClient::Errors::InvalidOption, "api_key or username and password is required"
+      end
+      unless VALID_API_VERSIONS.include?(@options[:api_version])
+        raise BugherdClient::Errors::InvalidOption, "api_version must be #{VALID_API_VERSIONS.join(',')}"
+      end
+    end
+
+    def build_credentials
+      if @options[:api_key]
+        [@options[:api_key], 'x']
+      else
+        [@options[:username], @options[:password]]
+      end
+    end
+
+    def resource(name, opts={})
+      version = self.options[:api_version]
+      klass = Object.const_get("BugherdClient::Resources::V#{version}::#{name.to_s.classify}")
+      klass.new(self.connection, self.options)
+    end
+
+    # 
+    # Resources
+    # 
+    [:organization, :user, :project, :task, :comment].each do |resource_name|
+      define_method("#{resource_name.to_s.pluralize}") do
+        resource("#{resource_name}")
+      end
+    end
+
+  end
+end

data/lib/bugherd_client/errors.rb

@@ -0,0 +1,22 @@
+module BugherdClient
+  module Errors
+
+    class InvalidOption < StandardError
+      def initialize(msg="invalid option")
+        super(msg)
+      end
+    end
+
+    class UnsupportedMethod < StandardError
+      def initialize(api_version="")
+        super("Method supported in API version #{api_version}")
+      end
+    end
+
+    class UnsupportedAttribute < StandardError
+      def initialize(api_version="", attrs=[])
+        super("Attributes (#{attrs.join(',')}) supported in #{api_version}")
+      end
+    end
+  end
+end

data/lib/bugherd_client/resources/base.rb

@@ -0,0 +1,36 @@
+require 'json'
+
+module BugherdClient
+  module Resources
+    class Base
+
+      DEFAULT_HEADERS = { content_type: :json, accept: :json }
+
+      attr_accessor :connection, :options
+      def initialize(conn, opts={})
+        @connection, @options = conn, opts
+      end
+
+      def send_request(method="GET", path="", params={}, headers={})
+        headers = DEFAULT_HEADERS.merge(headers)
+        params.merge!(headers)
+        method_name = method.to_s.downcase
+        self.connection[path].__send__(method_name, params)
+      end
+
+      [:get, :post, :put, :patch, :delete].each do |method_name|
+        define_method("#{method_name}_request") do |path, params={}|
+          send_request(method_name, path, params)
+        end
+      end
+
+      def parse_response(response, root_element=nil)
+        if root_element
+          JSON.parse(response)[root_element.to_s]
+        else
+          JSON.parse(response)
+        end
+      end
+    end
+  end
+end

data/lib/bugherd_client/resources/comment.rb

@@ -0,0 +1,23 @@
+module BugherdClient
+  module Resources
+    class Comment < Base
+
+      #
+      # Get a paginated list of comments for a task.
+      #
+      def all(project_id, task_id)
+        raw_response = get_request("projects/#{project_id}/tasks/#{task_id}/comments")
+        parse_response(raw_response, :comments)
+      end
+
+      #
+      # Create a comment
+      # attributes: text, user_id or email
+      def create(project_id, task_id, attributes={})
+        raw_response = post_request("projects/#{project_id}/tasks/#{task_id}/comments", comment: attributes)
+        parse_response(raw_response)
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/organization.rb

@@ -0,0 +1,14 @@
+module BugherdClient
+  module Resources
+    class Organization < Base
+
+      #
+      # Get more detail of your account.
+      # 
+      def get
+        raw_response = self.connection['organization'].get
+        parse_response(raw_response, :organization)
+      end
+    end
+  end
+end

data/lib/bugherd_client/resources/project.rb

@@ -0,0 +1,76 @@
+module BugherdClient
+  module Resources
+    class Project < Base
+
+      #
+      # Get more detail of your account.
+      # 
+      def all
+        raw_response = get_request('projects')
+        parse_response(raw_response, :projects)
+      end
+
+      #
+      # Show details for a specific project
+      # 
+      def find(project_id)
+        raw_response = get_request("projects/#{project_id}")
+        parse_response(raw_response, :project)
+      end
+
+      #
+      # Create a Project, will initially have no members
+      # attributes: name, devurl, is_public, is_active
+      # 
+      def create(attributes={})
+        raw_response = post_request("projects", project: attributes)
+        parse_response(raw_response, :project)
+      end
+
+      #
+      # Update settings for an existing project under your control (ie: only the ones you own).
+      # API: 1,2
+      def update(project_id, attributes={})
+        raw_response = put_request("projects/#{project_id}", project: attributes)
+        parse_response(raw_response, :project)
+      end
+
+      # 
+      # Delete a project and all associated data. Use with care, deleted projects cannot be recovered.
+      # API: 1,2
+      def delete(project_id)
+        raw_response = delete_request("projects/#{project_id}")
+        parse_response(raw_response)
+      end
+
+      # 
+      # Add an existing guest to a project, or invite someone by email address.
+      # required: project_id
+      # attributes: user_id, email
+      # API: 2
+      def add_guest(project_id, attributes={})
+        raw_response = post_request("projects/#{project_id}/add_guest", attributes)
+        parse_response(raw_response)
+      end
+
+      # 
+      # Add an existing guest to a project, or invite someone by email address.
+      # required: project_id
+      # attributes: user_id
+      # 
+      def add_member(project_id, attributes={})
+        raw_response = post_request("projects/#{project_id}/add_member", attributes)
+        parse_response(raw_response)
+      end
+
+
+      #
+      # Get all active projects
+      # 
+      def active
+        raw_response = get_request('projects/active')
+        parse_response(raw_response, :projects)
+      end
+    end
+  end
+end

data/lib/bugherd_client/resources/task.rb

@@ -0,0 +1,56 @@
+module BugherdClient
+  module Resources
+    class Task < Base
+
+      PRIORITIES = ['not set', 'critical', 'important', 'normal','minor']
+      PRIORITIES.each do |priority|
+        Task.const_set("PRIORITY_#{priority.gsub(' ', '').upcase}", priority)
+      end
+
+      STATUSES   = ['backlog','todo','doing','done','closed']
+      STATUSES.each do |status|
+        Task.const_set("STATUS_#{status.upcase}", status)
+      end
+
+      #
+      # Get a full list of tasks for a project, including archived tasks.
+      # filters: updated_since, created_since, status, priority, tag and external_id
+      def all(project_id, filter_attributes={})
+        params = filter_attributes.empty? ? {} : { params: filter_attributes }
+        raw_response = get_request("projects/#{project_id}/tasks", params)
+        parse_response(raw_response, :tasks)
+      end
+
+      #
+      # List details of a task in a given project, includes all data including comments, attachments, etc.
+      #
+      def find(project_id, task_id)
+        raw_response = get_request("projects/#{project_id}/tasks/#{task_id}")
+        parse_response(raw_response)
+      end
+
+      #
+      # Create a new Task
+      # attributes: 
+      #   description, priority, status, tag_names(Array), 
+      #   requester_id or requester_email, 
+      #   assigned_to_id or assigned_to_email
+      #   external_id
+      # if status is null the Task is automatically put in the Feedback panel
+      # "requester_email" can be any email address while "assigned_to_email" needs to be of a current project member.
+      # Values for "priority" are not set, critical, important, normal, and minor.
+      # Values for "status" are backlog, todo, doing, done, and closed. Omit this field or set as "null" to send tasks to the Feedback panel.
+      # External ID is an API-only field. It cannot be set from the BugHerd application, only using the API. An external ID can be used to track originating IDs from other systems in BugHerd bugs.
+      def create(project_id, attributes={})
+        raw_response = post_request("projects/#{project_id}/tasks", task: attributes)
+        parse_response(raw_response)
+      end
+
+      def update(project_id, task_id, attributes={})
+        raw_response = put_request("projects/#{project_id}/tasks/#{task_id}", task: attributes)
+        parse_response(raw_response)
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/user.rb

@@ -0,0 +1,31 @@
+module BugherdClient
+  module Resources
+    class User < Base
+
+      #
+      # See all the people in your account.
+      # API: 1,2
+      def all
+        raw_response = get_request('users')
+        parse_response(raw_response, :users)
+      end
+
+      #
+      # See all your account members
+      #
+      def members
+        raw_response = get_request('users/members')
+        parse_response(raw_response, :users)
+      end
+
+      #
+      # See all the guest in your account
+      #
+      def guests
+        raw_response = get_request('users/guests')
+        parse_response(raw_response, :users)
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v1/base.rb

@@ -0,0 +1,47 @@
+require 'json'
+
+module BugherdClient
+  module Resources
+    module V1
+
+      class Base
+
+        DEFAULT_HEADERS = { content_type: :json, accept: :json }
+
+        #
+        # Return a list of available methods in a Resource
+        #
+        def api_methods
+          self.class.instance_methods(false)
+        end
+
+        attr_accessor :connection, :options
+        def initialize(conn, opts={})
+          @connection, @options = conn, opts
+        end
+
+        def send_request(method="GET", path="", params={}, headers={})
+          headers = DEFAULT_HEADERS.merge(headers)
+          params.merge!(headers)
+          method_name = method.to_s.downcase
+          self.connection[path].__send__(method_name, params)
+        end
+
+        [:get, :post, :put, :patch, :delete].each do |method_name|
+          define_method("#{method_name}_request") do |path, params={}|
+            send_request(method_name, path, params)
+          end
+        end
+
+        def parse_response(response, root_element=nil)
+          if root_element
+            JSON.parse(response)[root_element.to_s]
+          else
+            JSON.parse(response)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v1/comment.rb

@@ -0,0 +1,33 @@
+module BugherdClient
+  module Resources
+    module V1
+      class Comment < Base
+
+        #
+        # Get a paginated list of comments for a task.
+        #
+        def all(project_id, task_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}/comments")
+          parse_response(raw_response, :comments)
+        end
+
+        #
+        # Get a single comment of a Task
+        #
+        def find(project_id, task_id, comment_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}/comments/#{comment_id}")
+          parse_response(raw_response, :comment)
+        end
+
+        #
+        # Create a comment
+        # attributes: text, user_id or email
+        def create(project_id, task_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/tasks/#{task_id}/comments", comment: attributes)
+          parse_response(raw_response)
+        end
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v1/project.rb

@@ -0,0 +1,52 @@
+module BugherdClient
+  module Resources
+    module V1
+
+      class Project < Base
+
+        #
+        # Get more detail of your account.
+        #
+        def all
+          raw_response = get_request('projects')
+          parse_response(raw_response, :projects)
+        end
+
+        #
+        # Show details for a specific project
+        #
+        def find(project_id)
+          raw_response = get_request("projects/#{project_id}")
+          parse_response(raw_response, :project)
+        end
+
+        #
+        # Create a Project, will initially have no members
+        # attributes: name, devurl, is_public, is_active
+        #
+        def create(attributes={})
+          raw_response = post_request("projects", project: attributes)
+          parse_response(raw_response, :project)
+        end
+
+        #
+        # Update settings for an existing project under your control (ie: only the ones you own).
+        #
+        def update(project_id, attributes={})
+          raw_response = put_request("projects/#{project_id}", project: attributes)
+          parse_response(raw_response, :project)
+        end
+
+        # 
+        # Delete a project and all associated data. Use with care, deleted projects cannot be recovered.
+        #
+        def delete(project_id)
+          raw_response = delete_request("projects/#{project_id}")
+          parse_response(raw_response)
+        end
+
+      end
+      
+    end
+  end
+end

data/lib/bugherd_client/resources/v1/task.rb

@@ -0,0 +1,64 @@
+module BugherdClient
+  module Resources
+    module V1
+
+      class Task < Base
+
+        PRIORITIES = ['not set', 'critical', 'important', 'normal','minor']
+        PRIORITIES.each.with_index do |priority, index|
+          Task.const_set("PRIORITY_#{priority.gsub(' ', '').upcase}", index)
+        end
+
+        STATUSES   = ['feedback', 'backlog','todo','doing','done','closed']
+        STATUSES.each.with_index do |status, index|
+          if index == 0
+            Task.const_set("STATUS_#{status.upcase}", nil)  
+          else
+            Task.const_set("STATUS_#{status.upcase}", index-1)
+          end
+        end
+
+        #
+        # Get a full list of tasks for a project, including archived tasks.
+        # filters: updated_since, created_since, status, priority, tag and external_id
+        def all(project_id, filter_attributes={})
+          params = filter_attributes.empty? ? {} : { params: filter_attributes }
+          raw_response = get_request("projects/#{project_id}/tasks", params)
+          parse_response(raw_response, :tasks)
+        end
+
+        #
+        # List details of a task in a given project, includes all data including comments, attachments, etc.
+        #
+        def find(project_id, task_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}")
+          parse_response(raw_response)
+        end
+
+        #
+        # Create a new Task
+        # attributes: 
+        #   description, priority, status, tag_names(Array), 
+        #   requester_id or requester_email, 
+        #   assigned_to_id or assigned_to_email
+        #   external_id
+        # if status is null the Task is automatically put in the Feedback panel
+        # "requester_email" can be any email address while "assigned_to_email" needs to be of a current project member.
+        # Values for "priority" are not set, critical, important, normal, and minor.
+        # Values for "status" are backlog, todo, doing, done, and closed. Omit this field or set as "null" to send tasks to the Feedback panel.
+        # External ID is an API-only field. It cannot be set from the BugHerd application, only using the API. An external ID can be used to track originating IDs from other systems in BugHerd bugs.
+        def create(project_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/tasks", task: attributes)
+          parse_response(raw_response)
+        end
+
+        def update(project_id, task_id, attributes={})
+          raw_response = put_request("projects/#{project_id}/tasks/#{task_id}", task: attributes)
+          parse_response(raw_response)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v1/user.rb

@@ -0,0 +1,17 @@
+module BugherdClient
+  module Resources
+    module V1
+      class User < Base
+
+        #
+        # See all the people in your account.
+        #
+        def all
+          raw_response = get_request('users')
+          parse_response(raw_response, :users)
+        end
+
+      end
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/base.rb

@@ -0,0 +1,40 @@
+require 'json'
+
+module BugherdClient
+  module Resources
+    module V2
+
+      class Base
+
+        DEFAULT_HEADERS = { content_type: :json, accept: :json }
+
+        attr_accessor :connection, :options
+        def initialize(conn, opts={})
+          @connection, @options = conn, opts
+        end
+
+        def send_request(method="GET", path="", params={}, headers={})
+          headers = DEFAULT_HEADERS.merge(headers)
+          params.merge!(headers)
+          method_name = method.to_s.downcase
+          self.connection[path].__send__(method_name, params)
+        end
+
+        [:get, :post, :put, :patch, :delete].each do |method_name|
+          define_method("#{method_name}_request") do |path, params={}|
+            send_request(method_name, path, params)
+          end
+        end
+
+        def parse_response(response, root_element=nil)
+          if root_element
+            JSON.parse(response)[root_element.to_s]
+          else
+            JSON.parse(response)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/comment.rb

@@ -0,0 +1,34 @@
+module BugherdClient
+  module Resources
+    module V2
+      
+      class Comment < Base
+
+        #
+        # Get a paginated list of comments for a task.
+        #
+        def all(project_id, task_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}/comments")
+          parse_response(raw_response, :comments)
+        end
+
+        #
+        # Get a single comment of a Task
+        #
+        def find(project_id, task_id, comment_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}/comments/#{comment_id}")
+          parse_response(raw_response, :comment)
+        end
+
+        #
+        # Create a comment
+        # attributes: text, user_id or email
+        def create(project_id, task_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/tasks/#{task_id}/comments", comment: attributes)
+          parse_response(raw_response)
+        end
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/organization.rb

@@ -0,0 +1,18 @@
+module BugherdClient
+  module Resources
+    module V2
+      
+      class Organization < Base
+
+        #
+        # Get more detail of your account.
+        # 
+        def get
+          raw_response = self.connection['organization'].get
+          parse_response(raw_response, :organization)
+        end
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/project.rb

@@ -0,0 +1,80 @@
+module BugherdClient
+  module Resources
+    module V2
+
+      class Project < Base
+
+        #
+        # Get more detail of your account.
+        # 
+        def all
+          raw_response = get_request('projects')
+          parse_response(raw_response, :projects)
+        end
+
+        #
+        # Show details for a specific project
+        # 
+        def find(project_id)
+          raw_response = get_request("projects/#{project_id}")
+          parse_response(raw_response, :project)
+        end
+
+        #
+        # Create a Project, will initially have no members
+        # attributes: name, devurl, is_public, is_active
+        # 
+        def create(attributes={})
+          raw_response = post_request("projects", project: attributes)
+          parse_response(raw_response, :project)
+        end
+
+        #
+        # Update settings for an existing project under your control (ie: only the ones you own).
+        # API: 1,2
+        def update(project_id, attributes={})
+          raw_response = put_request("projects/#{project_id}", project: attributes)
+          parse_response(raw_response, :project)
+        end
+
+        # 
+        # Delete a project and all associated data. Use with care, deleted projects cannot be recovered.
+        # API: 1,2
+        def delete(project_id)
+          raw_response = delete_request("projects/#{project_id}")
+          parse_response(raw_response)
+        end
+
+        # 
+        # Add an existing guest to a project, or invite someone by email address.
+        # required: project_id
+        # attributes: user_id, email
+        # API: 2
+        def add_guest(project_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/add_guest", attributes)
+          parse_response(raw_response)
+        end
+
+        # 
+        # Add an existing guest to a project, or invite someone by email address.
+        # required: project_id
+        # attributes: user_id
+        # 
+        def add_member(project_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/add_member", attributes)
+          parse_response(raw_response)
+        end
+
+
+        #
+        # Get all active projects
+        # 
+        def active
+          raw_response = get_request('projects/active')
+          parse_response(raw_response, :projects)
+        end
+      end
+      
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/task.rb

@@ -0,0 +1,60 @@
+module BugherdClient
+  module Resources
+    module V2
+
+      class Task < Base
+
+        PRIORITIES = ['not set', 'critical', 'important', 'normal','minor']
+        PRIORITIES.each do |priority|
+          Task.const_set("PRIORITY_#{priority.gsub(' ', '').upcase}", priority)
+        end
+
+        STATUSES   = ['backlog','todo','doing','done','closed']
+        STATUSES.each do |status|
+          Task.const_set("STATUS_#{status.upcase}", status)
+        end
+
+        #
+        # Get a full list of tasks for a project, including archived tasks.
+        # filters: updated_since, created_since, status, priority, tag and external_id
+        def all(project_id, filter_attributes={})
+          params = filter_attributes.empty? ? {} : { params: filter_attributes }
+          raw_response = get_request("projects/#{project_id}/tasks", params)
+          parse_response(raw_response, :tasks)
+        end
+
+        #
+        # List details of a task in a given project, includes all data including comments, attachments, etc.
+        #
+        def find(project_id, task_id)
+          raw_response = get_request("projects/#{project_id}/tasks/#{task_id}")
+          parse_response(raw_response)
+        end
+
+        #
+        # Create a new Task
+        # attributes: 
+        #   description, priority, status, tag_names(Array), 
+        #   requester_id or requester_email, 
+        #   assigned_to_id or assigned_to_email
+        #   external_id
+        # if status is null the Task is automatically put in the Feedback panel
+        # "requester_email" can be any email address while "assigned_to_email" needs to be of a current project member.
+        # Values for "priority" are not set, critical, important, normal, and minor.
+        # Values for "status" are backlog, todo, doing, done, and closed. Omit this field or set as "null" to send tasks to the Feedback panel.
+        # External ID is an API-only field. It cannot be set from the BugHerd application, only using the API. An external ID can be used to track originating IDs from other systems in BugHerd bugs.
+        def create(project_id, attributes={})
+          raw_response = post_request("projects/#{project_id}/tasks", task: attributes)
+          parse_response(raw_response)
+        end
+
+        def update(project_id, task_id, attributes={})
+          raw_response = put_request("projects/#{project_id}/tasks/#{task_id}", task: attributes)
+          parse_response(raw_response)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/bugherd_client/resources/v2/user.rb

@@ -0,0 +1,33 @@
+module BugherdClient
+  module Resources
+    module V2
+      class User < Base
+
+        #
+        # See all the people in your account.
+        #
+        def all
+          raw_response = get_request('users')
+          parse_response(raw_response, :users)
+        end
+
+        #
+        # See all your account members
+        #
+        def members
+          raw_response = get_request('users/members')
+          parse_response(raw_response, :users)
+        end
+
+        #
+        # See all the guest in your account
+        #
+        def guests
+          raw_response = get_request('users/guests')
+          parse_response(raw_response, :users)
+        end
+
+      end
+    end
+  end
+end

data/lib/bugherd_client/version.rb

@@ -0,0 +1,9 @@
+module BugherdClient
+  module VERSION
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 2
+
+    STRING = [MAJOR,MINOR,PATCH].join('.')
+  end
+end

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: bugherd_client
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- John Faucett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>'
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby Client for the Bugherd Rest API
+email:
+- jwaterfaucett@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bugherd_client.gemspec
+- lib/bugherd_client.rb
+- lib/bugherd_client/client.rb
+- lib/bugherd_client/errors.rb
+- lib/bugherd_client/resources/base.rb
+- lib/bugherd_client/resources/comment.rb
+- lib/bugherd_client/resources/organization.rb
+- lib/bugherd_client/resources/project.rb
+- lib/bugherd_client/resources/task.rb
+- lib/bugherd_client/resources/user.rb
+- lib/bugherd_client/resources/v1/base.rb
+- lib/bugherd_client/resources/v1/comment.rb
+- lib/bugherd_client/resources/v1/project.rb
+- lib/bugherd_client/resources/v1/task.rb
+- lib/bugherd_client/resources/v1/user.rb
+- lib/bugherd_client/resources/v2/base.rb
+- lib/bugherd_client/resources/v2/comment.rb
+- lib/bugherd_client/resources/v2/organization.rb
+- lib/bugherd_client/resources/v2/project.rb
+- lib/bugherd_client/resources/v2/task.rb
+- lib/bugherd_client/resources/v2/user.rb
+- lib/bugherd_client/version.rb
+homepage: ''
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Ruby Client for the Bugherd API
+test_files: []