luet

README

luet-geaaru (fork) - Container-based Package manager

Luet is a multi-platform Package Manager based off from containers - it uses Docker (and others) to build packages. It has zero dependencies and it is well suitable for "from scratch" environments. It can also version entire rootfs and enables delivery of OTA-alike updates, making it a perfect fit for the Edge computing era and IoT embedded devices.

It offers a simple specfile format in YAML notation to define both packages and rootfs. As it is based on containers, it can be also used to build stages for Linux From Scratch installations and it can build and track updates for those systems.

It is written entirely in Golang and where used as package manager, it can run in from scratch environment, with zero dependencies.

Major differences between upstream release

• subsets feature: Permit to define subsets to choice what files extract from original package. This means that we could avoid splitting of a package, for example for Portage metadata, Include files, etc. and customize the subsets defined in the original package definition with custom options that could be configured from an user at runtime.

• solverv2 implementation: i begin the rewriting of all solver code and for now i only rewrite some internal code to speedup solver logic. It's yet too slow for a stable condition but i hope to rewrite completly all this part.

• annotations: the annotations are managed as interface{} struct without define only strings

• luet q files: following the command equo q files from Sabayon entropy tool, this command supply the list of the files of a package and in the near future the mapping of the files with the subsets configured.

• dockerv2 backend: i begin to rewrite the docker backend and using the tar-formers to manage the tar streams.

In a glance

• Luet can reuse Gentoo's portage tree hierarchy, and it is heavily inspired from it.
• It builds, installs, uninstalls and perform upgrades on machines
• Installer doesn't depend on anything ( 0 dep installer !), statically built
• You can install it aside also with your current distro package manager, and start building and distributing your packages
• Support for packages as "layers"
• It uses SAT solving techniques to solve the deptree ( Inspired by OPIUM )
• Support for collections and templated package definitions
• Can be extended with Plugins and Extensions
• Can build packages in Kubernetes (experimental)

Install

To install luet, you can grab a release on the Release page or to install it in your system:

$> curl https://raw.githubusercontent.com/geaaru/luet/geaaru/contrib/config/get_luet_root.sh | sh
$> luet search ...
$> luet install ..
$> luet --help

Build from source

$ git clone https://github.com/geaaru/luet.git -b geaaru
$ cd luet
$ make build

Documentation

Original Documentation is available, or run luet --help, any subcommand is documented as well, try e.g.: luet build --help.

I hope to prepare an aligned documentation to the geaaru fork soon.

Dependency solving

Luet uses SAT and Reinforcement learning engine for dependency solving. It encodes the package requirements into a SAT problem, using gophersat to solve the dependency tree and give a concrete model as result.

SAT encoding

Each package and its constraints are encoded and built around OPIUM. Additionally, Luet treats also selectors seamlessly while building the model, adding ALO ( At least one ) and AMO ( At most one ) rules to guarantee coherence within the installed system.

Reinforcement learning

Luet also implements a small and portable qlearning agent that will try to solve conflict on your behalf when they arises while trying to validate your queries against the system model.

To leverage it, simply pass --solver-type qlearning to the subcommands that supports it ( you can check out by invoking --help ).

License

Luet is distributed under the terms of GPLv3, check out the LICENSE file.