NAME

PLSH - Perl Shell

SYNOPSIS

 plsh [options] [args]

DESCRIPTION

Creates an interactive Perl shell. Startup configuration commands written in Perl syntax can be stored in '.plshrc' file in HOME directory (e.g., $HOME on Linxu, %USERPROFILE% on Windows) which will initialize the Perl Shell on every startup.

OPTIONS

 -E                   Exit after -e commands complete.
 --exit

 -e                   Valid Perl to execute.  Multiple valid Perl
 --execute            statements (semicolon-separated) and multiple
                      -e allowed.

 -f                   Perl feature set to use.  Example: ":5.10"
 --feature            DEFAULT:  (or not specified) ":default"

 -I dir               Specify directory to prepend @INC.  Multiple
 --Include            -I allowed.

 -l                   Require "my" for all variables.
 --lexical            Requires Lexical::Persistence, fails if not found.

 -P package           Package to use as namespace.  Will:
 --package              use `package';
                      before any -e arguments.

 -p prompt            Prompt for the shell.
 --prompt

 -s file              Session command log file.
 --session

 -V                   Output verbose initialization information.
 --verose

 --help               Print Options and Arguments.
 --man                Print complete man page.
 --versions           Print Modules, Perl, OS, Program info.

CONFIGURATION

An example '.plshrc' file.

    use App::PerlShell::Plugin::Macros;

    # do not require a semicolon to terminate each line
    $ENV{PERLSHELL_SEMIOFF}=1;
    # turn on feature 5.10 (use feature ':5.10';)
    $ENV{PERLSHELL_FEATURE}=":5.10";

    # override the `version` command
    no warnings 'redefine'; *App::PerlShell::version = sub { print "MyVersion" }

ORDER

Command line options -f, -p, -P override .'plshrc'.

1. Prepend any -I paths to @INC.

2. Set -P package. If provided, set -e to "use <package>".

3. Add any commmands from '$HOME/.plshrc' file if exists in HOME directory.

4. Add any commmands from '.plshrc' file if exists in working directory.

5. Add any additional -e arguments to -e.

6. If -E, add "exit;" to end of -e.

EXAMPLES

The following two examples accomplish the same thing.

Command Line

 plsh.pl -e "print join ' ', @ARGV;" -E hello world

Interactive

 C:\> plsh.pl
 Perl> print "hello world";
 Perl> exit;

SEE ALSO

App::PerlShell

LICENSE

This software is released under the same terms as Perl itself. If you don't know what that means visit http://perl.com/.

AUTHOR

Copyright (c) 2015-2022 Michael Vincent

http://www.VinsWorld.com

All rights reserved