Forgejo

Forgejo is a lightweight version control hub that provides git hosting, project management, release management and packages. It’s very powerful and very efficient (written in Go and uses minimal memory).

Gitea and Forejo

Forgejo is a fork of Gitea which was created in 2022 after Gitea changed the direction of their project to align with more commercial interests. Forgejo offers most of the same features as Gitea but focuses on public good.

Actions

Forgejo have recently introduced a CI actions feature which is compatible with github’s actions.

In order for a lot of the actions to work, it can be helpful to have a number of labels set up for the runner like so:

  labels:
    - 'docker:docker://node:20-bookworm'
    - 'node20:docker://node:20-bookworm'
    - 'lxc:lxc://debian:bullseye'
    - 'bullseye:lxc://debian:bullseye'
    - 'self-hosted:host://-self-hosted'
    - 'ubuntu-22.04:docker:// ghcr.io/catthehacker/ubuntu:act-22.04' 
    - 'ubuntu-latest:docker://ghcr.io/catthehacker/ubuntu:act-22.04'

setup-python does not work with the recommended node:20-bookworm container so it is better to use the ubuntu act containers when working with Python. These ubuntu act image have a number of prerequisite tools and libraries built in.

Resources

• https://forgejo.org/docs/next/admin/runner-installation/
• https://forgejo.org/docs/next/admin/actions/

Python Packages

• Official docs: https://docs.gitea.com/usage/packages/pypi

Best strategy with PDM seems to be:

1. use pdm build
2. upload package with twine:

    twine upload \
       --repository-url https://gitea.example.org/api/packages/<username>/pypi \
       -u <username> \
       -p <password> \
       dist/something-0.1.0-py3-none-any.whl