jade_systems_toolbox 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34c1084f87c203c6d008d7c871bfeeeeba556d5208575df9a00c5c7e6c0f95a2
-  data.tar.gz: fa4ced1128644400b4bc691cbf9537570edf6246400dbea55a1944b2a3ec85a5
+  metadata.gz: 6e5e58dc71de22b037aab057b8a9205361a239590b6b844f438b59fdd771441f
+  data.tar.gz: 1b6a2766065ad815318eb62d463c3d5113ac3ed4b6e293c6aa883f6b3e174845
 SHA512:
-  metadata.gz: 9ad77d436e5dcdd4f8552bd19c60e53d253dd83daa1cba573c4e6a6f9c9a188ab15b5695e85a13612752e5a04acb624dd0c4e3a63a6342c3891c7efc3ee79c08
-  data.tar.gz: 303847847a630d6fdb089932957f7415ea163256c14ca728d163df3bfc64319037a7479acb81b127808119a95cccfedb796d36c97297ad0a5f36166869cbd95d
+  metadata.gz: 257d930928d5186d49415b1cc25b28122e5dada2753610ef3346ef39aa6174b01c89a43dfa567464caca71ea0c23982d9bb876e544e1fd4ae2fed4c4b29548e7
+  data.tar.gz: 51ea308a86ef16a12d8d2cb43dbe300558e3b97ed4aa0fe009834ad6c226121c58cc3e287639132f425f0d50ae2da3b907b9698349e9ec9775df551dd9eb28b6

data/README.md

@@ -3,7 +3,7 @@
 This gem installs a program to help do container-based development. It provides functions to:
 
 * Prepare a directory for development in containers, including some files to configure VScode.
-* Bring up the container(s).
+* Start the container(s).
 * Open VScode on the code in the container.
 * Open a browser window on the application-under-development's web server.
 * Open a terminal session on the application container.
@@ -29,7 +29,7 @@ gem install --user-install jade_systems_toolbox
 
 ```terminal
 Commands:
-  tool down -- COMPOSE_ARGS   # docker compose down. Deletes the container. You probably want stop.
+  tool down -- [COMPOSE_ARGS] # docker compose down. Deletes the container. You probably want stop.
   tool edit                   # devcontainer open
   tool exec COMMAND [ARGS]    # Run a command in the container and exit
   tool help [COMMAND]         # Describe available commands or one specific command
@@ -58,7 +58,7 @@ The broad steps to start a brand new project are:
 1. Create a directory for the project, and change directory into the new directory.
 1. Decide which container(s) you want to use.
 1. Initialize the container(s).
-1. Bring up the container(s).
+1. Start the container(s).
 1. Open a terminal session and create the application (e.g. `rails new` if you're doing a Rails project.)
 1. Run the editor and otherwise do what you need to do to create your project.
 1. When the web server is ready to run (if you're developing a web app), run the server.
@@ -85,7 +85,9 @@ tool init
 
 The initialization installs
 
-* A `compose.yml` file for Rails development with a SQLite database, using Ruby 3.4, and the `bookworm` version of Debian.
+* A `compose.yml` file for Rails development with a SQLite database, using the latest released version of Ruby,
+and the latest stable version of Debian.
+(Give or take. We don't track the releases so closely. Raise and issue if you need an upgrade.)
 * On Linux, a `compose.override.yml` file.
 * A `.devcontainer.json` file, so VScode can edit without the context of the container.
 * `.vscode/settings.json` and `vscode/extensions.json` so developers have a consistent experience in VScode (mostly linting and autoformatting).
@@ -130,8 +132,8 @@ You can add additional Docker Compose arguments to the command line. For example
 tool start --remove-orphans
 ```
 
-If any of the command's arguments are the same as any of `tool`'s arguments,
-separate the `exec` command from the rest of the command line with `--`,
+If any of the Docker Compose arguments are the same as any of `tool`'s arguments,
+separate the `start` command from the rest of the command line with `--`,
 like this: `tool start -- -v`.
 
 #### Open a Terminal Session
