YAP — Yet Another Packager

curl -fsSL https://raw.githubusercontent.com/M0Rf30/yap/main/scripts/install.sh | sh

curl -fsSL https://raw.githubusercontent.com/M0Rf30/yap/main/scripts/install.sh \  | sh -s -- --version v2.1.3 --tool yap

wget https://github.com/M0Rf30/yap/releases/latest/download/yap_Linux_x86_64.tar.gztar -xzf yap_Linux_x86_64.tar.gzsudo mv yap /usr/local/bin/yap version

git clone https://github.com/M0Rf30/yap.gitcd yapmake buildsudo mv yap /usr/local/bin/

# Dockersudo systemctl enable --now docker && sudo usermod -aG docker $USER
# Podmansudo systemctl enable --now podman

pkgname=my-packagepkgver=1.0.0pkgrel=1pkgdesc="My awesome application"arch=('x86_64')license=('GPL-3.0')url="https://github.com/user/my-package"makedepends=('gcc' 'make')source=("https://github.com/user/my-package/archive/v${pkgver}.tar.gz")sha256sums=('SKIP')
build() {    cd "${srcdir}/${pkgname}-${pkgver}"    make}
package() {    cd "${srcdir}/${pkgname}-${pkgver}"    install -Dm755 my-package "${pkgdir}/usr/bin/my-package"    install -Dm644 README.md "${pkgdir}/usr/share/doc/${pkgname}/README.md"}

# Auto-detect host distro from /etc/os-releaseyap build .
# Specific distributionyap build ubuntu-jammy .yap build fedora-38 /path/to/projectyap build --cleanbuild --no-makedeps ubuntu-jammy .

pkgdesc="My application"pkgdesc__debian="My application for Debian/Ubuntu"pkgdesc__ubuntu_noble="My application optimized for Ubuntu 24.04"
makedepends=('gcc' 'make')makedepends__apt=('build-essential' 'cmake')makedepends__yum=('gcc-c++' 'cmake3')makedepends__ubuntu_noble=('build-essential' 'cmake' 'pkg-config' 'libtool')

depends=('glibc' 'gcc')depends_x86_64=('glibc' 'gcc' 'lib32-glibc')depends_aarch64=('glibc' 'gcc' 'aarch64-linux-gnu-gcc')
source=('https://example.com/generic-source.tar.gz')source_x86_64=('https://example.com/x86_64-optimized.tar.gz')source_aarch64=('https://example.com/aarch64-source.tar.gz')
sha256sums=('generic_hash')sha256sums_x86_64=('x86_64_specific_hash')sha256sums_aarch64=('aarch64_specific_hash')

# BLAKE2b (recommended)b2sums=('2f240f2a3d2f8d8f...')
# CRC32 (format: checksum filesize)cksums=('1234567890 2048576')

changelog=CHANGELOG.md

pre_install()  { echo "Before install"; }post_install() { systemctl daemon-reload; }pre_upgrade()  { systemctl stop myservice; }post_upgrade() { systemctl start myservice; }pre_remove()   { systemctl disable myservice; }post_remove()  { systemctl daemon-reload; }

# DEBsection=utilspriority=optional
# RPMgroup="Applications/System"requires_pre=('shadow-utils')
# APKmaintainer="John Doe <[email protected]>"

yap build [distro[-release]] <path>   # Build packages (distro auto-detected if omitted)yap zap [distro] <path>               # Clean build environmentyap prepare [distro[-release]]        # Prepare host build environmentyap pull <distro>                     # Pull pre-built container imagesyap install <artifact-file>           # Install a built artifactyap publish [artifact-or-dir]...      # Upload built packages to an OpenArtifact repositoryyap graph [path]                      # Show dependency graphyap list-distros                      # List supported distributionsyap status                            # Show host status and runtime detectionyap version                           # Show version informationyap completion <shell>                # Generate shell completion (bash/zsh/fish/powershell)

# Build behavior--cleanbuild, -c            # Clean srcdir before build--no-build, -o              # Download sources only--zap, -z                   # Deep clean staging directory--skip-hash-check, -H       # Skip source checksum verification--no-container              # Build natively on the host (skip container dispatch)
# Dependencies--no-makedeps, -d           # Skip makedeps installation--skip-sync, -s             # Skip package manager sync--skip-deps pkg1,pkg2       # Omit specific packages from makedeps--parallel, -P              # Enable parallel topo-sort (opt-in)
# Version--pkgver 1.2.3, -w          # Override package version--pkgrel 2, -r              # Override release number
# Range / filter--from package1             # Start from specific package--to package5               # Stop at specific package--only pkg1,pkg2            # Build only listed packages--skip pkg1,pkg2            # Skip listed packages
# Source access--ssh-password pass, -p     # Password for SSH source access--source-retries <n>        # Retries after first attempt for source/gensum/toolchain downloads (default 3; env: YAP_SOURCE_MAX_RETRIES)
# Cross-compilation--target-arch arm64, -t     # Cross-compile for target architecture--skip-toolchain-validation, -T
# Repositories / trust--repo "<spec>"             # Add an extra package repository (repeatable)--allow-unverified-repos, -U  # Allow apt sources without a verifiable Signed-By key
# Signing--sign, -K                  # Enable artifact signing--sign-key /path/to/key     # Private key path--sign-passphrase pass      # Passphrase (prefer env: YAP_SIGN_PASSPHRASE)--sign-key-name mykey       # APK key name
# SBOM--sbom, -S                  # Generate SBOM sidecars--sbom-format cyclonedx     # CycloneDX 1.5 only--sbom-format spdx          # SPDX 2.3 only--sbom-format both          # Both (default)
# Compression--compression-deb gzip      # DEB: zstd|gzip|xz (default: zstd)--compression-rpm xz        # RPM: zstd|gzip|xz (default: zstd)
# Debug / output--debug-dir /path, -D       # Emit split debug info--verbose                   # Verbose logging--no-color                  # Disable colored output

