Devel::REPL::Profile
package Devel::REPL::Profile::MyProject; use Moose; use namespace::clean -except => [ 'meta' ]; with 'Devel::REPL::Profile'; sub apply_profile { my ($self, $repl) = @_; # do something here } 1;
For particular projects you might well end up running the same commands each time the REPL shell starts up - loading Perl modules, setting configuration, and so on.
A mechanism called profiles exists to let you package and distribute these start-up scripts, as Perl modules.
Quite simply, follow the "SYNOPSIS" section above to create a boilerplate profile module. Within the apply_profile method, the $repl variable can be used to run any commands as the user would, within the context of their running Devel::REPL shell instance.
apply_profile
$repl
Devel::REPL
For example, to load a module, you might have something like this:
sub apply_profile { my ($self, $repl) = @_; $repl->eval('use Carp'); }
As you can see, the eval method is used to run any code. The user won't see any output from that, and the code can "safely" die without destroying the REPL shell. The return value of eval will be the return value of the code you gave, or else if it died then a Devel::REPL::Error object is returned.
eval
Devel::REPL::Error
If you want to load a Devel::REPL plugin, then use the following method:
$repl->load_plugin('Timing');
The load_plugin and eval methods should cover most of what you would want to do before the user has access to the shell. Remember that plugin features are immediately available, so you can load for example the LexEnv plugin, and then declare my variables which the user will have access to.
load_plugin
LexEnv
my
To run the shell with a particular profile, use the following command:
system$ re.pl --profile MyProject
Alternatively, you can set the environment variable DEVEL_REPL_PROFILE to MyProject.
DEVEL_REPL_PROFILE
When the profile name is unqualified, as in the above example, the profile is assumed to be in the Devel::REPL::Profile:: namespace. Otherwise if you pass something which contains the :: character sequence, it will be loaded as-is.
Devel::REPL::Profile::
::
Matt S Trout - mst (at) shadowcatsystems.co.uk (http://www.shadowcatsystems.co.uk/)
This library is free software under the same terms as perl itself
To install Devel::REPL, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Devel::REPL
CPAN shell
perl -MCPAN -e shell install Devel::REPL
For more information on module installation, please visit the detailed CPAN module installation guide.