travis-client 0.1.0 → 3.0.0

data/lib/travis/client/link.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+module Travis::Client
+  class Link
+    attr_reader :session, :href
+
+    def initialize(session, href, payload = {})
+      @session, @href, @payload = session, href, payload
+    end
+
+    def to_entity
+      fetch
+    end
+
+    def fetch
+      session.fetch(href)
+    end
+
+    def to_h
+      @payload.dup
+    end
+
+    def offset
+      @payload['offset']
+    end
+
+    def limit
+      @payload['limit']
+    end
+
+    def inspect
+      "#<%p:%p>" % [ self.class, href.omit(:scheme, :authority).to_s ]
+    end
+  end
+end

data/lib/travis/client/session.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+module Travis::Client
+  class Session
+    LINK_ATTRIBUTES = %w[@href offset limit]
+    private_constant :LINK_ATTRIBUTES
+
+    attr_reader :connection, :response_cache, :request_headers
+
+    def initialize(connection, access_token: nil, request_headers: {})
+      @connection                       = connection
+      @http_connections                 = {}
+      @response_cache                   = {}
+      @request_headers                  = connection.request_headers.merge(request_headers)
+      @request_headers['Authorization'] = "token #{access_token}" if access_token
+    end
+
+    def inspect
+      "#<#{Session}>"
+    end
+
+    def request(method, uri, params = {})
+      method         = method.to_s.upcase
+      options        = {}
+      options[:json] = params if params.any?
+      uri            = Addressable::URI.parse(uri) unless uri.is_a? Addressable::URI
+      response       = connection.notify(method, uri, params) { http_connection(uri).request(method, uri, options) }
+      payload        = JSON.load(response.body)
+      wrap(payload, uri)
+    end
+
+    def call(resource_type, action_name, variables = {})
+      action(resource_type, action_name).call(self, variables)
+    end
+
+    def error_types
+      # we currently don't allow/need to override error types
+      connection.error_types
+    end
+
+    def resource_types
+      return @resource_types if defined? @resource_types and @resource_types
+      connection.resource_types
+    end
+
+    def set_default_types
+      @resource_types ||= connection.resource_types.map { |k,v| [k,v.for_session(self)] }.to_h
+    end
+
+    def define_constants(container)
+      set_default_types
+      error_types.merge(resource_types).each do |key, factory|
+        constant = key.split('_').map(&:capitalize).join
+        container.const_set(constant, factory) unless container.const_defined?(constant, false)
+      end
+      container.extend connection.mixin
+      container
+    end
+
+    def fetch(link)
+      response_cache.fetch(link) { request('GET', link) }
+    end
+
+    private def session
+      self
+    end
+
+    private def http_connection(uri)
+      raise ArgumentError, 'request URI needs to be absolute' unless uri.absolute?
+      @http_connections[uri.authority] ||= connection.http_factory.persistent(uri.join('/')).headers(request_headers)
+    end
+
+    private def wrap(payload, uri)
+      case payload
+      when Array then payload.map { |e| wrap(e, uri) }
+      when Hash  then load(payload.map { |k,v| [k, wrap(v, uri)] }.to_h, uri)
+      else payload
+      end
+    end
+
+    private def load(payload, uri)
+      return payload unless payload['@type'] or payload['@href']
+
+      if payload['@type'] == 'error'
+        factory = error_types.fetch(payload['error_type']) { resource_types.fetch('error', Error) }
+        error   = factory.new(self, payload['error_message'] || factory.default_message)
+        error.merge! payload
+        raise error
+      end
+
+      if payload['@href']
+        href    = uri.join(payload['@href'])
+        return response_cache[href] || Link.new(self, href, payload) if payload.all? { |a, _| LINK_ATTRIBUTES.include?(a) }
+        current = response_cache[href]
+      end
+
+      current ||= resource_types.fetch(payload['@type'], Unknown).new(self, href)
+      current.merge! payload
+      response_cache[href] = current
+    end
+  end
+end

data/lib/travis/client/unknown.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+module Travis::Client
+  class Unknown < Entity
+  end
+end

data/lib/travis/client/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module Travis
+  module Client
+    VERSION = '3.0.0'
+  end
+end

data/readme.md

