Yet another Yogurt - An AUR Helper written in Go
Clone or download
Latest commit ade9eb8 Sep 25, 2018
Permalink
Failed to load latest commit information.
.go Improve makefile Mar 23, 2018
completions Remove non existant show options and add missing -Pg Sep 23, 2018
doc Fix misleading word in man page and missing \n Sep 19, 2018
testdata Add test for reading pacman config Sep 10, 2018
vendor/github.com Update vendored dependencies Sep 14, 2018
.gitignore fix Makefile and fix README Feb 17, 2018
Gopkg.lock Update vendored dependencies Sep 14, 2018
Gopkg.toml Add go-pacmanconf Sep 10, 2018
ISSUE_TEMPLATE.md Update issue template Sep 25, 2018
LICENSE Create LICENSE Sep 5, 2016
Makefile Fixup Makefile Sep 23, 2018
README.md Fix typo Aug 30, 2018
callbacks.go Fix provider menu showing when it shouldn't Sep 25, 2018
clean.go Use go-pacmanconf for config parsing Sep 10, 2018
cmd.go Fix misleading word in man page and missing \n Sep 19, 2018
completions.go Correctly set config.AURURL after parsing flags Aug 19, 2018
config.go Fix provider menu showing when it shouldn't Sep 25, 2018
config_test.go Fix hard coded path Sep 15, 2018
dep.go getBases now wants a slice instead of a map Aug 18, 2018
depCheck.go Abort ealy when there's conflicts with --noconfirm Jul 20, 2018
depOrder.go Fix depends sometimes being ordered incorrectly Sep 4, 2018
depPool.go Fix provider menu showing when it shouldn't Sep 25, 2018
download.go Limit download concurrency to 25 threads Sep 4, 2018
exec.go Use go-pacmanconf for config parsing Sep 10, 2018
install.go Fix --rebuild logic Sep 4, 2018
keys.go implement formatPkgbase as Base.String Aug 18, 2018
keys_test.go Fix tests Aug 29, 2018
main.go Fix build when go module is enabled Sep 15, 2018
parser.go Accept --assume-installed Sep 23, 2018
parser_test.go Support commas in parserNumberMenu Jul 2, 2018
print.go Fix -Qu to respect -q. Fixes #726 Sep 24, 2018
print_test.go Fix tests Aug 29, 2018
query.go Use MultiError in other goroutines Aug 9, 2018
query_test.go Fixed tests for unified structure Aug 7, 2017
upgrade.go Use MultiError in other goroutines Aug 9, 2018
upgrade_test.go Fix tests Aug 29, 2018
utils.go MultiError: add new lines between errors Aug 18, 2018
vcs.go Remove the timeout warning for vcs checks Aug 28, 2018
vcs_test.go Fix tests Aug 29, 2018

README.md

Yay

Yet Another Yogurt - An AUR Helper Written in Go

Packages

yay yay-bin yay-git GitHub license

Objectives

There's a point in everyone's life when you feel the need to write an AUR helper because there are only about 20 of them. So say hi to 20+1.

Yay is based on the design of yaourt, apacman and pacaur. It is developed with these objectives in mind:

  • Provide an interface for pacman
  • Yaourt-style interactive search/install
  • Minimal dependencies
  • Minimize user input
  • Know when git packages are due for upgrades

Features

  • Perform advanced dependency solving
  • Download PKGBUILDs from ABS or AUR
  • Tab-complete the AUR
  • Query user up-front for all input (prior to starting builds)
  • Narrow search terms (yay linux header will first search linux and then narrow on header)
  • Find matching package providers during search and allow selection
  • Remove make dependencies at the end of the build process
  • Run without sourcing PKGBUILD

Installation

If you are migrating from another AUR helper, you can simply install Yay with that helper.

Alternatively, the initial installation of Yay can be done by cloning the PKGBUILD and building with makepkg:

git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

Support

All support related to Yay should be requested via GitHub issues. Since Yay is not officially supported by Arch Linux, support should not be sought out on the forums, AUR comments or other official channels.

A broken AUR package should be reported as a comment on the package's AUR page. A package may only be considered broken if it fails to build with makepkg. Reports should be made using makepkg and include the full output as well as any other relevant information. Never make reports using Yay or any other external tools.

Contributing

Contributors are always welcome!

If you plan to make any large changes or changes that may not be 100% agreed on, we suggest opening an issue detailing your ideas first.

Otherwise send us a pull request and we will be happy to review it.

Dependencies

Yay depends on:

  • go (make only)
  • git
  • base-devel

Note: Yay also depends on a few other projects (as vendored dependencies). These projects are stored in vendor/, are built into yay at build time, and do not need to be installed separately. These files are managed by dep and should not be modified manually.

Following are the dependencies managed under dep:

Building

Run make to build Yay. This command will generate a binary called yay in the same directory as the Makefile.

Note: Yay's Makefile automatically sets the GOPATH to $PWD/.go. This path will ensure dependencies in vendor/ are built. Running manual go commands such as go build will require that you either set the GOPATH manually or go get the vendored dependencies into your own GOPATH.

Code Style

All code should be formatted through go fmt. This tool will automatically format code for you. We recommend, however, that you write code in the proper style and use go fmt only to catch mistakes.

Testing

Run make test to test Yay. This command will verify that the code is formatted correctly, run the code through go vet, and run unit tests.

Frequently Asked Questions

Yay does not display colored output. How do I fix it?

Make sure you have the Color option in your /etc/pacman.conf (see issue #123).

Yay is not prompting to skip packages during system upgrade.

The default behavior was changed after v8.918 (see 3bdb534 and issue #554). To restore the package-skip behavior use --combinedupgrade (make it permanent by appending --save). Note: skipping packages will leave your system in a partially-upgraded state.

Sometimes diffs are printed to the terminal, and other times they are paged via less. How do I fix this?

Yay uses git diff to display diffs, which by default tells less not to page if the output can fit into one terminal length. This behavior can be overridden by exporting your own flags (export LESS=SRX).

Yay is not asking me to edit PKGBUILDS, and I don't like the diff menu! What can I do?

yay --editmenu --nodiffmenu --save

How can I tell Yay to act only on AUR packages, or only on repo packages?

yay -{OPERATION} --aur yay -{OPERATION} --repo

An Out Of Date AUR Packages message is displayed. Why doesn't Yay update them?

This message does not mean that updated AUR packages are available. It means the packages have been flagged out of date on the AUR, but their maintainers have not yet updated the PKGBUILDs (see outdated AUR packages).

Yay doesn't install dependencies added to a PKGBUILD during installation.

Yay resolves all dependencies ahead of time. You are free to edit the PKGBUILD in any way, but any problems you cause are your own and should not be reported unless they can be reproduced with the original PKGBUILD.

Examples of Custom Operations

yay <Search Term>
        Present package-installation selection menu.

yay -Ps
        Print system statistics.

yay -Yc
        Clean unneeded dependencies.

yay -G <AUR Package>
        Download PKGBUILD from ABS or AUR.

yay -Y --gendb
        Generate development package database used for devel update.

yay -Syu --devel --timeupdate
        Perform system upgrade, but also check for development package updates and use
        PKGBUILD modification time (not version number) to determine update.

Images