BOTCH-GRAPH-ANCESTORS(1)

💅 botch-graph-ancestors(1) — a botch tools moment

okay bestie, welcome to the manual page for botch-graph-ancestors, one of the lil botch tools 👑 this is the whole vibe, let's get into it 🫶

---

✨ NAME ✨

botch-graph-ancestors — find all ancestors of a vertex in a graph in GraphML or dot format 🌳💖

---

🌸 SYNOPSIS 🌸

botch-graph-ancestors [options] --target TARGET [--target TARGET ...] [ingraph] [outgraph]

---

🦋 DESCRIPTION 🦋

So basically it pulls out the subgraph of all the ancestors of one specific node in your input graph. ancestor core, ancestor crown, the whole bloodline 💀✨

The --target option is mandatory, no cap. and you can drop it more than once if you're feeling extra.

If either (or both 😌) of the positional arguments gets omitted, then it reads GraphML or dot from standard input and/or writes GraphML or dot to standard output, respectively. And if you pass a - as either argument? that's you explicitly saying "read from stdin" and "write to stdout" respectively. iconique.

The input graph type is figured out automatically, it just knows 🔮 If the output graph is given as a filename, then the output type is GraphML if the filename ends with .xml and dot if the filename ends with .dot. And if the output goes to standard output, then it happens in the same format as the input graph. periodt.

---

💖 OPTIONS 💖

• -h, --help — Display help. bestie behaviour honestly 🥰
• --target=TARGET — This one picks the target vertex of which the ancestors are computed. The TARGET argument is a key/value pair (separated by a colon) of a graph attribute and its desired value. If more than one vertex matches the given key/value pair, then the smallest (by node comparison) is chosen. ✨

The special key "__ID__" lets you select the unique vertex identifier. iykyk 🔑

This option can be specified more than once. The final set of vertices is chosen such that all vertices match all key/value pairs. Multiple --target options thus form a logical conjunction (they are AND-ed together). yes, it's giving strict. it's giving AND gate. slay 🔥

• -v, --verbose — Be verbose. tell me everything, I'm listening 🍓

---

🌈 EXAMPLE 🌈

Extract the subgraph of all ancestors of a binary packages vertex with name "build-essential" and version "11.7".

botch-graph-ancestors --target name:build-essential --target version:11.7 --target type:bin < in.xml > out.xml

or giving input and output as positional arguments:

botch-graph-ancestors --target name:build-essential --target version:11.7 --target type:bin in.xml out.xml

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 --target realversion:2015.20150524.37493-5 - - \
        | botch-graph-sources - - \
        | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
        | sort

---

💀 BUGS 💀

See <http://bugs.debian.org/botch>. (not me sending you straight to the bug tracker 😭 it's fine, it's fine, they're on it)

---

🎀 SEE ALSO 🎀

Debian doc-base Manual /usr/share/doc/botch/wiki/Home.html — go read it, it's the lore 📚

---

👑 AUTHOR 👑

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

---

⭐ 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.

---

fr fr, that's the whole page, no notes, nothing skipped 💅✨

and that's a wrap bestie!! this beauty is living under perl v5.36.0, dated 2023-02-17, filed as BOTCH-GRAPH-ANCESTORS(1) — go forth and find those ancestors 🌳💖🎀