How jguer/yay works
yay is a Go AUR helper for searching, querying, upgrading, and installing Arch packages from both repositories and the AUR. The main CLI initializes configuration and runtime services, then dispatches package operations; the sync operation prepares build directories, checks source metadata and PGP keys, and installs packages. Dependency solving, PKGBUILD retrieval, upgrade checks, completions, voting, and Lua customization are additional product branches. Some dispatch and build implementation files were not excerpted, so those relationships are shown only where README documentation or sampled references support them.
Main entry points: main.go CLI entry · sync.go Sync operation · alpm.go Package database · service.go Upgrade service
Components 23
CLI and Runtime
- CLI entry
main.go - Configuration
pkg/settings/config.go - Argument parsing
pkg/settings/parser/parser.go - Runtime services
pkg/runtime/runtime.go - Command dispatch
cmd.go
Package Discovery
- Package search
pkg/query/query_builder.go - Package database
pkg/db/ialpm/alpm.go - Dependency solver
pkg/dep/dep_graph.go - PKGBUILD retrieval
pkg/download/unified.go - Upgrade service
pkg/upgrade/service.go - AUR service
Build and Install
- Sync operation
pkg/sync/sync.go - Build preparation
pkg/sync/workdir/preparer.go - Source metadata
pkg/sync/srcinfo/service.go - Package installer
pkg/sync/build - PKGBUILD review
pkg/menus/diff_menu.go
System Operations
- Development tracking
pkg/vcs/vcs.go - AUR completions
pkg/completion/completion.go - Package voting
vote.go - Package queries
query.go - Package cleanup
clean.go - Lua customization
pkg/settings/lua
Other components
- CLI user
Connections 32
- CLI user → CLI entry: invokes
main.go - CLI entry → Configuration: loads
main.go - CLI entry → Argument parsing: parses options
main.go - CLI entry → Runtime services: creates
main.go - CLI entry → Package database: opens database
main.go - CLI entry → Command dispatch: dispatches
- Runtime services → Package search: creates
pkg/runtime/runtime.go - Runtime services → Development tracking: creates
pkg/runtime/runtime.go - Package search → AUR service: searches
pkg/query/query_builder.go - Package search → Package database: queries packages
pkg/query/query_builder.go - Dependency solver → Package database: resolves against
pkg/dep/dep_graph.go - Dependency solver → AUR service: retrieves package data
- PKGBUILD retrieval → AUR service: fetches package data
pkg/download/unified.go - PKGBUILD retrieval → Package database: selects package source
pkg/download/unified.go - Upgrade service → AUR service: checks updates
pkg/upgrade/service.go - Upgrade service → Dependency solver: uses dependency graph
- Sync operation → Build preparation: prepares builds
pkg/sync/sync.go - Sync operation → Source metadata: checks source metadata
pkg/sync/sync.go - Sync operation → Package installer: installs packages
pkg/sync/sync.go - Sync operation → AUR completions: updates completions
pkg/sync/sync.go - Sync operation → Lua customization: runs post-install hooks
pkg/sync/sync.go - Build preparation → PKGBUILD retrieval: retrieves build sources
- Source metadata → Development tracking: updates development records
pkg/sync/srcinfo/service.go - PKGBUILD review → CLI user: requests review
pkg/menus/diff_menu.go - Upgrade service → Package database: checks repository updates
- Command dispatch → Package queries: routes queries
- CLI user → Package queries: requests package query
README.md - CLI user → Package voting: votes packages
README.md - CLI user → Package cleanup: cleans dependencies
README.md - CLI user → AUR completions: requests completions
README.md - CLI user → Upgrade service: requests upgrades
README.md - CLI user → Sync operation: requests package install
README.md