Fsdb::F...l_to_db(3)

📦
version 3.9 · 3 versions
, in epel 9

✨ yaml_to_db ✨ (the manual page is Fsdb::F...l_to_db(3))

okay so bestie, this is the User Contributed Perl Documentation page for yaml_to_db, and it is lowkey iconic in a “tiny filter that does one thing” way. 💅 We’re gonna get you comfy with it, no cap.

🎀 NAME 🎀

yaml_to_db — convert a subset of YAML into fsdb. That’s the whole vibe. 🦋

🌈 SYNOPSIS 🌈

yaml_to_db <source.yaml

🧚 DESCRIPTION 🧚

So here’s the tea: this thing converts a very limited subset of YAML into Fsdb format. It is not out here doing general YAML sorcery — it’s a niche little gremlin and we love her. 🫶

The input is YAML-format (not fsdb). The input is parsed as YAML, assuming the file is an array of dictionary entries. We extract the dictionary names and output this as an fsdb table. Slay. ✨

We also flatten one level of lists into comma-separated values. iykyk 🍓

The output is tab-separated fsdb. (Someday more general field separators should be supported.) Not today, though. 😭

💖 OPTIONS 💖

This module also supports the standard fsdb options:

  • -d — enable debugging output. Spill the diagnostics, bestie. 🔍
  • -i or --input InputSource — read from InputSource, typically a file name, or "-" for standard input, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects. 📥
  • -o or --output OutputDestination — write to OutputDestination, typically a file name, or "-" for standard output, or (if in Perl) a IO::Handle, Fsdb::IO or Fsdb::BoundedQueue objects. 📤
  • --autorun or --noautorun — by default, programs process automatically, but Fsdb::Filter objects in Perl do not run until you invoke the run() method. The "--(no)autorun" option controls that behavior within Perl. 🎛️
  • --help — show help. 🆘
  • --man — show full manual. 📖

🌸 SAMPLE USAGE 🌸

📥 Input:

- name: ACM
  role: sponsor
  alttext: ACM, the Association for Computing Machinery
  image: logos/acm-small.jpg
  link:  https://www.acm.org/
  date: 2016-01-01

- name: SIGCOMM
  role: sponsor
  alttext: SIGCOMM, ACM'S Special Interest Group on Communication
  image: logos/sigcommlogo.png
  link:  http://sigcomm.org
  date: 2016-01-02

- name: SIGMETRICS
  role: sponsor
  alttext: SIGMETRICS, ACM'S Special Interest Group on Performance Evaluation
  image: logos/sigmetrics-small.png
  link:  http://www.sigmetrics.org
  date: 2016-01-03

🪄 Command:

yaml_to_db <gnupod.yaml

📤 Output:

#fsdb -F t alttext date image link name role
ACM, the Association for Computing Machinery    2016-01-01    logos/acm-small.jpg    https://www.acm.org/    ACM    sponsor
SIGCOMM, ACM'S Special Interest Group on Communication    2016-01-02    logos/sigcommlogo.png    http://sigcomm.org    SIGCOMM    sponsor
SIGMETRICS, ACM'S Special Interest Group on Performance Evaluation    2016-01-03    logos/sigmetrics-small.png    http://www.sigmetrics.org    SIGMETRICS    sponsor
#   | yaml_to_db

👀 SEE ALSO 👀

Fsdb. Go check the mothership, bestie. 🚀

👑 CLASS FUNCTIONS 👑

🧚 new

$filter = new Fsdb::Filter::yaml_to_db(@arguments);

Create a new yaml_to_db object, taking command-line arguments. Main character constructor energy. ✨

🎀 set_defaults

$filter->set_defaults();

Internal: set up defaults. Housekeeping, but make it cute. 🧹

🦋 parse_options

$filter->parse_options(@ARGV);

Internal: parse command-line arguments. Reading the room, aka the @ARGV. 📝

🌈 setup

$filter->setup();

Internal: setup, parse headers. Getting the table ready for its close-up. 💅

🔥 run

$filter->run();

Internal: run over each rows. Go off, filter. 🔥

Copyright (C) 2011-2018 by John Heidemann <johnh@isi.edu>

This program is distributed under terms of the GNU general public license, version 2. See the file COPYING with the distribution for details. 📜

That’s the tea! This page came from perl v5.32.1, dated 2024-08-02, and it is the Fsdb::F...l_to_db(3) manual page. Stay slaying, bestie. 💖✨🎀

📦 where this page comes from