buildkiterb 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c74759ca24a01e1c3014a40e390bf0e6856f6f822afbe9b3ec04ce4eedf47a3
-  data.tar.gz: 15155f0dd6b2925cd986ca1fe4f800070b14f532b26bdf75dd368c40996afdc0
+  metadata.gz: f6ecaa3ffea095a7da23de6dac919c1eef744c42d645d75288ae2a3411f4e10c
+  data.tar.gz: 2a03c413f50559febd8d3f4432640153af6e380028a1ba39a42757ec1cb528ea
 SHA512:
-  metadata.gz: 6471e3269bedfda857df898a96435d6b71759720880d4707e95ee1e9dd1d1eb54539446c9a05ada092413c7bc67327414781153ffec061dad8136c39d753ae04
-  data.tar.gz: 1424178e0527a785d2ac7b63d6632ee02fa7b8e19bae68e2a4a02dc15df3e0b04066395ba7de968a9db24df2c4be6f06dbaeb68a73b444e1fff65aa3cffe41be
+  metadata.gz: 8e4d2348ff0f7ab4418e78c5a273b63dce1d441cf50a39cdd6d5dcf5632413aa25d54d55b61cb627f3d56d41b54ec941ecaa526fee633313541e022b17808e2e
+  data.tar.gz: f8e8a39511244f94c497b6443d0acc9b7d37c8ef2a375be3ba1ed2df485584c4025153f9577dd38f0d2d7c9b1202c6b67f97a3872e7f96c0d6b7beac44682b82

data/.env.example

@@ -1 +1,2 @@
-ACCESS_TOKEN=
+BUILDKITE_TOKEN=
+BUILDKITE_ORG=

data/.github/workflows/ci.yml

@@ -7,12 +7,12 @@ jobs:
       fail-fast: false
       matrix:
         ruby_version:
-          - 2.6
           - 2.7
           - 3.0
           - 3.1
+          - 3.2
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby_version }}

data/Gemfile

@@ -5,4 +5,6 @@ gemspec
 
 gem "rake", "~> 12.0"
 gem "minitest", "~> 5.0"
-gem "dotenv"
+gem "dotenv"
+
+gem "vcr"

data/Gemfile.lock

@@ -1,20 +1,21 @@
 PATH
   remote: .
   specs:
