mirror/yay
0
0
Fork 0
mirror of https://github.com/Jguer/yay.git synced 2024-11-06 17:17:22 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity
Yet another Yogurt - An AUR Helper written in Go
1,669 Commits 4 Branches 100 Tags 10 MiB
Go 92.7%
Shell 6.6%
Makefile 0.6%
Dockerfile 0.1%
faf03436a7
Go to file
x1b6e6 faf03436a7 Sync with go-alpm v2.0.5
2021-05-07 23:30:08 +02:00
.github add testing with pacman-git 2021-05-07 18:03:57 +02:00
completions fix(yay): fix completions of -Gp 2021-01-31 19:07:08 +01:00
doc fix(yay): fix completions of -Gp 2021-01-31 19:07:08 +01:00
pkg Sync with go-alpm v2.0.5 2021-05-07 23:30:08 +02:00
po Update eu.po 2021-04-20 22:00:30 +02:00
testdata fix(pgp): package key importing 2020-07-11 00:48:30 +02:00
.dockerignore fix(docker): fix dockerignore 2020-07-20 09:27:25 +02:00
.gitignore fix(ialpm): fix typo 2020-10-26 09:32:22 +01:00
.golangci.yml ci(yay): update golangci and remove deprecated 2021-04-12 16:54:51 +02:00
.pre-commit-config.yaml chore(deps): update dependencies 2021-03-11 09:36:42 +01:00
ci.Dockerfile ci(yay): update golangci and remove deprecated 2021-04-12 16:54:51 +02:00
clean.go feat(exe): AddMakepkg builder 2020-08-22 01:24:52 +02:00
cmd.go Add doc for getFilter func. 2021-02-14 22:38:49 +01:00
config.go ci(yay): tweak release notary 2021-04-12 17:21:29 +02:00
CONTRIBUTING.md docs(contributing): remove outadated info 2020-07-27 00:17:05 +02:00
Dockerfile ci(builder): update ci builder 2020-11-17 20:25:40 +01:00
download.go test(alpm): implement alpm interfaces 2020-10-01 13:38:03 +02:00
exec.go fix(sudoloop): reduce sudoloop sleep, fixes #1379 2021-03-13 12:08:11 +01:00
go.mod Sync with go-alpm v2.0.5 2021-05-07 23:30:08 +02:00
go.sum Sync with go-alpm v2.0.5 2021-05-07 23:30:08 +02:00
install.go Add support for multiple 'Architecture' values 2021-05-04 08:43:56 +02:00
LICENSE Create LICENSE 2016-09-05 03:43:29 +01:00
main_test.go fix test using multiple 'Architecture' value 2021-05-04 08:43:56 +02:00
main.go Add support for multiple 'Architecture' values 2021-05-04 08:43:56 +02:00
Makefile fix(yay): fix proxy settings 2021-04-12 16:54:51 +02:00
print.go Make UpSlice a struct instead of a type alias 2021-04-24 17:28:53 +02:00
query.go feat(pkgbuild): extract logic 2021-01-31 19:07:08 +01:00
README.md add asciicast 2021-03-15 23:54:30 +01:00
upgrade.go Sort upslice by pacman repo order 2021-04-24 17:28:53 +02:00
vcs.go feat(vcs): refactor and test cover 2020-08-22 00:39:26 +02:00

README.md

Yay

Yet Another Yogurt - An AUR Helper Written in Go

Packages

yay yay-bin yay-git AUR votes 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:

Before you begin, make sure you have the base-devel package group installed.

pacman -S --needed git base-devel
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.

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.

I know my -git package has updates but yay doesn't offer to update it

Yay uses an hash cache for development packages. Normally it is updated at the end of the package install with the message Found git repo. If you transition between aur helpers and did not install the devel package using yay at some point, it is possible it never got added to the cache. yay -Y --gendb will fix the current version of every devel package and start checking from there.

I want to help out!

Check CONTRIBUTING.md for more information.

Examples of Custom Operations

Command Description
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

asciicast

asciicast

Other AUR helpers/tools