Directories
¶
| Path | Synopsis |
|---|---|
|
Package autoupdate provides automated version checking and update application for ebuilds in the Bentoo overlay.
|
Package autoupdate provides automated version checking and update application for ebuilds in the Bentoo overlay. |
|
ebuilds
Package ebuilds reads the ebuild tree of an overlay: it locates a package directory, lists its ebuilds, selects the current ebuild for a slot or a version series, splits package atoms, labels and slots, and extracts EbuildMetadata from an ebuild file.
|
Package ebuilds reads the ebuild tree of an overlay: it locates a package directory, lists its ebuilds, selects the current ebuild for a slot or a version series, splits package atoms, labels and slots, and extracts EbuildMetadata from an ebuild file. |
|
fetch
Package fetch is autoupdate's HTTP layer: the retrying client with its circuit breaker, per-host policies and body caps, the rate limiter, the response and fetch caches, header allow-listing with credential scoping, and authenticated distfile fetching driven by a record's meta.fetch_* keys, including the spec parser that --lint reuses.
|
Package fetch is autoupdate's HTTP layer: the retrying client with its circuit breaker, per-host policies and body caps, the rate limiter, the response and fetch caches, header allow-listing with credential scoping, and authenticated distfile fetching driven by a record's meta.fetch_* keys, including the spec parser that --lint reuses. |
|
fixer
Package fixer holds autoupdate's agent fixers: LLM agents, run through the Claude Code CLI with the least-privilege profile from llm, that repair a failed bump — the manifest fixer, the build fixer, the bump reviewer and the registry fixer.
|
Package fixer holds autoupdate's agent fixers: LLM agents, run through the Claude Code CLI with the least-privilege profile from llm, that repair a failed bump — the manifest fixer, the build fixer, the bump reviewer and the registry fixer. |
|
jsonpath
Package jsonpath parses the path syntax the autoupdate configuration uses to point at a value inside a JSON document, such as "tag_name", "[0].sha" or "versions[0].version".
|
Package jsonpath parses the path syntax the autoupdate configuration uses to point at a value inside a JSON document, such as "tag_name", "[0].sha" or "versions[0].version". |
|
llm
Package llm holds autoupdate's LLM providers: the OpenAI and Ollama HTTP clients and the Claude Code client that drives the local `claude` CLI, the least-privilege permission profile every agent run is given, and the classification of how a `claude` run ended.
|
Package llm holds autoupdate's LLM providers: the OpenAI and Ollama HTTP clients and the Claude Code client that drives the local `claude` CLI, the least-privilege permission profile every agent run is given, and the classification of how a `claude` run ended. |
|
parse
Package parse extracts versions from upstream content: JSON paths, regular expressions and HTML/XPath, version transforms and series selection, version-history extraction, and the validation of an extracted version against a registry record.
|
Package parse extracts versions from upstream content: JSON paths, regular expressions and HTML/XPath, version transforms and series selection, version-history extraction, and the validation of an extracted version against a registry record. |
|
registry
Package registry is the packages.toml registry: it loads and saves the file, validates each record (including its meta.fetch_* spec, judged by the fetch package's own parser), lints and repairs it, renders a record, prunes and removes records, and migrates auto-disabled entries.
|
Package registry is the packages.toml registry: it loads and saves the file, validates each record (including its meta.fetch_* spec, judged by the fetch package's own parser), lints and repairs it, renders a record, prunes and removes records, and migrates auto-disabled entries. |
|
statefile
Package statefile reads, merges and saves autoupdate's JSON state files under the inter-process file lock, so concurrent bentoo processes never lose each other's writes.
|
Package statefile reads, merges and saves autoupdate's JSON state files under the inter-process file lock, so concurrent bentoo processes never lose each other's writes. |
|
validate
Package validate answers one question about an ebuild without building it: does it still match the source it points at?
|
Package validate answers one question about an ebuild without building it: does it still match the source it points at? |
|
common
|
|
|
config
Package config loads and saves ~/.config/bentoo/config.yaml: the overlay, git identity, autoupdate, validation, UI, notice and tray settings.
|
Package config loads and saves ~/.config/bentoo/config.yaml: the overlay, git identity, autoupdate, validation, UI, notice and tray settings. |
|
distfiles
Package distfiles resolves and prepares the directory pkgdev is given as --distdir, and holds the single implementation every caller shares.
|
Package distfiles resolves and prepares the directory pkgdev is given as --distdir, and holds the single implementation every caller shares. |
|
ebuild
Package ebuild parses ebuild paths into category, package and version, and compares Gentoo versions (suffixes such as _rc and _p, and -r revisions) the way Portage orders them.
|
Package ebuild parses ebuild paths into category, package and version, and compares Gentoo versions (suffixes such as _rc and _p, and -r revisions) the way Portage orders them. |
|
filelock
Package filelock is an inter-process exclusive lock on one path.
|
Package filelock is an inter-process exclusive lock on one path. |
|
fileutil
Package fileutil provides shared helpers for file modes and for writing files that survive a crash, so every write site uses one source for permissions and one audited sequence of temp file, sync and rename.
|
Package fileutil provides shared helpers for file modes and for writing files that survive a crash, so every write site uses one source for permissions and one audited sequence of temp file, sync and rename. |
|
git
Package git runs the git commands the overlay workflow needs (status, add, commit, push, pull, fetch) under a context, with network and local timeouts, and parses their output.
|
Package git runs the git commands the overlay workflow needs (status, add, commit, push, pull, fetch) under a context, with network and local timeouts, and parses their output. |
|
github
Package github is a small GitHub Contents API client that lists the ebuild versions a repository holds for a package, with an on-disk response cache, rate-limit detection and a token resolved from the secrets chain.
|
Package github is a small GitHub Contents API client that lists the ebuild versions a repository holds for a package, with an on-disk response cache, rate-limit detection and a token resolved from the secrets chain. |
|
httpx
Package httpx provides centralized outbound HTTP transport tuning for the bentoolkit.
|
Package httpx provides centralized outbound HTTP transport tuning for the bentoolkit. |
|
logging
Package logging builds bentoo's diagnostics logger on log/slog.
|
Package logging builds bentoo's diagnostics logger on log/slog. |
|
output
Package output holds the terminal helpers the commands print with: the color palette, status and package formatting, and terminal detection that turns color off when stdout is not a terminal or NO_COLOR is set.
|
Package output holds the terminal helpers the commands print with: the color palette, status and package formatting, and terminal detection that turns color off when stdout is not a terminal or NO_COLOR is set. |
|
procgroup
Package procgroup stops a child process — and, on Unix, every process that child started — when the context it was started under is done.
|
Package procgroup stops a child process — and, on Unix, every process that child started — when the context it was started under is done. |
|
provider
Package provider reads another repository's ebuild versions, for comparing the overlay against it and reviving packages from it.
|
Package provider reads another repository's ebuild versions, for comparing the overlay against it and reviving packages from it. |
|
report
Package report is the view model of one `overlay autoupdate` run: the packages it scanned, the validation it planned, what the gates answered, and the counts that summarize all of it.
|
Package report is the view model of one `overlay autoupdate` run: the packages it scanned, the validation it planned, what the gates answered, and the counts that summarize all of it. |
|
report/render
Package render turns the view model in internal/common/report into text for a terminal: it decides how wide a column is, how a value that does not fit is cut, and how much room the line has to begin with.
|
Package render turns the view model in internal/common/report into text for a terminal: it decides how wide a column is, how a value that does not fit is cut, and how much room the line has to begin with. |
|
secrets
Package secrets resolves a named secret (an API token, a serial, ...) from a fixed, security-conscious chain and nothing else.
|
Package secrets resolves a named secret (an API token, a serial, ...) from a fixed, security-conscious chain and nothing else. |
|
tui
Package tui is a single Bubble Tea-based TUI foundation for bentoolkit.
|
Package tui is a single Bubble Tea-based TUI foundation for bentoolkit. |
|
version
Package version holds bentoo's build version, commit and date, stamped at link time through -ldflags -X by the Makefile and the ebuild.
|
Package version holds bentoo's build version, commit and date, stamped at link time through -ldflags -X by the Makefile and the ebuild. |
|
xdg
Package xdg resolves XDG Base Directory locations.
|
Package xdg resolves XDG Base Directory locations. |
|
desktop
|
|
|
dbustest
Package dbustest starts private D-Bus message buses for integration tests, so no test ever talks to the developer's own session or system bus.
|
Package dbustest starts private D-Bus message buses for integration tests, so no test ever talks to the developer's own session or system bus. |
|
dbusx
Package dbusx opens bentoo-tray's private D-Bus connections and owns its well-known bus name.
|
Package dbusx opens bentoo-tray's private D-Bus connections and owns its well-known bus name. |
|
netmon
Package netmon reports whether NetworkManager considers the machine online and the connection metered, and when either of those changes.
|
Package netmon reports whether NetworkManager considers the machine online and the connection metered, and when either of those changes. |
|
notify
Package notify sends desktop notifications over org.freedesktop.Notifications and reports the actions the user takes on them.
|
Package notify sends desktop notifications over org.freedesktop.Notifications and reports the actions the user takes on them. |
|
portal
Package portal opens a notice's URL in the user's browser: through the desktop portal's OpenURI when it answers, through xdg-open when it definitely did not act.
|
Package portal opens a notice's URL in the user's browser: through the desktop portal's OpenURI when it answers, through xdg-open when it definitely did not act. |
|
sni
Package sni exports a StatusNotifierItem (the freedesktop/KDE system tray protocol) over D-Bus.
|
Package sni exports a StatusNotifierItem (the freedesktop/KDE system tray protocol) over D-Bus. |
|
gentoo
|
|
|
news
Package news reads the portage news of one repository as notices, the tray's offline source: the unread list portage keeps under /var/lib/gentoo/news and the GLEP 42 news items that list names.
|
Package news reads the portage news of one repository as notices, the tray's offline source: the unread list portage keeps under /var/lib/gentoo/news and the GLEP 42 news items that list names. |
|
pkgdb
Package pkgdb reads Portage's installed-package database (/var/db/pkg): one directory per installed package at <root>/<CATEGORY>/<PF>/, holding a SLOT file and, for packages installed from a named repository, a repository file.
|
Package pkgdb reads Portage's installed-package database (/var/db/pkg): one directory per installed package at <root>/<CATEGORY>/<PF>/, holding a SLOT file and, for packages installed from a named repository, a repository file. |
|
repo
Package repo scans the category/package/*.ebuild layout of a Gentoo repository (an overlay) and reports the packages and versions it holds.
|
Package repo scans the category/package/*.ebuild layout of a Gentoo repository (an overlay) and reports the packages and versions it holds. |
|
Package notice authors bentoo notices: one input becomes a GLEP 42 news item in the overlay and a YAML file in the site repository, sharing one ID.
|
Package notice authors bentoo notices: one input becomes a GLEP 42 news item in the overlay and a YAML file in the site repository, sharing one ID. |
|
Package notices holds the bentoo notices feed contract: the types a notice is carried in, and the parser that turns the site's JSON Feed 1.1 document into them.
|
Package notices holds the bentoo notices feed contract: the types a notice is carried in, and the parser that turns the site's JSON Feed 1.1 document into them. |
|
Package overlay implements the overlay operations behind `bentoo overlay`: the git workflow (status, add, commit with a generated message, push, pull), version renames, Manifest regeneration, pruning of superseded ebuilds, and compare, which reads each package against a baseline repository, classifies how it diverges and, with a model available, reviews the divergence.
|
Package overlay implements the overlay operations behind `bentoo overlay`: the git workflow (status, add, commit with a generated message, push, pull), version renames, Manifest regeneration, pruning of superseded ebuilds, and compare, which reads each package against a baseline repository, classifies how it diverges and, with a model available, reviews the divergence. |
|
Package realign proves a proposed realignment of an overlay ebuild towards its ::gentoo baseline, and proving is the whole of what it does: the staged-bump ladder in internal/autoupdate/validate decides whether the realignment builds, and this package is only the composition that hands the proposal to it.
|
Package realign proves a proposed realignment of an overlay ebuild towards its ::gentoo baseline, and proving is the whole of what it does: the staged-bump ladder in internal/autoupdate/validate decides whether the realignment builds, and this package is only the composition that hands the proposal to it. |
|
Package snapshot orchestrates btrfs snapshot tooling (btrbk, systemd) through a single declarative TOML config.
|
Package snapshot orchestrates btrfs snapshot tooling (btrbk, systemd) through a single declarative TOML config. |
|
snapshottest
Package snapshottest provides test doubles for package snapshot.
|
Package snapshottest provides test doubles for package snapshot. |
|
Package tray is bentoo-tray's event loop and its notification and icon policy.
|
Package tray is bentoo-tray's event loop and its notification and icon policy. |
|
feed
Package feed fetches the bentoo notices feed over HTTPS with ETag revalidation, a body size cap and a request deadline.
|
Package feed fetches the bentoo notices feed over HTTPS with ETag revalidation, a body size cap and a request deadline. |
|
icons
Package icons holds the tray icon as SNI pixmaps.
|
Package icons holds the tray icon as SNI pixmaps. |
|
messages
Package messages is bentoo-tray's message catalog: every menu label, notification text and summary format the tray shows, in English, in one place.
|
Package messages is bentoo-tray's message catalog: every menu label, notification text and summary format the tray shows, in English, in one place. |
|
schedule
Package schedule holds the pure timing functions of bentoo-tray: the startup delay, the jittered check interval and the failure backoff.
|
Package schedule holds the pure timing functions of bentoo-tray: the startup delay, the jittered check interval and the failure backoff. |
|
state
Package state persists bentoo-tray's state: the feed ETag and serial, the read state and source of every notice, the pause end, the backoff and the earliest next fetch.
|
Package state persists bentoo-tray's state: the feed ETag and serial, the read state and source of every notice, the pause end, the backoff and the earliest next fetch. |
|
version
Package version is bentoo-tray's own version, independent of the bentoolkit release it ships in.
|
Package version is bentoo-tray's own version, independent of the bentoolkit release it ships in. |
Click to show internal directories.
Click to hide internal directories.