-    buildkiterb (0.1.0)
+    buildkiterb (1.0.0)
       faraday (~> 2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     dotenv (2.7.6)
-    faraday (2.7.4)
+    faraday (2.7.10)
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
     faraday-net_http (3.0.2)
     minitest (5.15.0)
     rake (12.3.3)
     ruby2_keywords (0.0.5)
+    vcr (6.2.0)
 
 PLATFORMS
   ruby
@@ -24,6 +25,7 @@ DEPENDENCIES
   dotenv
   minitest (~> 5.0)
   rake (~> 12.0)
+  vcr
 
 BUNDLED WITH
    2.3.21

data/README.md

@@ -15,20 +15,235 @@ gem "buildkiterb"
 ### Set Client Details
 
 Firstly you'll need to create an API Token on [Buildkite](https://buildkite.com/user/api-access-tokens)
-and then set it like so: 
+and then configure it like below.
+
+Buildkite tokens are created for a single organization now, so I recommend setting the `org` the same way,
+to tidy up your code.
+
+You can optionally set a pipeline too.
 
 ```ruby
-@client = Buildkite::Client.new(access_token: "")
+Buildkite.configure do |config|
+  config.token    = ENV["BUILDKITE_TOKEN"]
+  config.org      = ENV["BUILDKITE_ORG"]
+  config.pipeline = ENV["BUILDKITE_PIPELINE"]
+end
+
 ```
 
-### Organizations
+### Access Token
 
 ```ruby
-# List all of your organizations
-@client.organizations.list
+# Get details of the current token
+Buildkite::AccessToken.retrieve
+
+# Revoke the current token
+Buildkite::AccessToken.revoke
+```
 
+### Organizations
+
+```ruby
 # Retrieves an organization
-@client.organizations.get slug: "my-org-slug"
+Buildkite::Organization.get slug: "my-org-slug"
+```
+
+### Pipelines
+
+```ruby
+# List all pipelines for an org
+Buildkite::Pipeline.list
+#=> #<Buildkite::Collection...
+
+# Get a pipeline
+Buildkite::Pipeline.retrieve pipeline: "my pipeline"
+
+# Create a Pipeline. View the 2 docs links for the correct params
+# Docs: https://buildkite.com/docs/apis/rest-api/pipelines#create-a-yaml-pipeline
+# Docs: https://buildkite.com/docs/apis/rest-api/pipelines#create-a-visual-step-pipeline
+Buildkite::Pipeline.create name: "my pipeline", repository: "git@github.com:user/repo.git", configuration: {}
+
+# Update a pipeline
+# Docs: https://buildkite.com/docs/apis/rest-api/pipelines#update-a-pipeline
+Buildkite::Pipeline.update pipeline: "my-pipeline", {}
+
+# Archive a pipeline
+Buildkite::Pipeline.archive pipeline: "my-pipeline"
+
+# Unarchive a pipeline
+Buildkite::Pipeline.unarchive pipeline: "my-pipeline"
+
+# Delete a pipeline
+Buildkite::Pipeline.delete pipeline: "my-pipeline"
+
+# Setup automatic webhooks
+# Returns 422 if not supported or cannot be done
+Buildkite::Pipeline.webhook pipeline: "my-pipeline"
+```
+
+### Builds
+
+```ruby
+# List all builds
+Buildkite::Build.list
+
+# List all builds for an org
+Buildkite::Build.list org: "org-slug"
+
+# List all builds for a pipeline
+Buildkite::Build.list org: "org-slug", pipeline: "pipeline-slug"
+
+# Get a build
+# The Build Number is used, not the ID
+Buildkite::Build.retrieve pipeline: "pipeline-slug", number: 123
+
+# Create a Build
+# Docs: https://buildkite.com/docs/apis/rest-api/builds#create-a-build
+Buildkite::Build.create pipeline: "pipeline-slug", commit: "abc123", branch: "master"
+
+# Cancel a build
+Buildkite::Build.cancel pipeline: "pipeline-slug", number: 123
+
+# Rebuild a build
+Buildkite::Build.rebuild pipeline: "pipeline-slug", number: 123
+```
+
+### Agents
+
+```ruby
+# List all agents for an org
+Buildkite::Agent.list
+
+# Get an agent
+Buildkite::Agent.retrieve id: "abc123"
+
+# Stop an agent
+# To force an agent to stop, add `force: true`
+Buildkite::Agent.stop id: "abc123"
+```
+
+### Clusters
+
+```ruby
+# List all clusters for an org
+Buildkite::Cluster.list
+
+# Get a cluster
+Buildkite::Cluster.retrieve id: "abc123"
+
+# Create a cluster
+Buildkite::Cluster.create name: "Open Source"
+
+# Update a cluster
+Buildkite::Cluster.update id: "abc123", description: "A cluster for our Open Source projects"
+
+# Delete a cluster
+Buildkite::Cluster.delete id: "abc123"
+```
+
+### Cluster Queues
+
+```ruby
+# List all queues for a cluster
+Buildkite::ClusterQueue.list cluster: "abc123",
+
+# Get a cluster queue
+Buildkite::ClusterQueue.retrieve cluster: "abc123", id: "abc123"
+
+# Create a cluster queue
+Buildkite::ClusterQueue.create cluster: "abc123", key: "arm64"
+
+# Update a cluster queue
+Buildkite::ClusterQueue.update cluster: "abc123", id: "abc123", description: "For ARM64 builds"
+
+# Pause a cluster queue
+Buildkite::ClusterQueue.pause cluster: "abc123", id: "abc123", note: "For maintenance"
+
+# Unpause a cluster queue
+Buildkite::ClusterQueue.unpause cluster: "abc123", id: "abc123"
+
+# Delete a cluster queue
+Buildkite::ClusterQueue.delete cluster: "abc123", id: "abc123"
+```
+
+### Cluster Tokens
+
+```ruby
+# List all tokens for a cluster
+Buildkite::ClusterToken.list cluster: "abc123",
+
+# Get a cluster token
+Buildkite::ClusterToken.retrieve cluster: "abc123", id: "abc123"
+
+# Create a cluster token
+Buildkite::ClusterToken.create cluster: "abc123", description: "Windows Agents"
+
+# Update a cluster token
+Buildkite::ClusterToken.update cluster: "abc123", id: "abc123", allowed_ip_addresses: "1.1.1.1"
+
+# Delete a cluster token
+Buildkite::ClusterToken.delete cluster: "abc123", id: "abc123"
+```
+
+
+### Jobs
+
+```ruby
+# Retry a job
+Buildkite::Job.retry pipeline: "pipeline-slug", number: 123, job: "abc123"
+
+# Unblock a job
+# Docs: https://buildkite.com/docs/apis/rest-api/jobs#unblock-a-job
+Buildkite::Job.unblock pipeline: "pipeline-slug", number: 123, job: "abc123", {}
+
+# Get a job's logs
+Buildkite::Job.log pipeline: "pipeline-slug", number: 123, job: "abc123"
+
+# Delete a job's log
+Buildkite::Job.delete_log pipeline: "pipeline-slug", number: 123, job: "abc123"
+
+# Get a job's environment variables
+Buildkite::Job.env pipeline: "pipeline-slug", number: 123, job: "abc123"
+```
+
+### Annotations
+
+```ruby
+# List annotations for a build
+Buildkite::Annotation.list pipeline: "pipeline-slug", number: 123
+```
+
+### Artifacts
+
+```ruby
+# List artifacts for a build
+Buildkite::Artifact.list pipeline: "pipeline-slug", number: 123
+
+# List artifacts for a build job
+Buildkite::Artifact.list pipeline: "pipeline-slug", number: 123, job: "abc123"
+
+# Get an artifact
+Buildkite::Artifact.retrieve pipeline: "pipeline-slug", number: 123, job: "abc123", id: "123abc"
+
+# Download an artifact
+Buildkite::Artifact.download pipeline: "pipeline-slug", number: 123, job: "abc123", id: "123abc"
+
+# Delete an artifact
+Buildkite::Artifact.delete pipeline: "pipeline-slug", number: 123, job: "abc123", id: "123abc"
+```
+
+### Emojis
+
+```ruby
+# List emojis for an organization
+Buildkite::Emoji.list
+```
+
+### User
+
+```ruby
+# Get the current user
+Buildkite::User.retrieve
 ```
 
 ## Contributing

data/bin/console

@@ -13,7 +13,10 @@ require 'dotenv/load'
 # require "pry"
 # Pry.start
 
-@client = Buildkite::Client.new(access_token: ENV["ACCESS_TOKEN"])
+Buildkite.configure do |config|
+  config.token = ENV["BUILDKITE_TOKEN"]
+  config.org   = ENV["BUILDKITE_ORG"]
+end
 
 require "irb"
 IRB.start(__FILE__)

data/lib/buildkite/client.rb

@@ -1,34 +1,69 @@
 module Buildkite
   class Client
+
     BASE_URL = "https://api.buildkite.com/v2"
 
-    attr_reader :access_token, :adapter
+    class << self
 
-    def initialize(access_token:, adapter: Faraday.default_adapter, stubs: nil)
-      @access_token = access_token
-      @adapter = adapter
+      def connection
+        @connection ||= Faraday.new(BASE_URL) do |conn|
+          conn.request :authorization, :Bearer, Buildkite.config.token
 
-      # Test stubs for requests
-      @stubs = stubs
-    end
+          conn.headers = {
+            "User-Agent" => "buildkiterb/v#{VERSION} (github.com/deanpcmad/buildkiterb)"
+          }
 
-    def organizations
-      OrganizationsResource.new(self)
-    end
+          conn.request :json
+
+          conn.response :json, content_type: "application/json"
+        end
+      end
+
+      def get_request(url, params: {}, headers: {})
+        handle_response connection.get(url, params, headers)
+      end
 
-    def connection
-      @connection ||= Faraday.new(BASE_URL) do |conn|
-        conn.request :authorization, :Bearer, access_token
-        
-        conn.headers = {
-          "User-Agent" => "buildkiterb/v#{VERSION} (github.com/deanpcmad/buildkiterb)"
-        }
-        
-        conn.request :json
+      def post_request(url, body: {}, headers: {})
+        handle_response connection.post(url, body, headers)
+      end
+
+      def put_request(url, body:, headers: {})
+        handle_response connection.put(url, body, headers)
+      end
+
+      def patch_request(url, body:, headers: {})
+        handle_response connection.patch(url, body, headers)
+      end
+
+      def delete_request(url, headers: {})
+        handle_response connection.delete(url, headers)
+      end
 
-        conn.response :json, content_type: "application/json"
+      def handle_response(response)
+        case response.status
+        when 400
+          raise Error, "Error 400: Your request was malformed. '#{response.body["message"]}'"
+        when 401
+          raise Error, "Error 401: You did not supply valid authentication credentials. '#{response.body["message"]}'"
+        when 403
+          raise Error, "Error 403: You are not allowed to perform that action. '#{response.body["message"]}'"
+        when 404
+          raise Error, "Error 404: No results were found for your request. '#{response.body["message"]}'"
+        when 409
+          raise Error, "Error 409: Your request was a conflict. '#{response.body["message"]}'"
+        when 429
+          raise Error, "Error 429: Your request exceeded the API rate limit. '#{response.body["message"]}'"
+        when 500
+          raise Error, "Error 500: We were unable to perform the request due to server-side problems. '#{response.body["message"]}'"
+        when 503
+          raise Error, "Error 503: You have been rate limited for sending more than 20 requests per second. '#{response.body["message"]}'"
+        when 501
+          raise Error, "Error 501: This resource has not been implemented. '#{response.body["message"]}'"
+        when 204
+          return true
+        end
 
-        conn.adapter adapter, @stubs
+        response
       end
     end
 

data/lib/buildkite/configuration.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Buildkite
+  class Configuration
+
+    attr_accessor :token
+    attr_accessor :org
+    attr_accessor :pipeline
+
+  end
+end

data/lib/buildkite/models/access_token.rb

@@ -0,0 +1,18 @@
+module Buildkite
+  class AccessToken < Object
+
+    class << self
+
+      def retrieve
+        response = Client.get_request("access-token")
+        AccessToken.new response.body
+      end
+
+      def revoke
+        Client.delete_request("access-token")
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/agent.rb

@@ -0,0 +1,23 @@
+module Buildkite
+  class Agent < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org)
+        response = Client.get_request("organizations/#{org}/agents")
+        Collection.from_response(response, type: Agent)
+      end
+
+      def retrieve(org: Buildkite.config.org, id:)
+        response = Client.get_request("organizations/#{org}/agents/#{id}")
+        Agent.new response.body
+      end
+
+      def stop(org: Buildkite.config.org, id:, **args)
+        Client.put_request("organizations/#{org}/agents/#{id}/stop", body: args)
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/annotation.rb

@@ -0,0 +1,14 @@
+module Buildkite
+  class Annotation < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, build:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/annotations")
+        Collection.from_response(response, type: Annotation)
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/artifact.rb

@@ -0,0 +1,33 @@
+module Buildkite
+  class Artifact < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, build:, job: nil)
+        if job
+          response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/jobs/#{job}/artifacts")
+        else
+          response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/artifacts")
+        end
+
+        Collection.from_response(response, type: Artifact)
+      end
+
+      def retrieve(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, build:, job:, id:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/jobs/#{job}/artifacts/#{id}")
+        Artifact.new response.body
+      end
+
+      def download(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, build:, job:, id:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/jobs/#{job}/artifacts/#{id}/download")
+        ArtifactDownload.new response.body
+      end
+
+      def delete(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, build:, job:, id:)
+        Client.delete_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{build}/jobs/#{job}/artifacts/#{id}")
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/artifact_download.rb

@@ -0,0 +1,4 @@
+module Buildkite
+  class ArtifactDownload < Object
+  end
+end

data/lib/buildkite/models/build.rb

@@ -0,0 +1,44 @@
+module Buildkite
+  class Build < Object
+
+    class << self
+
+      def list(org: nil, pipeline: nil)
+        if org && pipeline
+          response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds")
+        elsif org
+          response = Client.get_request("organizations/#{org}/builds")
+        else
+          response = Client.get_request("builds")
+        end
+
+        if response
+          Collection.from_response(response, type: Build)
+        end
+      end
+
+      def retrieve(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}")
+        Build.new response.body
+      end
+
+      def create(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, commit:, branch:, **args)
+        data = {commit: commit, branch: branch}
+        response = Client.post_request("organizations/#{org}/pipelines/#{pipeline}/builds", body: data.merge(args))
+        Build.new response.body
+      end
+
+      def cancel(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:)
+        response = Client.put_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/cancel", body: {})
+        Build.new response.body
+      end
+
+      def rebuild(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:)
+        response = Client.put_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/rebuild", body: {})
+        Build.new response.body
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/cluster.rb

@@ -0,0 +1,34 @@
+module Buildkite
+  class Cluster < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org)
+        response = Client.get_request("organizations/#{org}/clusters")
+        Collection.from_response(response, type: Cluster)
+      end
+
+      def retrieve(org: Buildkite.config.org, id:)
+        response = Client.get_request("organizations/#{org}/clusters/#{id}")
+        Cluster.new response.body
+      end
+
+      def create(org: Buildkite.config.org, name:, **args)
+        data = {name: name}
+        response = Client.post_request("organizations/#{org}/clusters", body: data.merge(args))
+        Cluster.new response.body
+      end
+
+      def update(org: Buildkite.config.org, id:, **args)
+        response = Client.patch_request("organizations/#{org}/clusters/#{id}", body: args)
+        Cluster.new response.body
+      end
+
+      def delete(org: Buildkite.config.org, id:)
+        Client.delete_request("organizations/#{org}/clusters/#{id}")
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/cluster_queue.rb

@@ -0,0 +1,44 @@
+module Buildkite
+  class ClusterQueue < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org, cluster:)
+        response = Client.get_request("organizations/#{org}/clusters/#{cluster}/queues")
+        Collection.from_response(response, type: ClusterQueue)
+      end
+
+      def retrieve(org: Buildkite.config.org, cluster:, id:)
+        response = Client.get_request("organizations/#{org}/clusters/#{cluster}/queues/#{id}")
+        ClusterQueue.new response.body
+      end
+
+      def create(org: Buildkite.config.org, cluster:, key:, **args)
+        data = {key: key}
+        response = Client.post_request("organizations/#{org}/clusters/#{cluster}/queues", body: data.merge(args))
+        ClusterQueue.new response.body
+      end
+
+      def update(org: Buildkite.config.org, cluster:, id:, **args)
+        response = Client.patch_request("organizations/#{org}/clusters/#{cluster}/queues/#{id}", body: args)
+        ClusterQueue.new response.body
+      end
+
+      def pause(org: Buildkite.config.org, cluster:, id:, note: nil)
+        response = Client.post_request("organizations/#{org}/clusters/#{cluster}/queues/#{id}/pause_dispatch", body: {note: note})
+        ClusterQueue.new response.body
+      end
+
+      def resume(org: Buildkite.config.org, cluster:, id:)
+        response = Client.post_request("organizations/#{org}/clusters/#{cluster}/queues/#{id}/resume_dispatch", body: {})
+        ClusterQueue.new response.body
+      end
+
+      def delete(org: Buildkite.config.org, cluster:, id:)
+        Client.delete_request("organizations/#{org}/clusters/#{cluster}/queues/#{id}")
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/cluster_token.rb

