Skip to content

Installation

Brett Estrade edited this page Nov 14, 2026 · 12 revisions

Download and installation

Requirements

  • Full Perl 5.10+, including its standard modules (POSIX, Digest::SHA, File::Temp, Getopt::Long, Pod::Usage and the other bundled libraries).
  • A POSIX tty and ANSI/VT100 terminal for interactive editing.
  • Writable temporary disk space; see Large Files.
  • Optional Perl::Tidy, for formatting only.

No privileged installation is required. Minimal OS packages sometimes split the standard Perl library into separate packages. A stripped-down Perl binary alone is insufficient; this is distinct from needing CPAN dependencies for pvim.

Standalone file

pvim-standalone.pl is the complete editor, including its POD and CLI help. It has the same bytes as the pvim download. All pvim packages are already embedded in that file, so no additional fat-packing step or extraction is required. It uses the host's core Perl library; it does not embed a Perl interpreter or the optional formatter.

mkdir -p "$HOME/.local/bin"
curl -fL https://github.com/oodler577/pvim/releases/download/v0.1.3/pvim-standalone.pl -o "$HOME/.local/bin/pvim"
chmod +x "$HOME/.local/bin/pvim"
"$HOME/.local/bin/pvim" --version
"$HOME/.local/bin/pvim" file.pl

If ~/.local/bin is in your PATH, run pvim file.pl. Otherwise use its full path, or add that directory to your shell's PATH configuration. You can always invoke an explicit interpreter: perl "$HOME/.local/bin/pvim" file.pl.

Check downloads

Download SHA256SUMS alongside the exact release asset, then compare its entry:

curl -fLO https://github.com/oodler577/pvim/releases/download/v0.1.3/SHA256SUMS
sha256sum pvim-standalone.pl

For a full release directory containing all listed assets, sha256sum -c SHA256SUMS checks every entry. macOS also provides shasum -a 256. Checksums detect a mismatch; they are not a separate cryptographic signature.

Upgrade and remove

To upgrade, quit pvim, download the desired release, verify it, and replace your user-owned installed file. There is no package database or installed module tree. To uninstall the example installation: rm "$HOME/.local/bin/pvim".

Git checkout

git clone git@github.com:oodler577/pvim.git
cd pvim
git checkout master
perl pvim file.pl

See Perl Features for the optional formatter and Portability for actual test coverage.

Clone this wiki locally