wslc-wip 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aacee07e7929d736a13e1a7a4812a52155431b311913a4e5fa25409f6c772f60
-  data.tar.gz: 31de690c5b1040a9d0cb0c12890f20cf8d07f1d3d57e74d44140d8af30d7e0f0
+  metadata.gz: c1e6e4afaf5e33e69fa5dd6dc35f4fc32695e9916b0ceeac998ae58334fab3d4
+  data.tar.gz: 56e438283cad62937ac37132bb49048a1159897de4d3058c122f14272bca9e68
 SHA512:
-  metadata.gz: 13e7a7c473c92063c6c9bc505ea72b03a8fab8269a6deb0ae2f27fb6309a2848477257b3d759b917eb2e6ddf86dc3b3144fbb98031e6548ece4ae2eaf14f166e
-  data.tar.gz: 494a24787a32f87479e8c984617e1928c54b43864b9a247da042281b138cd48795970e05ebb69b9805b31a8dd239a0c190f5554f9f427b29f81c1b9a42b669d9
+  metadata.gz: 29bfbc9430132bf62ae58813e333f64df00d9228ad98386f3374e3a0de897e55605b977d7208bf7ce9622957e0a3acd1d598e25f25a594eed839fc7007deb37d
+  data.tar.gz: 8588e1b97851a59936bb42daf6a8d09002e1c3fdba12dafba0a35bfe8a1c9e430742bee1b8f818a677b83cc793f6b96151be1d729f7465632c3c368d9b518cd8

data/README.md

@@ -1,43 +1,56 @@
 # wip
 
