ruboty-github_actions 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0b7f1d6a639921e72c8f477d9030a78a4742a8c5d8cb798dd163fad49abdd75e
+  data.tar.gz: 006ec7480c7ee6e6ef561b4a4120e9b006def396b72b158b6bbfbd9fc0f249ab
+SHA512:
+  metadata.gz: da1944e77c53e3e130459e583e9e875ba0c7397fb9c414d398058301a93ba8eed77a692dd558686e786ebe5f029f22e19ed49456ee028e008fce464c352df5b9
+  data.tar.gz: 8dc6f22faa338433a6dac1075b8eef66ccfa4c55fcf879692b9c821602592543ade84940636d22dee30a213d85666256667f86559c20fbf7f32532c7f270971a

data/README.md

@@ -0,0 +1,69 @@
+# ruboty-github_actions
+
+A ruboty plugin to trigger GitHub Actions workflows via chat.
+
+## Installation
+
+Add this line to your ruboty project's Gemfile:
+
+```ruby
+gem "ruboty-github_actions"
+```
+
+And then execute:
+
+```console
+$ bundle
+```
+
+## Usage
+
+### Set a credential
+
+Register a GitHub Personal Access Token for a user:
+
+```
+ruboty github actions set credential <user> <token>
+```
+
+Example:
+
+```
+ruboty github actions set credential alice ghp_xxxxxxxxxxxx
+```
+
+The credential is stored in the ruboty brain.
+
+### Fallback credential
+
+If the user has no credential saved by this plugin, the GitHub access token saved by [ruboty-qiita-github](https://github.com/increments/ruboty-qiita-github) (stored under the `github` key in the brain) is used as a fallback. A credential saved via `set credential` always takes precedence.
+
+### Dispatch a workflow
+
+Trigger a workflow run:
+
+```
+ruboty github actions run <repo> <workflow> <branch> [key=value,key2=value2 ...]
+```
+
+Example:
+
+```
+ruboty github actions run tomoasleep/myapp deploy main env=production
+```
+
+The workflow runs as the user who sent the message.
+
+## Configuration
+
+| Environment variable | Description |
+|----------------------|-------------|
+| `RUBOTY_GITHUB_ACTIONS_API_URL` | GitHub API base URL (optional, for testing/local emulation) |
+
+## Development
+
+Run the test suite:
+
+```console
+$ bundle exec rspec
+```

data/lib/ruboty/github_actions/actions/client.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    module Actions
+      class Client
+        class << self
+          def build(credential)
+            Octokit::Client.new(access_token: credential[:token], **base_options)
+          end
+
+          private
+
+          def base_options
+            options = {}
+            options[:api_endpoint] = ENV["RUBOTY_GITHUB_ACTIONS_API_URL"] if ENV["RUBOTY_GITHUB_ACTIONS_API_URL"]
+            options
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ruboty/github_actions/actions/run_workflow.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    module Actions
+      class RunWorkflow < Ruboty::Actions::Base
+        def call
+          repo = message[1]
+          workflow = message[2]
+          ref = message[3]
+          inputs = parse_inputs(message[4])
+
+          credential = Credential.find(message.robot.brain, message.from_name)
+          return message.reply("No credential found for #{message.from_name}") unless credential
+
+          client = Client.build(credential)
+          return message.reply("Workflow #{workflow} dispatch failed for #{repo}") unless client.workflow_dispatch(repo, workflow, ref, inputs: inputs)
+
+          message.reply("Workflow #{workflow} dispatched for #{repo}")
+        end
+
+        private
+
+        def parse_inputs(raw)
+          return {} unless raw
+
+          raw.split(",").each_with_object({}) do |pair, hash|
+            key, value = pair.split("=", 2)
+            hash[key.to_sym] = value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ruboty/github_actions/actions/set_credential.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    module Actions
+      class SetCredential < Ruboty::Actions::Base
+        def call
+          user = message[1]
+          token = message[2]
+
+          Credential.save(message.robot.brain, user, type: "pat", token: token)
+          message.reply("Credential saved for #{user}")
+        end
+      end
+    end
+  end
+end

data/lib/ruboty/github_actions/credential.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    class Credential
+      PREFIX = "github_actions:credentials"
+      QIITA_GITHUB_NAMESPACE = "github"
+
+      class << self
+        def save(brain, user, attributes)
+          brain.data[key_for(user)] = attributes
+        end
+
+        def find(brain, user)
+          brain.data[key_for(user)] || from_qiita_github(brain, user)
+        end
+
+        private
+
+        def key_for(user)
+          "#{PREFIX}:#{user}"
+        end
+
+        def from_qiita_github(brain, user)
+          token = brain.data[QIITA_GITHUB_NAMESPACE].to_h[user]
+          { type: "pat", token: token } if token
+        end
+      end
+    end
+  end
+end

data/lib/ruboty/github_actions/handlers/github_actions.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    module Handlers
+      class GithubActions < Ruboty::Handlers::Base
+        on(
+          /github actions set credential (?<user>\S+) (?<token>\S+)\z/,
+          name: "set_credential",
+          description: "Set a GitHub PAT credential for a user"
+        )
+
+        on(
+          /github actions run (?<repo>\S+) (?<workflow>\S+) (?<ref>\S+)(?<inputs> [\S,=]+)?\z/,
+          name: "run",
+          description: "Dispatch a GitHub Actions workflow"
+        )
+
+        def set_credential(message)
+          Ruboty::GithubActions::Actions::SetCredential.new(message).call
+        end
+
+        def run(message)
+          Ruboty::GithubActions::Actions::RunWorkflow.new(message).call
+        end
+      end
+    end
+  end
+end

data/lib/ruboty/github_actions/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Ruboty
+  module GithubActions
+    VERSION = "0.1.0"
+  end
+end

data/lib/ruboty/github_actions.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "ruboty"
+require "octokit"
+
+require "ruboty/github_actions/version"
+require "ruboty/github_actions/credential"
+require "ruboty/github_actions/actions/client"
+require "ruboty/github_actions/actions/set_credential"
+require "ruboty/github_actions/actions/run_workflow"
+require "ruboty/github_actions/handlers/github_actions"
+
+module Ruboty
+  module GithubActions
+  end
+end

data/lib/ruboty-github_actions.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "ruboty/github_actions"

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: ruboty-github_actions
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- tomoasleep
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: ruboty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: A ruboty plugin to trigger GitHub Actions workflows via chat
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/ruboty-github_actions.rb
+- lib/ruboty/github_actions.rb
+- lib/ruboty/github_actions/actions/client.rb
+- lib/ruboty/github_actions/actions/run_workflow.rb
+- lib/ruboty/github_actions/actions/set_credential.rb
+- lib/ruboty/github_actions/credential.rb
+- lib/ruboty/github_actions/handlers/github_actions.rb
+- lib/ruboty/github_actions/version.rb
+homepage: https://github.com/tomoasleep/ruboty-github_actions
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: Run GitHub Actions workflows from ruboty
+test_files: []