stable-cli-rails 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb7161cbe3a5e9ed3d651e059f0884fd065cf1281a13baf1ee7f518e47ce66c4
-  data.tar.gz: 882e21ccd55072e66bf5f0e4dac8b023b41da126667d17de930876d69827d536
+  metadata.gz: 3d18b06df5101ef5a3c05b47822ffbc031fe91c2351bda7ca2c8fffbf1bacf01
+  data.tar.gz: 82af0cf68641c023280ba82e8c8c808182cf5c1455e9341086df9d7b99ca24ae
 SHA512:
-  metadata.gz: 4f093a5af1f22b2212280b57bc69afd934b44525378a707c5c0bb399b3645b4ee936aea242e316628015930b3ab4ee3ea0f99bd798dc1aa8514ef98aea775c30
-  data.tar.gz: c87973bf27d5f0d297ebb7104d0197d5432ce360f278d0a5711fe639c928ee58a363a16f1bf07857e79c79ded85849d6721416be00e549019ae522d171a0fe57
+  metadata.gz: 9630bf72dd47d20ffbf776b200fe4be8c2772663a1a33c841af58bc09dd333d6178ec10049b8ed61abcf5b3246e0408c4f6bc70b95b34fe863f91906ee664f40
+  data.tar.gz: 2e5007ac55dc7f06fc70e6dd0e00636a5a545f6e1e87ea0f6a81ca4195405cb5eaf631da9ac99048c966cc3ed0aa987a2aa57e673ebcaf3a29e8b3617ec7588e

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stable-cli-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Danny Simfukwe
@@ -44,39 +44,40 @@ description: "# Stable CLI (macOS)\n\nStable is a CLI tool to manage local Rails
   `/etc/hosts` for `.test` domains.\n- Start Rails apps with integrated Caddy reverse
   proxy.\n- Reload Caddy after adding/removing apps.\n- List all registered apps.\n\n##
   Installation\n\n### From source\n\n```bash\n# Clone the repository\ngit clone git@github.com:dannysimfukwe/stable-rails.git\ncd
