lex-docker 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cfc6c9e230ea3f7eae802316ed21b5188f252ad70efa3033790c57097764c7e0
+  data.tar.gz: 0707ac874e590ee10f6134e76cef740a5a73f100c0e419d67df5031cfb434534
+SHA512:
+  metadata.gz: c7d3a9eb99f9a06720c51f7a72ce3ae8ac15fec6ddda5c988660d57b5ce7ec88ca55d9e17afc6e52a5669642256db309651889465e27c0e9b12e2831397265f7
+  data.tar.gz: 4585d38424b5083709fbcdb6faa70abde580318f46fbc02f649e61367e60c25e9a51b62c9cd0da15f566910395fabd0766e008729c518b0c4774275a4fd8cc0c

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,53 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
+Metrics/BlockLength:
+  Max: 40
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/ParameterLists:
+  Max: 10
+
+Metrics/AbcSize:
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 17
+
+Style/Documentation:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Naming/FileName:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2026-03-22
+
+### Added
+- Initial release
+- `Helpers::Client` — Docker API connection wrapper with configurable URL and timeouts
+- `Runners::Containers` — list_containers, create_container, start_container, stop_container, remove_container, container_logs
+- `Runners::Images` — list_images, pull_image, build_image, remove_image
+- `Runners::Networks` — list_networks, create_network
+- Standalone `Client` class for use outside the Legion framework

data/Gemfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'base64'
+gem 'docker-api', '~> 2.0'
+gem 'rake', '~> 12.0'
+gem 'rspec', '~> 3.0'
+gem 'rspec_junit_formatter'
+gem 'rubocop'
+gem 'rubocop-rspec'

data/lex-docker.gemspec

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/docker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-docker'
+  spec.version       = Legion::Extensions::Docker::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX::Docker'
+  spec.description   = 'Used to connect Legion to Docker'
+  spec.homepage      = 'https://github.com/LegionIO/lex-docker'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri']         = spec.homepage
+  spec.metadata['source_code_uri']      = 'https://github.com/LegionIO/lex-docker'
+  spec.metadata['changelog_uri']        = 'https://github.com/LegionIO/lex-docker/blob/main/CHANGELOG.md'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'base64'
+  spec.add_dependency 'docker-api', '~> 2.0'
+end

