stable-cli-rails 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. checksums.yaml +2 -2
  2. metadata +3 -47
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3d18b06df5101ef5a3c05b47822ffbc031fe91c2351bda7ca2c8fffbf1bacf01
3
+ metadata.gz: 44255eb169e13d0f525e93fd948eb7f5f4b2fa9c6818fba7b1bd09889adc9d2a
4
4
  data.tar.gz: 82af0cf68641c023280ba82e8c8c808182cf5c1455e9341086df9d7b99ca24ae
5
5
  SHA512:
6
- metadata.gz: 9630bf72dd47d20ffbf776b200fe4be8c2772663a1a33c841af58bc09dd333d6178ec10049b8ed61abcf5b3246e0408c4f6bc70b95b34fe863f91906ee664f40
6
+ metadata.gz: 0fe49c3aed3dbbc723d63b5a72fe7b2f51c110d17e076b1c6d882079a7df3ed338675fe1a8633c12dcd449150cecc797680182efe68011e037c150ed37abf754
7
7
  data.tar.gz: 2e5007ac55dc7f06fc70e6dd0e00636a5a545f6e1e87ea0f6a81ca4195405cb5eaf631da9ac99048c966cc3ed0aa987a2aa57e673ebcaf3a29e8b3617ec7588e
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: stable-cli-rails
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.0
4
+ version: 0.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Danny Simfukwe
@@ -37,52 +37,8 @@ dependencies:
37
37
  - - ">="
38
38
  - !ruby/object:Gem::Version
39
39
  version: '0'
40
- description: "# Stable CLI (macOS)\n\nStable is a CLI tool to manage local Rails applications
41
- with automatic Caddy setup on macOS, local trusted HTTPS certificates, and easy
42
- start/stop functionality.\n\n## Features\n\n- Add and remove Rails apps.\n- Automatically
43
- generate and manage local HTTPS certificates using `mkcert`.\n- Automatically update
44
- `/etc/hosts` for `.test` domains.\n- Start Rails apps with integrated Caddy reverse
45
- proxy.\n- Reload Caddy after adding/removing apps.\n- List all registered apps.\n\n##
46
- Installation\n\n### From source\n\n```bash\n# Clone the repository\ngit clone git@github.com:dannysimfukwe/stable-rails.git\ncd
47
- stable-rails\n\n# Install dependencies\nbundle install\n```\n\n### As a gem from
48
- Rubygems registry\n\n```bash\ngem install stable-cli-rails\n```\n\n### Or add it
49
- to your Gemfile\n```bash\ngem \"stable-cli-rails\" \n```\n\n## Setup\n\nInitialize
50
- Caddy home and required directories:\n\n```bash\nstable setup\n```\n\nThis will
51
- create: \n- `~/StableCaddy/` for Caddy configuration. \n- `~/StableCaddy/certs`
52
- for generated certificates. \n- `~/StableCaddy/Caddyfile` for Caddy configuration.
53
- \ \n\n## CLI Commands\n\n### List apps\n\n```bash\nstable list\n```\n\nLists all
54
- registered apps and their domains.\n\n### Create a new Rails app\n\n```bash\nstable
55
- new myapp [--ruby 3.4.4] [--rails 7.0.7.1] [--skip-ssl]\n```\n\nCreates a new Rails
56
- app, generates `.ruby-version`, installs Rails, adds the app to Stable, and optionally
57
- secures it with HTTPS.\n\n### Add a Rails app\n\n```bash\nstable add /path/to/rails_app\n```\n\nThis
58
- will: \n- Register the app. \n- Add a `/etc/hosts` entry. \n- Generate local
59
- trusted HTTPS certificates. \n- Add a Caddy reverse proxy block. \n- Reload Caddy.\n\n###
60
- Remove a Rails app\n\n```bash\nstable remove app_name\n```\n\nThis will: \n- Remove
61
- the app from registry. \n- Remove `/etc/hosts` entry. \n- Remove the Caddy reverse
62
- proxy block. \n- Reload Caddy.\n\n### Start an app\n\n```bash\nstable start app_name\n```\n\nStarts
63
- the Rails server on the assigned port and ensures Caddy is running with the proper
64
- reverse proxy. Rails logs can be viewed in your terminal.\n\n### Stop an app\n\n```bash\nstable
65
- stop app_name\n```\n\nStops the Rails server running on the assigned port.\n\n###
66
- Secure an app manually\n\n```bash\nstable secure app_name.test\n```\n\nGenerates
67
- or updates trusted local HTTPS certificates and reloads Caddy.\n\n### Reload Caddy\n\n```bash\nstable
68
- caddy reload\n```\n\nReloads Caddy configuration after changes.\n\n### Health check\n\n```bash\nstable
69
- doctor\n```\n\nChecks the environment, RVM/Ruby, Caddy, mkcert, and app readiness.\n\n###
70
- Upgrade Ruby for an app\n\n```bash\nstable upgrade-ruby myapp 3.4.4\n```\n\nUpgrades
71
- the Ruby version for a specific app, updating `.ruby-version` and ensuring gemset
72
- compatibility.\n\n## Paths\n\n- Caddy home: `~/StableCaddy` \n- Caddyfile: `~/StableCaddy/Caddyfile`
73
- \ \n- Certificates: `~/StableCaddy/certs` \n- Registered apps: `~/StableCaddy/apps.yml`
74
- \ \n\n## Dependencies\n\n- Homebrew \n- Caddy \n- mkcert \n- RVM (or rbenv fallback)\n\n`ensure_dependencies!`
75
- will install missing dependencies automatically.\n\n## Known Issues\n\n- Sometimes
76
- you may see: \n```\nTCPSocket#initialize: Connection refused - connect(2) for \"127.0.0.1\"
77
- port 300.. (Errno::ECONNREFUSED)\n```\nThis usually disappears after a few seconds
78
- when Caddy reloads. If it persists, run:\n\n```bash\nstable secure myapp.test\n```\n\n-
79
- Some commands may need to be run consecutively for proper setup: \n```bash\nstable
80
- setup\nstable add myapp or stable new myapp\nstable secure myapp.test\nstable start
81
- myapp\n```\n\n- PATH warnings from RVM may appear on the first run. Make sure your
82
- shell is properly configured for RVM.\n\n## Notes\n\n- Make sure to run `stable
83
- setup` initially. \n- Requires `sudo` to modify `/etc/hosts`. \n- Rails apps are
84
- started on ports assigned by Stable (default 3000+). \n- Domains are automatically
85
- suffixed with `.test`. \n\n## License\n\nMIT License\n"
40
+ description: 'Stable CLI: manage local Rails apps with automatic Caddy, HTTPS, and
41
+ simple start/stop commands.'
86
42
  email:
87
43
  - dannysimfukwe@gmail.com
88
44
  executables: