Catman...x::cmd(3pm)

📦 version 0.0201, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Catmandu::Fix::cmd 💖

okay bestie, buckle up, because this is the manual page for Catman...x::cmd(3pm) — yes that's the manual name, it's giving "truncated by the renderer" energy but we move 🫶 — and it's a Perl fix that pipes your data through an external process. slay.

✨ NAME ✨

Catmandu::Fix::cmd — pipe data to be fixed through an external process. that's the whole vibe. external process, data goes in, data comes out, main character energy for your JSON 💅

🌸 VERSION 🌸

Version 0.0201. iconic. noted. periodt.

🦋 DESCRIPTION 🦋

so the way this works is: this fix passes data as a JSON object to an external process over stdin, and then reads a JSON object back from its stdout. that's it. that's the whole relationship. a lil data handoff between you and some other program. no cap 💜

🎀 SYNOPSIS 🎀

here's the look, bestie:

    my $fixer = Catmandu::Fix->new(fixes => [
        # pipe data through the jq command-line json processor
        # keeping only the title field
        'cmd("jq -c -M {title}")',
        # ...
    ]);

    # a canonical external program in perl
    use JSON;
    while (<STDIN>) {
        my $data = decode_json($_);
        # ...
        print encode_json($data);
    }

see that first one? you're piping data through the jq command-line json processor and keeping only the title field. taste. and then below it there's a canonical external program in perl doing the same little dance — read a line from STDIN, decode_json it, do stuff, print encode_json($data) right back out. a whole conversation. obsessed 😭💖

🌈 SEE ALSO 🌈

  • Catmandu::Fix — the whole fix family, iykyk

👑 AUTHOR 👑

Nicolas Steenlant, "<nicolas.steenlant at ugent.be>" — we love a credited author, give them their flowers fr fr 🎀

okay legal bestie moment, listen up:

This program is free software; you can redistribute it and/or modify it under the terms of either:

  1. the GNU General Public License as published by the Free Software Foundation; or
  2. the Artistic License.

See http://dev.perl.org/licenses/ for more information.

yes you can have either one. yes that's the whole deal. no cap 🫶

and that's the page, bestie!! it came to you from perl v5.36.0, dated 2023-02-04, and it's filed under Catman...x::cmd(3pm) — go forth and pipe things through other things, you've got this 💅✨🦋🌸

📦 where this page comes from