@@ -0,0 +1,34 @@
+module Buildkite
+  class ClusterToken < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org, cluster:)
+        response = Client.get_request("organizations/#{org}/clusters/#{cluster}/tokens")
+        Collection.from_response(response, type: ClusterToken)
+      end
+
+      def retrieve(org: Buildkite.config.org, cluster:, id:)
+        response = Client.get_request("organizations/#{org}/clusters/#{cluster}/tokens/#{id}")
+        ClusterToken.new response.body
+      end
+
+      def create(org: Buildkite.config.org, cluster:, description:, **args)
+        data = {description: description}
+        response = Client.post_request("organizations/#{org}/clusters/#{cluster}/tokens", body: data.merge(args))
+        ClusterToken.new response.body
+      end
+
+      def update(org: Buildkite.config.org, cluster:, id:, **args)
+        response = Client.patch_request("organizations/#{org}/clusters/#{cluster}/tokens/#{id}", body: args)
+        ClusterToken.new response.body
+      end
+
+      def delete(org: Buildkite.config.org, cluster:, id:)
+        Client.delete_request("organizations/#{org}/clusters/#{cluster}/tokens/#{id}")
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/emoji.rb

@@ -0,0 +1,14 @@
+module Buildkite
+  class Emoji < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org)
+        response = Client.get_request("organizations/#{org}/emojis")
+        Collection.from_response(response, type: Emoji)
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/job.rb

