Commit ae7d08c6 by PLN (Algolia)

projects/devname: full ensure --help surface on both languages; repo link to…

projects/devname: full ensure --help surface on both languages; repo link to git.nech.pl/pln/devname
parent d1e7b825
...@@ -32,6 +32,32 @@ PORT=$(devname ensure myapp --format port) ...@@ -32,6 +32,32 @@ PORT=$(devname ensure myapp --format port)
Branch variants get their own names (`feat-x--tests.myapp.localhost`), so a worktree never collides with the main checkout. Branch variants get their own names (`feat-x--tests.myapp.localhost`), so a worktree never collides with the main checkout.
## Every knob
The source lives at [git.nech.pl/pln/devname](https://git.nech.pl/pln/devname). The full surface of the main verb:
```text
usage: devname ensure [-h] [--service SERVICE] [--branch BRANCH] [--port PORT]
[--force] [--keep-host] [--note NOTE]
[--format {url,port,json}]
[project]
positional arguments:
project
options:
-h, --help show this help message and exit
--service SERVICE
--branch BRANCH a branch name, or 'auto' = the cwd's git branch
(main/master get no suffix)
--port PORT adopt an existing server's port instead of allocating
--force with --port: remap an existing name
--keep-host do not rewrite Host to 127.0.0.1:<port> (default:
rewrite)
--note NOTE
--format {url,port,json}
```
## The index page ## The index page
Caddy also serves **devname.localhost** itself: every registered name with live up/down status, probed per request — the registry's front door, built by the same tool that keeps it. Caddy also serves **devname.localhost** itself: every registered name with live up/down status, probed per request — the registry's front door, built by the same tool that keeps it.
...@@ -32,6 +32,32 @@ PORT=$(devname ensure monapp --format port) ...@@ -32,6 +32,32 @@ PORT=$(devname ensure monapp --format port)
Les variantes de branche ont leurs propres noms (`feat-x--tests.monapp.localhost`) — un worktree ne entre jamais en collision avec le checkout principal. Les variantes de branche ont leurs propres noms (`feat-x--tests.monapp.localhost`) — un worktree ne entre jamais en collision avec le checkout principal.
## Tous les réglages
Le code source vit sur [git.nech.pl/pln/devname](https://git.nech.pl/pln/devname). La surface complète du verbe principal :
```text
usage: devname ensure [-h] [--service SERVICE] [--branch BRANCH] [--port PORT]
[--force] [--keep-host] [--note NOTE]
[--format {url,port,json}]
[project]
positional arguments:
project
options:
-h, --help show this help message and exit
--service SERVICE
--branch BRANCH a branch name, or 'auto' = the cwd's git branch
(main/master get no suffix)
--port PORT adopt an existing server's port instead of allocating
--force with --port: remap an existing name
--keep-host do not rewrite Host to 127.0.0.1:<port> (default:
rewrite)
--note NOTE
--format {url,port,json}
```
## La page d'index ## La page d'index
Caddy sert aussi **devname.localhost** lui-même : tous les noms enregistrés avec leur état up/down mesuré à chaque requête — la porte d'entrée du registre, construite par l'outil qui le tient. Caddy sert aussi **devname.localhost** lui-même : tous les noms enregistrés avec leur état up/down mesuré à chaque requête — la porte d'entrée du registre, construite par l'outil qui le tient.
...@@ -9,5 +9,6 @@ accent: '#2e9e44' ...@@ -9,5 +9,6 @@ accent: '#2e9e44'
featured: true featured: true
draft: false draft: false
links: links:
repo: https://git.nech.pl/pln/devname
post: devname post: devname
--- ---
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment