Files
2024-10-14 00:08:40 +02:00

87 lines
2.0 KiB
Perl

# --
# Copyright (C) 2001-2019 OTRS AG, https://otrs.com/
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see
# the enclosed file COPYING for license information (GPL). If you
# did not receive this file, see https://www.gnu.org/licenses/gpl-3.0.txt.
# --
package Kernel::System::Console::Command::Dev::Tools::Shell;
use strict;
use warnings;
use parent qw(Kernel::System::Console::BaseCommand);
our @ObjectDependencies = (
'Kernel::System::Main',
);
sub Configure {
my ( $Self, %Param ) = @_;
$Self->Description('An interactive REPL shell for the OTRS API.');
$Self->AddOption(
Name => 'eval',
Description => 'Perl code that should be evaluated in the OTRS context.',
Required => 0,
HasValue => 1,
ValueRegex => qr/.*/smx,
);
return;
}
sub PreRun {
my ( $Self, %Param ) = @_;
my @Dependencies = ( 'Devel::REPL', 'Data::Printer' );
DEPENDENCY:
for my $Dependency (@Dependencies) {
if ( !$Kernel::OM->Get('Kernel::System::Main')->Require( $Dependency, Silent => 1 ) ) {
die
"Required Perl module '$Dependency' not found. Please make sure the following dependencies are installed: "
. join( ' ', @Dependencies );
}
}
return 1;
}
sub Run {
my ( $Self, %Param ) = @_;
my $Repl = Devel::REPL->new();
for my $Plugin (qw(History LexEnv MultiLine::PPI FancyPrompt OTRS)) {
$Repl->load_plugin($Plugin);
}
# fancy things are made with love <3
$Repl->fancy_prompt(
sub {
my $Self = shift;
return sprintf 'OTRS: %03d%s> ',
$Self->lines_read(),
$Self->can('line_depth') ? ':' . $Self->line_depth() : '';
}
);
$Repl->ColoredOutput( $Self->{ANSI} );
my $Code = $Self->GetOption('eval');
if ($Code) {
my @Result = $Repl->formatted_eval($Code);
$Self->Print("@Result") if !$Repl->exit_repl();
}
else {
$Repl->run();
}
return $Self->ExitCodeOk();
}
1;