Archlinux repository server & package build system, written in V.
 
 
 
 
 
 
Go to file
Jef Roosens b3a119f221
chore: ran v fmt for v 0.3.3 changes
2023-02-08 11:00:17 +01:00
.woodpecker chore: some fixes 2023-01-28 13:18:44 +01:00
docs chore: update docs; final read 2023-01-04 14:37:41 +01:00
src chore: ran v fmt for v 0.3.3 changes 2023-02-08 11:00:17 +01:00
.clang-format refactor: link libvieter; remove cron code & daemon 2023-01-28 13:16:36 +01:00
.dockerignore Switched to patch-based builder, based on weekly 2022-01-27 19:18:11 +01:00
.editorconfig refactor: link libvieter; remove cron code & daemon 2023-01-28 13:16:36 +01:00
.gitignore refactor: link libvieter; remove cron code & daemon 2023-01-28 13:16:36 +01:00
.gitmodules refactor: link libvieter; remove cron code & daemon 2023-01-28 13:16:36 +01:00
CHANGELOG.md chore: updated changelog 2023-01-28 14:53:43 +01:00
Dockerfile fix: don't buffer stdout even if not a terminal 2022-12-16 11:37:51 +01:00
LICENSE Added AGPLv3 license [CI SKIP] 2022-01-27 22:34:12 +01:00
Makefile chore: use libvieter dev branch instead 2023-01-28 13:18:44 +01:00
PKGBUILD chore: bump versions to 0.5.0 2022-12-29 15:49:59 +01:00
PKGBUILD.dev fix: i'm too lazy to test these 2023-01-28 15:27:47 +01:00
README.md refactor(build): remove some code duplication from queue 2022-12-13 18:24:21 +01:00
renovate.json Add renovate.json 2022-04-11 10:01:38 +00:00
test.py Solved the "removing old packages" problem (I think) 2022-04-09 21:08:54 +02:00
vieter.toml refactor: link libvieter; remove cron code & daemon 2023-01-28 13:16:36 +01:00

README.md

Vieter

I host documentation for Vieter over at https://rustybever.be/docs/vieter/. API documentation for the current codebase can be found at https://rustybever.be/api-docs/vieter/.

For more information, questions or just a chat, there's #vieter:rustybever.be on Matrix!

Overview

Vieter is a restart of the Pieter project. The goal is to create a simple, lightweight self-hostable Arch repository server, paired with a system that periodically builds & publishes select Arch packages. This would allow me to build AUR packages (or PKGBUILDs I created myself) "in the cloud" & make sure I never have to compile anything on my own systems, making my updates a lot quicker.

Why V?

I chose V as I've been very intrigued by this language for a while now. I wanted a fast language that I could code while relaxing, without having to exert too much mental effort & V seemed like the right choice for that. Sadly, this didn't quite turn out the way I expected, but I'm sticking with it anyways ;p

Features

  • Arch repository server
    • Support for multiple repositories & multiple architectures
    • Endpoints for publishing new packages
    • API for managing repositories to build
  • Build system
    • Periodic rebuilding of packages
    • Prevent unnecessary rebuilds

Building

Besides a V installer, Vieter also requires the following libraries to work:

  • libarchive
  • openssl
  • sqlite3

Vieter also depends on some external V modules which you can install using cd src && v install. Make sure to keep these dependencies up to date using v update.

Compiler

I used to maintain a mirror that tracked the latest master, but nowadays, I maintain a Docker image containing the specific compiler version that Vieter builds with. Currently, this is V 0.3.2.

Contributing

If you wish to contribute to the project, please take note of the following:

  • Rebase instead of merging whenever possible, e.g. when updating your branch with the dev branch.
  • Please follow the Conventional Commits style for your commit messages.

Writing documentation

The docs directory contains a Hugo site consisting of all user & administrator documentation. docs/api on the other hand is a Slate project describing the HTTP web API.

To modify the Hugo documentation, you'll need to install Hugo. Afterwards, you can use the following commands inside the docs directory:

# Build the documentation
hugo

# Host an auto-refreshing web server with the documentation. Important to note
# is that the files will be at `http://localhost:1313/docs/vieter` instead of
# just `http://localhost:1313/`
hugo server

For the Slate docs, I personally just start a docker container:

docker run \
    --rm \
    -p 4567:4567 \
    --name slate \
    -v $(pwd)/docs/api/source:/srv/slate/source slatedocs/slate serve

This will make the Slate docs available at http://localhost:4567. Sadly, this server doesn't auto-refresh, so you'll have to manually refresh your browser every time you make a change.