@@ -0,0 +1,33 @@
+module Buildkite
+  class Job < Object
+
+    class << self
+
+      def retry(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:, job:)
+        response = Client.put_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/jobs/#{job}/retry", body: {})
+        Job.new response.body
+      end
+
+      def unblock(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:, job:, **args)
+        response = Client.put_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/jobs/#{job}/unblock", body: args)
+        Job.new response.body
+      end
+
+      def log(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:, job:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/jobs/#{job}/log")
+        JobLog.new response.body
+      end
+
+      def delete_log(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:, job:)
+        Client.delete_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/jobs/#{job}/log")
+      end
+
+      def env(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, number:, job:)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}/builds/#{number}/jobs/#{job}/env")
+        JobEnv.new response.body["env"]
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/job_env.rb

@@ -0,0 +1,4 @@
+module Buildkite
+  class JobEnv < Object
+  end
+end

data/lib/buildkite/models/job_log.rb

@@ -0,0 +1,4 @@
+module Buildkite
+  class JobLog < Object
+  end
+end

data/lib/buildkite/models/organization.rb

@@ -0,0 +1,19 @@
+module Buildkite
+  class Organization < Object
+
+    class << self
+
+      def list
+        response = Client.get_request("organizations")
+        Collection.from_response(response, type: Organization)
+      end
+
+      def retrieve(slug:)
+        response = Client.get_request("organizations/#{slug}")
+        Organization.new(response.body)
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/pipeline.rb

