BOTCH-GRAPH2TEXT(1)

✨ BOTCH-GRAPH2TEXT ✨

okay bestie, welcome to botch-graph2text, one of the botch tools 👑 — she takes a graph and just. prints stuff. one line per vertex, formatted exactly how you want it. it's giving "graph in, text out", and honestly? obsessed. 💅

---

🎀 NAME 🎀

botch-graph2text — for each vertex in a graph, print a formatted line on standard output 💖

---

🦋 SYNOPSIS 🦋

botch-graph2text [options] [ingraph] formatstring

---

🌸 DESCRIPTION 🌸

so you hand her a formatstring shaped like "{attr1} {attr2}...", and she prints a line in that exact format for every single vertex in the graph, swapping each "{attr}" placeholder for the value of the attribute "attr" on that vertex. no cap. ✨

but listen — if there's no attribute named "attr" to be found, the placeholder "{XXX}" just… stays there in the output. it does not get quietly deleted, it does not get replaced with vibes, it's literally still sitting in your string. 😭

wanna write an actual literal opening or closing curly brace? type it twice, respectively. that's the whole trick. 🫶

and the special placeholder "{__ID__}"? that one gets replaced with the vertex identifier. iconic. 🎀

if the positional arguments are omitted, she reads GraphML or dot from standard input. and if you pass a - as either argument, that explicitly says "read the input from standard input". the input graph type? determined automatically, bestie, she just knows. 💅

---

💜 OPTIONS 💜

• -h, --help — display help. that's it, that's the option. 🌈
• --vertex=VERT — this one picks which set of vertices actually gets output. the VERT argument is a key/value pair (separated by a colon) made of a graph attribute and its value. and by default, like, without this option at all? every vertex in the graph is considered. 🦋
  • the special key "__ID__" lets you select the unique vertex identifier. 👑
  • this option can be specified more than once. the final set of vertices is chosen such that all vertices match all key/value pairs — so multiple --vertex options form a logical conjunction (they are AND-ed together). periodt. ⭐
• -v, --verbose — be verbose. tell me everything, queen. 🗣️

---

🔥 EXAMPLE 🔥

Find all source packages that build depend on "texlive-binaries:amd64 (=2015.20150524.37493-5)". 😤

Using package selection and reverse dependency cone computation by ceve:

dose-ceve -r "texlive-binaries:amd64 (= 2015.20150524.37493-5)" --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
        | botch-graph-sources - - \
        | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
        | sort

Using package selection and ancestor vertex computation by botch:

dose-ceve --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
        | botch-graph-ancestors - - --target realpackage:texlive-binaries:amd64 realversion:2015.20150524.37493-5 \
        | botch-graph-sources - - \
        | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
        | sort

---

💀 BUGS 💀

See <http://bugs.debian.org/botch>.

(if something's cursed, that's where you go. not me. 🙈)

---

🌈 SEE ALSO 🌈

Debian doc-base Manual /usr/share/doc/botch/wiki/Home.html

---

💖 AUTHOR 💖

This man page was written by Johannes Schauer. Botch is written by Johannes Schauer and Pietro Abate. 🫶

---

👑 COPYRIGHT 👑

Copyright 2012-2014 Johannes Schauer, Pietro Abate

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. A special linking exception to the GNU Lesser General Public License applies to this library, see the COPYING file for more information.

---

ngl, that license paragraph is long but it matters — read it, don't skip it, bestie. 💅

okay that's the whole page, you're so welcome 🎀 this was botch-graph2text, from the botch tools era, page version from perl v5.36.0 dated 2023-02-17 — bye bye, go format some vertices, mwah 💋✨