yap completion bash > /etc/bash_completion.d/yapyap completion zsh > /usr/share/zsh/site-functions/_yapyap completion fish > ~/.config/fish/completions/yap.fishyap completion powershell > yap.ps1

# APK (after distributing the public key to /etc/apk/keys/)apk add my-package.apk
# DEBgpg --verify my-package_1.0.0_amd64.deb.asc my-package_1.0.0_amd64.deb
# RPMrpm -K my-package-1.0.0-1.x86_64.rpm
# Pacmanpacman-key --verify my-package-1.0.0-1-x86_64.pkg.tar.zst.sig

export YAP_OA_URL=https://oa.example.comexport YAP_OA_TOKEN_FILE=~/.config/yap/oa-token        # or YAP_OA_TOKENexport YAP_OA_DEB_REPO=debs YAP_OA_RPM_REPO=rpms
yap build ubuntu-jammy .yap publish --distribution jammy --component main ./dist   # or a single fileyap publish --dry-run ./dist                               # list only, no network

yap build --sbom .                        # Both formats (default)yap build --sbom --sbom-format cyclonedx .yap build --sbom --sbom-format spdx .

yap build --target-arch=aarch64 ubuntu-jammy .yap build --target-arch=armv7 fedora-38 .yap build --target-arch=i686 alpine .yap build --target-arch=ppc64le arch .

# Sequential (default) — explicit ordering via "install" fieldyap build .
# Parallel — topo-sort + worker poolyap build --parallel .

yap prepare                    # Auto-detect host distroyap prepare ubuntu-jammyyap prepare fedora-38yap prepare --golang archyap prepare --skip-sync rocky-9

pkgname=hello-worldpkgver=1.0.0pkgrel=1pkgdesc="A simple Hello World program"arch=('x86_64')license=('MIT')makedepends=('gcc')source=("hello.c")sha256sums=('SKIP')
build() { gcc -o hello hello.c; }
package() { install -Dm755 hello "${pkgdir}/usr/bin/hello"; }

pkgname=python-myapppkgver=2.1.0pkgrel=1pkgdesc="My Python application"arch=('any')license=('Apache-2.0')depends=('python3')makedepends__apt=('python3-dev' 'python3-setuptools')makedepends__yum=('python3-devel' 'python3-setuptools')source=("https://pypi.io/packages/source/m/myapp/myapp-${pkgver}.tar.gz")sha256sums=('...')
build() {    cd "${srcdir}/myapp-${pkgver}"    python3 setup.py build}
package() {    cd "${srcdir}/myapp-${pkgver}"    python3 setup.py install --root="${pkgdir}" --optimize=1}

pkgname=web-servicepkgver=1.5.0pkgrel=1pkgdesc="My web service"arch=('x86_64')license=('GPL-3.0')depends=('systemd')backup=('etc/web-service/config.yml')source=("web-service-${pkgver}.tar.gz" "web-service.service")sha256sums=('...' 'SKIP')
build() {    cd "${srcdir}/web-service-${pkgver}"    make build}
package() {    cd "${srcdir}/web-service-${pkgver}"    install -Dm755 web-service "${pkgdir}/usr/bin/web-service"    install -Dm644 ../web-service.service \        "${pkgdir}/usr/lib/systemd/system/web-service.service"    install -Dm644 config.yml "${pkgdir}/etc/web-service/config.yml"    install -dm755 "${pkgdir}/var/lib/web-service"    install -dm755 "${pkgdir}/var/log/web-service"}

make all              # clean, deps, fmt, lint, test, doc, buildmake build            # build the yap binarymake build-all        # build for linux/darwin/windows, amd64/arm64make clean            # clean build artifactsmake deps             # download and tidy Go modulesmake fmt              # gofmtmake lint             # golangci-lintmake lint-md          # markdownlintmake test             # run all tests (-p 1 -v, sequential required)make test-coverage    # tests with coverage report (coverage.html)make release          # create release packages
make doc              # view all package documentationmake doc-serve        # start pkgsite on localhost:8080make doc-generate     # generate static docs in docs/api/make doc-package PKG=./pkg/builders/apk
make docker-build DISTRO=ubuntumake docker-build-allmake docker-list-distros
make i18n-check       # verify localization file integritymake i18n-stats       # localization statistics

make testgo test ./pkg/source -vgo test ./pkg/builders/deb -vgo test ./pkg/graph -vgo test -race ./pkg/builders/...go test -timeout 30s ./pkg/download/...

yap --language=it build .

systemctl status docker       # or podmandocker run --rm hello-world   # test accesssudo usermod -aG docker $USER # fix permissions (re-login required)

yap build --verboseyap zap ubuntu-jammy /path/to/projectyap status

sudo chown -R $USER:$USER artifacts/setsebool -P container_manage_cgroup true   # SELinux (Red Hat family)

yap build --skip-sync     # skip package manager syncyap build --cleanbuild    # clean source before build