Directories
¶
| Path | Synopsis |
|---|---|
|
Package dbtasks implements the database lifecycle behind `forge db`: creating and dropping the application's database, dumping and loading its schema, and opening the database's own console (ADR 0035).
|
Package dbtasks implements the database lifecycle behind `forge db`: creating and dropping the application's database, dumping and loading its schema, and opening the database's own console (ADR 0035). |
|
Package deploy implements `forge deploy`, `forge logs` and `forge app`: container deployment to hosts over SSH with zero-downtime switches through forge-proxy (ADR 0030).
|
Package deploy implements `forge deploy`, `forge logs` and `forge app`: container deployment to hosts over SSH with zero-downtime switches through forge-proxy (ADR 0030). |
|
internal/fakedocker
command
Command fakedocker stands in for the docker CLI in the SSH integration tests of internal/deploy, where no Docker daemon is available.
|
Command fakedocker stands in for the docker CLI in the SSH integration tests of internal/deploy, where no Docker daemon is available. |
|
Package devloop is the engine behind `forge dev`: a polling file watcher, a supervisor that rebuilds and gracefully restarts the application, and a development-only reverse proxy that reloads the browser.
|
Package devloop is the engine behind `forge dev`: a polling file watcher, a supervisor that rebuilds and gracefully restarts the application, and a development-only reverse proxy that reloads the browser. |
|
Package exectest creates the executable stand-ins (fake ssh, fake database clients, hook scripts) that tests run as separate processes.
|
Package exectest creates the executable stand-ins (fake ssh, fake database clients, hook scripts) that tests run as separate processes. |
|
Package frontend compiles a generated application's TypeScript (app/javascript/**/*.ts) to the JavaScript the browser runs, with esbuild's Go API (ADR 0049).
|
Package frontend compiles a generated application's TypeScript (app/javascript/**/*.ts) to the JavaScript the browser runs, with esbuild's Go API (ADR 0049). |
|
Package langtag validates and canonicalizes the subset of BCP 47 locale names Forge supports.
|
Package langtag validates and canonicalizes the subset of BCP 47 locale names Forge supports. |
|
Command loadgen is the HTTP load generator of scripts/bench.sh: a closed loop of a fixed number of workers that send the requests of the benchmark scenarios (docs/BENCHMARKS.md) to a running generated application for a fixed time, and report requests per second and latency percentiles.
|
Command loadgen is the HTTP load generator of scripts/bench.sh: a closed loop of a fixed number of workers that send the requests of the benchmark scenarios (docs/BENCHMARKS.md) to a running generated application for a fixed time, and report requests per second and latency percentiles. |
|
Package principalctx reads the authenticated principal from a request context.
|
Package principalctx reads the authenticated principal from a request context. |
|
internal/key
Package key is the request-context key of the authenticated principal.
|
Package key is the request-context key of the authenticated principal. |
|
principalwrite
Package principalwrite puts the authenticated principal in a request context, where principalctx.Value and auth.FromContext read it.
|
Package principalwrite puts the authenticated principal in a request context, where principalctx.Value and auth.FromContext read it. |
|
Package proxy implements forge-proxy, the reverse proxy that `forge deploy` runs on every web host (ADR 0030).
|
Package proxy implements forge-proxy, the reverse proxy that `forge deploy` runs on every web host (ADR 0030). |
|
Package ptytest opens pseudo-terminals for tests that drive an interactive terminal: secret prompts, colored logs.
|
Package ptytest opens pseudo-terminals for tests that drive an interactive terminal: secret prompts, colored logs. |
|
Package scaffold generates new Forge applications.
|
Package scaffold generates new Forge applications. |
|
Package terminal reads a secret typed at an interactive terminal without echoing it.
|
Package terminal reads a secret typed at an interactive terminal without echoing it. |
|
Package version holds the build information of the forge and forge-proxy commands and renders it for `forge version` and `forge-proxy version`.
|
Package version holds the build information of the forge and forge-proxy commands and renders it for `forge version` and `forge-proxy version`. |
|
Package waittest waits for a condition that another goroutine, process or server makes true: the one place the tests poll the real clock.
|
Package waittest waits for a condition that another goroutine, process or server makes true: the one place the tests poll the real clock. |
Click to show internal directories.
Click to hide internal directories.