NAME

Acme::Shell - Interactive Perl 5 shell

VERSION

This document is for version .002 of Acme::Shell.

SYNOPSIS

A wrapper script, acme-sh, is included with this distribution.

Welcome to Acme::Shell.

Commands:
  exit          # exit
  ?pkgname      # perldoc for named package
  !cmd          # spawn system shell and run cmd

Hitting <return> 2 times will eval the buffer and continue.

perl> print "$$\n";
perl> 
2730
perl> my $var = "Hello there";
perl> 
perl> print "$var\n";
perl> 
Hello there
perl> if ( $var ) {
perl>   print "Still in scope: $var\n";
perl> } else {
perl>   die "This should never happen!\n";
perl> }
perl> 
Still in scope: Hello there
perl> exit

acme-sh just does this:

use Acme::Shell;

my $shell = Acme::Shell->new();

$shell->run();

DESCRIPTION

This module glues Term::ReadLine to Lexical::Persistence, forming the basis for a very simple interactive Perl 5 shell. There isn't much to it.

If Term::ReadLine::Gnu is not available on the local system, certain features like tab completion, up/down arrow support, and history file (~/.acmesh_history) will not work.

SEE ALSO

Lexical::Persistence, Term::ReadLine

Acme::Shell is on GitHub: http://github.com/aayars/acme-sh

Acme::Shell was originally included as an experimental add-on for OP.

AUTHOR

Alex Ayars <pause@nodekit.org>

COPYRIGHT

 File: Acme/Shell.pm

 Copyright (c) 2009 TiVo Inc.

 All rights reserved. This program and the accompanying materials
 are made available under the terms of the Common Public License v1.0
 which accompanies this distribution, and is available at
 http://opensource.org/licenses/cpl1.0.txt