enruby 0.1.0.pre.3 → 0.1.0.pre.3.pr80.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da457dba90f350a8065578cd84a7b702ac76bd50c25b8143a446bccb246c0a4d
-  data.tar.gz: a3f87d86893880a630a43b04932707dfce9e9bb70587e94c3f3aca921a0c56bf
+  metadata.gz: 3432969e6552e52155548d00337ceb5d800b27f35c2dda47f67245cb89652866
+  data.tar.gz: c726ad8eff7ee4f1889e4f7c47ec197b82214dffc866e783d1a1a9a3a06f65f7
 SHA512:
-  metadata.gz: d0401f734bed4be729849ca67358534762d58c84041ab0b6275dda1b0cfbcd988a620e3b008dde910063854dbf629d46823b5b2d28f3a334a1710039ddb835c7
-  data.tar.gz: 80fa07d55d8e45e35916412fa48017f6a7c805b20fb48c8202fb3f0b5961eed533159716a26a99b758d64135f43151b024fd6fdd22dd83893eb7f52c9dfdee63
+  metadata.gz: 8ab5465ebb35651ef80515f7494cdc4da7a7fdc133d1b73472b0cb9628bd12f628779ccf39769ea6ef48ccb0fd3cf03cc999390f5481d8b3556467224f86e4c4
+  data.tar.gz: 94335d974813cf8fddea438196985f4ebcb232135e8820536d9dfd1ddccd969a7c04a1dee67c5c98105d91266ca21bcb52ea6de74a411ee8e26c5b1bdf1495ad

data/Gemfile.lock

@@ -1,56 +1,63 @@
 PATH
   remote: .
   specs:
-    enruby (0.1.0.pre.3)
+    enruby (0.1.0.pre.3.pr80.1.1)
       immutable-struct (~> 2.4)
-      lino (>= 3, < 5)
+      lino (>= 4.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.3.4)
+    activesupport (8.1.3)
       base64
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.1.2)
     childprocess (5.0.0)
     coderay (1.1.3)
     colored2 (3.1.2)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
-    diff-lcs (1.5.1)
-    docile (1.4.0)
-    drb (2.2.1)
-    excon (0.111.0)
-    faker (3.4.2)
+    concurrent-ruby (1.3.8)
+    connection_pool (3.0.2)
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    drb (2.2.3)
+    excon (0.112.0)
+    faker (3.8.0)
       i18n (>= 1.8.11, < 2)
-    faraday (2.10.0)
-      faraday-net_http (>= 2.0, < 3.2)
+    faraday (2.14.3)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
       logger
-    faraday-net_http (3.1.0)
-      net-http
-    ffi (1.17.0-aarch64-linux-gnu)
-    ffi (1.17.0-arm64-darwin)
-    ffi (1.17.0-x86_64-darwin)
-    ffi (1.17.0-x86_64-linux-gnu)
-    formatador (1.1.0)
-    gem-release (2.2.2)
+    faraday-net_http (3.4.4)
+      net-http (~> 0.5)
+    ffi (1.17.4)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    formatador (1.2.3)
+      reline
+    gem-release (2.2.4)
     git (1.19.1)
       addressable (~> 2.8)
       rchardet (~> 1.8)
