docs: add paste service to Workflow; clarify app-log vs stdout in Deploy
- Workflow: paste.rethinkstudios.io pastebin section — pb() function
(recommended) + alias alternative in content tabs, usage, expires note,
creation rate-limit warning.
- Deploy: warning admonition distinguishing ${LOGS_DIR} (app logger, to
disk) from container stdout/stderr where startup crashes and uncaught
exceptions land; sys.excepthook snippet to route them into the log file.
Signed-off-by: disqualifier <dev@disqualifier.me>
This commit is contained in:
@@ -241,3 +241,48 @@ gitcs() {
|
||||
- **`gl`** — a readable branch graph for understanding history at a glance.
|
||||
- **`pyenv`** — per-project Python versions, so each repo builds against the
|
||||
version it targets.
|
||||
|
||||
## Paste service
|
||||
|
||||
A shared, self-hosted pastebin at
|
||||
[paste.rethinkstudios.io](https://paste.rethinkstudios.io) — for quickly sharing
|
||||
logs, snippets, or command output when you're pairing, filing an issue, or handing
|
||||
output to a coding agent. Pastes are **unlisted** (random URL), **expire** by
|
||||
default, and support **burn-after-read**. Anonymous — no login.
|
||||
|
||||
The easy way: pipe anything into it and get back a URL. Drop this into your
|
||||
`.zshrc` / `.bashrc` — a **function** is preferred over a plain alias because it
|
||||
reads stdin cleanly and has room to grow options (needs `jq` + `curl`):
|
||||
|
||||
=== "Function (recommended)"
|
||||
|
||||
```bash
|
||||
# paste stdin to the rethink paste service, print the URL. usage: cat file | pb
|
||||
pb() {
|
||||
jq -Rns '{text: inputs, expires: 259200}' \
|
||||
| curl -s -H 'Content-Type: application/json' --data-binary @- https://paste.rethinkstudios.io/ \
|
||||
| jq -r '"https://paste.rethinkstudios.io" + .path'
|
||||
}
|
||||
```
|
||||
|
||||
=== "Alias (alternative)"
|
||||
|
||||
Same behaviour as a one-liner — note the extra escaping the alias form needs:
|
||||
|
||||
```bash
|
||||
alias pb="jq -Rns '{text: inputs, expires: 259200}' | curl -s -H 'Content-Type: application/json' --data-binary @- https://paste.rethinkstudios.io/ | jq -r '\"https://paste.rethinkstudios.io\" + .path'"
|
||||
```
|
||||
|
||||
Usage — pipe any file or command output straight in:
|
||||
|
||||
```bash
|
||||
cat latest.log | pb # -> https://paste.rethinkstudios.io/xxxxxxx
|
||||
mycommand 2>&1 | pb # pipe any command's output (stderr too)
|
||||
```
|
||||
|
||||
`expires` is in **seconds** — `259200` = 72h (the default). Change it (e.g.
|
||||
`86400` for 24h) or drop the field entirely.
|
||||
|
||||
!!! info "Rate-limited on creation"
|
||||
The service rate-limits paste **creation** (not viewing), so it's built for
|
||||
occasional shares — not bulk or automated posting.
|
||||
|
||||
Reference in New Issue
Block a user