bugsnag-api 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4f70dd5425512569c5778aa3a89d852326195967
+  data.tar.gz: 254567403bf2c32834d25a7b4c23696f33748467
+SHA512:
+  metadata.gz: 67c60e4aae21b293ad5b75b2cb60d26ba2774c43d512c49d3a140fd82b6f43d10de5739eec93ac7edceb481939bd86b1bdb80c92a952b5030f01e111ec6b1f29
+  data.tar.gz: 4b154b2bc908b61db969e19afc53a3f09f12a756d66292562d9d8a6a9fc9f2e7b60a0b1ac173404cb1d5099120dde7b41c5f0aadfa8641d771e247efefa4e357

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/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Bugsnag Inc.
+
+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,52 @@
+Bugsnag API Ruby Toolkit
+========================
+
+The library allows for quick read-write access to the [Bugsnag API](https://bugsnag.com/docs/api) from Ruby applications. Use this library if you want to build your own applications which leverage data found in your Bugsnag dashboard. If you are looking to automatically detect crashes in your Ruby apps, you should take a look at the [Bugsnag Ruby Detection Library](https://bugsnag.com/docs/notifiers/ruby) instead.
+
+This library shares code and philosophies with the fantastic [Octokit](https://github.com/octokit/octokit.rb) library.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem "bugsnag-api"
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bugsnag-api
+
+
+## Usage
+
+```ruby
+# Configure a Bugsnag API client
+Bugsnag::Api.configure do |config|
+  config.api_token = "your-account-api-token"
+end
+
+# Fetch information about the authenticated account
+account = Bugsnag::Api.account
+
+# Get a list of users on this account
+users = Bugsnag::Api.users(account.id)
+
+# Get a list of the projects on this account
+projects = Bugsnag::Api.projects(account.id)
+
+# Get a list of errors on a project
+errors = Bugsnag::Api.errors(projects.first.id)
+```
+
+
+## Contributing
+
+1. Fork it
+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/bugsnag-api.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bugsnag/api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bugsnag-api"
+  spec.version       = Bugsnag::Api::VERSION
+  spec.authors       = ["James Smith"]
+  spec.email         = ["james@bugsnag.com"]
+  spec.description   = %q{Bugsnag API toolkit for ruby}
+  spec.summary       = %q{Bugsnag API toolkit for ruby}
+  spec.homepage      = "https://github.com/bugsnag/bugsnag-api-ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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 "sawyer", '~> 0.5.3'
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/bugsnag/api.rb

@@ -0,0 +1,29 @@
+require "bugsnag/api/client"
+require "bugsnag/api/configuration"
+require "bugsnag/api/error"
+require "bugsnag/api/version"
+
+module Bugsnag
+  module Api
+    class << self
+      def configure
+        yield(configuration) if block_given?
+      end
+
+      def configuration
+        @configuration ||= Bugsnag::Api::Configuration.new
+      end
+
+      def client
+        @client ||= Bugsnag::Api::Client.new(configuration)
+      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
+end

data/lib/bugsnag/api/client.rb

@@ -0,0 +1,200 @@
+require "sawyer"
+
+require "bugsnag/api/client/accounts"
+require "bugsnag/api/client/comments"
+require "bugsnag/api/client/errors"
+require "bugsnag/api/client/events"
+require "bugsnag/api/client/projects"
+require "bugsnag/api/client/users"
+
+module Bugsnag
+  module Api
+
+    # Client for the Bugsnag API
+    #
+    # @see https://bugsnag.com/docs/api
+    class Client
+      include Bugsnag::Api::Client::Accounts
+      include Bugsnag::Api::Client::Comments
+      include Bugsnag::Api::Client::Errors
+      include Bugsnag::Api::Client::Events
+      include Bugsnag::Api::Client::Projects
+      include Bugsnag::Api::Client::Users
+
+      # Header keys that can be passed in options hash to {#get},{#head}
+      CONVENIENCE_HEADERS = Set.new([:accept, :content_type])
+
+      def initialize(options = {})
+        if options.is_a?(Bugsnag::Api::Configuration)
+          @configuration = options
+        else
+          configuration.load(options)
+        end
+      end
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      # Make a HTTP GET request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Query and header params for request
+      # @return [Sawyer::Resource]
+      def get(url, options = {})
+        request :get, url, parse_query_and_convenience_headers(options)
+      end
+
+      # Make a HTTP POST request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Body and header params for request
+      # @return [Sawyer::Resource]
+      def post(url, options = {})
+        request :post, url, options
+      end
+
+      # Make a HTTP PUT request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Body and header params for request
+      # @return [Sawyer::Resource]
+      def put(url, options = {})
+        request :put, url, options
+      end
+
+      # Make a HTTP PATCH request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Body and header params for request
+      # @return [Sawyer::Resource]
+      def patch(url, options = {})
+        request :patch, url, options
+      end
+
+      # Make a HTTP DELETE request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Query and header params for request
+      # @return [Sawyer::Resource]
+      def delete(url, options = {})
+        request :delete, url, options
+      end
+
+      # Make a HTTP HEAD request
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Query and header params for request
+      # @return [Sawyer::Resource]
+      def head(url, options = {})
+        request :head, url, parse_query_and_convenience_headers(options)
+      end
+
+      # Make one or more HTTP GET requests, optionally fetching
+      # the next page of results from URL in Link response header based
+      # on value in {#auto_paginate}.
+      #
+      # @param url [String] The path, relative to {#endpoint}
+      # @param options [Hash] Query and header params for request
+      # @param block [Block] Block to perform the data concatination of the
+      #   multiple requests. The block is called with two parameters, the first
+      #   contains the contents of the requests so far and the second parameter
+      #   contains the latest response.
+      # @return [Sawyer::Resource]
+      def paginate(url, options = {}, &block)
+        opts = parse_query_and_convenience_headers(options.dup)
+        if configuration.auto_paginate || configuration.per_page
+          opts[:query][:per_page] ||=  configuration.per_page || (configuration.auto_paginate ? 100 : nil)
+        end
+
+        data = request(:get, url, opts)
+
+        if configuration.auto_paginate
+          while @last_response.rels[:next]
+            @last_response = @last_response.rels[:next].get
+            if block_given?
+              yield(data, @last_response)
+            else
+              data.concat(@last_response.data) if @last_response.data.is_a?(Array)
+            end
+          end
+        end
+
+        data
+      end
+
+      # Hypermedia agent for the Bugsnag API
+      #
+      # @return [Sawyer::Agent]
+      def agent
+        @agent ||= Sawyer::Agent.new(configuration.endpoint, sawyer_options) do |http|
+          http.headers[:content_type] = "application/json"
+          http.headers[:user_agent] = configuration.user_agent
+
+          if basic_authenticated?
+            http.basic_auth configuration.email, configuration.password
+          elsif token_authenticated?
+            http.authorization "token", configuration.api_token
+          end
+        end
+      end
+
+      # Response for last HTTP request
+      #
+      # @return [Sawyer::Response]
+      def last_response
+        @last_response if defined? @last_response
+      end
+
+      def basic_authenticated?
+        !!(configuration.email && configuration.password)
+      end
+
+      def token_authenticated?
+        !!configuration.api_token
+      end
+
+
+      private
+      def request(method, path, data, options = {})
+        if data.is_a?(Hash)
+          options[:query]   = data.delete(:query) || {}
+          options[:headers] = data.delete(:headers) || {}
+          if accept = data.delete(:accept)
+            options[:headers][:accept] = accept
+          end
+        end
+
+        @last_response = response = agent.call(method, URI::Parser.new.escape(path.to_s), data, options)
+        response.data
+      end
+
+      def sawyer_options
+        opts = {
+          :links_parser => Sawyer::LinkParsers::Simple.new
+        }
+        conn_opts = configuration.connection_options
+        conn_opts[:builder] = configuration.middleware if configuration.middleware
+        conn_opts[:proxy] = configuration.proxy if configuration.proxy
+        opts[:faraday] = Faraday.new(conn_opts)
+
+        opts
+      end
+
+      def parse_query_and_convenience_headers(options)
+        headers = options.fetch(:headers, {})
+        CONVENIENCE_HEADERS.each do |h|
+          if header = options.delete(h)
+            headers[h] = header
+          end
+        end
+        query = options.delete(:query)
+        opts = {:query => options}
+        opts[:query].merge!(query) if query && query.is_a?(Hash)
+        opts[:headers] = headers unless headers.empty?
+
+        opts
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/accounts.rb

@@ -0,0 +1,37 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Accounts API
+      #
+      # @see https://bugsnag.com/docs/api/accounts
+      module Accounts
+        # List your accounts
+        #
+        # @return [Array<Sawyer::Resource>] List of users
+        # @see https://bugsnag.com/docs/api/accounts#list-your-accounts
+        # @example
+        #   Bugsnag::Api.accounts
+        def accounts(options = {})
+          paginate "accounts", options
+        end
+
+        # Get a single account
+        #
+        # @param account [String] Bugsnag account id
+        # @return [Sawyer::Resource]
+        # @see https://bugsnag.com/docs/api/accounts#get-the-authenticated-account
+        # @see https://bugsnag.com/docs/api/accounts#get-account-details
+        # @example
+        #   Bugsnag::Api.account("515fb9337c1074f6fd000009")
+        def account(account=nil, options = {})
+          if account.nil?
+            get "account", options
+          else
+            get "accounts/#{account}", options
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/comments.rb

@@ -0,0 +1,64 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Comments API
+      #
+      # @see https://bugsnag.com/docs/api/comments
+      module Comments
+        # List an error's comments
+        #
+        # @param error [String] Bugsnag error for which to list comments
+        # @return [Array<Sawyer::Resource>] List of comments
+        # @see https://bugsnag.com/docs/api/comments#list-an-error-s-comments
+        # @example
+        #   Bugsnag::Api.comments("515fb9337c1074f6fd000009")
+        def comments(error, options = {})
+          paginate "errors/#{error}/comments", options
+        end
+
+        # Get a single comment
+        #
+        # @param comment [String] A Bugsnag comment ID
+        # @return [Sawyer::Resource] The comment you requested, if it exists
+        # @see https://bugsnag.com/docs/api/comments#get-comment-details
+        # @example
+        #   Bugsnag::Api.comment("50baed119bf39c1431000004")
+        def comment(comment, options = {})
+          get "comments/#{comment}", options
+        end
+
+        # Create a comment
+        #
+        # @param error [String] The Bugsnag error to create the comment on
+        # @option message [String] The comment's message
+        # @see https://bugsnag.com/docs/api/comments#create-a-comment
+        # @example
+        #   Bugsnag::Api.create_comment("515fb9337c1074f6fd000009", message: "Oops!")
+        def create_comment(error, message, options = {})
+          post "errors/#{error}/comments", options.merge({:message => message})
+        end
+
+        # Update a comment
+        #
+        # @param error [String] The Bugsnag comment to update
+        # @return [Sawyer::Resource] The updated comment
+        # @see https://bugsnag.com/docs/api/comments#update-a-comment
+        # @example
+        #   Bugsnag::Api.update_comment("50baed119bf39c1431000004", message: "Fixed!")
+        def update_comment(comment, message, options = {})
+          patch "comments/#{comment}", options.merge({:message => message})
+        end
+
+        # Delete a comment
+        #
+        # @param comment [String] The Bugsnag comment to delete
+        # @return [Boolean] `true` if comment was deleted
+        # @see https://bugsnag.com/docs/api/comments#delete-a-comment
+        def delete_comment(comment, options = {})
+          delete "comments/#{comment}", options
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/errors.rb

@@ -0,0 +1,75 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Errors API
+      #
+      # @see https://bugsnag.com/docs/api/errors
+      module Errors
+        # List a project's errors
+        #
+        # @param project [String] Bugsnag project for which to list errors
+        # @return [Array<Sawyer::Resource>] List of errors
+        # @see https://bugsnag.com/docs/api/errors#list-a-project-s-errors
+        # @example
+        #   Bugsnag::Api.errors("50baed119bf39c1431000004")
+        def errors(project, options = {})
+          paginate "projects/#{project}/errors", options
+        end
+
+        # Get a single error
+        #
+        # @param error [String] A Bugsnag error
+        # @return [Sawyer::Resource] The error you requested, if it exists
+        # @see https://bugsnag.com/docs/api/errors#get-error-details
+        # @example
+        #   Bugsnag::Api.error("518031bcd775355c48a1cd4e")
+        def error(error, options = {})
+          get "errors/#{error}", options
+        end
+
+        # Resolve an error
+        #
+        # @param error [String] A Bugsnag error
+        # @return [Sawyer::Resource] The updated error
+        # @see https://bugsnag.com/docs/api/errors#update-an-error-s-status
+        # @example
+        #   Bugsnag::Api.resolve_error("518031bcd775355c48a1cd4e")
+        def resolve_error(error, options = {})
+          patch "errors/#{error}", options.merge({:resolved => true})
+        end
+
+        # Re-open an error
+        #
+        # @param error [String] A Bugsnag error
+        # @return [Sawyer::Resource] The updated error
+        # @see https://bugsnag.com/docs/api/errors#update-an-error-s-status
+        # @example
+        #   Bugsnag::Api.reopen_error("518031bcd775355c48a1cd4e")
+        def reopen_error(error, options = {})
+          patch "errors/#{error}", options.merge({:resolved => false})
+        end
+
+        # Update an error
+        #
+        # @param error [String] A Bugsnag error
+        # @return [Sawyer::Resource] The updated error
+        # @see https://bugsnag.com/docs/api/errors#update-an-error-s-status
+        # @example
+        #   Bugsnag::Api.update_error("518031bcd775355c48a1cd4e")
+        def update_error(error, options = {})
+          patch "errors/#{error}", options
+        end
+
+        # Delete an error
+        #
+        # @param error [String] A Bugsnag error
+        # @return [Boolean] `true` if error was deleted
+        # @see https://bugsnag.com/docs/api/errors#delete-an-error
+        def delete_error(error, options = {})
+          delete "errors/#{error}", options
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/events.rb

@@ -0,0 +1,54 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Events API
+      #
+      # @see https://bugsnag.com/docs/api/events
+      module Events
+        # List a project's events
+        #
+        # @param project [String] Bugsnag project for which to list events
+        # @return [Array<Sawyer::Resource>] List of events
+        # @see https://bugsnag.com/docs/api/events#list-a-project-s-events
+        # @example
+        #   Bugsnag::Api.events("50baed119bf39c1431000004")
+        def events(project, options = {})
+          paginate "projects/#{project}/events", options
+        end
+        alias :project_events :events
+
+        # List an error's events
+        #
+        # @param error [String] Bugsnag error for which to list events
+        # @return [Array<Sawyer::Resource>] List of events
+        # @see https://bugsnag.com/docs/api/events#list-an-error-s-events
+        # @example
+        #   Bugsnag::Api.error_events("518031bcd775355c48a1cd4e")
+        def error_events(error, options = {})
+          paginate "error/#{error}/events", options
+        end
+
+        # Get a single event
+        #
+        # @param event [String] A Bugsnag event id
+        # @return [Sawyer::Resource] The event you requested, if it exists
+        # @see https://bugsnag.com/docs/api/events#get-event-details
+        # @example
+        #   Bugsnag::Api.event("51f5d152f002c6686d013a22")
+        def event(error, options = {})
+          get "events/#{event}", options
+        end
+
+        # Delete an event
+        #
+        # @param event [String] A Bugsnag event
+        # @return [Boolean] `true` if event was deleted
+        # @see https://bugsnag.com/docs/api/events#delete-an-event
+        def delete_event(event, options = {})
+          delete "events/#{event}", options
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/projects.rb

@@ -0,0 +1,77 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Projects API
+      #
+      # @see https://bugsnag.com/docs/api/projects
+      module Projects
+        # List account projects
+        #
+        # @param account [String] Bugsnag account for which to list projects
+        # @return [Array<Sawyer::Resource>] List of projects
+        # @see https://bugsnag.com/docs/api/projects#list-an-account-s-projects
+        # @example
+        #   Bugsnag::Api.projects("515fb9337c1074f6fd000009")
+        def projects(account, options = {})
+          paginate "accounts/#{account}/projects", options
+        end
+        alias :account_projects :projects
+
+        # List user projects
+        #
+        # @param account [String] Bugsnag user for which to list projects
+        # @return [Array<Sawyer::Resource>] List of projects
+        # @see https://bugsnag.com/docs/api/projects#list-a-user-s-projects
+        # @example
+        #   Bugsnag::Api.user_projects("515fb9337c1074f6fd000007")
+        def user_projects(user, options = {})
+          paginate "user/#{user}/projects", options
+        end
+
+        # Get a single project
+        #
+        # @param project [String] A Bugsnag project
+        # @return [Sawyer::Resource] The project you requested, if it exists
+        # @see https://bugsnag.com/docs/api/projects#get-project-details
+        # @example
+        #   Bugsnag::Api.project("50baed119bf39c1431000004")
+        def project(project, options = {})
+          get "projects/#{project}", options
+        end
+
+        # Create a project
+        #
+        # @param account [String] The Bugsnag account to create project on
+        # @option name [String] The project's name
+        # @option type [String] The type of the project
+        # @see https://bugsnag.com/docs/api/projects#create-a-project
+        # @example
+        #   Bugsnag::Api.create_project("515fb9337c1074f6fd000009", name: "Website")
+        def create_project(account, options = {})
+          post "accounts/#{account}/projects", options
+        end
+
+        # Update a project
+        #
+        # @param project [String] A Bugsnag project
+        # @return [Sawyer::Resource] The updated project
+        # @see https://bugsnag.com/docs/api/projects#update-a-project
+        # @example
+        #   Bugsnag::Api.update_project("50baed119bf39c1431000004", name: "Dashboard")
+        def update_project(project, options = {})
+          patch "projects/#{project}", options
+        end
+
+        # Delete a project
+        #
+        # @param project [String] A Bugsnag project
+        # @return [Boolean] `true` if project was deleted
+        # @see https://bugsnag.com/docs/api/projects#delete-a-project
+        def delete_project(project, options = {})
+          delete "projects/#{project}", options
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/client/users.rb

@@ -0,0 +1,81 @@
+module Bugsnag
+  module Api
+    class Client
+
+      # Methods for the Users API
+      #
+      # @see https://bugsnag.com/docs/api/users
+      module Users
+        # List account users
+        #
+        # @param account [String] Bugsnag account for which to list users
+        # @return [Array<Sawyer::Resource>] List of users
+        # @see https://bugsnag.com/docs/api/users#list-an-account-s-users
+        def users(account, options = {})
+          paginate "accounts/#{account}/users", options
+        end
+        alias :account_users :users
+
+        # List project users
+        #
+        # @param account [String] Bugsnag account for which to list users
+        # @return [Array<Sawyer::Resource>] List of users
+        # @see https://bugsnag.com/docs/api/users#list-an-project-s-users
+        def project_users(project, options = {})
+          paginate "projects/#{project}/users", options
+        end
+
+        # Get a single user
+        #
+        # @param user [String] Bugsnag user id.
+        # @return [Sawyer::Resource]
+        # @see https://bugsnag.com/docs/api/users#get-the-authenticated-user
+        # @see https://bugsnag.com/docs/api/users#get-user-details
+        # @example
+        #   Bugsnag::Api.user("515fb9337c1074f6fd000007")
+        def user(user=nil, options = {})
+          if user.nil?
+            get "user", options
+          else
+            get "users/#{user}", options
+          end
+        end
+
+        # Invite a user to an account
+        #
+        # @param account [String] Bugsnag account to invite user to.
+        # @option email [String] The email address of the invitee
+        # @option admin [Boolean] Should the invitee be an account admin?
+        # @option project_ids [Array<String>] Array of accessible project ids
+        # @see https://bugsnag.com/docs/api/users#invite-a-user-to-an-account
+        # @example
+        #   Bugsnag::Api.invite_user("515fb9337c1074f6fd000009", "james@example.com")
+        def invite_user(account, email, options = {})
+          post "accounts/#{account}/users", options.merge({:email => email})
+        end
+
+        # Update a user's account permissions
+        #
+        # @param account [String] Bugsnag account to update pemissions for
+        # @param user {String} Bugsnag user to update permissions for
+        # @see https://bugsnag.com/docs/api/users#update-a-user-s-account-permissions
+        # @example
+        #   Bugsnag::Api.update_user_permissions("515fb9337c1074f6fd000009", "515fb9337c1074f6fd000007", admin: false)
+        def update_user_permissions(account, user, options = {})
+          patch "accounts/#{account}/users/#{user}", options
+        end
+
+        # Remove a user from an account
+        #
+        # @param account [String] Bugsnag account to remove user from
+        # @param user [String] Bugsnag user to remove
+        # @see https://bugsnag.com/docs/api/users#delete-a-user-from-an-account
+        # @example
+        #   Bugsnag::Api.remove_user("515fb9337c1074f6fd000009", "515fb9337c1074f6fd000007")
+        def remove_user(account, user, options = {})
+          delete "accounts/#{account}/users/#{user}", options
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/configuration.rb

@@ -0,0 +1,48 @@
+require "bugsnag/api/response/raise_error"
+
+module Bugsnag
+  module Api
+
+    # Configuration storage and defaults for {Client}
+    class Configuration
+
+      # Default API endpoint
+      DEFAULT_ENDPOINT = "https://api.bugsnag.com"
+
+      # Default User Agent header string
+      DEFAULT_USER_AGENT = "Bugsnag API Ruby Gem #{Bugsnag::Api::VERSION}"
+
+      # In Faraday 0.9, Faraday::Builder was renamed to Faraday::RackBuilder
+      RACK_BUILDER_CLASS = defined?(Faraday::RackBuilder) ? Faraday::RackBuilder : Faraday::Builder
+
+      # Default Faraday middleware stack
+      DEFAULT_MIDDLEWARE = RACK_BUILDER_CLASS.new do |builder|
+        builder.use Bugsnag::Api::Response::RaiseError
+        builder.adapter Faraday.default_adapter
+      end
+
+      # Configuration options
+      attr_accessor :email, :password, :api_token, :endpoint, :user_agent,
+                    :proxy, :middleware, :connection_options, :auto_paginate,
+                    :per_page
+
+      # Set up configuration defaults
+      def initialize
+        @endpoint = DEFAULT_ENDPOINT
+        @user_agent = DEFAULT_USER_AGENT
+        @middleware = DEFAULT_MIDDLEWARE
+        @auto_paginate = false
+        @connection_options = {
+          :headers => {
+            :user_agent => DEFAULT_USER_AGENT
+          }
+        }
+      end
+
+      # Load configuration from hash
+      def load(options = {})
+        options.each {|k,v| self.send("#{k}=", v) if self.respond_to?("#{k}=")}
+      end
+    end
+  end
+end

data/lib/bugsnag/api/error.rb

@@ -0,0 +1,121 @@
+module Bugsnag
+  module Api
+    # Custom error class for rescuing from all Bugsnag API errors
+    class Error < StandardError
+
+      # Returns the appropriate Bugnsag::Api::Error subclass based
+      # on status and response message
+      #
+      # @param [Hash] response HTTP response
+      # @return [Octokit::Error]
+      def self.from_response(response)
+        status  = response[:status].to_i
+        body    = response[:body].to_s
+        headers = response[:response_headers]
+
+        if klass =  case status
+                    when 400      then Bugsnag::Api::BadRequest
+                    when 401      then Bugsnag::Api::Unauthorized
+                    when 403      then Bugsnag::Api::Forbidden
+                    when 404      then Bugsnag::Api::NotFound
+                    when 405      then Bugsnag::Api::MethodNotAllowed
+                    when 406      then Bugsnag::Api::NotAcceptable
+                    when 409      then Bugsnag::Api::Conflict
+                    when 415      then Bugsnag::Api::UnsupportedMediaType
+                    when 422      then Bugsnag::Api::UnprocessableEntity
+                    when 400..499 then Bugsnag::Api::ClientError
+                    when 500      then Bugsnag::Api::InternalServerError
+                    when 501      then Bugsnag::Api::NotImplemented
+                    when 502      then Bugsnag::Api::BadGateway
+                    when 503      then Bugsnag::Api::ServiceUnavailable
+                    when 500..599 then Bugsnag::Api::ServerError
+                    end
+          klass.new(response)
+        end
+      end
+
+      def initialize(response=nil)
+        @response = response
+        super(response_error)
+      end
+
+      private
+
+      def data
+        @data ||=
+          if (body = @response[:body]) && !body.empty?
+            if body.is_a?(String) &&
+              @response[:response_headers] &&
+              @response[:response_headers][:content_type] =~ /json/
+
+              Sawyer::Agent.serializer.decode(body)
+            else
+              body
+            end
+          else
+            nil
+          end
+      end
+
+      def response_error
+        "Error: #{data[:error]}" if data.is_a?(Hash) && data[:error]
+      end
+    end
+
+    # Raised on errors in the 400-499 range
+    class ClientError < Error; end
+
+    # Raised when Bugsnag returns a 400 HTTP status code
+    class BadRequest < ClientError; end
+
+    # Raised when Bugsnag returns a 401 HTTP status code
+    class Unauthorized < ClientError; end
+
+    # Raised when Bugsnag returns a 403 HTTP status code
+    class Forbidden < ClientError; end
+
+    # Raised when Bugsnag returns a 404 HTTP status code
+    class NotFound < ClientError; end
+
+    # Raised when Bugsnag returns a 405 HTTP status code
+    class MethodNotAllowed < ClientError; end
+
+    # Raised when Bugsnag returns a 406 HTTP status code
+    class NotAcceptable < ClientError; end
+
+    # Raised when Bugsnag returns a 409 HTTP status code
+    class Conflict < ClientError; end
+
+    # Raised when Bugsnag returns a 414 HTTP status code
+    class UnsupportedMediaType < ClientError; end
+
+    # Raised when Bugsnag returns a 422 HTTP status code
+    class UnprocessableEntity < ClientError; end
+
+    # Raised on errors in the 500-599 range
+    class ServerError < Error; end
+
+    # Raised when Bugsnag returns a 500 HTTP status code
+    class InternalServerError < ServerError; end
+
+    # Raised when Bugsnag returns a 501 HTTP status code
+    class NotImplemented < ServerError; end
+
+    # Raised when Bugsnag returns a 502 HTTP status code
+    class BadGateway < ServerError; end
+
+    # Raised when Bugsnag returns a 503 HTTP status code
+    class ServiceUnavailable < ServerError; end
+
+    # Raised when client fails to provide valid Content-Type
+    class MissingContentType < ArgumentError; end
+
+    # Raised when a method requires account-level credentials
+    # but none were provided
+    class AccountCredentialsRequired < StandardError; end
+
+    # Raised when a method requires user-level credentials
+    # but none were provided
+    class UserCredentialsRequired < StandardError; end
+  end
+end

data/lib/bugsnag/api/response/raise_error.rb

@@ -0,0 +1,22 @@
+require "faraday"
+require "bugsnag/api/error"
+
+module Bugsnag
+  module Api
+    # Faraday response middleware
+    module Response
+
+      # This class raises an Bugsnag-flavored exception based
+      # HTTP status codes returned by the API
+      class RaiseError < Faraday::Response::Middleware
+
+        private
+        def on_complete(response)
+          if error = Bugsnag::Api::Error.from_response(response)
+            raise error
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bugsnag/api/version.rb

@@ -0,0 +1,5 @@
+module Bugsnag
+  module Api
+    VERSION = "1.0.0"
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: bugsnag-api
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- James Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sawyer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: Bugsnag API toolkit for ruby
+email:
+- james@bugsnag.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bugsnag-api.gemspec
+- lib/bugsnag/api.rb
+- lib/bugsnag/api/client.rb
+- lib/bugsnag/api/client/accounts.rb
+- lib/bugsnag/api/client/comments.rb
+- lib/bugsnag/api/client/errors.rb
+- lib/bugsnag/api/client/events.rb
+- lib/bugsnag/api/client/projects.rb
+- lib/bugsnag/api/client/users.rb
+- lib/bugsnag/api/configuration.rb
+- lib/bugsnag/api/error.rb
+- lib/bugsnag/api/response/raise_error.rb
+- lib/bugsnag/api/version.rb
+homepage: https://github.com/bugsnag/bugsnag-api-ruby
+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.14
+signing_key: 
+specification_version: 4
+summary: Bugsnag API toolkit for ruby
+test_files: []
+has_rdoc: