bugsnag-api 2.0.1 → 2.1.1

data/bugsnag-api.gemspec

@@ -18,13 +18,55 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "sawyer", '~> 0.8.1'
+  if RUBY_VERSION < "2.2.0"
+    spec.add_dependency "sawyer", '0.8.1'
+
+    spec.add_development_dependency "rake", "< 12.0.0"
+    spec.add_development_dependency "rubocop", "0.41.2"
+    spec.add_development_dependency "faker", "1.3.0"
+
+    # i18n is used by faker
+    spec.add_development_dependency "i18n", "< 1.0.0"
+
+    # crack is used by webmock
+    spec.add_development_dependency "crack", "< 0.4.5"
+  else
+    spec.add_dependency "sawyer", '~> 0.8.1'
+
+    spec.add_development_dependency "rake"
+    spec.add_development_dependency "rubocop", "~> 0.52.1"
+    spec.add_development_dependency "faker", "> 1.7.3"
+  end
+
+  if RUBY_VERSION < "2.0.0"
+    spec.add_development_dependency "webmock", "2.3.2"
+    spec.add_development_dependency "addressable", "2.3.6"
+
+    # hashdiff is used by webmock
+    spec.add_development_dependency "hashdiff", "< 0.3.8"
+
+    # parser is used by rubocop
+    spec.add_development_dependency "parser", "< 2.5.0"
+  else
+    spec.add_development_dependency "webmock", "> 2.3.2"
+    spec.add_development_dependency "addressable", "> 2.3.6"
+  end
+
+  if RUBY_VERSION < "2.0.0"
+    spec.add_development_dependency "json", "< 2.0.0"
+  elsif RUBY_VERSION < "2.3.0"
+    spec.add_development_dependency "json", "< 2.6.0"
+  else
+    spec.add_development_dependency "json"
+  end
+
+  # public_suffix is used by addressable & sawyer
+  if RUBY_VERSION < "2.0.0"
+    spec.add_development_dependency "public_suffix", "< 1.5.0"
+  elsif RUBY_VERSION < "2.1.0"
+    spec.add_development_dependency "public_suffix", "< 3.0.0"
+  end
 
-  spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "webmock", RUBY_VERSION <= '2.0.0' ? '2.3.2': '>2.3.2'
-  spec.add_development_dependency "addressable", RUBY_VERSION <= '2.0.0' ? '2.3.6': '>2.3.6'
-  spec.add_development_dependency "faker", RUBY_VERSION <= '2.0.0' ? '1.3.0' : '>1.7.3'
   spec.add_development_dependency "vcr", "~> 2.9"
-  spec.add_development_dependency "json"
 end

data/config/.gitignore

@@ -0,0 +1 @@
+global.yml

data/docker-compose.yml

@@ -0,0 +1,9 @@
+version: '3.6'
+services:
+
+  license_finder:
+    build:
+      dockerfile: dockerfiles/Dockerfile.audit
+      context: .
+    volumes:
+      - ./:/scan

data/dockerfiles/Dockerfile.audit

@@ -0,0 +1,5 @@
+FROM licensefinder/license_finder
+
+WORKDIR /scan
+
+CMD /scan/scripts/license_finder.sh

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

@@ -19,7 +19,7 @@ module Bugsnag
         # @argument project_id [String] ID of project to get collaborators from (conflicts with org_id)
         # @argument org_id [String] ID of organization to get collaborators from (conflicts with project_id)
         #
-        # @option per_page [Number] Amount of results per-page             
+        # @option per_page [Number] Amount of results per-page
         # @return [Array<Sawyer::Resource>] List of Collaborators
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/organizations/collaborators/list-collaborators
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/organizations/collaborators/list-collaborators-on-a-project
@@ -84,4 +84,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -44,7 +44,7 @@ module Bugsnag
 
         # Delete a Comment
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/comments/delete-a-comment
         def delete_comment(id, options = {})
           boolean_from_response :delete, "comments/#{id}", options

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

@@ -30,4 +30,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -8,6 +8,8 @@ module Bugsnag
       module Errors
         # List the Errors on a Project
         #
+        # @argument id [String] optional ID of error to retrieve
+        #
         # @option base [String] Only Error Events occuring before this time will be returned
         # @option sort [String] Which field to sort by, one of: last_seen, first_seen, users, events, unsorted
         # @option direction [String] Which direction to sort the result by, one of: asc, desc
@@ -15,16 +17,14 @@ module Bugsnag
         # @return [Array<Sawyer::Resource>] List of Project Errors
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/errors/list-the-errors-on-a-project
         def errors(project_id, id=nil, options = {})
-          paginate "projects/#{project_id}/errors", options
+          if id.nil?
+            paginate "projects/#{project_id}/errors", options
+          else
+            get "projects/#{project_id}/errors/#{id}", options
+          end
         end
 
-        # View an Error
-        #
-        # @return [Sawyer::Resource] Requested Error
-        # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/errors/view-an-error
-        def error(project_id, id, options = {})
-          get "projects/#{project_id}/errors/#{id}", options
-        end
+        alias error errors
 
         # Update an Error
         #
@@ -42,7 +42,9 @@ module Bugsnag
           when String
             patch "projects/#{project_id}/errors/#{ids}", options.merge({:operation => operation})
           when Array
-            patch "projects/#{project_id}/errors", options.merge({:operation => operation, :query => {:error_ids => ids.join(' ')}})
+            defaults = {:operation => operation, :query => {:error_ids => ids.join(' ')}}
+            merged_opts = deep_merge(defaults, options)
+            patch "projects/#{project_id}/errors", merged_opts
           else
             raise ArgumentError, "ids must be a String or an Array"
           end
@@ -53,7 +55,7 @@ module Bugsnag
         # @argument error_id [String] ID of error to delete (conflicts with project_id)
         # @argument project_id [String] Id of project to delete all errors from (conflicts with error_id)
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/errors/delete-an-error
         def delete_errors(project_id, error_id=nil, options = {})
           if !error_id.nil?
@@ -66,4 +68,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -38,7 +38,7 @@ module Bugsnag
 
         # Delete a custom Event Field
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/projects/event-fields/delete-a-custom-event-field
         def delete_event_field(project_id, display_id, options = {})
           boolean_from_resposne :delete, "project/#{project_id}/event_fields/#{display_id}", options
@@ -47,4 +47,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -16,7 +16,7 @@ module Bugsnag
 
         # Delete an Event
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/events/delete-an-event
         def delete_event(project_id, id, options = {})
           boolean_from_response :delete, "projects/#{project_id}/events/#{id}", options
@@ -57,4 +57,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -34,7 +34,7 @@ module Bugsnag
 
         # Delete an Organization
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/organizations/organizations/delete-an-organization
         def delete_organization(id, options = {})
           boolean_from_response :delete, "organizations/#{id}", options
@@ -43,4 +43,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -26,7 +26,7 @@ module Bugsnag
         #
         # @option filters [Object] An optional filter object, see http://docs.bugsnagapiv2.apiary.io/#introduction/filtering
         # @option sort [String] Sorting method
-        # @option base [String] Only Events occuring before this time will be used 
+        # @option base [String] Only Events occuring before this time will be used
         # @return [Array<Sawyer::Resource>] List of values for the Pivots requested
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/pivots/list-values-of-a-pivot-on-an-error
         def pivot_values(project_id, ef_display_id, error_id=nil, options = {})
@@ -40,4 +40,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -42,7 +42,7 @@ module Bugsnag
 
         # Regenerate a Project's notifier API key
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/projects/projects/regenerate-a-project's-notifier-api-key
         def regenerate_api_key(id, options = {})
           delete "projects/#{id}/api_key", options
@@ -50,7 +50,7 @@ module Bugsnag
 
         # Delete a Project
         #
-        # @return 
+        # @return
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/organizations/organizations/delete-an-organization
         def delete_project(id, options = {})
           boolean_from_response :delete, "projects/#{id}", options
@@ -59,4 +59,3 @@ module Bugsnag
     end
   end
 end
-  

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