-  stable-rails\n\n# Install dependencies\nbundle install\n```\n\n### As a gem\n\n```bash\ngem
-  install stable\n```\n\n## Setup\n\nInitialize Caddy home and required directories:\n\n```bash\nstable
-  setup\n```\n\nThis will create:  \n- `~/StableCaddy/` for Caddy configuration.  \n-
-  `~/StableCaddy/certs` for generated certificates.  \n- `~/StableCaddy/Caddyfile`
-  for Caddy configuration.  \n\n## CLI Commands\n\n### List apps\n\n```bash\nstable
-  list\n```\n\nLists all registered apps and their domains.\n\n### Add a Rails app\n\n```bash\nstable
-  add /path/to/rails_app\n```\n\nThis will:  \n- Register the app.  \n- Add a `/etc/hosts`
-  entry.  \n- Generate local trusted HTTPS certificates.  \n- Add a Caddy reverse
-  proxy block.  \n- Reload Caddy.\n\n### Remove a Rails app\n\n```bash\nstable remove
-  app_name\n```\n\nThis will:  \n- Remove the app from registry.  \n- Remove `/etc/hosts`
-  entry.  \n- Remove the Caddy reverse proxy block.  \n- Reload Caddy.\n\n### Start
-  an app\n\n```bash\nrvmsudo stable start app_name\n```\n\nStarts the Rails server
-  on the assigned port and ensures Caddy is running with the proper reverse proxy.
-  Rails logs can be viewed in your terminal.\n\n### Stop an app\n\n```bash\nstable
+  stable-rails\n\n# Install dependencies\nbundle install\n```\n\n### As a gem from
+  Rubygems registry\n\n```bash\ngem install stable-cli-rails\n```\n\n### Or add it
+  to your Gemfile\n```bash\ngem \"stable-cli-rails\" \n```\n\n## Setup\n\nInitialize
+  Caddy home and required directories:\n\n```bash\nstable setup\n```\n\nThis will
+  create:  \n- `~/StableCaddy/` for Caddy configuration.  \n- `~/StableCaddy/certs`
+  for generated certificates.  \n- `~/StableCaddy/Caddyfile` for Caddy configuration.
+  \ \n\n## CLI Commands\n\n### List apps\n\n```bash\nstable list\n```\n\nLists all
+  registered apps and their domains.\n\n### Create a new Rails app\n\n```bash\nstable
+  new myapp [--ruby 3.4.4] [--rails 7.0.7.1] [--skip-ssl]\n```\n\nCreates a new Rails
+  app, generates `.ruby-version`, installs Rails, adds the app to Stable, and optionally
+  secures it with HTTPS.\n\n### Add a Rails app\n\n```bash\nstable add /path/to/rails_app\n```\n\nThis
+  will:  \n- Register the app.  \n- Add a `/etc/hosts` entry.  \n- Generate local
+  trusted HTTPS certificates.  \n- Add a Caddy reverse proxy block.  \n- Reload Caddy.\n\n###
+  Remove a Rails app\n\n```bash\nstable remove app_name\n```\n\nThis will:  \n- Remove
+  the app from registry.  \n- Remove `/etc/hosts` entry.  \n- Remove the Caddy reverse
+  proxy block.  \n- Reload Caddy.\n\n### Start an app\n\n```bash\nstable start app_name\n```\n\nStarts
+  the Rails server on the assigned port and ensures Caddy is running with the proper
+  reverse proxy. Rails logs can be viewed in your terminal.\n\n### Stop an app\n\n```bash\nstable
   stop app_name\n```\n\nStops the Rails server running on the assigned port.\n\n###
-  Secure an app manually\n\n```bash\nrvmsudo stable secure app_name.test\n```\n\nGenerates
+  Secure an app manually\n\n```bash\nstable secure app_name.test\n```\n\nGenerates
   or updates trusted local HTTPS certificates and reloads Caddy.\n\n### Reload Caddy\n\n```bash\nstable
   caddy reload\n```\n\nReloads Caddy configuration after changes.\n\n### Health check\n\n```bash\nstable
   doctor\n```\n\nChecks the environment, RVM/Ruby, Caddy, mkcert, and app readiness.\n\n###
   Upgrade Ruby for an app\n\n```bash\nstable upgrade-ruby myapp 3.4.4\n```\n\nUpgrades
   the Ruby version for a specific app, updating `.ruby-version` and ensuring gemset
-  compatibility.\n\n### Create a new Rails app\n\n```bash\nstable new myapp [--ruby
-  3.4.4] [--rails 7.0.7.1] [--skip-ssl]\n```\n\nCreates a new Rails app, generates
-  `.ruby-version`, installs Rails, adds the app to Stable, and optionally secures
-  it with HTTPS.\n\n## Paths\n\n- Caddy home: `~/StableCaddy`  \n- Caddyfile: `~/StableCaddy/Caddyfile`
+  compatibility.\n\n## Paths\n\n- Caddy home: `~/StableCaddy`  \n- Caddyfile: `~/StableCaddy/Caddyfile`
   \ \n- Certificates: `~/StableCaddy/certs`  \n- Registered apps: `~/StableCaddy/apps.yml`
   \ \n\n## Dependencies\n\n- Homebrew  \n- Caddy  \n- mkcert  \n- RVM (or rbenv fallback)\n\n`ensure_dependencies!`
   will install missing dependencies automatically.\n\n## Known Issues\n\n- Sometimes
   you may see:  \n```\nTCPSocket#initialize: Connection refused - connect(2) for \"127.0.0.1\"
   port 300.. (Errno::ECONNREFUSED)\n```\nThis usually disappears after a few seconds
-  when Caddy reloads. If it persists, run:\n\n```bash\nrvmsudo stable secure myapp.test\n```\n\n-
+  when Caddy reloads. If it persists, run:\n\n```bash\nstable secure myapp.test\n```\n\n-
   Some commands may need to be run consecutively for proper setup:  \n```bash\nstable