data/lib/legion/extensions/docker/client.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'helpers/client'
+require_relative 'runners/containers'
+require_relative 'runners/images'
+require_relative 'runners/networks'
+
+module Legion
+  module Extensions
+    module Docker
+      class Client
+        include Helpers::Client
+        include Runners::Containers
+        include Runners::Images
+        include Runners::Networks
+
+        attr_reader :opts
+
+        def initialize(**opts)
+          @opts = opts
+        end
+
+        def settings
+          { options: @opts }
+        end
+
+        def connection(**override)
+          super(**@opts, **override)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/docker/helpers/client.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'docker-api'
+
+module Legion
+  module Extensions
+    module Docker
+      module Helpers
+        module Client
+          module_function
+
+          def connection(**opts)
+            url = opts[:docker_url] || settings_value(:docker_url, 'unix:///var/run/docker.sock')
+            ::Docker.url = url
+            ::Docker.options = {
+              read_timeout:  opts.fetch(:read_timeout, 120),
+              write_timeout: opts.fetch(:write_timeout, 120)
+            }
+            ::Docker
+          end
+
+          def settings_value(key, default)
+            return default unless defined?(Legion::Settings)
+
+            settings = Legion::Settings[:'lex-docker']
+            settings.is_a?(Hash) ? settings.fetch(key, default) : default
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/docker/runners/containers.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Docker
+      module Runners
+        module Containers
+          def list_containers(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            ::Docker::Container.all(all: opts.fetch(:all, false))&.map(&:info)
+          end
+
+          def create_container(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            image  = opts.fetch(:image)
+            name   = opts[:name]
+            cmd    = opts[:cmd]
+            env    = opts[:env]
+            config = { 'Image' => image }
+            config['name'] = name if name
+            config['Cmd']  = cmd if cmd
+            config['Env']  = env if env
+            container = ::Docker::Container.create(config)
+            { container: container.info }
+          end
+
+          def start_container(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            container_id = opts.fetch(:container_id)
+            container = ::Docker::Container.get(container_id)
+            container.start
+            { started: true, container_id: container_id }
+          end
+
+          def stop_container(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            container_id = opts.fetch(:container_id)
+            timeout      = opts.fetch(:timeout, 10)
+            container = ::Docker::Container.get(container_id)
+            container.stop(t: timeout)
+            { stopped: true, container_id: container_id }
+          end
+
+          def remove_container(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            container_id = opts.fetch(:container_id)
+            force        = opts.fetch(:force, false)
+            container = ::Docker::Container.get(container_id)
+            container.remove(force: force)
+            { removed: true, container_id: container_id }
+          end
+
+          def container_logs(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            container_id = opts.fetch(:container_id)
+            tail         = opts.fetch(:tail, 'all')
+            timestamps   = opts.fetch(:timestamps, false)
+            container = ::Docker::Container.get(container_id)
+            logs = container.logs(stdout: true, stderr: true, tail: tail, timestamps: timestamps)
+            { logs: logs, container_id: container_id }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/docker/runners/images.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Docker
+      module Runners
+        module Images
+          def list_images(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            ::Docker::Image.all&.map(&:info)
+          end
+
+          def pull_image(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            repo = opts.fetch(:repo)
+            tag  = opts.fetch(:tag, 'latest')
+            image = ::Docker::Image.create('fromImage' => repo, 'tag' => tag)
+            { image: image.info }
+          end
+
+          def build_image(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            dir = opts.fetch(:dir)
+            t   = opts[:tag]
+            build_opts = {}
+            build_opts['t'] = t if t
+            image = ::Docker::Image.build_from_dir(dir, build_opts)
+            { image: image.info }
+          end
+
+          def remove_image(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            image_id = opts.fetch(:image_id)
+            force    = opts.fetch(:force, false)
+            image = ::Docker::Image.get(image_id)
+            image.remove(force: force)
+            { removed: true, image_id: image_id }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/docker/runners/networks.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Docker
+      module Runners
+        module Networks
+          def list_networks(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            ::Docker::Network.all&.map(&:info)
+          end
+
+          def create_network(**opts)
+            conn = opts.delete(:connection)
+            connection(**opts) unless conn
+            name   = opts.fetch(:name)
+            driver = opts.fetch(:driver, 'bridge')
+            config = { 'Name' => name, 'Driver' => driver }
+            network = ::Docker::Network.create(name, config)
+            { network: network.info }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/docker/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Docker
+      VERSION = '0.1.1'
+    end
+  end
+end

data/lib/legion/extensions/docker.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/docker/version'
+require 'legion/extensions/docker/helpers/client'
+require 'legion/extensions/docker/runners/containers'
+require 'legion/extensions/docker/runners/images'
+require 'legion/extensions/docker/runners/networks'
+require 'legion/extensions/docker/client'
+
+module Legion
+  module Extensions
+    module Docker
+      extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+    end
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: lex-docker
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Esity
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  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'
+description: Used to connect Legion to Docker
+email:
+- matthewdiverson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- lex-docker.gemspec
+- lib/legion/extensions/docker.rb
+- lib/legion/extensions/docker/client.rb
+- lib/legion/extensions/docker/helpers/client.rb
+- lib/legion/extensions/docker/runners/containers.rb
+- lib/legion/extensions/docker/runners/images.rb
+- lib/legion/extensions/docker/runners/networks.rb
+- lib/legion/extensions/docker/version.rb
+homepage: https://github.com/LegionIO/lex-docker
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/LegionIO/lex-docker
+  source_code_uri: https://github.com/LegionIO/lex-docker
+  changelog_uri: https://github.com/LegionIO/lex-docker/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: LEX::Docker
+test_files: []