@@ -0,0 +1,38 @@
+module Bugsnag
+  module Api
+    class Client
+      # Methods for the Releases API
+      module Releases
+        # List the Releases in a Project
+        #
+        # @option release_stage [String] Only Releases with this release stage will be returned
+        # @option base [String] Only Releases created before this time will be returned
+        # @option sort [String] How to sort the results, one of: timestamp, percent_of_sessions
+        # @option offset [Number] The pagination offset
+        # @option per_page [Number] The number of results to return per page
+        # @return [Array<Sawyer::Resource>] List of Events for the specified Error
+        # @see https://bugsnagapiv2.docs.apiary.io/#reference/projects/releases/list-releases-on-a-project
+        def releases(project_id, options = {})
+          get "projects/#{project_id}/releases", options
+        end
+
+        # View a single Release
+        #
+        # @see https://bugsnagapiv2.docs.apiary.io/#reference/projects/releases/view-a-release
+        def release(project_id, release_id, options = {})
+          get "projects/#{project_id}/releases/#{release_id}", options
+        end
+
+        # List the Releases in a Release Group
+        #
+        # @option per_page [Number] The number of results to return per page
+        # @option page_token [String] Value from the next relation in the Link response header to obtain the next page of results
+        # @return [Array<Sawyer::Resource>] List of Releases for the specified Release Group
+        # @see https://bugsnagapiv2.docs.apiary.io/#reference/projects/releases/list-releases-on-a-release-group
+        def releases_in_group(release_group_id, options = {})
+          get "release_groups/#{release_group_id}/releases", options
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Bugsnag
+  module Api
+    class Client
+      # Methods for the Stability API
+      module Stability
+        # View the stability trend for a project
+        #
+        # @return [Sawyer::Resource] Stability trend
+        # @see https://bugsnagapiv2.docs.apiary.io/#reference/projects/stability-trend/view-the-stability-trend-for-a-project
+        def stability_trend(id, options = {})
+          get "projects/#{id}/stability_trend", options
+        end
+      end
+    end
+  end
+end

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

@@ -12,10 +12,12 @@ module Bugsnag
         # @return [Array<Sawyer::Resource>] List of Trends as requested
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/trends/list-the-trends-for-an-error-(buckets)
         def trends_buckets(project_id, buckets_count, error_id=nil, options = {})
+          defaults = {:query => {:buckets_count => buckets_count}}
+          merged_opts = deep_merge(defaults, options)
           if !error_id.nil?
-            get "projects/#{project_id}/errors/#{error_id}/trend", options.merge({:query => {:buckets_count => buckets_count}})
+            get "projects/#{project_id}/errors/#{error_id}/trend", merged_opts
           else
-            get "projects/#{project_id}/trend", options.merge({:query => {:buckets_count => buckets_count}})
+            get "projects/#{project_id}/trend", merged_opts
           end
         end
 
@@ -25,14 +27,15 @@ module Bugsnag
         # @return [Array<Sawyer::Resource>] List of Trends as requested
         # @see http://docs.bugsnagapiv2.apiary.io/#reference/errors/trends/list-the-trends-for-an-error-(buckets)
         def trends_resolution(project_id, resolution, error_id=nil, options = {})
+          defaults = {:query => {:resolution => resolution}}
+          merged_opts = deep_merge(defaults, options)
           if !error_id.nil?
-            get "projects/#{project_id}/errors/#{error_id}/trend", options.merge({:query => {:resolution => resolution}})
+            get "projects/#{project_id}/errors/#{error_id}/trend", merged_opts
           else
-            get "projects/#{project_id}/trend", options.merge({:query => {:resolution => resolution}})
+            get "projects/#{project_id}/trend", merged_opts
           end
         end
       end
     end
   end
 end
-  

data/lib/bugsnag/api/client.rb

@@ -10,6 +10,10 @@ require "bugsnag/api/client/events"
 require "bugsnag/api/client/pivots"
 require "bugsnag/api/client/trends"
 require "bugsnag/api/client/comments"
+require "bugsnag/api/client/stability"
+require "bugsnag/api/client/releases"
+
+require "base64"
 
 module Bugsnag
   module Api
@@ -28,6 +32,8 @@ module Bugsnag
       include Bugsnag::Api::Client::Pivots
       include Bugsnag::Api::Client::Trends
       include Bugsnag::Api::Client::Comments
