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. |
|
repair
Package repair holds what an operator-present repair of a failed autoupdate bump needs: the repair bundle written beside a kept staged tree (its schema, its redacted failure text, its atomic write), the lookup that finds it again by package, and the argv of the interactive claude session seeded with it.
|
Package repair holds what an operator-present repair of a failed autoupdate bump needs: the repair bundle written beside a kept staged tree (its schema, its redacted failure text, its atomic write), the lookup that finds it again by package, and the argv of the interactive claude session seeded with it. |
|
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? |
|
vendor
Package vendor handles the vendor tarball of a staged Go candidate ebuild.
|
Package vendor handles the vendor tarball of a staged Go candidate ebuild. |
|
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. |
|
smartmon
Package smartmon lists the drives udisks2 exports with their SMART verdict and tells when that verdict may have changed, over D-Bus.
|
Package smartmon lists the drives udisks2 exports with their SMART verdict and tells when that verdict may have changed, over D-Bus. |
|
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. |
|
unitmon
Package unitmon lists the units a systemd manager reports failed and tells when any unit's ActiveState may have changed, over D-Bus.
|
Package unitmon lists the units a systemd manager reports failed and tells when any unit's ActiveState may have changed, 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. |
|
pending
Package pending asks Portage what is waiting on this host: the packages an `emerge --pretend --update --deep --newuse @world` would merge, and the security advisories `glsa-check --list affected` reports as applicable.
|
Package pending asks Portage what is waiting on this host: the packages an `emerge --pretend --update --deep --newuse @world` would merge, and the security advisories `glsa-check --list affected` reports as applicable. |
|
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 sysmon reads host resource figures for bentoo-tray: memory from /proc/meminfo, pressure stall information from /proc/pressure, free disk space and running emerge processes.
|
Package sysmon reads host resource figures for bentoo-tray: memory from /proc/meminfo, pressure stall information from /proc/pressure, free disk space and running emerge processes. |
|
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.