30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# scripts/
|
|
|
|
Standalone operational helpers. These are **not** part of the application build,
|
|
and the Librarian executable never invokes them — they exist to be picked up by
|
|
the separate, user-maintained installer/packaging project.
|
|
|
|
## `install-ripgrep.ps1`
|
|
|
|
Provisions [ripgrep](https://github.com/BurntSushi/ripgrep) (`rg.exe`), which
|
|
Librarian uses as its recursive-search engine. Intended to run as a **pre-install
|
|
step** in the installer for users who don't already have ripgrep.
|
|
|
|
It resolves the latest `x86_64-pc-windows-msvc` release from GitHub (with a pinned
|
|
fallback if GitHub is unreachable), installs `rg.exe` to
|
|
`%LOCALAPPDATA%\Programs\ripgrep`, and adds it to the user PATH. It is idempotent:
|
|
if ripgrep is already discoverable it does nothing.
|
|
|
|
```powershell
|
|
# Default per-user install (no admin needed):
|
|
powershell -ExecutionPolicy Bypass -File .\install-ripgrep.ps1
|
|
|
|
# Pin a version / install next to the app instead of touching PATH:
|
|
powershell -ExecutionPolicy Bypass -File .\install-ripgrep.ps1 -Version 15.1.0 -InstallDir "C:\Program Files\Librarian" -NoPath
|
|
```
|
|
|
|
At runtime Librarian locates `rg.exe` in this order: next to its own executable,
|
|
then on `PATH`, then the common winget/scoop/chocolatey locations and the
|
|
install dir above. So the installer can either run this script or simply drop
|
|
`rg.exe` beside `librarian.exe` for a fully portable install.
|