@@ -0,0 +1,187 @@
+# Travis CI API Client
+
+Ruby client for the [Travis CI API, version 3](https://developer.travis-ci.com/).
+
+## Installation
+
+You can install it as a RubyGem via:
+
+``` console
+$ gem install travis-client
+```
+
+Note that it does conflict with [travis.rb](https://github.com/travis-ci/travis.rb) at the moment, as both of them add a `travis/client` file. It is highly recommended to use [Bundler](http://bundler.io/) to avoid accidentally loading the wrong gem in your scripts.
+
+## Getting Started
+
+This library has two general ways to use it. An interface based on globals, that should feel quite natural to Ruby developers:
+
+``` ruby
+require 'travis/client'
+Travis.connect # call before interacting with anything else
+repository = Travis::Repository.find(slug: 'travis-ci/travis-web')
+```
+
+Or an approach based on sessions, which helps avoiding global state, and easily allows multiple connections in parallel with different credentials or even different Travis CI installations:
+
+``` ruby
+require 'travis/client'
+connection = Travis.new
+session    = connection.create_session
+repository = session.find_repository(slug: 'travis-ci/travis-web')
+```
+
+Objects returned by `Repository.find` and `find_repository` are identical. You can access the underlying session object used by `Travis::Repository.find` via `Travis.session`.
+
+Each session will have its own cache, and HTTP connections. Recreating connection objects (by either calling `Travis.connect` or `Travis.new`) frequently should be avoided, as it will rebuild internal factories based on the API auto-discovery.
+
+Both `Travis.new` and `Travis.connect` accept the following options:
+
+* **endpoint:** URI for the entry point to the Travis CI API, defaults to `https://api.travis-ci.org`. Set this to `https://api.travis-ci.com` for the Pro version of Travis CI, `https://travis.your-domain.com/api`  for Travis CI Enterprise (assuming your Enterprise web UI is reachable under `https://travis.your-domain.com`).
+* **request_headers:** Allows defining additional headers to be sent to Travis CI with every HTTP request. Can also be used to override headers, like `User-Agent`.
+* **access_token:** API access token to use for authentication.
+
+## Advanced Features
+
+### Authentication
+
+You'll need an API token to authenticate. The library currently does not offer a way to obtain such a token, the easiest way to obtain such a token is to visit the developer pages and hover over the token in a code example and copy the value. Please note that there are separate tokens for [travis-ci.org](https://developer.travis-ci.org/explore/user) and [travis-ci.com](https://developer.travis-ci.com/explore/user), and you will have to use the appropriate token depending on which API you interact with.
+
+Alternatively, you can use the [`token` command](https://github.com/travis-ci/travis.rb#token) from the CLI.
+
+``` ruby
+# connecting to travis-ci.org with a token stored in TRAVIS_TOKEN env var
+Travis.connect(access_token: ENV['TRAVIS_TOKEN'])
+
+# connecting to travis-ci.com with a token stored in TRAVIS_PRO_TOKEN env var
+Travis.connect(api_endpoint: 'https://api.travis-ci.com' access_token: ENV['TRAVIS_PRO_TOKEN'])
+```
+
+When using multiple sessions, the token may either be passed to the connection (in which case it will be used fo all sessions) or each session individually:
+
+``` ruby
+connection = Travis.new(access_token: ENV['TRAVIS_TOKEN'])
+puts connection.create_session.current_user.login
+
+
+# for a list of tokens, output which user is associated with it
+access_tokens = [ ... list of tokens ... ]
+connection    = Travis.new(api_endpoint: 'https://api.travis-ci.com')
+access_tokens.each do |token|
+  session     = connection.create_session(access_token: token)
+  puts session.current_user.login
+end
+```
+
+### Caching and Session Renewal
+
+Each session will have it's own cache. If you have long running processes and concerns about cache size or stale caches, then the easiest and cleanest way to deal with this is to discard session objects after a while and not hold on to any entities associated with it.
+
+In a web application (like Rails or Sinatra), it is recommended to use a new session per request, or per background job. This will also greatly decrease threading issues (see below).
+
+``` ruby
+require 'sinatra'
+require 'travis/client'
+
+# create connection once, but create one session per request
+connection = Travis.new(access_token: ENV['TRAVIS_TOKEN'])
+before { @travis = connection.create_session }
+
+get '/' do
+  "Hello, #{@travis.current_user.name}!"
+end
+```
+
+If you do have to clear a session's cache, you can do so via `session.response_cache.clear` or `Travis.clear_cache`. However, this is not recommended and any response objects that might still be referenced somewhere will probably end up with a mix of outdated and recent data.
+
+### Thread Safety
+
+Neither `Travis.connect` nor loading resources is currently thread-safe, with the notable exception of `Connection#create_session`. You still can (and should) use it in a threaded environment.
+
+To use with a threaded environment:
+
+* Initialize a new connection once, via `Travis.new`.
+* From this connection, create one session per thread via `#create_session`.
+
+Example that fetches repositories in parallel:
+
+``` ruby
+require 'travis/client'
+
+repositories = ['travis-ci/travis-web', 'travis-ci/travis-api', 'sinatra/sinatra']
+connection   = Travis.new
+threads      = repositories.map do |slug|
+  Thread.new { connection.create_session.find_repository(slug: slug) }
+end
+
+threads.each do |thread|
+  puts thread.value.name
+end
+```
+
+### Permission Checks
+
+You can check permissions on any entity object via the `permission?` method:
+
+``` ruby
+Travis::User.current.permission? :sync                    # => true
+Travis::Owner.find(login: 'svenfuchs').permission? :sync  # => false
+
+user = Travis::User.current
+user.sync if user.permission? :sync
+```
+
+You can find a full list of permission in the [developer documentation](https://developer.travis-ci.org/).
+
+### Eager Loading
+
+The following code will trigger two HTTP requests, one to fetch the repository, and one to fetch the last build on the default branch:
+
+``` ruby
+repository = Travis::Repository.find(slug: 'travis-ci/travis-api')
+puts repository.default_branch.last_build.state
+```
+
+You can reduce this to a single HTTP request by eager loading `branch.last_build`:
+
+``` ruby
+repository = Travis::Repository.find(slug: 'travis-ci/travis-api', include: 'branch.last_build')
+puts repository.default_branch.last_build.state
+```
+
+### Pagination
+
+Each object representing a collection is an Enumerable and will handle pagination in a transparent way:
+
+``` ruby
+# will automatically paginate if necessary
+repository.branches.map { |branch| branch.name }
+```
+
+Just like with missing attributes, the code will trigger any additional HTTP requests lazily, but only once, so exiting a loop over a collection prematurely (for instance, by using `break` or `return`) might reduce the number of HTTP requests.
+
+You can also use the `limit`, `offset` and `sort` parameters to fine-tune requests.
+
+### Request Hooks and Instrumentation
+
+You can add hooks that will trigger before or after any HTTP request:
+
+``` ruby
+Travis.before_request { |r| puts "** #{r.request_method} #{r.uri}"}
+Travis::Repository.find(slug: 'rails/rails')
+```
+
+You can use the `meta_data` hash to share data between hooks:
+
+``` ruby
+Travis.before_request do |request|
+  request.meta_data[:start] = Time.now
+end
+
+Travis.after_request do |request|
+  duration = Time.now - request.meta_data[:start]
+  puts "** #{request.request_method} #{request.uri} - #{request.response.status} - #{duration}s"
+end
+
+Travis::Repository.find(slug: 'rails/rails')
+```

data/script/generate

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require 'bundler/setup'
+require 'travis/client'
+require 'yaml'
+
+unless ARGV.first and File.exist? ARGV.first
+  $stderr.puts "Please specify path to attributes.yml (from data directory in developer repo)."
+  exit 1
+end
+
+info = YAML.load_file(ARGV.first)
+Travis.connect
+
+signature = Proc.new do |dev_info, method_name, method, klass|
+  docs     = dev_info['description']
+  docs   &&= docs.sub(/^(\w)/) { |s| s.upcase }.sub(/\w$/, '\0.')
+  docs   ||= "Wheather or not ##{method_name.to_s.sub(/\?$/, '')} returns a truthy value (anything but `nil` or `false`)." if method_name.to_s.end_with? '?'
+  args     = method.parameters.map { |mode, name| mode == :opt ? "#{name} = #{name == :params ? '{}' : 'nil'}" : name }.join(', ')
+  args     = "(#{args})" unless args.empty?
+
+  puts "#      # #{docs}" if docs
+  puts "#      def #{method_name}#{args}", "#        # This is a placeholder.", "#      end"
+end
+
+puts '# @!parse'
+
+Travis.session.resource_types.each_with_index do |(type, klass), klass_index|
+  puts "#  " if klass_index > 0
+  superclass = klass < Travis::Client::Collection ? Travis::Client::Collection : Travis::Client::Entity
+  puts "#    class #{klass} < #{superclass}"
+
+  (klass.methods - superclass.methods - [:session]).each do |method|
+    signature[info["#{type}.#{method}"] || {}, "self.#{method}", klass.method(method), klass]
+    puts "#  "
+  end
+
+  (klass.instance_methods - superclass.instance_methods).each_with_index do |method, method_index|
+    next if superclass == Travis::Client::Collection and method.to_s.sub(/\?$/, '') == type
+    puts "#  " if method_index > 0
+    signature[info["#{type}.#{method}"] || {}, method, klass.instance_method(method), klass]
+  end
+  puts "#    end"
+end

data/spec/http_responses/default/branches.http

@@ -0,0 +1,715 @@
+GET https://api.travis-ci.org/repo/409371/branches HTTP/1.1
+Accept: application/json
+Travis-API-Version: 3
+
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "@type": "branches",
+  "@href": "/repo/409371/branches",
+  "@representation": "standard",
+  "@pagination": {
+    "limit": 25,
+    "offset": 0,
+    "count": 22,
+    "is_first": true,
+    "is_last": true,
+    "next": null,
+    "prev": null,
+    "first": {
+      "@href": "/repo/409371/branches",
+      "offset": 0,
+      "limit": 25
+    },
+    "last": {
+      "@href": "/repo/409371/branches",
+      "offset": 0,
+      "limit": 25
+    }
+  },
+  "branches": [
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/master",
+      "@representation": "standard",
+      "name": "master",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": true,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/207350319",
+        "@representation": "minimal",
+        "id": 207350319,
+        "number": "826",
+        "state": "passed",
+        "duration": 523,
+        "event_type": "push",
+        "previous_state": "passed",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-03-03T13:03:34Z",
+        "finished_at": "2017-03-03T13:16:52Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/ag-bump-version",
+      "@representation": "standard",
+      "name": "ag-bump-version",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/207345748",
+        "@representation": "minimal",
+        "id": 207345748,
+        "number": "824",
+        "state": "passed",
+        "duration": 498,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-03-03T12:49:48Z",
+        "finished_at": "2017-03-03T12:56:13Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/ag-test-autologin",
+      "@representation": "standard",
+      "name": "ag-test-autologin",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/207337389",
+        "@representation": "minimal",
+        "id": 207337389,
+        "number": "821",
+        "state": "passed",
+        "duration": 531,
+        "event_type": "push",
+        "previous_state": "failed",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-03-03T12:09:38Z",
+        "finished_at": "2017-03-03T12:25:36Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/rkh-2fa-login",
+      "@representation": "standard",
+      "name": "rkh-2fa-login",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/178040816",
+        "@representation": "minimal",
+        "id": 178040816,
+        "number": "792",
+        "state": "passed",
+        "duration": 655,
+        "event_type": "push",
+        "previous_state": "errored",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-11-22T17:17:50Z",
+        "finished_at": "2016-11-22T18:01:23Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/cd-login",
+      "@representation": "standard",
+      "name": "cd-login",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/177697219",
+        "@representation": "minimal",
+        "id": 177697219,
+        "number": "786",
+        "state": "passed",
+        "duration": 562,
+        "event_type": "push",
+        "previous_state": "passed",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-11-21T16:11:41Z",
+        "finished_at": "2016-11-21T16:20:48Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/debug",
+      "@representation": "standard",
+      "name": "debug",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/102107694",
+        "@representation": "minimal",
+        "id": 102107694,
+        "number": "726",
+        "state": "passed",
+        "duration": 343,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-01-13T14:15:11Z",
+        "finished_at": "2016-01-13T14:17:48Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/db-fix-encrypt-repo-arg-detection",
+      "@representation": "standard",
+      "name": "db-fix-encrypt-repo-arg-detection",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/49090056",
+        "@representation": "minimal",
+        "id": 49090056,
+        "number": "666",
+        "state": "failed",
+        "duration": 349,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2015-02-01T15:54:33Z",
+        "finished_at": "2015-02-01T15:56:17Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/rkh-heroku-special-token",
+      "@representation": "standard",
+      "name": "rkh-heroku-special-token",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/37817833",
+        "@representation": "minimal",
+        "id": 37817833,
+        "number": "648",
+        "state": "passed",
+        "duration": 431,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2014-10-13T12:02:10Z",
+        "finished_at": "2014-10-13T12:05:19Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/ha-bug-deploy_problems",
+      "@representation": "standard",
+      "name": "ha-bug-deploy_problems",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": true,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/23672116",
+        "@representation": "minimal",
+        "id": 23672116,
+        "number": "497",
+        "state": "passed",
+        "duration": 1381,
+        "event_type": "push",
+        "previous_state": "errored",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2014-04-24T12:54:26Z",
+        "finished_at": "2014-04-24T13:00:37Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.8",
+      "@representation": "standard",
+      "name": "v1.8.8",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/207350503",
+        "@representation": "minimal",
+        "id": 207350503,
+        "number": "827",
+        "state": "passed",
+        "duration": 538,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-03-03T13:04:25Z",
+        "finished_at": "2017-03-03T13:19:38Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.6",
+      "@representation": "standard",
+      "name": "v1.8.6",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/195648126",
+        "@representation": "minimal",
+        "id": 195648126,
+        "number": "810",
+        "state": "passed",
+        "duration": 591,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-01-26T19:46:38Z",
+        "finished_at": "2017-01-26T22:59:01Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/fix_report",
+      "@representation": "standard",
+      "name": "fix_report",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/194281685",
+        "@representation": "minimal",
+        "id": 194281685,
+        "number": "804",
+        "state": "passed",
+        "duration": 479,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2017-01-22T20:25:57Z",
+        "finished_at": "2017-01-22T20:29:06Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.5",
+      "@representation": "standard",
+      "name": "v1.8.5",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/182323691",
+        "@representation": "minimal",
+        "id": 182323691,
+        "number": "795",
+        "state": "passed",
+        "duration": 651,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-12-08T16:14:19Z",
+        "finished_at": "2016-12-08T16:45:18Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.4",
+      "@representation": "standard",
+      "name": "v1.8.4",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/174556256",
+        "@representation": "minimal",
+        "id": 174556256,
+        "number": "780",
+        "state": "passed",
+        "duration": 489,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-11-09T17:45:45Z",
+        "finished_at": "2016-11-09T18:09:30Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.3",
+      "@representation": "standard",
+      "name": "v1.8.3",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/174531237",
+        "@representation": "minimal",
+        "id": 174531237,
+        "number": "778",
+        "state": "passed",
+        "duration": 508,
+        "event_type": "push",
+        "previous_state": "errored",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-11-09T16:13:15Z",
+        "finished_at": "2016-11-09T16:30:28Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/sec-incident-20161007",
+      "@representation": "standard",
+      "name": "sec-incident-20161007",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/166763571",
+        "@representation": "minimal",
+        "id": 166763571,
+        "number": "772",
+        "state": "passed",
+        "duration": 578,
+        "event_type": "push",
+        "previous_state": "errored",
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-10-11T14:10:26Z",
+        "finished_at": "2016-10-11T14:15:30Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.2",
+      "@representation": "standard",
+      "name": "v1.8.2",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/101827353",
+        "@representation": "minimal",
+        "id": 101827353,
+        "number": "725",
+        "state": "passed",
+        "duration": 282,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-01-12T12:56:48Z",
+        "finished_at": "2016-01-12T12:57:22Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.1",
+      "@representation": "standard",
+      "name": "v1.8.1",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/101827328",
+        "@representation": "minimal",
+        "id": 101827328,
+        "number": "723",
+        "state": "passed",
+        "duration": 284,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-01-12T12:54:23Z",
+        "finished_at": "2016-01-12T12:55:07Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/ha-feature-logger",
+      "@representation": "standard",
+      "name": "ha-feature-logger",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/101148156",
+        "@representation": "minimal",
+        "id": 101148156,
+        "number": "720",
+        "state": "passed",
+        "duration": 333,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2016-01-08T20:13:05Z",
+        "finished_at": "2016-01-08T20:13:57Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.8.0",
+      "@representation": "standard",
+      "name": "v1.8.0",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/71051560",
+        "@representation": "minimal",
+        "id": 71051560,
+        "number": "690",
+        "state": "passed",
+        "duration": 300,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2015-07-15T10:07:19Z",
+        "finished_at": "2015-07-15T10:09:45Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.7.7",
+      "@representation": "standard",
+      "name": "v1.7.7",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/64086905",
+        "@representation": "minimal",
+        "id": 64086905,
+        "number": "685",
+        "state": "passed",
+        "duration": 360,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2015-05-26T12:52:46Z",
+        "finished_at": "2015-05-26T12:54:55Z"
+      }
+    },
+    {
+      "@type": "branch",
+      "@href": "/repo/409371/branch/v1.7.6",
+      "@representation": "standard",
+      "name": "v1.7.6",
+      "repository": {
+        "@type": "repository",
+        "@href": "/repo/409371",
+        "@representation": "minimal",
+        "id": 409371,
+        "name": "travis.rb",
+        "slug": "travis-ci/travis.rb"
+      },
+      "default_branch": false,
+      "exists_on_github": false,
+      "last_build": {
+        "@type": "build",
+        "@href": "/build/57651617",
+        "@representation": "minimal",
+        "id": 57651617,
+        "number": "679",
+        "state": "passed",
+        "duration": 669,
+        "event_type": "push",
+        "previous_state": null,
+        "pull_request_title": null,
+        "pull_request_number": null,
+        "started_at": "2015-04-08T14:28:31Z",
+        "finished_at": "2015-04-08T14:34:03Z"
+      }
+    }
+  ]
+}