@fabiofiorita/porcelain 0.65.0 → 0.65.2
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.
- package/README.md +22 -11
- package/package.json +1 -1
- package/server/src/cli/main.mjs +2555 -2509
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# @fabiofiorita/porcelain (0.65.
|
|
1
|
+
# @fabiofiorita/porcelain (0.65.2)
|
|
2
2
|
|
|
3
3
|
The Porcelain review server and bundled web app for a plain Node installation.
|
|
4
4
|
|
|
@@ -12,8 +12,11 @@ npx @fabiofiorita/porcelain@latest serve
|
|
|
12
12
|
# Permit other devices on the local network to connect:
|
|
13
13
|
npx @fabiofiorita/porcelain@latest serve --lan
|
|
14
14
|
|
|
15
|
-
# Install this exact CLI version as a user service:
|
|
16
|
-
npx @fabiofiorita/porcelain@latest service install
|
|
15
|
+
# Install this exact CLI version as a user service (Linux):
|
|
16
|
+
npx @fabiofiorita/porcelain@latest service install
|
|
17
|
+
|
|
18
|
+
# Update the service to the latest version:
|
|
19
|
+
npx @fabiofiorita/porcelain@latest service update
|
|
17
20
|
```
|
|
18
21
|
|
|
19
22
|
State lives in `~/.porcelain/`; pass `--data-directory` to keep it somewhere
|
|
@@ -30,14 +33,22 @@ process on this machine can open.
|
|
|
30
33
|
|
|
31
34
|
## Background service
|
|
32
35
|
|
|
33
|
-
`porcelain service install|status|update|uninstall` manages a systemd
|
|
34
|
-
service on Linux. Install and update persist the
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
36
|
+
`porcelain service install|status|update|recover|uninstall` manages a systemd
|
|
37
|
+
user service on Linux. Install and update persist the invoked package version
|
|
38
|
+
outside the npx cache and write a `porcelain` command to `~/.local/bin` that
|
|
39
|
+
runs it; they print how to add that folder to `PATH` when it is missing, and
|
|
40
|
+
leave alone a `porcelain` there that they did not write.
|
|
41
|
+
|
|
42
|
+
`porcelain share lan on` shares the service on the local network and
|
|
43
|
+
`porcelain share` shows how it is shared. Sharing is kept in the data
|
|
44
|
+
directory, so it survives restarts and updates.
|
|
45
|
+
|
|
46
|
+
Updates stop the service and back up SQLite before the new runtime can migrate
|
|
47
|
+
it. An older CLI refuses to replace a newer runtime unless
|
|
48
|
+
`service update --allow-downgrade` is explicit. Uninstall removes the
|
|
49
|
+
service, the runtime and the `porcelain` command while retaining data,
|
|
50
|
+
configuration, logs and database backups. Run service commands as the regular
|
|
51
|
+
user, never with sudo.
|
|
41
52
|
|
|
42
53
|
## Repository development
|
|
43
54
|
|