@@ -0,0 +1,48 @@
+module Buildkite
+  class Pipeline < Object
+
+    class << self
+
+      def list(org: Buildkite.config.org)
+        response = Client.get_request("organizations/#{org}/pipelines")
+        Collection.from_response(response, type: Pipeline)
+      end
+
+      def retrieve(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline)
+        response = Client.get_request("organizations/#{org}/pipelines/#{pipeline}")
+        Pipeline.new response.body
+      end
+
+      def create(org: Buildkite.config.org, name:, repository:, configuration:, **args)
+        data = {name: name, repository: repository, configuration: configuration}
+        response = Client.post_request("organizations/#{org}/pipelines", body: data.merge(args))
+        Pipeline.new response.body
+      end
+
+      def update(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline, **args)
+        response = Client.patch_request("organizations/#{org}/pipelines/#{pipeline}", body: args)
+        Pipeline.new response.body
+      end
+
+      def archive(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline)
+        response = Client.post_request("organizations/#{org}/pipelines/#{pipeline}/archive", body: {})
+        Pipeline.new response.body
+      end
+
+      def unarchive(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline)
+        response = Client.post_request("organizations/#{org}/pipelines/#{pipeline}/unarchive", body: {})
+        Pipeline.new response.body
+      end
+
+      def delete(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline)
+        Client.delete_request("organizations/#{org}/pipelines/#{pipeline}")
+      end
+
+      def webhook(org: Buildkite.config.org, pipeline: Buildkite.config.pipeline)
+        Client.post_request("organizations/#{org}/pipelines/#{pipeline}/webhook", body: {})
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/models/user.rb