-    guard (2.18.1)
+    guard (2.20.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
+      logger (~> 1.6)
       lumberjack (>= 1.0.12, < 2.0)
       nenv (~> 0.1)
       notiffany (~> 0.0)
@@ -64,50 +71,50 @@ GEM
       rspec (>= 2.99.0, < 4.0)
     hamster (3.0.0)
       concurrent-ruby (~> 1.0)
-    i18n (1.14.5)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    immutable-struct (2.4.1)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
+    immutable-struct (2.5.0)
+    io-console (0.8.2)
+    json (2.21.1)
+    language_server-protocol (3.17.0.6)
     lino (4.1.0)
       childprocess (~> 5.0.0)
       hamster (~> 3.0)
       open4 (~> 1.3)
-    listen (3.9.0)
+    lint_roller (1.1.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    logger (1.6.0)
-    lumberjack (1.2.10)
+    logger (1.7.0)
+    lumberjack (1.4.2)
     method_source (1.1.0)
-    minitest (5.24.1)
-    mutex_m (0.2.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
     nenv (0.3.0)
-    net-http (0.4.1)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    octokit (8.1.0)
-      base64
+    octokit (10.0.0)
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
     open4 (1.3.4)
-    parallel (1.25.1)
-    parser (3.3.4.0)
+    parallel (2.1.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
-    pry (0.14.2)
+    prism (1.9.0)
+    pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (6.0.1)
-    racc (1.8.0)
+      reline (>= 0.6.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
-    rake_circle_ci (0.13.0)
-      colored2 (~> 3.1)
-      excon (~> 0.72)
-      rake_factory (~> 0.33)
-      sshkey (~> 2.0)
+    rake (13.4.2)
     rake_factory (0.33.0)
       activesupport (>= 4)
       rake (~> 13.0)
@@ -115,91 +122,102 @@ GEM
       colored2 (~> 3.1)
       git (~> 1.13, >= 1.13.2)
       rake_factory (~> 0.33)
-    rake_git_crypt (0.2.0)
+    rake_git_crypt (0.4.0)
       colored2 (~> 3.1)
+      lino (~> 4.1)
       rake_factory (~> 0.33)
       ruby_git_crypt (~> 0.1)
       ruby_gpg2 (~> 0.12)
-    rake_github (0.15.0)
+    rake_github (0.17.0)
       colored2 (~> 3.1)
-      octokit (>= 4.16, < 9.0)
+      octokit (>= 7.0, < 11.0)
       rake_factory (~> 0.33)
+      rbnacl (~> 7.1)
       sshkey (~> 2.0)
     rake_gpg (0.20.0)
       rake_factory (~> 0.33)
       ruby_gpg2 (~> 0.12)
-    rake_ssh (0.12.0)
-      colored2 (~> 3.1)
+    rake_slack (0.3.0)
+      excon (>= 0.72, < 2.0)
       rake_factory (~> 0.33)
-      sshkey (~> 2.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rchardet (1.8.0)
-    regexp_parser (2.9.2)
-    rexml (3.3.2)
-      strscan
-    rspec (3.13.0)
+    rbnacl (7.1.2)
+      ffi (~> 1)
+    rchardet (1.10.2)
+    regexp_parser (2.12.0)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.65.0)
+    rspec-support (3.13.7)
+    rubocop (1.88.2)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.4, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (3.0.3)
-      rubocop (~> 1.61)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.10.2)
+      lint_roller (~> 1.1)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
     ruby-progressbar (1.13.0)
     ruby_git_crypt (0.1.0)
       immutable-struct (~> 2.4)
       lino (>= 4.1)
     ruby_gpg2 (0.12.0)
       lino (>= 4.1)
-    sawyer (0.9.2)
+    sawyer (0.9.3)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
+    securerandom (0.4.1)
     shellany (0.0.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
     sshkey (2.0.0)
-    strscan (3.1.0)
     terminal-notifier-guard (1.7.0)
-    thor (1.3.1)
+    thor (1.5.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
-    yard (0.9.36)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    yard (0.9.44)
 
 PLATFORMS
   aarch64-linux
   arm64-darwin-21
   arm64-darwin-22
   arm64-darwin-23
+  arm64-darwin-25
+  ruby
   x86_64-darwin-19
   x86_64-darwin-20
   x86_64-darwin-21
@@ -213,12 +231,11 @@ DEPENDENCIES
   guard
   guard-rspec
   rake
-  rake_circle_ci
   rake_git
   rake_git_crypt
   rake_github
   rake_gpg
-  rake_ssh
+  rake_slack
   rspec
   rubocop
   rubocop-rake
@@ -228,4 +245,4 @@ DEPENDENCIES
   yard
 
 BUNDLED WITH
-   2.3.26
+  4.0.16

data/README.md

@@ -63,16 +63,16 @@ To check for code linting / formatting issues without fixing:
 You can also run `bin/console` for an interactive prompt that will allow you to
 experiment.
 
-### Managing CircleCI keys
+### Managing CI keys
 
-To encrypt a GPG key for use by CircleCI:
+To encrypt a GPG key for use by CI:
 
 ```shell
 openssl aes-256-cbc \
   -e \
   -md sha1 \
   -in ./config/secrets/ci/gpg.private \
-  -out ./.circleci/gpg.private.enc \
+  -out ./.github/gpg.private.enc \
   -k "<passphrase>"
 ```
 
@@ -82,7 +82,7 @@ To check decryption is working correctly:
 openssl aes-256-cbc \
   -d \
   -md sha1 \
-  -in ./.circleci/gpg.private.enc \
+  -in ./.github/gpg.private.enc \
   -k "<passphrase>"
 ```
 

data/Rakefile

@@ -1,15 +1,13 @@
 # frozen_string_literal: true
 
-require 'rake_circle_ci'
 require 'rake_git'
 require 'rake_git_crypt'
 require 'rake_github'
 require 'rake_gpg'
-require 'rake_ssh'
+require 'rake_slack'
 require 'rspec/core/rake_task'
 require 'rubocop/rake_task'
 require 'securerandom'
-require 'yaml'
 require 'yard'
 
 task default: %i[
@@ -60,13 +58,6 @@ namespace :encryption do
 end
 
 namespace :keys do
-  namespace :deploy do
-    RakeSSH.define_key_tasks(
-      path: 'config/secrets/ci/',
-      comment: 'maintainers@infrablocks.io'
-    )
-  end
-
   namespace :gpg do
     RakeGPG.define_generate_key_task(
       output_directory: 'config/secrets/ci',
@@ -92,7 +83,6 @@ namespace :secrets do
   desc 'Generate all generatable secrets.'
   task generate: %w[
     encryption:passphrase:generate
-    keys:deploy:generate
     keys:gpg:generate
   ]
 
@@ -121,6 +111,11 @@ namespace :library do
 
   desc 'Attempt to automatically fix issues with the library'
   task fix: [:'rubocop:autocorrect_all']
+
+  desc 'Build the library'
+  task :build do
+    sh 'gem build enruby.gemspec'
+  end
 end
 
 namespace :documentation do
@@ -135,7 +130,7 @@ namespace :documentation do
 
     sh('git', 'commit',
        '-a',
-       '-m', "Generate latest documentation#{skip_ci ? ' [ci skip]' : ''}")
+       '-m', "Generate latest documentation#{' [ci skip]' if skip_ci}")
   end
 
   desc 'Update documentation'
@@ -146,51 +141,95 @@ namespace :test do
   RSpec::Core::RakeTask.new(:unit)
 end
 
-RakeCircleCI.define_project_tasks(
-  namespace: :circle_ci,
-  project_slug: 'github/infrablocks/enruby'
-) do |t|
-  circle_ci_config =
-    YAML.load_file('config/secrets/circle_ci/config.yaml')
-
-  t.api_token = circle_ci_config['circle_ci_api_token']
-  t.environment_variables = {
-    ENCRYPTION_PASSPHRASE:
-        File.read('config/secrets/ci/encryption.passphrase')
-            .chomp
-  }
-  t.checkout_keys = []
-  t.ssh_keys = [
-    {
-      hostname: 'github.com',
-      private_key: File.read('config/secrets/ci/ssh.private')
-    }
-  ]
+def gh_auth_token
+  `gh auth token`
+rescue Errno::ENOENT
+  ''
+end
+
+def resolve_github_token
+  # Operator's ambient auth. Resolve once and fail fast: a missing,
+  # unauthenticated, or absent gh yields an empty string, which would
+  # otherwise surface later as an opaque Octokit 401. An empty or
+  # whitespace-only GITHUB_TOKEN is treated as absent so an authenticated
+  # operator falls through to `gh auth token` rather than hitting the raise.
+  token = ENV['GITHUB_TOKEN'].to_s.strip
+  token = gh_auth_token.strip if token.empty?
+  if token.empty?
+    raise 'No GitHub token available: set GITHUB_TOKEN or run `gh auth login`'
+  end
+
+  token
+end
+
+def read_encryption_passphrase
+  # Guard against a locked clone: without it, File.read returns git-crypt
+  # ciphertext and github:secrets:ensure silently uploads garbage that only
+  # surfaces much later as an opaque GPG unlock failure in the release job.
+  path = 'config/secrets/ci/encryption.passphrase'
+  unless File.exist?(path)
+    raise "Passphrase file not found: #{path} — expected an unlocked clone"
+  end
+
+  passphrase = File.binread(path)
+  if passphrase.start_with?("\x00GITCRYPT")
+    raise 'encryption.passphrase is git-crypt ciphertext — unlock the clone'
+  end
+
+  passphrase.chomp
 end
 
 RakeGithub.define_repository_tasks(
   namespace: :github,
   repository: 'infrablocks/enruby'
 ) do |t|
-  github_config =
-    YAML.load_file('config/secrets/github/config.yaml')
-
-  t.access_token = github_config['github_personal_access_token']
-  t.deploy_keys = [
-    {
-      title: 'CircleCI',
-      public_key: File.read('config/secrets/ci/ssh.public')
-    }
+  t.access_token = resolve_github_token
+
+  # Actions store only: dependabot runs never reach the passphrase — the
+  # only pr.yaml job that unlocks git-crypt (prerelease) is guarded to
+  # same-repo human PRs.
+  t.secrets = [
+    { name: 'ENCRYPTION_PASSPHRASE', value: read_encryption_passphrase }
   ]
+  t.environments = [
+    { name: 'release',
+      reviewers: [{ team: 'maintainers' }] }
+  ]
+end
+
+namespace :slack do
+  RakeSlack.define_notification_tasks do |t|
+    t.bot_token = ENV.fetch('SLACK_BOT_TOKEN', nil)
+    t.routing_rules = [
+      { when: { type: 'on_hold' },
+        channel: 'C038EDCRSQJ', format: :on_hold },  # release
+      { when: { actor: 'dependabot[bot]', outcome: 'success' },
+        channel: 'C03N711HVDG', format: :success },  # builds-dependabot
+      { when: { actor: 'dependabot[bot]' },
+        channel: 'C03N711HVDG', format: :failure },  # builds-dependabot
+      { when: { outcome: 'success' },
+        channel: 'C023XUE76GH', format: :success },  # builds
+      # Failures go to builds, not team-dev (org default), to keep noise
+      # out of a popular channel while this pipeline beds in.
+      { when: {},
+        channel: 'C023XUE76GH', format: :failure } # builds
+    ]
+  end
+end
+
+namespace :repository do
+  desc 'Set the git author for CI'
+  task :set_ci_author do
+    sh 'git config --global user.name "InfraBlocks CI"'
+    sh 'git config --global user.email "ci@infrablocks.io"'
+  end
 end
 
 namespace :pipeline do
-  desc 'Prepare CircleCI Pipeline'
+  desc 'Prepare GitHub Actions pipeline'
   task prepare: %i[
-    circle_ci:env_vars:ensure
-    circle_ci:checkout_keys:ensure
-    circle_ci:ssh_keys:ensure
-    github:deploy_keys:ensure
+    github:secrets:ensure
+    github:environments:ensure
   ]
 end
 
@@ -201,6 +240,38 @@ namespace :version do
   end
 end
 
+namespace :prerelease do
+  desc 'Build and push a namespaced pre-release to RubyGems ' \
+       '(PR CI only; no bump, no tag, no commit, no push)'
+  task :publish, %i[pr_number run_number run_attempt] do |_, args|
+    %i[pr_number run_number run_attempt].each do |name|
+      raise "Missing task argument: #{name}" if args[name].to_s.empty?
+    end
+
+    version_file = 'lib/enruby/version.rb'
+    version_pattern = /(VERSION\s*=\s*')([^']+)(')/
+    source = File.read(version_file)
+    base = source[version_pattern, 2]
+    raise "Could not read VERSION from #{version_file}" unless base
+
+    version = "#{base}.pr#{args.pr_number}" \
+              ".#{args.run_number}.#{args.run_attempt}"
+    gem_file = "enruby-#{version}.gem"
+    begin
+      File.write(version_file,
+                 source.sub(version_pattern, "\\1#{version}\\3"))
+      # Build + push directly: `gem release` aborts on the (deliberately)
+      # uncommitted version rewrite. PR CI must not tag, commit, or push
+      # (contrast the `release` task).
+      sh 'gem build enruby.gemspec'
+      sh "gem push #{gem_file}"
+    ensure
+      File.write(version_file, source)
+      rm_f gem_file
+    end
+  end
+end
+
 desc 'Release gem'
 task :release do
   sh 'gem release --tag --push'

data/enruby.gemspec

@@ -35,10 +35,10 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 3.1'
+  spec.required_ruby_version = '>= 3.3'
 
   spec.add_dependency 'immutable-struct', '~> 2.4'
-  spec.add_dependency 'lino', '>= 3', '< 5'
+  spec.add_dependency 'lino', '>= 4.1'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'faker'
@@ -46,12 +46,11 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard'
   spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rake_circle_ci'
   spec.add_development_dependency 'rake_git'
   spec.add_development_dependency 'rake_git_crypt'
   spec.add_development_dependency 'rake_github'
   spec.add_development_dependency 'rake_gpg'
-  spec.add_development_dependency 'rake_ssh'
+  spec.add_development_dependency 'rake_slack'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-rake'

data/lib/enruby/command/base.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+require 'lino'
+require 'tempfile'
+
+module Enruby
+  module Command
+    class Base
+      # rubocop:disable Metrics/AbcSize
+
+      def initialize(opts = {})
+        @binary = opts[:binary] || configuration.binary
+        @logger = opts[:logger] || configuration.logger
+        @options = opts[:options] || configuration.options
+        @stdin = opts[:stdin] || configuration.stdin
+        @stdout = opts[:stdout] || configuration.stdout
+        @stderr = opts[:stderr] || configuration.stderr
+      end
+
+      # rubocop:enable Metrics/AbcSize
+
+      # Executes the command instance.
+      #
+      # @param [Hash<String, Object>] parameters The parameters used to
+      #   invoke the command. See subclass documentation for details of
+      #   supported options.
+      # @param [Hash<String, Object>] invocation_options Additional options
+      #   controlling the invocation of the command.
+      # @option invocation_options [Hash<String, String>] :environment A map
+      #   of environment variables to expose at command invocation time.
+      def execute(parameters = {}, invocation_options = {})
+        parameters = resolve_parameters(parameters)
+        invocation_options = resolve_invocation_options(invocation_options)
+
+        do_before(parameters)
+        result = build_and_execute_command(parameters, invocation_options)
+        do_after(parameters)
+
+        prepare_result(result, parameters, invocation_options)
+      rescue Lino::Errors::ExecutionError
+        message = "Failed while running '#{command_name}'."
+        logger.error(message)
+        raise Errors::ExecutionError, message
+      end
+
+      private
+
+      attr_reader :binary, :logger, :stdin, :stdout, :stderr
+
+      def command_name
+        self.class.to_s.split('::')[-1].downcase
+      end
+
+      def do_before(_parameters); end
+
+      def do_after(_parameters); end
+
+      def build_command(parameters, invocation_options)
+        Lino::CommandLineBuilder
+          .for_command(@binary)
+          .with_environment_variables(invocation_options[:environment] || {})
+          .with_options_after_subcommands
+          .with_option_separator('=')
+          .with_appliables(@options.resolve(options, parameters))
+          .with_subcommands(subcommands)
+          .with_arguments(arguments(parameters).compact.flatten)
+          .build
+      end
+
+      def process_result(result, _parameters, _invocation_options)
+        result
+      end
+
+      def parameter_defaults(_parameters)
+        {}
+      end
+
+      def parameter_overrides(_parameters)
+        {}
+      end
+
+      def invocation_option_defaults(_invocation_options)
+        { capture: [], result: :processed }
+      end
+
+      def subcommands
+        []
+      end
+
+      def options
+        []
+      end
+
+      def arguments(_parameters)
+        []
+      end
+
+      def build_and_execute_command(parameters, invocation_options)
+        command = build_command(parameters, invocation_options)
+        stdout = resolve_stdout(invocation_options)
+        stderr = resolve_stderr(invocation_options)
+
+        logger.debug("Running '#{command}'.")
+        command.execute(stdin:, stdout:, stderr:)
+
+        process_streams(invocation_options, stdout, stderr)
+      end
+
+      def resolve_parameters(parameters)
+        parameter_defaults(parameters)
+          .merge(parameters)
+          .merge(parameter_overrides(parameters))
+      end
+
+      def resolve_invocation_options(invocation_options)
+        invocation_option_defaults(invocation_options)
+          .merge(invocation_options)
+      end
+
+      def resolve_stdout(invocation_options)
+        invocation_options[:capture].include?(:stdout) ? Tempfile.new : @stdout
+      end
+
+      def resolve_stderr(invocation_options)
+        invocation_options[:capture].include?(:stderr) ? Tempfile.new : @stderr
+      end
+
+      def process_streams(invocation_options, stdout, stderr)
+        cap = invocation_options[:capture]
+
+        return nil if cap == []
+
+        result = {}
+        result = add_contents_to_result(cap, result, :stdout, stdout, :output)
+        add_contents_to_result(cap, result, :stderr, stderr, :error)
+      end
+
+      def add_contents_to_result(capture, result, stream_name, stream, type)
+        return result unless capture.include?(stream_name)
+
+        stream.rewind
+        result.merge({ type => stream.read })
+      end
+
+      def prepare_result(result, parameters, invocation_options)
+        return result if invocation_options[:result] == :raw
+
+        process_result(result, parameters, invocation_options)
+      end
+    end
+  end
+end

data/lib/enruby/command.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'command/base'
+
+module Enruby
+  module Command
+  end
+end

data/lib/enruby/configuration/base.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'mixins'
+
+module Enruby
+  module Configuration
+    class Base
+      include Mixins::Streams
+      include Mixins::Logging
+      include Mixins::Binary
+    end
+  end
+end

data/lib/enruby/configuration/mixins/binary.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+module Enruby
+  module Configuration
+    module Mixins
+      module Binary
+        attr_accessor :binary
+
+        def initialize
+          super
+          @binary = default_binary
+        end
+
+        private
+
+        def default_binary
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/enruby/configuration/mixins/logging.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+module Enruby
+  module Configuration
+    module Mixins
+      module Logging
+        attr_accessor :logger
+
+        def initialize
+          super
+          @logger = default_logger
+        end
+
+        def default_logger
+          logger = Logger.new($stdout)
+          logger.level = Logger::INFO
+          logger
+        end
+      end
+    end
+  end
+end

data/lib/enruby/configuration/mixins/streams.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Enruby
+  module Configuration
+    module Mixins
+      module Streams
+        attr_accessor :stdin, :stdout, :stderr
+
+        def initialize
+          super
+          @stdin = nil
+          @stdout = $stdout
+          @stderr = $stderr
+        end
+      end
+    end
+  end
+end

data/lib/enruby/configuration/mixins.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative 'mixins/streams'
+require_relative 'mixins/logging'
+require_relative 'mixins/binary'
+
+module Enruby
+  module Configuration
+    module Mixins
+    end
+  end
+end

data/lib/enruby/configuration.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'configuration/base'
+
+module Enruby
+  module Configuration
+  end
+end

data/lib/enruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Enruby
-  VERSION = '0.1.0.pre.3'
+  VERSION = '0.1.0.pre.3.pr80.1.1'
 end

data/lib/enruby.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative 'enruby/version'
+require_relative 'enruby/command'
+require_relative 'enruby/configuration'
 
 module Enruby
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: enruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.3
+  version: 0.1.0.pre.3.pr80.1.1
 platform: ruby
 authors:
 - InfraBlocks Maintainers
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-26 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: immutable-struct
@@ -30,20 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '5'
+        version: '4.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -128,20 +122,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake_circle_ci
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake_git
   requirement: !ruby/object:Gem::Requirement
@@ -199,7 +179,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake_ssh
+  name: rake_slack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -327,13 +307,21 @@ files:
 - bin/setup
 - enruby.gemspec
 - lib/enruby.rb
+- lib/enruby/command.rb
+- lib/enruby/command/base.rb
+- lib/enruby/configuration.rb
+- lib/enruby/configuration/base.rb
+- lib/enruby/configuration/mixins.rb
+- lib/enruby/configuration/mixins/binary.rb
+- lib/enruby/configuration/mixins/logging.rb
+- lib/enruby/configuration/mixins/streams.rb
 - lib/enruby/version.rb
 homepage: https://github.com/infrablocks/enruby
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'false'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -341,15 +329,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.3.26
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: A framework for creating Ruby command line tool wrappers.
 test_files: []