repo/README.md

195 lines
6.3 KiB
Markdown
Raw Normal View History

2019-05-09 08:14:38 +00:00
# KISS Package Experiment
2019-05-09 07:59:27 +00:00
This is an alternative package system I am experimenting with. Instead of the usual `PKGBUILD`, `APKBUILD`, `xbps-template` and `Pkgfile` format, this repository explores a more unixy approach.
Each Package is split into multiple files.
```sh
zlib/ # Package name.
├─ build # Build script.
2019-05-10 16:58:35 +00:00
├─ depends # Dependencies (one per line) (optional).
2019-05-09 07:59:27 +00:00
├─ sources # Sources (one per line).
├─ version # Package version.
# Files generated by the package manager.
├─ manifest # The built package's files and directories.
├─ checksums # The checksums for the source files.
```
2019-05-09 08:05:09 +00:00
When a built package is installed, this entire directory tree is copied to `/var/db/puke` where it becomes a database entry. Listing the dependencies for a package is a simple as printing the contents of the `depends` file. Searching for which package owns a file is as simple as checking each `manifest` file.
This new structure also allows the package manager to be stupid simple. POSIX `sh` has no arrays. However, they are mimicked by looping over each line of each file. No more insecure `depends="pkg pkg pkg"` and `for pkg in $depends`.
Instead, the following can be done.
```sh
while read -r depend; do
# do thing.
done < depends
```
2019-05-09 08:12:31 +00:00
2019-05-09 09:20:42 +00:00
## TODO
2019-05-10 07:07:17 +00:00
- [x] Checksums.
2019-05-10 11:40:51 +00:00
- [x] Package installation.
- [x] Package listing.
2019-05-10 16:58:35 +00:00
- [x] Package removal.
2019-05-10 11:40:51 +00:00
- [x] Package dependencies.
- [x] Source extraction.
2019-05-09 09:20:42 +00:00
- [x] `tar.*`
2019-05-10 07:07:17 +00:00
- [x] `git`
2019-05-09 09:20:42 +00:00
2019-05-09 08:12:31 +00:00
## Table of Contents
<!-- vim-markdown-toc GFM -->
2019-05-09 13:05:22 +00:00
* [Getting started with `puke`](#getting-started-with-puke)
2019-05-10 18:00:46 +00:00
* [`puke build pkg`](#puke-build-pkg)
* [`puke checksum pkg`](#puke-checksum-pkg)
* [`puke depends pkg`](#puke-depends-pkg)
* [`puke install pkg`](#puke-install-pkg)
* [`puke remove pkg`](#puke-remove-pkg)
* [`puke list` or `puke list pkg`](#puke-list-or-puke-list-pkg)
* [`puke update`](#puke-update)
2019-05-09 12:58:14 +00:00
* [The package format](#the-package-format)
* [`build`](#build)
* [`manifest`](#manifest)
* [`sources`](#sources)
* [`depends`](#depends)
* [`version`](#version)
* [`checksums`](#checksums)
2019-05-09 08:12:31 +00:00
<!-- vim-markdown-toc -->
2019-05-09 13:05:22 +00:00
## Getting started with `puke`
Puke is a simple package manager written in POSIX `sh`. The package manager does not need to be added to your `PATH`. Instead it runs inside the packages repository, very similar to Void Linux's `xbps-src`.
Puke has 6 different "operators".
- `build`: Build a package.
- `checksum`: Generate checksums for a package.
2019-05-10 17:38:50 +00:00
- `depends`: List a package's dependencies .
2019-05-09 13:05:22 +00:00
- `install`: Install a built package.
- `remove`: Remove an installed package.
- `list`: List installed packages.
2019-05-10 17:38:50 +00:00
- `update`: List packages with available updates.
2019-05-09 13:05:22 +00:00
2019-05-10 18:00:46 +00:00
### `puke build pkg`
Puke's `build` operator handles a package from its source code to the installable `.tar.gz` file. Sources are downloaded, checksums are verified, dependencies are checked and the package is compiled then packaged.
### `puke checksum pkg`
Puke's `checksum` operator generates the initial checksums for a package from every source in the `sources` file.
### `puke depends pkg`
Puke's `depends` operator does not recursively check dependencies. It only lists the direct dependencies for the selected package. In the future, more complex dependency solving may be added.
### `puke install pkg`
Puke's `install` operator takes the built `.tar.gz` file and installs it in the system. This is as simple as removing the old version of the package (*if it exists*) and unpacking the archive at `/`.
### `puke remove pkg`
Puke's `remove` operator uninstalls a package from your system. Files and directories in `/etc` are untouched. Support for exclusions will come as they are needed.
### `puke list` or `puke list pkg`
Puke's `list` operator lists the installed packages and their versions. Giving `list` an argument will check if a singular package is installed.
### `puke update`
Puke's `update` operator does a `git pull` of the repository and compares the repository versions to the installed database versions. Any mismatch in versions is considered a new upgrade from the repository.
2019-05-09 12:58:14 +00:00
## The package format
### `build`
2019-05-09 08:12:31 +00:00
The `build` file should contain the necessary steps to patch, configure, build and install the package. When at the install step; the variable `$pkg_dir` is available. This variable points to the directory the package manager uses for built packages. Whatever is in this directory will become part of the package's manifest and will be copied to `/` (or `$PUKE_ROOT`).
2019-05-09 08:33:24 +00:00
```sh
./configure \
--prefix=/usr \
--libdir=/lib \
--shared
make
make DESTDIR="$pkg_dir" install
```
2019-05-09 12:58:14 +00:00
### `manifest`
2019-05-09 08:33:24 +00:00
The `manifest` file contains the built package's file and directory list. The full paths to files are listed first and the directories (*in reverse*) follow. This allows the package manager to remove the directories if they're empty without needing checks in-between.
2019-05-10 07:06:18 +00:00
The manifest also includes the package's database entry. You can install the package with or without `puke` and it will be recognized.
2019-05-09 08:33:24 +00:00
```
/usr/share/man/man3/zlib.3
/usr/include/zconf.h
/usr/include/zlib.h
2019-05-10 07:06:18 +00:00
/var/db/puke/zlib/sources
/var/db/puke/zlib/manifest
/var/db/puke/zlib/checksums
/var/db/puke/zlib/build
/var/db/puke/zlib/version
2019-05-09 08:33:24 +00:00
/lib/libz.so.1.2.11
/lib/libz.so.1
/lib/libz.so
/lib/libz.a
/lib/pkgconfig/zlib.pc
2019-05-10 07:06:18 +00:00
/var/db/puke/zlib
/var/db/puke
/var/db
/var
2019-05-09 08:33:24 +00:00
/usr/share/man/man3
/usr/share/man
/usr/share
/usr/include
/usr
/lib/pkgconfig
/lib
```
2019-05-09 08:44:02 +00:00
2019-05-09 12:58:14 +00:00
### `sources`
2019-05-09 08:44:02 +00:00
The `sources` file contains the package's sources one per line. Sources can be local or remote.
```
https://www.openssl.org/source/openssl-X.X.X.tar.gz
patches/fix-musl.patch
```
2019-05-09 12:58:14 +00:00
### `depends`
2019-05-09 08:44:02 +00:00
The `depends` file contains the package's dependencies one per line.
```
zlib
binutils
openssl
```
2019-05-09 08:52:34 +00:00
2019-05-09 12:58:14 +00:00
### `version`
2019-05-09 08:52:34 +00:00
The `version` file contains the package's version as well as its release number. The format of this file is `version release`. The `release` portion allows a package upgrade without the modification of the version number.
2019-05-10 07:06:18 +00:00
The version can also be `git 1` to specify that the package is built from the latest `git` head.
2019-05-09 08:52:34 +00:00
```
1.2.11 1
```
2019-05-09 12:51:37 +00:00
2019-05-09 12:58:14 +00:00
### `checksums`
2019-05-09 12:51:37 +00:00
The `checksums` file contains the `sha256` sums of each entry in the `sources` file. This is generated and verified automatically.
```
c3e5e9fdd5004dcb542feda5ee4f0ff0744628baf8ed2dd5d66f8ca1197cb1a1 zlib-1.2.11.tar.gz
```