@@ -0,0 +1,14 @@
+module Buildkite
+  class User < Object
+
+    class << self
+
+      def retrieve
+        response = Client.get_request("user")
+        User.new response.body
+      end
+
+    end
+
+  end
+end

data/lib/buildkite/version.rb

@@ -1,3 +1,3 @@
 module Buildkite
-  VERSION = "0.1.0"
+  VERSION = "1.0.0"
 end

data/lib/buildkite.rb

@@ -1,18 +1,42 @@
 require "faraday"
-require "json"
-require "buildkite/version"
+
+require_relative "buildkite/version"
 
 module Buildkite
 
+  autoload :Configuration, "buildkite/configuration"
   autoload :Client, "buildkite/client"
   autoload :Collection, "buildkite/collection"
   autoload :Error, "buildkite/error"
-  autoload :Resource, "buildkite/resource"
   autoload :Object, "buildkite/object"
-  
 
-  autoload :OrganizationsResource, "buildkite/resources/organizations"
+  class << self
+    attr_writer :config
+  end
+
+  def self.configure
+    yield(config) if block_given?
+  end
+
+  def self.config
+    @config ||= Buildkite::Configuration.new
+  end
 
-  autoload :Organization, "buildkite/objects/organization"
+  autoload :AccessToken, "buildkite/models/access_token"
+  autoload :Organization, "buildkite/models/organization"
+  autoload :Pipeline, "buildkite/models/pipeline"
+  autoload :Build, "buildkite/models/build"
+  autoload :Job, "buildkite/models/job"
+  autoload :JobLog, "buildkite/models/job_log"
+  autoload :JobEnv, "buildkite/models/job_env"
+  autoload :Agent, "buildkite/models/agent"
+  autoload :Cluster, "buildkite/models/cluster"
+  autoload :ClusterQueue, "buildkite/models/cluster_queue"
+  autoload :ClusterToken, "buildkite/models/cluster_token"
+  autoload :Annotation, "buildkite/models/annotation"
+  autoload :Artifact, "buildkite/models/artifact"
+  autoload :ArtifactDownload, "buildkite/models/artifact_download"
+  autoload :Emoji, "buildkite/models/emoji"
+  autoload :User, "buildkite/models/user"
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: buildkiterb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Dean Perry
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-06 00:00:00.000000000 Z
+date: 2023-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -24,7 +24,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-description: 
+description:
 email:
 - dean@deanpcmad.com
 executables: []
@@ -46,11 +46,25 @@ files:
 - lib/buildkite.rb
 - lib/buildkite/client.rb
 - lib/buildkite/collection.rb
+- lib/buildkite/configuration.rb
 - lib/buildkite/error.rb