+      include Bugsnag::Api::Client::Stability
+      include Bugsnag::Api::Client::Releases
 
       # Header keys that can be passed in options hash to {#get},{#head}
       CONVENIENCE_HEADERS = Set.new([:accept, :content_type])
@@ -143,6 +149,18 @@ module Bugsnag
         !!configuration.auth_token
       end
 
+      # Merges hashes together cleanly, favouring RHS values
+      #
+      # @return [Hash]
+      def deep_merge(l_hash, r_hash)
+        l_hash.merge(r_hash) do |_key, l_val, r_val|
+          if l_val.is_a?(Hash) && r_val.is_a?(Hash)
+            deep_merge(l_val, r_val)
+          else
+            r_val
+          end
+        end
+      end
 
       private
       def agent
@@ -153,9 +171,11 @@ module Bugsnag
           http.headers[:user_agent] = configuration.user_agent
 
           if basic_authenticated?
-            http.basic_auth configuration.email, configuration.password
+            credentials = Base64.strict_encode64("#{configuration.email}:#{configuration.password}")
+
+            http.headers[:Authorization] = "Basic #{credentials}"
           elsif token_authenticated?
-            http.authorization "token", configuration.auth_token
+            http.headers[:Authorization] = "token #{configuration.auth_token}"
           end
         end
       end
@@ -173,7 +193,7 @@ module Bugsnag
           end
         end
 
-        @last_response = response = agent.call(method, URI.escape(path.to_s), data, options)
+        @last_response = response = agent.call(method, path.to_s, data, options)
         response.data
       end
 

data/lib/bugsnag/api/configuration.rb

@@ -45,7 +45,7 @@ module Bugsnag
 
       # Load configuration from hash
       def load(options = {})
-        options.each {|k,v| self.send("#{k}=", v) if self.respond_to?("#{k}=") && !v.nil?}
+        options.each { |k,v| self.send("#{k}=", v) if self.respond_to?("#{k}=") && !v.nil?}
       end
     end
   end

data/lib/bugsnag/api/error.rb

@@ -3,7 +3,7 @@ module Bugsnag
     # Custom error class for rescuing from all Bugsnag API errors
     class Error < StandardError
 
-      # Returns the appropriate Bugnsag::Api::Error subclass based
+      # Returns the appropriate Bugsnag::Api::Error subclass based
       # on status and response message
       #
       # @param [Hash] response HTTP response

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

@@ -9,8 +9,6 @@ module Bugsnag
       # 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

data/lib/bugsnag/api/version.rb

@@ -1,5 +1,5 @@
 module Bugsnag
   module Api
-    VERSION = "2.0.1"
+    VERSION = "2.1.1"
   end
 end

data/scripts/license_finder.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+curl https://raw.githubusercontent.com/bugsnag/license-audit/master/config/decision_files/global.yml -o config/global.yml
+bundle install
+license_finder --decisions-file=config/global.yml

data/spec/bugsnag/api/client/releases_spec.rb

