view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    App::VivaldiUtils - Utilities related to the Vivaldi browser

VERSION
    This document describes version 0.011 of App::VivaldiUtils (from Perl
    distribution App-VivaldiUtils), released on 2023-10-28.

SYNOPSIS
DESCRIPTION
    This distribution includes several utilities related to the Vivaldi
    browser:

    1. kill-vivaldi
    2. list-vivaldi-profiles
    3. pause-vivaldi
    4. ps-vivaldi
    5. restart-vivaldi
    6. start-vivaldi
    7. terminate-vivaldi
    8. unpause-vivaldi
    9. vivaldi-has-processes
    10. vivaldi-is-paused
    11. vivaldi-is-running

FUNCTIONS
  pause_vivaldi
    Usage:

     pause_vivaldi(%args) -> [$status_code, $reason, $payload, \%result_meta]

    Pause (kill -STOP) Vivaldi.

    A modern browser now runs complex web pages and applications. Despite
    browser's power management feature, these pages/tabs on the browser
    often still eat considerable CPU cycles even though they only run in the
    background. Pausing (kill -STOP) the browser processes is a simple and
    effective way to stop CPU eating on Unix and prolong your laptop battery
    life. It can be performed whenever you are not using your browser for a
    little while, e.g. when you are typing on an editor or watching a movie.
    When you want to use your browser again, simply unpause (kill -CONT) it.

    This function is not exported.

    Arguments ('*' denotes required arguments):

    *   cmndline_pat => *re_from_str*

        Filter processes using regex against their cmndline.

        If one of the "*-pat" options are specified, then instead of the
        default heuristic rules to find the browser processes, these "*-pat"
        options are solely used to determine which processes are the browser
        processes.

    *   exec_pat => *re_from_str*

        Filter processes using regex against their exec.

        If one of the "*-pat" options are specified, then instead of the
        default heuristic rules to find the browser processes, these "*-pat"
        options are solely used to determine which processes are the browser
        processes.

    *   fname_pat => *re_from_str*

        Filter processes using regex against their fname.

        If one of the "*-pat" options are specified, then instead of the
        default heuristic rules to find the browser processes, these "*-pat"
        options are solely used to determine which processes are the browser
        processes.

    *   pid_pat => *re_from_str*

        Filter processes using regex against their pid.

        If one of the "*-pat" options are specified, then instead of the
        default heuristic rules to find the browser processes, these "*-pat"
        options are solely used to determine which processes are the browser
        processes.

    *   users => *array[unix::uid::exists]*

        Kill browser processes that belong to certain user(s) only.

    Returns an enveloped result (an array).

    First element ($status_code) is an integer containing HTTP-like status
    code (200 means OK, 4xx caller error, 5xx function error). Second
    element ($reason) is a string containing error message, or something
    like "OK" if status is 200. Third element ($payload) is the actual
    result, but usually not present when enveloped result is an error
    response ($status_code is not 2xx). Fourth element (%result_meta) is
    called result metadata and is optional, a hash that contains extra
    information, much like how HTTP response headers provide additional
    metadata.