forked from kiss-community/kiss
.github/workflows | ||
contrib | ||
.editorconfig | ||
kiss | ||
kiss.1 | ||
LICENSE.md | ||
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). - 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] [pkg] [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
# - Anything with a specification should follow it (POSIX, BSD, etc).
# - Anything without a specification which has ONLY a single (widely used)
# implementation will be considered portable (git, curl, etc).
#
# POSIX utilities
# - sh (POSIX)
# - find (POSIX) -type f, -type d, -exec {} [+;], -o, -print, !
# - ls (POSIX) -l, -d
# - sed (POSIX) -n, s/<search>/<replace>/g, /<delete>/d
# - grep (POSIX) -l, -F, -x, -f, -q, -v
# - sort (POSIX) -r, -u, -k
# - tee (POSIX) -a
# - date (POSIX)
# - mkdir (POSIX) -p
# - rm (POSIX) -f, -r
# - rmdir (POSIX)
# - cp (POSIX) -f, -P, -p, -L, -R
# - mv (POSIX) -f
# - chown (POSIX) -h
# - diff (POSIX) -U
#
# Misc
# - su* (sudo, doas, su) (in order, optional)
# - git (downloads from git) (must link to curl)
# - curl (downloads over http) (also needed by git)
# - sha256 (multiple fallbacks: sha256sum, shasum, sha256, openssl, etc)
#
# Compiler/libc utilities (depends cc & libc)
# - readelf (optional) (Part of compiler toolchain) (GNU, LLVM or elfutils)
# - strip (optional) (Part of compiler toolchain) (GNU, LLVM or elfutils)
# - ldd (optional) (Part of libc)
#
# Tarball compression
# - tar (as portable as can be) (merely: cf, tf, xf)
# - bzip2 (widely used) -d, -z
# - xz (widely used) -d, -z, -c, -T
# - gzip (widely used) -d, -6
# - zstd (optional) -d, -z, -c
# - unzip (optional)
# - lzma (optional)
# - lzip (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 KISSchroot
.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.