@@ -0,0 +1,184 @@
+require "spec_helper"
+
+describe Bugsnag::Api::Client::Releases do
+  before do
+    @client = auth_token_client
+    @project_id = test_bugsnag_project_id
+    @release_id = test_bugsnag_release_id
+    @release_group_id = test_bugsnag_release_group_id
+
+    Bugsnag::Api.reset!
+  end
+
+  describe ".releases", :vcr do
+    it "gets as list of releases" do
+      releases = @client.releases(@project_id)
+
+      expect(releases).to be_an_instance_of(Array)
+
+      releases.map!(&:to_h)
+
+      expect(releases.first[:id]).to eq(@release_id)
+      expect(releases.first[:project_id]).to eq(@project_id)
+      expect(releases.first[:release_group_id]).to eq(@release_group_id)
+
+      expect(releases).to all have_key(:id)
+      expect(releases).to all have_key(:project_id)
+      expect(releases).to all have_key(:release_group_id)
+      expect(releases).to all have_key(:release_time)
+      expect(releases).to all have_key(:release_source)
+      expect(releases).to all have_key(:app_version)
+      expect(releases).to all have_key(:app_version_code)
+      expect(releases).to all have_key(:app_bundle_version)
+      expect(releases).to all have_key(:build_label)
+      expect(releases).to all have_key(:builder_name)
+      expect(releases).to all have_key(:build_tool)
+      expect(releases).to all have_key(:errors_introduced_count)
+      expect(releases).to all have_key(:errors_seen_count)
+      expect(releases).to all have_key(:sessions_count_in_last_24h)
+      expect(releases).to all have_key(:total_sessions_count)
+      expect(releases).to all have_key(:unhandled_sessions_count)
+      expect(releases).to all have_key(:accumulative_daily_users_seen)
+      expect(releases).to all have_key(:accumulative_daily_users_with_unhandled)
+      expect(releases).to all have_key(:metadata)
+      expect(releases).to all have_key(:release_stage)
+    end
+
+    it "accepts parameters" do
+      releases = @client.releases(
+        @project_id,
+        {
+          release_stage: 'development',
+          base: '2021-07-21T12:00:00Z',
+          sort: 'percent_of_sessions',
+          offset: 0,
+          per_page: 1
+        }
+      )
+
+      expect(releases).to be_an_instance_of(Array)
+
+      releases.map!(&:to_h)
+
+      expect(releases.first[:id]).to eq(@release_id)
+      expect(releases.first[:project_id]).to eq(@project_id)
+      expect(releases.first[:release_group_id]).to eq(@release_group_id)
+
+      expect(releases).to all have_key(:id)
+      expect(releases).to all have_key(:project_id)
+      expect(releases).to all have_key(:release_group_id)
+      expect(releases).to all have_key(:release_time)
+      expect(releases).to all have_key(:release_source)
+      expect(releases).to all have_key(:app_version)
+      expect(releases).to all have_key(:app_version_code)
+      expect(releases).to all have_key(:app_bundle_version)
+      expect(releases).to all have_key(:build_label)
+      expect(releases).to all have_key(:builder_name)
+      expect(releases).to all have_key(:build_tool)
+      expect(releases).to all have_key(:errors_introduced_count)
+      expect(releases).to all have_key(:errors_seen_count)
+      expect(releases).to all have_key(:sessions_count_in_last_24h)
+      expect(releases).to all have_key(:total_sessions_count)
+      expect(releases).to all have_key(:unhandled_sessions_count)
+      expect(releases).to all have_key(:accumulative_daily_users_seen)
+      expect(releases).to all have_key(:accumulative_daily_users_with_unhandled)
+      expect(releases).to all have_key(:metadata)
+      expect(releases).to all have_key(:release_stage)
+    end
+  end
+
+  describe ".release", :vcr do
+    it "gets a single release" do
+      release = @client.release(@project_id, @release_id)
+
+      expect(release.id).to eq(@release_id)
+      expect(release.project_id).to eq(@project_id)
+      expect(release.release_group_id).to eq(@release_group_id)
+      expect(release.release_time).not_to be_nil
+      expect(release.release_source).not_to be_nil
+      expect(release.app_version).not_to be_nil
+      expect(release.app_version_code).not_to be_nil
+      expect(release.app_bundle_version).not_to be_nil
+      expect(release.build_label).not_to be_nil
+      expect(release.builder_name).not_to be_nil
+      expect(release.build_tool).not_to be_nil
+      expect(release.errors_introduced_count).not_to be_nil
+      expect(release.errors_seen_count).not_to be_nil
+      expect(release.sessions_count_in_last_24h).not_to be_nil
+      expect(release.total_sessions_count).not_to be_nil
+      expect(release.unhandled_sessions_count).not_to be_nil
+      expect(release.accumulative_daily_users_seen).not_to be_nil
+      expect(release.accumulative_daily_users_with_unhandled).not_to be_nil
+      expect(release.metadata).not_to be_nil
+      expect(release.release_stage).not_to be_nil
+    end
+  end
+
+  describe ".release_groups", :vcr do
+    it "gets releases in a release group" do
+      releases = @client.releases_in_group(@release_group_id)
+
+      expect(releases).to be_an_instance_of(Array)
+
+      releases.map!(&:to_h)
+
+      expect(releases.first[:id]).to eq(@release_id)
+      expect(releases.first[:project_id]).to eq(@project_id)
+      expect(releases.first[:release_group_id]).to eq(@release_group_id)
+
+      expect(releases).to all have_key(:id)
+      expect(releases).to all have_key(:project_id)
+      expect(releases).to all have_key(:release_group_id)
+      expect(releases).to all have_key(:release_time)
+      expect(releases).to all have_key(:release_source)
+      expect(releases).to all have_key(:app_version)
+      expect(releases).to all have_key(:app_version_code)
+      expect(releases).to all have_key(:app_bundle_version)
+      expect(releases).to all have_key(:build_label)
+      expect(releases).to all have_key(:builder_name)
+      expect(releases).to all have_key(:build_tool)
+      expect(releases).to all have_key(:errors_introduced_count)
+      expect(releases).to all have_key(:errors_seen_count)
+      expect(releases).to all have_key(:sessions_count_in_last_24h)
+      expect(releases).to all have_key(:total_sessions_count)
+      expect(releases).to all have_key(:unhandled_sessions_count)
+      expect(releases).to all have_key(:accumulative_daily_users_seen)
+      expect(releases).to all have_key(:accumulative_daily_users_with_unhandled)
+      expect(releases).to all have_key(:metadata)
+      expect(releases).to all have_key(:release_stage)
+    end
+
+    it "accepts parameters" do
+      releases = @client.releases_in_group(@release_group_id, { per_page: 1 })
+
+      expect(releases).to be_an_instance_of(Array)
+
+      releases.map!(&:to_h)
+
+      expect(releases.first[:id]).to eq(@release_id)
+      expect(releases.first[:project_id]).to eq(@project_id)
+      expect(releases.first[:release_group_id]).to eq(@release_group_id)
+
+      expect(releases).to all have_key(:id)
+      expect(releases).to all have_key(:project_id)
+      expect(releases).to all have_key(:release_group_id)
+      expect(releases).to all have_key(:release_time)
+      expect(releases).to all have_key(:release_source)
+      expect(releases).to all have_key(:app_version)
+      expect(releases).to all have_key(:app_version_code)
+      expect(releases).to all have_key(:app_bundle_version)
+      expect(releases).to all have_key(:build_label)
+      expect(releases).to all have_key(:builder_name)
+      expect(releases).to all have_key(:build_tool)
+      expect(releases).to all have_key(:errors_introduced_count)
+      expect(releases).to all have_key(:errors_seen_count)
+      expect(releases).to all have_key(:sessions_count_in_last_24h)
+      expect(releases).to all have_key(:total_sessions_count)
+      expect(releases).to all have_key(:unhandled_sessions_count)
+      expect(releases).to all have_key(:accumulative_daily_users_seen)
+      expect(releases).to all have_key(:accumulative_daily_users_with_unhandled)
+      expect(releases).to all have_key(:metadata)
+      expect(releases).to all have_key(:release_stage)
+    end
+  end
+end

