2019-06-13 08:49:05 -06:00
# kiss
2019-09-11 00:00:33 -06:00
Tiny and straightforward package manager for KISS written in POSIX `sh` .
2019-06-13 11:22:08 -06:00
2020-03-22 08:20:51 -06:00
- Only 600~ lines of POSIX `sh` (See [cloc ](#cloc )).
2019-09-11 00:00:33 -06:00
- Runtime dependency detection.
- Incremental package installation.
2019-09-11 00:02:24 -06:00
- Fast dependency solver.
- File conflict detection.
2020-01-29 01:26:31 -07:00
- Package alternatives system.
2019-09-11 00:00:33 -06:00
- Binary stripping.
- `shellcheck` compliant.
2019-06-13 11:22:08 -06:00
2020-02-11 03:41:41 -07:00
## `kiss` Guidestones
2020-02-14 04:47:23 -07:00
Read: https://k1ss.org/guidestones.txt
2020-02-11 03:41:41 -07:00
2019-06-13 11:32:46 -06:00
## Usage
```sh
2020-01-29 01:19:56 -07:00
-> 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
2019-06-13 11:32:46 -06:00
```
2019-08-13 03:22:12 -06:00
2020-01-29 03:21:20 -07:00
## Index
<!-- vim - markdown - toc GFM -->
* [Package format ](#package-format )
* [Extending the package manager ](#extending-the-package-manager )
2020-03-22 08:20:51 -06:00
* [cloc ](#cloc )
2020-01-29 03:21:20 -07:00
<!-- vim - markdown - toc -->
2019-09-11 00:00:33 -06:00
## Package format
2020-03-11 08:52:48 -06:00
See: < https: / / k1ss . org / package-system >
2019-09-11 00:00:33 -06:00
2019-10-07 07:31:26 -06:00
## Extending the package manager
2020-02-19 02:53:03 -07:00
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.
2019-10-30 04:51:48 -06:00
2020-03-12 09:00:16 -06:00
- `kiss-cargo-urlgen` : Generate sources for rust packages.
2020-02-19 02:53:03 -07:00
- `kiss-chbuild` : Spawn a throwaway chroot.
2019-10-30 04:51:48 -06:00
- `kiss-chroot` : Enter a KISS `chroot` .
- `kiss-depends-finder` : Find missing dependencies by parsing 'ldd'.
- `kiss-depends` : Display a package's dependencies.
- `kiss-export` : Turn an installed package into a KISS tarball.
2020-03-13 07:45:07 -06:00
- `kiss-fork` : Copy a package's repository files into the current directory.
- `kiss-link` : Link a repository file to another repository.
2019-10-30 04:51:48 -06:00
- `kiss-manifest-tree` : Display all files as tree owned by a package.
- `kiss-manifest` : Display all files owned by a package.
- `kiss-maintainer` : Display the package maintainers.
2020-02-19 02:53:03 -07:00
- `kiss-new` : Create a boilerplate package.
2019-10-30 04:51:48 -06:00
- `kiss-orphans` : List orphaned packages.
2020-03-03 15:49:41 -07:00
- `kiss-outdated` : List outdated packages based on Repology versions.
2019-10-30 04:51:48 -06:00
- `kiss-owns` : Check which package owns a file.
2020-02-19 02:53:03 -07:00
- `kiss-repodepends` : Display a package's original dependencies.
- `kiss-reset` : Reset the system to the base.
2019-10-30 04:51:48 -06:00
- `kiss-revdepends` : Display packages which depend on package.
- `kiss-size` : Show the size on disk for an installed package.
2020-02-19 02:53:03 -07:00
2020-03-22 08:20:51 -06:00
## cloc
```
+---------------------------------------+
| Language files blank comment code |
|---------------------------------------|
2020-03-28 02:18:47 -06:00
| Shell 1 271 391 663 |
2020-03-22 08:20:51 -06:00
+---------------------------------------+
```
