kiss/README.md

kiss

Tiny and straightforward package manager for KISS written in POSIX sh.

• Less than 1000 lines of POSIX sh (excluding blank lines and comments).
• Highly portable (will run in any POSIX compliant environment).
• Runtime dependency detection.
• Incremental package installation.
• Fast dependency solver.
• File conflict detection.
• Package alternatives system.
• 3-way handshake for /etc/ configuration files.
• Binary stripping.
• shellcheck compliant.

Usage

-> kiss [a|b|c|i|l|r|s|u|v] [pkg]...
-> alternatives: List and swap to alternatives
-> build:        Build a package
-> checksum:     Generate checksums
-> install:      Install a package
-> list:         List installed packages
-> remove:       Remove a package
-> search:       Search for a package
-> update:       Check for updates
-> version:      Package manager version

Dependencies / Portability

dependency	why	mandatory?
POSIX utilities	Used throughout	Yes
git	Repositories and git sources	Yes
gnupg1 or gnupg2	Repository signing	No (optional)
curl	Source downloads	Yes
sha256sum, shasum, sha256 or openssl	Checksum verification	Yes
tar	Tarball creation/extraction	Yes
bzip2	Compression method.	Yes (widely used)
xz	Compression method.	Yes (widely used)
gzip	Compression method.	Yes (widely used)
zstd	Compression method.	No (rarely used)
lzma	Compression method.	No (rarely used)
lzip	Compression method.	No (rarely used)
unzip	Source type.	No (rarely used)
su, sudo or doas	Privilege escalation.	No (optional)
ldd	Automatic dependency fixer.	No (optional)
readelf and strip	Binary stripping	No (optional)

Package format

See: https://k1ss.org/package-system

Extending the package manager

The contrib directory contains a set of simple scripts to extend the package manager. These are just simple and stupid automations which parse the package format.

• kiss-chbuild: Spawn a throwaway chroot.
• kiss-chroot: Enter a KISS chroot.
• kiss-depends: Display a package's dependencies.
• kiss-export: Turn an installed package into a KISS tarball.
• kiss-fork: Copy a package's repository files into the current directory.
• kiss-link: Link a repository file to another repository.
• kiss-manifest: Display all files owned by a package.
• kiss-maintainer: Display the package maintainers.
• kiss-new: Create a boilerplate package.
• kiss-orphans: List orphaned packages.
• kiss-outdated: List outdated packages based on Repology versions.
• kiss-owns: Check which package owns a file.
• kiss-reset: Reset the system to the base.
• kiss-revdepends: Display packages which depend on package.
• kiss-size: Show the size on disk for an installed package.