data/spec/bugsnag/api/client/stability_spec.rb

@@ -0,0 +1,32 @@
+require "spec_helper"
+
+describe Bugsnag::Api::Client::Stability do
+  before do
+    @client = auth_token_client
+    @project_id = test_bugsnag_project_id
+
+    Bugsnag::Api.reset!
+  end
+
+  describe ".stability_trend", :vcr do
+    it "gets the stability trend" do
+      stability_trend = @client.stability_trend(@project_id)
+
+      expect(stability_trend.project_id).to eq(@project_id)
+      expect(stability_trend.release_stage_name).not_to be_nil
+      expect(stability_trend.timeline_points).to be_an_instance_of(Array)
+
+      # convert each "Sawyer::Resource" to a hash so we can use the "have_key" matcher
+      timeline_points = stability_trend.timeline_points.map(&:to_h)
+
+      expect(timeline_points).to all have_key(:bucket_start)
+      expect(timeline_points).to all have_key(:bucket_end)
+      expect(timeline_points).to all have_key(:total_sessions_count)
+      expect(timeline_points).to all have_key(:unhandled_sessions_count)
+      expect(timeline_points).to all have_key(:users_seen)
+      expect(timeline_points).to all have_key(:users_with_unhandled)
+
+      assert_requested(:get, bugsnag_url("/projects/#{@project_id}/stability_trend"))
+    end
+  end
+end