bitrise-client 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba17bd32401a009fcfce53e1aea475ab478fcb3409facfe3f5ea60a1473b4703
-  data.tar.gz: e3cefe0df76ca123b9978ac4935cad2df085f78e421c801507b367facefc7f83
+  metadata.gz: bea45506fb22cbcf82ac88de924ee3bbd72fac3f9e8e541f8a3e58a7ff9efca2
+  data.tar.gz: a9ef13c2d000307505b1bf3b7060d0998eccee62828796a2455d1710ddbd4164
 SHA512:
-  metadata.gz: f9a93ee147c25b5fa3951691f262dd826dbc4c7bb8897ca581d654196dc563b0c8ff47544c489eb38acaa9fbfeed8f2a0cbd5e13947d6b225e9ff980b6a2a4cf
-  data.tar.gz: 9bbff68c08ae6ee968560a17be4f258c24b4946271274eed9439862472d72d37bb6013d7d90b848be1995d735994fddef98d739d61018558cb7b9413940b813b
+  metadata.gz: f2fe332714ef892a3047f047d24697315461a8a3917826edb37a53ed19d57d20764f5b934597e6a240f5f6c7ad0d848177cc7a23a6da66273efac18c06b54c06
+  data.tar.gz: 80cf9f62e6ffe79a0f0740276031a967e786946f0f3062bc509ec11270491eae9d79c2283ae4d254fd78f4ae03548f47e3612c5f4c2fed41f243bde4f70e88c4

data/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - "**"
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [head, 3.0, 2.7]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+    - name: Run tests
+      run: |
+        bundle exec rspec

data/.gitignore

@@ -11,3 +11,5 @@
 
 # rspec failure tracking
 .rspec_status