-  setup\nrvmsudo stable add myapp\nrvmsudo stable secure myapp.test\nstable start
+  setup\nstable add myapp or stable new myapp\nstable secure myapp.test\nstable start
   myapp\n```\n\n- PATH warnings from RVM may appear on the first run. Make sure your
   shell is properly configured for RVM.\n\n## Notes\n\n- Make sure to run `stable
   setup` initially.  \n- Requires `sudo` to modify `/etc/hosts`.  \n- Rails apps are
@@ -89,7 +90,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- README.md
 - bin/stable
 - lib/stable.rb
 - lib/stable/bootstrap.rb

data/README.md

@@ -1,184 +0,0 @@
-# Stable CLI (macOS)
-
-Stable is a CLI tool to manage local Rails applications with automatic Caddy setup on macOS, local trusted HTTPS certificates, and easy start/stop functionality.
-
-## Features
-
-- Add and remove Rails apps.
-- Automatically generate and manage local HTTPS certificates using `mkcert`.
-- Automatically update `/etc/hosts` for `.test` domains.
-- Start Rails apps with integrated Caddy reverse proxy.
-- Reload Caddy after adding/removing apps.
-- List all registered apps.
-
-## Installation
-
-### From source
-
-```bash
-# Clone the repository
-git clone git@github.com:dannysimfukwe/stable-rails.git
-cd stable-rails
-
-# Install dependencies
-bundle install
-```
-
-### As a gem
-
-```bash
-gem install stable
-```
-
-## Setup
-
-Initialize Caddy home and required directories:
-
-```bash
-stable setup
-```
-
-This will create:  
-- `~/StableCaddy/` for Caddy configuration.  
-- `~/StableCaddy/certs` for generated certificates.  
-- `~/StableCaddy/Caddyfile` for Caddy configuration.  
-
-## CLI Commands
-
-### List apps
-
-```bash
-stable list
-```
-
-Lists all registered apps and their domains.
-
-### Add a Rails app
-
-```bash
-stable add /path/to/rails_app
-```
-
-This will:  
-- Register the app.  
-- Add a `/etc/hosts` entry.  
-- Generate local trusted HTTPS certificates.  
-- Add a Caddy reverse proxy block.  
-- Reload Caddy.
-
-### Remove a Rails app
-
-```bash
-stable remove app_name
-```
-
-This will:  
-- Remove the app from registry.  
-- Remove `/etc/hosts` entry.  
-- Remove the Caddy reverse proxy block.  
-- Reload Caddy.
-
-### Start an app
-
-```bash
-rvmsudo stable start app_name
-```
-
-Starts the Rails server on the assigned port and ensures Caddy is running with the proper reverse proxy. Rails logs can be viewed in your terminal.
-
-### Stop an app
-
-```bash
-stable stop app_name
-```
-
-Stops the Rails server running on the assigned port.
-
-### Secure an app manually
-
-```bash
-rvmsudo stable secure app_name.test
-```
-
-Generates or updates trusted local HTTPS certificates and reloads Caddy.
-
-### Reload Caddy
-
-```bash
-stable caddy reload
-```
-
-Reloads Caddy configuration after changes.
-
-### Health check
-
-```bash
-stable doctor
-```
-
-Checks the environment, RVM/Ruby, Caddy, mkcert, and app readiness.
-
-### Upgrade Ruby for an app
-
-```bash
-stable upgrade-ruby myapp 3.4.4
-```
-
-Upgrades the Ruby version for a specific app, updating `.ruby-version` and ensuring gemset compatibility.
-
-### Create a new Rails app
-
-```bash
-stable new myapp [--ruby 3.4.4] [--rails 7.0.7.1] [--skip-ssl]
-```
-
-Creates a new Rails app, generates `.ruby-version`, installs Rails, adds the app to Stable, and optionally secures it with HTTPS.
-
-## Paths
-
-- Caddy home: `~/StableCaddy`  
-- Caddyfile: `~/StableCaddy/Caddyfile`  
-- Certificates: `~/StableCaddy/certs`  
-- Registered apps: `~/StableCaddy/apps.yml`  
-
-## Dependencies
-
-- Homebrew  
-- Caddy  
-- mkcert  
-- RVM (or rbenv fallback)
-
-`ensure_dependencies!` will install missing dependencies automatically.
-
-## Known Issues
-
-- Sometimes you may see:  
-```
-TCPSocket#initialize: Connection refused - connect(2) for "127.0.0.1" port 300.. (Errno::ECONNREFUSED)
-```
-This usually disappears after a few seconds when Caddy reloads. If it persists, run:
-
-```bash
-rvmsudo stable secure myapp.test
-```
-
-- Some commands may need to be run consecutively for proper setup:  
-```bash
-stable setup
-rvmsudo stable add myapp
-rvmsudo stable secure myapp.test
-stable start myapp
-```
-
-- PATH warnings from RVM may appear on the first run. Make sure your shell is properly configured for RVM.
-
-## Notes
-
-- Make sure to run `stable setup` initially.  
-- Requires `sudo` to modify `/etc/hosts`.  
-- Rails apps are started on ports assigned by Stable (default 3000+).  
-- Domains are automatically suffixed with `.test`.  
-
-## License
-
-MIT License