pbot/lib/PBot/Plugin/RunCommand.pm

# File: RunCommand.pm
#
# Purpose: Runs a system command, streaming each line of output in real-time.
#
# WARNING: The `runcmd` command will allow a user to run any command on your
# system. Do not give out the `can-runcmd` capability to anyone you do not
# absolutely trust 100%. Instead, make a locked-down factoid; i.e.:
#
#   factalias ls runcmd ls $args
#   factset ls cap-override can-runcmd
#   factset ls locked 1
#
# The above will create an `ls` alias that can only run `runcmd ls $args` and
# cannot be modified by anybody. The cap-override is necessary so the factoid
# itself has permission to use `runcmd` regardless of whether the user has the
# `can-runcmd` capability.
#
# This plugin is not in data/plugin_autoload. Load at your own risk.

# SPDX-FileCopyrightText: 2021-2023 Pragmatic Software <pragma78@gmail.com>
# SPDX-License-Identifier: MIT

package PBot::Plugin::RunCommand;
use parent 'PBot::Plugin::Base';

use PBot::Imports;

use IPC::Run qw/start pump finish/;

sub initialize($self, %conf) {
    $self->{pbot}->{commands}->add(
        name => 'runcmd',
        help => 'Executes a system command and outputs each line in real-time',
        requires_cap => 1,
        subref => sub { $self->cmd_runcmd(@_) },
    );
}

sub unload($self) {
    $self->{pbot}->{commands}->remove('runcmd');
}

sub cmd_runcmd($self, $context) {
    my @args = $self->{pbot}->{interpreter}->split_line($context->{arguments}, strip_quotes => 1);

    my ($in, $out, $err);

    my $h = eval { start \@args, \$in, \$out, \$err };

    if ($@) {
        return "Error starting command: $@";
    }

    my $lines = 0;

    while (pump $h) {
        $lines += $self->send_lines($context, \$out);
        $lines += $self->send_lines($context, \$err);
    }

    finish $h;

    $lines += $self->send_lines($context, \$out, 1);
    $lines += $self->send_lines($context, \$err, 1);

    return "No output." if not $lines;
}

sub send_lines($self, $context, $buffer, $send_all = 0) {
    my $lines = 0;

    my $regex;

    if ($send_all) {
        # all lines
        $regex = qr/(.{1,450})/;
    } else {
        # lines that end with a newline
        $regex = qr/^(.{1,450})\s+/;
    }

    while ($$buffer =~ s/$regex//) {
        my $line = $1;
        $line =~ s/^\s+|\s+$//g;

        if (length $line) {
            $self->{pbot}->{conn}->privmsg($context->{from}, $line);
            $lines++;
        }
    }

    return $lines;
}

1;