Skip to content

Installation

Brett Estrade edited this page Nov 16, 2026 · 1 revision

Installation

The executable is anterepl, without a .pl suffix. The CPAN distribution and module are named App::AnteREPL.

From a release archive

With Perl 5.16 or newer and cpanminus available:

cpanm ./App-AnteREPL-0.01.tar.gz
anterepl

Use the archive path for the release you downloaded. You can also unpack it and use the standard installer:

perl Makefile.PL
make test
make install

Use the make program supplied with your Perl installation; its name may be gmake on Windows. Dist::Zilla is not required to install a release.

From the source repository

git clone https://github.com/oodler577/p5-App-AnteREPL.git
cd p5-App-AnteREPL
cpanm .
anterepl

To try the checkout without installing it:

perl -Ilib script/anterepl

Screen support

The screen editor needs an ANSI-capable terminal. On Unix, AnteREPL uses Term::ReadKey when available, otherwise its core POSIX backend. Native Windows screen mode requires Term::ReadKey; the installer requests it there. If needed, install it with cpanm Term::ReadKey.

Native Windows screen behavior has not yet been verified on Windows. If screen setup fails, AnteREPL explains the problem and falls back to plain input. You can choose plain input yourself:

anterepl --plain

Plain mode still supports the program, environment, and file commands. It does not provide cursor movement through old output or LIST pause controls.

Select your editor

In AnteREPL, set the process environment directly:

$ENV{EDITOR} = 'vim';

Or, on Windows:

$ENV{EDITOR} = 'notepad';

A GUI editor must wait until you finish editing, for example $ENV{EDITOR} = 'code --wait'. Paths containing spaces need quotes inside the editor setting. Use forward slashes for Windows paths in EDITOR.

$EDITOR takes precedence over $VISUAL. The fallback is vi on Unix and notepad on Windows. See Files and EDIT for the round trip.

Startup choices

Invocation Result
anterepl Start a fresh session
anterepl program.pl Load ordinary Perl without running it
anterepl program.bperl Load numbered source without running it
anterepl --quiet Hide the banner
anterepl --plain Use plain input; --no-readline is an alias
anterepl --help or anterepl -h Print complete HELP and exit
anterepl --version Print the application version
anterepl -- -example.pl Load a filename beginning with a hyphen

Next: First session.

Clone this wiki locally