@pirafrank/poof 0.6.4-rc.3 → 0.6.4
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 -52
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -45,6 +45,18 @@ poof list
|
|
|
45
45
|
poof which rg
|
|
46
46
|
```
|
|
47
47
|
|
|
48
|
+
## Verifying what you installed
|
|
49
|
+
|
|
50
|
+
Every release is built by GitHub Actions from a tagged commit, signed with Sigstore, and
|
|
51
|
+
published with npm provenance. You can inspect the provenance of an installed version with:
|
|
52
|
+
|
|
53
|
+
```sh
|
|
54
|
+
npm audit signatures
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Native release archives, checksums, SPDX inventories, and attestations are published on the
|
|
58
|
+
[GitHub Releases page](https://github.com/pirafrank/poof/releases).
|
|
59
|
+
|
|
48
60
|
## How it works
|
|
49
61
|
|
|
50
62
|
The launcher resolves the native executable with Node module resolution and spawns it with
|
|
@@ -55,63 +67,21 @@ The launcher performs **no network access at runtime**. It never downloads, extr
|
|
|
55
67
|
updates anything: the executable is already installed by npm. All download and update
|
|
56
68
|
behavior belongs to `poof` itself and is unchanged by this packaging.
|
|
57
69
|
|
|
58
|
-
##
|
|
59
|
-
|
|
60
|
-
### `poof: native package @pirafrank/poof-<os>-<cpu> is not installed`
|
|
61
|
-
|
|
62
|
-
The optional platform package was skipped or removed. Common causes:
|
|
63
|
-
|
|
64
|
-
- **Optional dependencies were disabled.** `npm install --omit=optional` (or `--no-optional`,
|
|
65
|
-
or `optional=false` in `.npmrc`) skips the native package. Reinstall with them enabled:
|
|
66
|
-
|
|
67
|
-
```sh
|
|
68
|
-
npm install --global --include=optional @pirafrank/poof
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
- **An incomplete or pruned install.** A interrupted install, a `node_modules` cleanup, or a
|
|
72
|
-
lockfile that predates the platform packages can leave the tree incomplete. Remove and
|
|
73
|
-
reinstall:
|
|
74
|
-
|
|
75
|
-
```sh
|
|
76
|
-
npm uninstall --global @pirafrank/poof
|
|
77
|
-
npm install --global @pirafrank/poof
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
- **A package-manager layout that hides sibling packages.** Some pnpm and Yarn PnP
|
|
81
|
-
configurations do not place scoped sibling packages where Node can resolve them. Use npm,
|
|
82
|
-
or configure your package manager to hoist `@pirafrank/*` (for pnpm,
|
|
83
|
-
`public-hoist-pattern[]=@pirafrank/*`), or install `poof` from a native release archive
|
|
84
|
-
instead.
|
|
85
|
-
|
|
86
|
-
### `poof: unsupported platform`
|
|
87
|
-
|
|
88
|
-
Your operating system or CPU is not one of the four supported targets. The launcher prints
|
|
89
|
-
the detected platform and the full supported list. Build from source or download a native
|
|
90
|
-
release archive from <https://github.com/pirafrank/poof/releases>.
|
|
91
|
-
|
|
92
|
-
### `poof: failed to execute ... (EACCES)` or `(ENOENT)`
|
|
93
|
-
|
|
94
|
-
The native package is installed but its executable could not be started. Check that the file
|
|
95
|
-
exists and is executable (mode `0755`), and that the filesystem is not mounted `noexec` and
|
|
96
|
-
no security software is blocking it. Reinstalling usually repairs a damaged installation.
|
|
97
|
-
|
|
98
|
-
## Verifying what you installed
|
|
70
|
+
## Documentation
|
|
99
71
|
|
|
100
|
-
|
|
101
|
-
published with npm provenance. You can inspect the provenance of an installed version with:
|
|
72
|
+
Full CLI documentation, shell integration, and more is available at [poof.fpira.com](https://poof.fpira.com).
|
|
102
73
|
|
|
103
|
-
|
|
104
|
-
npm audit signatures
|
|
105
|
-
```
|
|
74
|
+
## Troubleshooting
|
|
106
75
|
|
|
107
|
-
|
|
108
|
-
|
|
76
|
+
See the [npm troubleshooting guide](https://poof.fpira.com/docs/npm-troubleshooting)
|
|
77
|
+
for help with missing native packages, unsupported platforms, and executable launch errors.
|
|
109
78
|
|
|
110
|
-
##
|
|
79
|
+
## Repository
|
|
111
80
|
|
|
112
|
-
|
|
113
|
-
<https://github.com/pirafrank/poof>
|
|
81
|
+
The source code is available on GitHub: <https://github.com/pirafrank/poof>.
|
|
114
82
|
|
|
115
83
|
## License
|
|
116
84
|
|
|
117
|
-
MIT
|
|
85
|
+
MIT
|
|
86
|
+
|
|
87
|
+
See [LICENSE.md](https://github.com/pirafrank/poof/blob/main/LICENSE.md).
|
package/package.json
CHANGED
|
@@ -26,10 +26,10 @@
|
|
|
26
26
|
"license": "MIT",
|
|
27
27
|
"name": "@pirafrank/poof",
|
|
28
28
|
"optionalDependencies": {
|
|
29
|
-
"@pirafrank/poof-darwin-arm64": "0.6.4
|
|
30
|
-
"@pirafrank/poof-darwin-x64": "0.6.4
|
|
31
|
-
"@pirafrank/poof-linux-arm64": "0.6.4
|
|
32
|
-
"@pirafrank/poof-linux-x64": "0.6.4
|
|
29
|
+
"@pirafrank/poof-darwin-arm64": "0.6.4",
|
|
30
|
+
"@pirafrank/poof-darwin-x64": "0.6.4",
|
|
31
|
+
"@pirafrank/poof-linux-arm64": "0.6.4",
|
|
32
|
+
"@pirafrank/poof-linux-x64": "0.6.4"
|
|
33
33
|
},
|
|
34
34
|
"private": false,
|
|
35
35
|
"publishConfig": {
|
|
@@ -39,5 +39,5 @@
|
|
|
39
39
|
"type": "git",
|
|
40
40
|
"url": "git+https://github.com/pirafrank/poof.git"
|
|
41
41
|
},
|
|
42
|
-
"version": "0.6.4
|
|
42
|
+
"version": "0.6.4"
|
|
43
43
|
}
|