+- lib/buildkite/models/access_token.rb
+- lib/buildkite/models/agent.rb
+- lib/buildkite/models/annotation.rb
+- lib/buildkite/models/artifact.rb
+- lib/buildkite/models/artifact_download.rb
+- lib/buildkite/models/build.rb
+- lib/buildkite/models/cluster.rb
+- lib/buildkite/models/cluster_queue.rb
+- lib/buildkite/models/cluster_token.rb
+- lib/buildkite/models/emoji.rb
+- lib/buildkite/models/job.rb
+- lib/buildkite/models/job_env.rb
+- lib/buildkite/models/job_log.rb
+- lib/buildkite/models/organization.rb
+- lib/buildkite/models/pipeline.rb
+- lib/buildkite/models/user.rb
 - lib/buildkite/object.rb
-- lib/buildkite/objects/organization.rb
-- lib/buildkite/resource.rb
-- lib/buildkite/resources/organizations.rb
 - lib/buildkite/version.rb
 - lib/buildkiterb.rb
 homepage: https://deanpcmad.com
@@ -59,7 +73,7 @@ licenses:
 metadata:
   homepage_uri: https://deanpcmad.com
   source_code_uri: https://github.com/deanpcmad/buildkiterb
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -74,8 +88,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.6
-signing_key: 
+rubygems_version: 3.4.18
+signing_key:
 specification_version: 4
 summary: A Ruby library for the Buildkite API
 test_files: []

data/lib/buildkite/objects/organization.rb

@@ -1,4 +0,0 @@
-module Buildkite
-  class Organization < Object
-  end
-end

data/lib/buildkite/resource.rb

@@ -1,59 +0,0 @@
-module Buildkite
-  class Resource
-    attr_reader :client
-
-    def initialize(client)
-      @client = client
-    end
-
-    private
-
-    def get_request(url, params: {}, headers: {})
-      handle_response client.connection.get(url, params, headers)
-    end
-
-    def post_request(url, body:, headers: {})
-      handle_response client.connection.post(url, body, headers)
-    end
-
-    def patch_request(url, body:, headers: {})
-      handle_response client.connection.patch(url, body, headers)
-    end
-
-    def put_request(url, body:, headers: {})
-      handle_response client.connection.put(url, body, headers)
-    end
-
-    def delete_request(url, params: {}, headers: {})
-      handle_response client.connection.delete(url, params, headers)
-    end
-
-    def handle_response(response)
-      case response.status
-      when 400
-        raise Error, "Error 400: Your request was malformed. '#{response.body["message"]}'"
-      when 401
-        raise Error, "Error 401: You did not supply valid authentication credentials. '#{response.body["error"]}'"
-      when 403
-        raise Error, "Error 403: You are not allowed to perform that action. '#{response.body["error"]}'"
-      when 404
-        raise Error, "Error 404: No results were found for your request. '#{response.body["error"]}'"
-      when 409
-        raise Error, "Error 409: Your request was a conflict. '#{response.body["message"]}'"
-      when 422
-        raise Error, "Error 422: Unprocessable Entity. '#{response.body["message"]}"
-      when 429
-        raise Error, "Error 429: Your request exceeded the API rate limit. '#{response.body["error"]}'"
-      when 500
-        raise Error, "Error 500: We were unable to perform the request due to server-side problems. '#{response.body["error"]}'"
-      when 503
-        raise Error, "Error 503: You have been rate limited for sending more than 20 requests per second. '#{response.body["error"]}'"
-      when 204
-        # 204 is a response for success on Twitch's API
-        return true
-      end
-
-      response
-    end
-  end
-end

data/lib/buildkite/resources/organizations.rb

@@ -1,14 +0,0 @@
-module Buildkite
-  class OrganizationsResource < Resource
-    
-    def list
-      response = get_request("organizations")
-      Collection.from_response(response, type: Organization)
-    end
-
-    def get(slug:)
-      Organization.new get_request("organizations/#{slug}").body
-    end
-
-  end
-end