Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/threadexio/zeus

🐳 📦 Bringing containers to your AUR helper since 2022
https://github.com/threadexio/zeus

arch-linux arch-user-repository archlinux aur aur-helper aur-helpers aur-packages container containerization containers docker docker-container docker-image dockerfile dockerfiles linux linux-app rust rust-cli rustlang

Last synced: about 10 hours ago
JSON representation

🐳 📦 Bringing containers to your AUR helper since 2022

Awesome Lists containing this project

README

        

[repo]: https://github.com/threadexio/zeus

[latest-release]: https://github.com/threadexio/zeus/releases/latest
[release-badge]: https://img.shields.io/github/v/release/threadexio/zeus?style=for-the-badge&display_name=release

[issues]: https://github.com/threadexio/zeus/issues
[issues-badge]: https://img.shields.io/github/issues-raw/threadexio/zeus?style=for-the-badge

[build]: https://github.com/threadexio/zeus/actions/workflows/build.yaml
[build-badge]: https://img.shields.io/github/workflow/status/threadexio/zeus/Build?style=for-the-badge

[license]: https://github.com/threadexio/zeus/blob/master/LICENSE
[license-badge]: https://img.shields.io/github/license/threadexio/zeus?style=for-the-badge

[pkg-aur]: https://aur.archlinux.org/packages/zeus
[pkg-aur-badge]: https://img.shields.io/aur/version/zeus?style=for-the-badge&label=AUR
[pkg-bin-aur]: https://aur.archlinux.org/packages/zeus-bin
[pkg-bin-aur-badge]: https://img.shields.io/aur/version/zeus-bin?style=for-the-badge&label=AUR

[help]: https://github.com/threadexio/zeus/pulls
[help-badge]: https://img.shields.io/badge/HELP-WANTED-green?style=for-the-badge&logo=github

[wiki]: https://github.com/threadexio/zeus/wiki
[usage]: https://github.com/threadexio/zeus/wiki/Usage
[faq]: https://github.com/threadexio/zeus/wiki/FAQ
[releases]: https://github.com/threadexio/zeus/releases
[ci]: https://github.com/threadexio/zeus/actions
[installing]: #installing
[building]: #building


zeus

**[Wiki][wiki]**    
**[Install][installing]**    
**[Usage][usage]**    
**[FAQ][faq]**    
**[Releases][releases]**    
**[Issues][issues]**    
**[CI][ci]**    

---

[![release-badge]][releases]
[![issues-badge]][issues]
[![build-badge]][build]
[![license-badge]][license]
[![help-badge]][help]

---


**Zeus**. A simple AUR helper which utilizes containers allowing developers and users alike to benefit from it's reproducible, clean and flexible builds. To get started with `zeus` follow the [install instructions][installing] or [build it yourself][building]. Be sure to check out the [wiki][wiki] for anything else.


## Installing

Currently there are 2 packages in the AUR.

- `zeus` - Which builds from the [latest release][latest-release]
- `zeus-bin` - Which unpacks prebuilt binaries from the [latest release][latest-release].

| Package | Version |
| :--------: | :---------------------------------: |
| `zeus` | [![pkg-aur-badge]][pkg-aur] |
| `zeus-bin` | [![pkg-bin-aur-badge]][pkg-bin-aur] |

> **NOTE:** The binaries for `zeus-bin` are built in [Github Actions][build]

After installing one of the 2 packages, there is one final step towards getting up and running.

Building the actual builder container.

```shell
$ zeus -B
```

> If your user does _**not**_ have access to the docker socket, you will have to run the previous command as root and subsequently every time you want to use the program.


## Building

After cloning the repository, use the `build` target in the `Makefile` to build everything.

```shell
$ make build
```

> By default the `build` target builds the debug version, if you wish to build the release version set `BUILD_TYPE=release`.

```shell
$ export BUILD_TYPE=release
$ make build
```

Testing local changes can be done in 2 ways.


### Not installing locally

This method involves no extra steps.

Running the built binary is as simple as:

```shell
$ ./target/$BUILD_TYPE/zeus
```


### Installing locally

Installing locally for easier testing is possible with the `install` target.

```shell
# make install
```

> `DESTDIR` and `PREFIX` can be used to alter the installation.

After all this you should be able to just run `zeus` directly in the terminal.

```shell
$ zeus
```