+
+.ruby-version

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+## v0.2.0
+
+Changed to use the [Bitrise v0.1 API](https://devcenter.bitrise.io/en/api.html), so you need to change to specify an access token to bitrise-client initialization. See: https://github.com/mataku/bitrise-client#usage
+
+- Support endpoint for triggering a build
+- Support aborting a build
+- Support listing registered test devices of all members of a specified Bitrise app
+
+## v0.1.0
+
+Released.
+
+- Support triggering a build

data/README.md

@@ -2,7 +2,7 @@
 
 A ruby client for [Bitrise API](https://devcenter.bitrise.io/#bitrise-api).
 
-Now supports [Build Trigger API](https://devcenter.bitrise.io/api/build-trigger/) only.
+Now supports v0.1 [Build Trigger API](https://devcenter.bitrise.io/api/build-trigger/) and [Test Devices](https://devcenter.bitrise.io/en/api/api-reference.html#operations-tag-test-devices) only.
 
 ## Installation
 
@@ -25,19 +25,52 @@ Or install it yourself as:
 ```ruby
 require 'bitrise'
 
-client = Bitrise::Client.new
-client.trigger_build(
-  app_slug = 'your_app_slug', # required
-  build_trigger_token = 'your_build_trigger_token', # required
+# Access token required to use bitrise v0.1 API. See: https://devcenter.bitrise.io/en/api/authenticating-with-the-bitrise-api.html
+client = Bitrise::Client.new(access_token: 'your access token')
+
+# Trigger a build
+result = client.trigger_build(
+  app_slug: 'your_app_slug', # Required
   build_params: {
-    # A tag, branch or workflow_id parameter required
+    # At least a tag, branch or workflow_id parameter required so that Bitrise can identify which workflow to run
     branch: 'branch',
     tag:    'tag',
     workflow_id: 'workflow_id'
   }
 )
+
+p result.build_url # => "https://app.bitrise.io/build/1234abcd5678efgh"
+
+# Abort a build
+client.abort_build(
+  # Required
+  app_slug: 'your_app_slug',
+  # Required
+  build_slug: 'build slug to abort',
+
+  # Optional
+  options: {
+    abort_reason: 'wanna relax', # You can set a reason
+    abort_with_success: true,    # Set true if you want to treat as a successful
+    skip_notifications: true     # Set true if you want to receive notification even if your notification setting in app is off
+  }
+)
+
+# List registered test devices of all members of a specified Bitrise app
+devices = client.test_devices(
+  # Required
+  app_slug: 'your_app_slug'
+)
+devices.each do |device|
+  p device.device_id
+  p device.device_type
+  p device.owner
+end
 ```
 
+## Changelog
+
+See [/CHANGELOG.md]
 
 ## License
 

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
 require "bundler/setup"
-require "bitrise/client"
+require "bitrise"
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.

data/bitrise-client.gemspec

@@ -35,7 +35,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency 'faraday', '~> 0.9'
+  spec.add_runtime_dependency 'faraday'
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "irb"

data/lib/bitrise/build_trigger_result.rb

@@ -0,0 +1,15 @@
+module Bitrise
+  class BuildTriggerResult
+    attr_accessor :build_number, :build_slug, :build_url, :message, :service, :slug, :status, :triggered_workflow
+    def initialize(attrs = {})
+      @build_number = attrs['build_number']
+      @build_slug = attrs['build_slug']
+      @build_url = attrs['build_url']
+      @message = attrs['message']
+      @service = attrs['service']
+      @slug = attrs['slug']
+      @status = attrs['status']
+      @triggered_workflow = attrs['triggered_workflow']
+    end
+  end
+end

data/lib/bitrise/client/build.rb

@@ -1,43 +1,58 @@
+require 'bitrise/build_trigger_result'
 require 'json'
 
 module Bitrise
   class Client
     module Build
-      
       # Trigger a build of your bitrise app
       #
       # @param app_slug [String] Your bitrise app slug
-      # @param build_trigger_token [String] Build Trigger token of your app
-      # 
-      # See: https://devcenter.bitrise.io/api/build-trigger/
-      def trigger_build(app_slug = nil, build_trigger_token = nil, options = {})
-        @app_slug = app_slug || raise('App slug required.')
-        @build_trigger_token = build_trigger_token || raise('Build trigger token required.')
+      # @param build_params [Hash] Bulld params so that Bitrise can identify which workflow to run. Specify a branch or tag or workflow_id at least.
+      #
+      # @return [Bitrise::BuildTriggerResult]
+      #
+      # See: https://devcenter.bitrise.io/en/api/triggering-and-aborting-builds.html#triggering-a-new-build-with-the-api
+      def trigger_build(app_slug: nil, build_params: {})
+        raise ArgumentError, 'App slug required. You must specify by \'app_slug:\'' unless app_slug
+        raise ArgumentError, 'No value found for \'branch\' or \'tag\' or \'workflow_id\'' if build_params.empty?
 
         response = client.post do |request|
-          request.url "/app/#{@app_slug}/build/start.json"
+          request.url "/v0.1/apps/#{app_slug}/builds"
           request.headers['Content-Type'] = 'application/json'
           request.body = {
             hook_info: {
-              type: 'bitrise',
-              build_trigger_token: @build_trigger_token
+              type: 'bitrise'
             },
-            build_params: options[:build_params]
+            build_params: build_params
           }.to_json
         end
 
-        check_http_status(response)
-
-        JSON.parse(response.body)
+        result = JSON.parse(response.body)
+        BuildTriggerResult.new(result)
       end
+    end
 
-      def check_http_status(response)
-        case response.status
-        when 200..299 then
-          return
-        else
-          raise JSON.parse(response.body)['message']
-        end
+    # Abort a build of your bitrise app
+    #
+    # @param app_slug [String] Your bitrise app slug
+    # @param build_slug [String] Bitrise build slug which you want to abort
+    #
+    # @param options [Hash]
+    # @option opts [String]  :abort_reason        A reason for aborting the build
+    # @option opts [Boolean] :abort_with_success  Treat as a successful or not
+    # @option opts [Boolean] :skip_notifications  Set true if you want to send email notifications about aborting by Bitrise
+    #
+    # @return [Bitrise::BuildTriggerResult]
+    #
+    # See: https://devcenter.bitrise.io/en/api/triggering-and-aborting-builds.html#aborting-a-build
+    def abort_build(app_slug: nil, build_slug: nil, options: {})
+      raise ArgumentError, 'App slug required. You must specify by \'app_slug:\'' unless app_slug
+      raise ArgumentError, 'Build slug required. You must specify by \'build_slug:\'' unless build_slug
+
+      client.post do |request|
+        request.url "/v0.1/apps/#{app_slug}/builds/#{build_slug}/abort"
+        request.headers['Content-Type'] = 'application/json'
+        request.body = options.to_json
       end
     end
   end

data/lib/bitrise/client/middleware/error_handler.rb

@@ -0,0 +1,20 @@
+require 'faraday'
+require 'bitrise/error'
+
+module Bitrise
+  class Client
+    module Middleware
+
+      class ErrorHandler < Faraday::Response::Middleware
+
+      # @param [Faraday::Response]
+        def on_complete(response)
+          case response.status
+          when 400..599
+            raise Bitrise::Error.new(JSON.parse(response.body)['message'])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bitrise/client/test_device.rb

@@ -0,0 +1,28 @@
+require 'bitrise/test_device'
+require 'json'
+
+
+module Bitrise
+  class Client
+    module TestDevice
+
+      # List registered test devices of all members of a specified Bitrise app
+      #
+      # @param app_slug [String] Your bitrise app slug
+      #
+      # @return [Array<Bitrise::TestDevice>
+      def test_devices(app_slug: nil)
+        raise ArgumentError, 'App slug required. You must specify by \'app_slug:\'' unless app_slug
+
+        response = client.get do |request|
+          request.url "/v0.1/apps/#{app_slug}/test-devices"
+          request.headers['Content-Type'] = 'application/json'
+        end
+
+        JSON.parse(response.body)['data'].map do |device|
+          Bitrise::TestDevice.new(device)
+        end
+      end
+    end
+  end
+end

data/lib/bitrise/client/version.rb

@@ -1,5 +1,5 @@
 module Bitrise
   class Client
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/bitrise/client.rb

@@ -1,14 +1,23 @@
-require 'bitrise/client/build'
-require 'faraday'
+%w(
+  bitrise/client/build
+  bitrise/client/test_device
+  bitrise/client/middleware/error_handler
+  faraday
+).each do |lib|
+  require lib
+end
 
 module Bitrise
   class Client
     include Bitrise::Client::Build
+    include Bitrise::Client::TestDevice
 
-    def initialize(options = {})
-      @api_host = options[:host] || 'https://app.bitrise.io'
+    def initialize(access_token: nil, options: {})
+      raise ArgumentError.new('You must specify Bitrise access token by `access_token:`.') unless access_token
+      @api_host = options[:host] || 'https://api.bitrise.io'
       @timeout = options[:timeout] || 30
       @open_timeout = options[:open_timeout] || 30
+      @access_token = access_token
     end
 
     def client
@@ -16,7 +25,9 @@ module Bitrise
         faraday.options.timeout        = @timeout
         faraday.options.open_timeout   = @open_timeout
         faraday.options.params_encoder = Faraday::FlatParamsEncoder
+        faraday.use Bitrise::Client::Middleware::ErrorHandler
         faraday.response :logger if ENV['DEBUG']
+        faraday.headers['Authorization'] = @access_token
 
         faraday.adapter Faraday.default_adapter
       end

data/lib/bitrise/error.rb

@@ -0,0 +1,5 @@
+module Bitrise
+  class Error < StandardError
+
+  end
+end

data/lib/bitrise/test_device.rb

@@ -0,0 +1,11 @@
+module Bitrise
+  class TestDevice
+    attr_accessor :device_id, :device_type, :owner
+
+    def initialize(attrs = {})
+      @device_id = attrs['device_id']
+      @device_type = attrs['device_type']
+      @owner = attrs['owner']
+    end
+  end
+end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: bitrise-client
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - mataku
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-01-27 00:00:00.000000000 Z
+date: 2021-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -87,9 +87,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/test.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -98,16 +99,21 @@ files:
 - bin/setup
 - bitrise-client.gemspec
 - lib/bitrise.rb
+- lib/bitrise/build_trigger_result.rb
 - lib/bitrise/client.rb
 - lib/bitrise/client/build.rb
+- lib/bitrise/client/middleware/error_handler.rb
+- lib/bitrise/client/test_device.rb
 - lib/bitrise/client/version.rb
+- lib/bitrise/error.rb
+- lib/bitrise/test_device.rb
 homepage: https://github.com/mataku/bitrise-client
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/mataku/bitrise-client
   source_code_uri: https://github.com/mataku/bitrise-client
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -122,8 +128,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 3.2.32
+signing_key:
 specification_version: 4
 summary: A ruby clent for Bitrise API
 test_files: []

data/.travis.yml

@@ -1,8 +0,0 @@
----
-sudo: false
-language: ruby
-cache: bundler
-rvm:
-  - 2.6.0
-script:
-  - bundle exec rspec spec