view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    App::orgadb - An opinionated Org addressbook toolset

VERSION
    This document describes version 0.020 of App::orgadb (from Perl
    distribution App-orgadb), released on 2025-06-19.

SYNOPSIS
DESCRIPTION
    This distribution includes the following CLI's:

    *   orgadb-sel

FUNCTIONS
  select
    Usage:

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

    Select Org addressbook entries/fields/subfields.

    This function is not exported.

    Arguments ('*' denotes required arguments):

    *   category => *str_or_re*

        Find entry by string or regex search against the category title.

    *   clipboard => *str*

        Whether to copy matching field values to clipboard.

        If set to "tee", then will display matching fields to terminal as
        well as copy matching field values to clipboard.

        If set to "only", then will not display matching fields to terminal
        and will only copy matching field values to clipboard.

        Mnemonic for short option "-y" and "-Y": *y*ank as in Emacs ("C-y").

    *   color => *str* (default: "auto")

        Whether to use color.

    *   color_theme => *perl::colortheme::modname_with_optional_args*

        (No description)

    *   count => *true*

        Return just the number of matching entries instead of showing them.

    *   detail => *bool*

        Instead of showing matching field values, display the whole entry.

        Mnemonic for shortcut option "-l": the option "-l" is usually used
        for the short version of "--detail", as in *ls* Unix command.

    *   entry => *str_or_re*

        Find entry by string or regex search against its title.

    *   entry_match_mode => *str* (default: "default")

        How entry should be matched.

        The default matching mode is as follow:

         str       Substring matching
         /re/      Regular expression matching

        If matching mode is set to "exact", then matching will be done by
        string equality test. This mode is basically a shorter alternative
        to having to specify:

         /^\Qre\E$/

        Matching mode "exact-ci" is like "exact" except case-insensitive. It
        is equivalent to:

         /^\Qre\E$/i

    *   field_match_mode => *str* (default: "default")

        How entry should be matched.

        The default matching mode is as follow:

         str       Substring matching
         /re/      Regular expression matching

        If matching mode is set to "exact", then matching will be done by
        string equality test. This mode is basically a shorter alternative
        to having to specify:

         /^\Qre\E$/