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.
- checksums.yaml +2 -2
- metadata +3 -47
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
3
|
+
metadata.gz: 44255eb169e13d0f525e93fd948eb7f5f4b2fa9c6818fba7b1bd09889adc9d2a
|
|
4
4
|
data.tar.gz: 82af0cf68641c023280ba82e8c8c808182cf5c1455e9341086df9d7b99ca24ae
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
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.
|
|
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:
|
|
41
|
-
|
|
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:
|