-`wip` は、Docker 開発環境 CLI の dip に近い操作感を Microsoft WSLC に提供する Ruby 製 OSS CLI ラッパーです。プロジェクト固有のコンテナ、イメージ、環境変数やコマンドを `wip.yml` にまとめ、安全な引数配列として `wslc.exe` / `wslc` に渡します。
+[![Tests](https://github.com/slidict/wip/actions/workflows/test.yml/badge.svg)](https://github.com/slidict/wip/actions/workflows/test.yml)
+[![Gem Version](https://img.shields.io/gem/v/wslc-wip.svg)](https://rubygems.org/gems/wslc-wip)
+[![License: MIT](https://img.shields.io/github/license/slidict/wip.svg)](LICENSE)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2-red.svg)](wslc-wip.gemspec)
 
-> **Status:** 初期リリース 0.1.0。WSLC 自体の仕様変更に追随が必要になる可能性があります。
+`wip` is a Ruby-built OSS CLI wrapper that brings a [`dip`](https://github.com/bibendi/dip)-like
+workflow to Microsoft WSLC. It collects a project's container, image, environment variables, and
+commands into a single `wip.yml`, and forwards them to `wslc.exe` / `wslc` as safe argument arrays
+(no shell interpolation).
 
-## 対応環境とインストール
+![wip demo](https://raw.githubusercontent.com/slidict/wip/main/docs/demo.gif)
 
-Ruby 3.2 以上、WSL2、および Microsoft WSLC が必要です。RubyGems 公開後は次で導入できます。
+> **Status:** early release. Expect to track WSLC's own interface as it evolves.
+
+## Requirements & installation
+
+Ruby 3.2+, WSL2, and Microsoft WSLC.
 
 ```bash
-gem install wip
+gem install wslc-wip
 ```
 
-ソースからは `bundle install && bundle exec exe/wip version` を使用します。
+From source: `bundle install && bundle exec exe/wip version`.
 
-## クイックスタート
+## Quick start
 
 ```bash
-gem install wip
+gem install wslc-wip
 cd my-project
 wip doctor
 wip build
+wip up -d
 wip rails console
 ```
 
-## 完全な設定例
+## Full configuration example
 
-プロジェクトルートに `wip.yml` を置きます。子ディレクトリから実行しても親方向へ探索され、`--config PATH` で明示指定もできます。
+Put a `wip.yml` in your project root. Running from a subdirectory walks up to find it, or pass
+`--config PATH` to point at one explicitly.
 
 ```yaml
 version: 1
 wslc:
-  command: auto # wslc.exe、wslc、System32 の順。絶対パスも指定可能
+  command: auto # tries wslc.exe, wslc, then System32; an absolute path also works
 defaults:
   container: app
   image: slidict/slidict:development
   workdir: /app
   interactive: false
   remove: true
+  network: app-tier # optional; shared with `dependencies` so containers can resolve each other by name
   env:
     RAILS_ENV: development
     PORT: "3000"
@@ -46,7 +59,17 @@ defaults:
   volumes:
     - ".:/app"
 up:
-  command: server # `wip up` がコンテナ作成時にイメージへ渡す常駐コマンド（未指定ならイメージの既定 CMD）
+  command: server # command `wip up` passes to the image when it creates the container
+                   # (omit to use the image's default CMD)
+dependencies:
+  redis:
+    image: redis:latest
+  development.mysql:
+    image: mysql:8.0
+    command: --default-authentication-plugin=mysql_native_password
+    env:
+      MYSQL_ROOT_PASSWORD: password
+      MYSQL_DATABASE: development
 commands:
   rails:
     type: exec
@@ -74,46 +97,63 @@ commands:
     tag: slidict/slidict:development
 ```
 
-`env` の値は文字列化されます。`config` の表示では token、password、secret、credential、auth を含むキーを伏せます。秘密値は可能なら設定ファイルではなく実行環境側で管理してください。
+`env` values are stringified. `wip config` masks any key matching token, password, secret,
+credential, or auth. Keep real secrets out of the config file and in your runtime environment
+instead.
+
+### Dependency containers
 
-## コマンド
+If your app needs sidecar services (a database, Redis, ...), declare them under `dependencies`
+and set `defaults.network`. `wip up` creates the network first (if it doesn't exist), then brings
+up each dependency by name before the main container — so `bin/rails c` (or anything else run
+inside the main container) can reach `development.mysql`/`redis`/etc. by their dependency name,
+the same way Compose's service names resolve. `wip down` tears the main container and all
+dependencies down (the network itself is left in place). Each dependency entry accepts `image`
+(required), `command`, `env`, `ports`, `volumes`, and `workdir` — the same shape as `defaults`.
 
-| コマンド | 説明 |
+## Commands
+
+| Command | Description |
 |---|---|
-| `wip version` | wip と、検出できた WSLC のバージョン |
-| `wip doctor` | WSL2、相互運用、WSLC、設定、アーキテクチャ、Git を診断 |
-| `wip config` | デフォルト適用済み設定（秘密値をマスク） |
-| `wip build -- --no-cache` | build 定義でイメージをビルド |
-| `wip up [-d]` | `defaults.container` を起動（無ければ `up.command` 付きで作成）。`-d` でバックグラウンド実行 |
-| `wip down` | `defaults.container` を停止・削除 |
-| `wip exec [--no-interactive] COMMAND...` | 既存コンテナ内で実行 |
-| `wip run [--no-interactive] COMMAND...` | `--rm` の新規コンテナで実行 |
-| `wip shell` | 定義済み shell、または `bash`、`sh` の順に起動 |
-| `wip NAME ARGS...` | `commands.NAME` を実行し、引数を末尾に追加 |
-
-TTY はコマンド設定、CLI オプション、標準入出力が双方 TTY かを合わせて判定します。`WIP_DEBUG=1` では `Shellwords.join` した実行コマンドを表示します。
+| `wip version` | wip's version, plus WSLC's if it can be detected |
+| `wip doctor` | Diagnose WSL2, interop, WSLC, config, architecture, and Git |
+| `wip config` | Print the effective configuration (secrets masked) |
+| `wip build -- --no-cache` | Build the image from the `build` definition |
+| `wip up [-d]` | Start `defaults.container` and its `dependencies` (creating any that are missing, on `defaults.network` if set). `-d` runs the main container in the background |
+| `wip down` | Stop and remove `defaults.container` and its `dependencies` |
+| `wip exec [--no-interactive] COMMAND...` | Run a command in the existing container |
+| `wip run [--no-interactive] COMMAND...` | Run a command in a new `--rm` container |
+| `wip shell` | Open the configured shell, falling back to `bash` then `sh` |
+| `wip NAME ARGS...` | Run `commands.NAME`, appending any extra arguments |
+
+TTY allocation is decided by combining the command's config, the CLI option, and whether both
+stdin and stdout are real TTYs. Set `WIP_DEBUG=1` to print the `Shellwords`-joined command before
+running it.
 
 ## doctor
 
-`[OK]`、`[WARN]`、`[FAIL]` で各診断を表示します。警告だけなら終了コード 0、WSL2/相互運用/WSLC/設定など実行を妨げる問題があれば 1 です。実際のビルド環境から Git が見えない場合は警告になります。
+Each check prints as `[OK]`, `[WARN]`, or `[FAIL]`. Warnings alone exit 0; a WSL2, interop, WSLC,
+or config problem that blocks execution exits 1. Git being unreachable from the real build
+environment is only a warning.
 
-## よくあるエラー
+## Common errors
 
-### WSLC がない
+### WSLC not found
 
-WSLC/WSL コンテナツールをインストールまたは更新し、`wip doctor` を実行してください。`auto` は `wslc.exe`、`wslc`、`/mnt/c/Windows/System32/wslc.exe` の順で探します。
+Install or update the WSL container tooling, then run `wip doctor`. `auto` looks for `wslc.exe`,
+`wslc`, then `/mnt/c/Windows/System32/wslc.exe`, in that order.
 
-### Docker Hub の認証
+### Docker Hub authentication
 
-`pull access denied` 等を検出するとログイン方法を補足します。
+When `pull access denied` (or similar) is detected, wip suggests how to log in:
 
 ```bash
 wslc registry login -u <username> docker.io
 ```
 
-### CPU アーキテクチャ不一致
+### CPU architecture mismatch
 
-イメージを確認し、amd64/arm64 のマルチアーキテクチャイメージを公開します。
+Check the image and publish a multi-arch (amd64/arm64) image:
 
 ```bash
 docker buildx imagetools inspect <image>
@@ -123,10 +163,10 @@ docker buildx build \
   --push .
 ```
 
-## 開発
+## Development
 
 ```bash
-git clone <repository-url>
+git clone https://github.com/slidict/wip.git
 cd wip
 bundle install
 bundle exec rspec
@@ -134,11 +174,21 @@ bundle exec rubocop
 bundle exec rake
 ```
 
-テストは WSLC を必要とせず、解決・構築・実行層を差し替え可能にしています。GitHub Actions は Ruby 3.2、3.3、3.4 で RSpec と RuboCop を実行します。
+The test suite doesn't need WSLC — the resolution, build, and execution layers are all
+swappable. GitHub Actions runs RSpec and RuboCop on Ruby 3.2, 3.3, 3.4, and 4.0.
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/slidict/wip). See
+[CONTRIBUTING.md](CONTRIBUTING.md) for commit conventions, versioning policy, and the PR
+checklist.
 
-## 初期リリースに含まれないもの
+## Not in the initial release
 
-Compose 互換、常駐プロセス、GUI、PowerShell 最適化、レジストリ API/manifest の直接解析、自動更新、プラグインは未実装です。将来は設定スキーマ、ライフサイクルフック、複数コンテナ、プラットフォーム選択、より詳細な診断の追加が有用です。
+Full Compose compatibility (multiple networks, `depends_on` ordering/health checks, profiles), a
+resident/daemon process, a GUI, PowerShell-specific tuning, direct registry API/manifest parsing,
+self-update, and plugins are all unimplemented. Likely future additions: a richer config schema,
+lifecycle hooks, platform selection, and more detailed diagnostics.
 
 ## License
 

data/lib/wip/cli.rb

@@ -2,6 +2,8 @@
 
 require 'thor'
 require 'yaml'
+require 'json'
+require 'stringio'
 
 module Wip
   # Thor-based command-line interface for wip.
@@ -51,40 +53,53 @@ module Wip
       execute(builder.build(settings: load_config.command('build') || {}, extra: extra))
     end
 
-    desc 'up', 'Start the configured container, creating it if necessary'
+    desc 'up', 'Start the configured container and its dependencies, creating them if necessary'
     option :detach, type: :boolean, default: false, aliases: '-d'
     def up
-      code = execute(builder.start(detach: options[:detach]), exit_on_failure: false)
-      execute(builder.up(detach: options[:detach])) if code != 0
+      ensure_network
+      load_config.dependencies.each_key { |name| ensure_dependency(name) }
+      ensure_container
     end
 
-    desc 'down', 'Stop and remove the configured container'
+    desc 'down', 'Stop and remove the configured container and its dependencies'
     def down
       execute(builder.down, exit_on_failure: false)
       execute(builder.remove, exit_on_failure: false)
+      load_config.dependencies.each_key do |name|
+        execute(builder.dependency_down(name), exit_on_failure: false)
+        execute(builder.dependency_remove(name), exit_on_failure: false)
+      end
     end
 
     desc 'exec COMMAND...', 'Execute a command in the running container'
     option :interactive, type: :boolean, default: true
     def exec(*command)
-      execute(builder.exec(command, interactive: options[:interactive]))
+      tty = builder.tty?(options[:interactive])
+      execute(builder.exec(command, interactive: options[:interactive]), interactive: tty)
     end
 
     desc 'run COMMAND...', 'Run a command in a new container'
     option :interactive, type: :boolean, default: true
     def run_command(*command)
-      execute(builder.run(command, interactive: options[:interactive]))
+      tty = builder.tty?(options[:interactive])
+      execute(builder.run(command, interactive: options[:interactive]), interactive: tty)
     end
     map 'run' => :run_command
 
     desc 'shell', 'Open a shell in the configured container'
     def shell_command
       configured = load_config.command('shell')
-      return execute(builder.custom('shell', [])) if configured
+      if configured
+        tty = builder.tty?(configured.fetch('interactive', false))
+        return execute(builder.custom('shell', []), interactive: tty)
+      end
 
+      tty = builder.tty?(true)
       code = execute(builder.exec(['bash'], settings: { 'interactive' => true }, interactive: true),
-                     exit_on_failure: false)
-      execute(builder.exec(['sh'], settings: { 'interactive' => true }, interactive: true)) if code != 0
+                     interactive: tty, exit_on_failure: false)
+      return if code.zero?
+
+      execute(builder.exec(['sh'], settings: { 'interactive' => true }, interactive: true), interactive: tty)
     end
     map 'shell' => :shell_command
 
@@ -92,7 +107,8 @@ module Wip
     def dispatch(name = nil, *arguments)
       raise ConfigError, 'A command is required' unless name
 
-      execute(builder.custom(name, arguments))
+      values = load_config.command(name) || raise(ConfigError, "Unknown command: #{name}")
+      execute(builder.custom(name, arguments), interactive: builder.tty?(values.fetch('interactive', false)))
     end
 
     private
@@ -102,10 +118,59 @@ module Wip
     def resolver = CommandResolver.new
     def builder = CommandBuilder.new(wslc: resolver.resolve(load_config.wslc_command), config: load_config)
 
-    def execute(command, exit_on_failure: true)
-      code = CommandRunner.new.run(command)
+    def execute(command, interactive: false, exit_on_failure: true)
+      code = CommandRunner.new.run(command, interactive: interactive)
       exit(code) if exit_on_failure && !code.zero?
       code
     end
+
+    def resource_exists?(find_command)
+      out = StringIO.new
+      code = CommandRunner.new(stdout: out, stderr: StringIO.new).run(find_command)
+      code.zero? && !JSON.parse(out.string).empty?
+    rescue JSON::ParserError
+      false
+    end
+
+    def ensure_network
+      network = load_config.network
+      return unless network
+      return if network_exists?(network)
+
+      warn "wip: creating network '#{network}'"
+      execute(builder.network_create, exit_on_failure: false)
+    end
+
+    def network_exists?(network)
+      out = StringIO.new
+      code = CommandRunner.new(stdout: out, stderr: StringIO.new).run(builder.network_list)
+      return false unless code.zero?
+
+      JSON.parse(out.string).any? { |entry| entry['Name'] == network }
+    rescue JSON::ParserError
+      false
+    end
+
+    def ensure_dependency(name)
+      if resource_exists?(builder.dependency_find(name))
+        warn "wip: starting existing dependency '#{name}'"
+        execute(builder.dependency_start(name))
+      else
+        warn "wip: dependency '#{name}' not found, creating it"
+        execute(builder.dependency_up(name))
+      end
+    end
+
+    def ensure_container
+      container = load_config.defaults['container']
+      interactive = builder.tty?(!options[:detach])
+      if resource_exists?(builder.find)
+        warn "wip: starting existing container '#{container}'"
+        execute(builder.start(detach: options[:detach]), interactive: interactive)
+      else
+        warn "wip: container '#{container}' not found, creating it"
+        execute(builder.up(detach: options[:detach]), interactive: interactive)
+      end
+    end
   end
 end

data/lib/wip/command_builder.rb

@@ -29,6 +29,7 @@ module Wip
     def up(detach: false)
       values = @config.defaults
       command = [@wslc, 'run', '--name', required(values, 'container')]
+      command.push('--network', @config.network) if @config.network
       command << '-d' if detach
       command << '-it' if !detach && tty?(true)
       command.concat(options(values)).push(required(values, 'image'))
@@ -42,6 +43,11 @@ module Wip
       command
     end
 
+    def find
+      container = required(@config.defaults, 'container')
+      [@wslc, 'list', '--all', '--filter', "name=#{container}", '--format', 'json']
+    end
+
     def down
       [@wslc, 'stop', required(@config.defaults, 'container')]
     end
@@ -50,6 +56,40 @@ module Wip
       [@wslc, 'remove', '-f', required(@config.defaults, 'container')]
     end
 
+    def network_create
+      [@wslc, 'network', 'create', required_network]
+    end
+
+    def network_list
+      [@wslc, 'network', 'list', '--format', 'json']
+    end
+
+    def dependency_up(name, detach: true)
+      values = dependency_values(name)
+      command = [@wslc, 'run', '--name', name.to_s]
+      command.push('--network', @config.network) if @config.network
+      command << '-d' if detach
+      command.concat(options(values)).push(required(values, 'image'))
+      command.concat(Shellwords.split(values['command'].to_s)) unless values['command'].to_s.empty?
+      command
+    end
+
+    def dependency_start(name)
+      [@wslc, 'start', name.to_s]
+    end
+
+    def dependency_find(name)
+      [@wslc, 'list', '--all', '--filter', "name=#{name}", '--format', 'json']
+    end
+
+    def dependency_down(name)
+      [@wslc, 'stop', name.to_s]
+    end
+
+    def dependency_remove(name)
+      [@wslc, 'remove', '-f', name.to_s]
+    end
+
     def build(settings:, extra: [])
       values = @config.defaults.merge(settings)
       context = values['context'] || '.'
@@ -68,6 +108,8 @@ module Wip
       public_send(type, base + arguments, settings: values, interactive: values.fetch('interactive', false))
     end
 
+    def tty?(requested) = requested && @environment.interactive?
+
     private
 
     def options(values, include_container: false, include_publish: true)
@@ -89,6 +131,15 @@ module Wip
       value
     end
 
-    def tty?(requested) = requested && @environment.interactive?
+    def required_network
+      network = @config.network
+      raise ConfigError, 'Configured network must not be empty' if network.to_s.empty?
+
+      network
+    end
+
+    def dependency_values(name)
+      @config.dependency(name) || raise(ConfigError, "Unknown dependency: #{name}")
+    end
   end
 end

data/lib/wip/command_runner.rb

@@ -13,8 +13,10 @@ module Wip
       @interpreter = interpreter
     end
 
-    def run(command, env: {})
+    def run(command, env: {}, interactive: false)
       @stderr.puts "+ #{Shellwords.join(command)}" if ENV['WIP_DEBUG']
+      return run_attached(command, env) if interactive
+
       captured = +''
       status = nil
       Open3.popen3(env, *command) do |input, output, error, wait|
@@ -33,6 +35,19 @@ module Wip
 
     private
 
+    # Piping stdin/stdout/stderr (as `run` does above) closes the child's
+    # stdin immediately, which breaks anything that reads from the terminal
+    # (a shell, `rails console`, ...). Inherit the real file descriptors
+    # instead so the child gets a genuine TTY.
+    def run_attached(command, env)
+      pid = Process.spawn(env, *command)
+      _, status = Process.wait2(pid)
+      status.exitstatus
+    rescue Errno::ENOENT => e
+      @stderr.puts e.message
+      127
+    end
+
     def pump(source, destination, captured)
       Thread.new do
         source.each(4096) do |chunk|

data/lib/wip/config.rb

@@ -18,6 +18,8 @@ module Wip
     def commands = @raw['commands'] || {}
     def defaults = DEFAULTS.merge(@raw['defaults'] || {})
     def up_command = @raw.dig('up', 'command')
+    def dependencies = @raw['dependencies'] || {}
+    def network = defaults['network']
 
     def command(name)
       entry = commands[name.to_s]
@@ -26,9 +28,16 @@ module Wip
       defaults.merge('type' => 'exec').merge(entry)
     end
 
+    def dependency(name)
+      entry = dependencies[name.to_s]
+      return unless entry
+
+      { 'workdir' => nil, 'env' => {}, 'ports' => [], 'volumes' => [] }.merge(entry)
+    end
+
     def to_h(redact: true)
       value = { 'version' => 1, 'wslc' => { 'command' => wslc_command }, 'defaults' => defaults,
-                'up' => { 'command' => up_command },
+                'up' => { 'command' => up_command }, 'dependencies' => dependencies,
                 'commands' => commands.transform_values { |entry| defaults.merge('type' => 'exec').merge(entry) } }
       redact ? redact_secrets(value) : value
     end
@@ -37,12 +46,24 @@ module Wip
 
     def validate!
       raise ConfigError, "Unsupported configuration version: #{@raw['version']}" unless (@raw['version'] || 1) == 1
-      raise ConfigError, 'commands must be a mapping' unless commands.is_a?(Hash)
       raise ConfigError, 'up must be a mapping' if @raw.key?('up') && !@raw['up'].is_a?(Hash)
 
+      validate_commands!
+      validate_dependencies!
+    end
+
+    def validate_commands!
+      raise ConfigError, 'commands must be a mapping' unless commands.is_a?(Hash)
+
       commands.each { |name, entry| validate_command!(name, entry) }
     end
 
+    def validate_dependencies!
+      raise ConfigError, 'dependencies must be a mapping' unless dependencies.is_a?(Hash)
+
+      dependencies.each { |name, entry| validate_dependency!(name, entry) }
+    end
+
     def validate_command!(name, entry)
       raise ConfigError, "commands.#{name} must be a mapping" unless entry.is_a?(Hash)
 
@@ -52,6 +73,13 @@ module Wip
       entry['env']&.transform_values!(&:to_s)
     end
 
+    def validate_dependency!(name, entry)
+      raise ConfigError, "dependencies.#{name} must be a mapping" unless entry.is_a?(Hash)
+      raise ConfigError, "dependencies.#{name} must set image" if entry['image'].to_s.empty?
+
+      entry['env']&.transform_values!(&:to_s)
+    end
+
     def stringify(object)
       case object
       when Hash then object.to_h { |key, value| [key.to_s, stringify(value)] }

data/lib/wip/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Wip
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wslc-wip
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Wip contributors
@@ -44,11 +44,14 @@ files:
 - lib/wip/error_interpreter.rb
 - lib/wip/errors.rb
 - lib/wip/version.rb
-homepage: https://github.com/example/wip
+homepage: https://github.com/slidict/wip
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/slidict/wip
+  changelog_uri: https://github.com/slidict/wip/releases
+  bug_tracker_uri: https://github.com/slidict/wip/issues
 rdoc_options: []
 require_paths:
 - lib