@@ -232,7 +234,7 @@ You can add additional Docker Compose arguments to the command line. For example
 tool stop --remove-orphans
 ```
 
-If any of the command's arguments are the same as any of `tool`'s arguments,
+If any of the Docker Compose arguments are the same as any of `tool`'s arguments,
 separate the `exec` command from the rest of the command line with `--`,
 like this: `tool stop -- -v`.
 
@@ -244,7 +246,7 @@ tool exec ls -l ..
 
 Some things to watch for:
 
-- If any of the command's arguments are the same as any of `tool`'s arguments,
+- If any of the Docker Compose arguments are the same as any of `tool`'s arguments,
 separate the `exec` command from the rest of the command line with `--`,
 like this: `tool exec -- ls -l -t ..`.
 - The shell on the host processes the command line,
@@ -264,10 +266,10 @@ tool down
 You can add additional Docker Compose arguments to the command line. For example: NOTE THAT THE FOLLOWING COMMAND IS VERY DESTRUCTIVE. It destroys the volume where you might have your development and test databases, or other important data:
 
 ```bash
-tool start -- -v
+tool down --volumes --remove-orphans
 ```
 
-If any of the command's arguments are the same as any of `tool`'s arguments,
+If any of the Docker Compose arguments are the same as any of `tool`'s arguments,
 separate the `exec` command from the rest of the command line with `--`,
 like this: `tool down -- -v`.
 
@@ -293,7 +295,7 @@ To run in another directory, use the path from the directory you're in, to the d
 ruby -I ../jade_systems_toolbox/lib ../jade_systems_toolbox/exe/tool [COMMAND]
 ```
 
-To install this gem onto your local machine, build it: `gem build jade_systems_toolbox.gemspec`, and install it: `gem install -l jade_systems_toolbox-0.1.4.gem`. (Change the version number to match the current version number.)
+To install this gem onto your local machine, build it: `gem build jade_systems_toolbox.gemspec`, and install it: `gem install -l jade_systems_toolbox-0.2.0.gem`. (Change the version number to match the current version number.)
 
 ## Release
 

data/lib/jade_systems_toolbox/cli.rb

@@ -14,7 +14,7 @@ module JadeSystemsToolbox
 
     class_option :verbose, type: :boolean, default: false, aliases: "-v"
 
-    desc "down -- COMPOSE_ARGS", "docker compose down. Deletes the container. You probably want stop."
+    desc "down -- [COMPOSE_ARGS]", "docker compose down. Deletes the container. You probably want stop."
     option :force, default: "n", aliases: "-f"
     def down(*compose_args)
       force = ask("tool down destroys the containers. Are you sure [y/N]?").downcase unless options[:force] == "y"
@@ -97,7 +97,16 @@ module JadeSystemsToolbox
       container_ports = compose_yaml.dig("services", service, "ports")
       container_port = container_ports&.[](0) || container_port
       path = "/#{path}" if path[0] != "/"
-      `open "#{protocol}://localhost:#{host_port_from_container_port(service:, container_port:)}#{path}"`
+      url = "#{protocol}://localhost:#{host_port_from_container_port(service:, container_port:)}#{path}"
+      if `command -v "open"`
+        # Real Unix :-)
+        system "open #{url}"
+      elsif `command -v "cmd.exe"`
+        # WSL because this opens a URL in the browser, which will be on Windows.
+        system "cmd.exe /c start #{url}"
+      else
+        raise ArgumentError, "no suitable command available to open app."
+      end
     end
 
     desc "port [CONTAINER_PORT]", "Get the host port for the CONTAINER_PORT's container port CONTAINER_PORT"

data/lib/jade_systems_toolbox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JadeSystemsToolbox
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jade_systems_toolbox
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Larry Reid
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-09 00:00:00.000000000 Z
+date: 2026-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor