botch(1)

📦
version 0.24 · 6 versions
, in debian bookworm, ubuntu noble

✨ botch — bootstrap/build order tool chain ✨

okay bestie, sit down, hydrate, because botch is a whole tool chain and it is lowkey iconic 💖

🌸 NAME 🌸

botch — bootstrap/build order tool chain 🫶

💅 DESCRIPTION 💅

botch is a collection of tools to create and analyze dependency graphs. This task is facilitated by a range of individual tools which use the deb822 and graphml formats to exchange information with each other. no cap, that's the whole vibe 💫

Also consider browsing the HTML based doc-base Manual at /usr/share/doc/botch/wiki/Home.html — it's giving very much "read the docs, bestie" energy 📖✨

The tools that botch ships allow one to:

🎀 set operations on Packages or Sources files

  • botch-packages-difference — calculate the asymmetric set difference
  • botch-packages-intersection — calculate the set intersection
  • botch-packages-union — calculate the set union

🦋 transform Packages and Sources control files

  • botch-latest-version — only keep the latest version
  • botch-bin2src — convert binary packages to their source packages
  • botch-src2bin — turn source packages into their binary packages
  • botch-clean-repository — clean errors in a repository by removing transitively uninstallable or compilable packages
  • botch-add-arch — add architecture to source packages
  • botch-convert-arch — convert the architecture of a Packages file
  • botch-remove-virtual-disjunctions — remove virtual dependency disjunctions
  • botch-optuniv — self contained repository with minimal number of source packages
  • botch-fix-cross-problems — fix Packages files with the output of botch-cross-problems
  • botch-filter-src-builds-for — filter a Sources file for the packages building for a certain architecture

🌈 analysis of Packages and Sources control files

  • botch-packages-diff — create a diff between two Packages or Sources files
  • botch-ma-diff — diff two packages files for differences in their multiarch values
  • botch-apply-ma-diff — applies a multiarch diff as created by botch-ma-diff
  • botch-check-ma-same-versions — check if Multi-Arch:same versions are in sync

👑 create graphs of different types

  • botch-create-graph — create graph based on installation sets, strong dependency sets or dependency closures
  • botch-annotate-strong — add strong dependency information to a dependency graph

🧚 conversion of graphs

  • botch-buildgraph2srcgraph — converts a buildgraph into a srcgraph
  • botch-graphml2dot — converts graphml to dot
  • botch-collapse-srcgraph — make a srcgraph acyclic by collapsing its strongly connected components
  • botch-profile-build-fvs — remove droppable dependencies from graph
  • botch-buildgraph2packages — convert buildgraph to packages
  • botch-graph-tred — find the transitive reduction of a graph in GraphML or dot format
  • botch-graph2text — for each vertex in a graph print a formatted line on standard output

🍓 extract regions from graphs

  • botch-graph-neighborhood — extract the neighborhood around a vertex
  • botch-extract-scc — extract all strongly connected components
  • botch-graph-ancestors — find all ancestors of a vertex in a graph in GraphML or dot format
  • botch-graph-descendants — find all descendants of a vertex in a graph in GraphML or dot format
  • botch-graph-shortest-path — find the shortest path(s) between two vertices of a graph in GraphML or dot format
  • botch-graph-sinks — find all sinks (vertices without successors) in a graph in GraphML or dot format
  • botch-graph-sources — find all sources (vertices without predecessors) in a graph in GraphML or dot format

💜 dose3 wrappers

  • botch-dose2html — turn the yaml output by dose-builddebcheck into html
  • botch-buildcheck-more-problems — a tool like dose-builddebcheck but return more than the first reason
  • botch-distcheck-more-problems — a tool like dose-distcheck but return more than the first reason

⭐ analyze graphs

  • botch-calcportsmetric — calculate source package importance
  • botch-calculate-fas — calculate a feedback arc set
  • botch-find-fvs — calculate a feedback vertex set
  • botch-graph-difference — graph diff
  • botch-graph-info — show info about a buildgraph or sourcegraph
  • botch-partial-order — calculate the partial vertex order
  • botch-print-stats — find cycles, selfcycles, amount of cycles through edges, feedback arc and vertex set, strong articulation points and bridges
  • botch-multiarch-interpreter-problem — find all arch:all packages that allow switching architectures

🎀 create build orders

  • botch-build-fixpoint — find build order until dependency cycles occur
  • botch-build-order-from-zero — find a build order for a non-existing architecture
  • botch-wanna-build-sortblockers — importance of source packages for ports

🌸 handling of botch-internal formats

  • botch-stat-html — turn the JSON output of botch-print-stats into human readable HTML
  • botch-droppable-diff — difference between two *.droppable files
  • botch-droppable-union — union of two *.droppable files
  • botch-checkfas — check which edges in the fas are not droppable
  • botch-fasofstats — extract feedback arc set from output of botch-print-stats
  • botch-download-pkgsrc — download Packages and Sources

💖 shell scripts connecting the tools for meaningful operations

  • botch-cross — execute botch tools in the cross phase
  • botch-native — execute botch tools in the native phase
  • botch-transition — calculate a transition order
  • botch-y-u-no-bootstrap — Find out why Debian cannot be bootstrapped.
  • botch-y-u-b-d-transitive-essential — Find out why source packages are B-D transitive essential.

🌈 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. absolute legends, fr fr 👑

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.

💌 okay that's the whole page bestie — this one's perl v5.36.0, dated 2023-02-17, and it's the botch(1) page. go forth and bootstrap, you absolute main character 🦋✨
📦 where this page comes from