#Raku Overlay for Portage

This is an overlay for Portage, allowing Gentoo (and derivative) users to manage modules for the Raku programming language through Portage.

#Installation

Create the file /etc/portage/repos.conf/raku.conf, and add the following contents.

[raku-overlay]
priority = 50
sync-type = git
sync-uri = https://git.sr.ht/tyil/raku-overlay.git
auto-sync = yes

The Raku overlay introduces a new category for Portage, dev-raku. Since this is not a default category known by Portage, you must add this yourself.

echo dev-raku >> /etc/portage/categories

If you're on a stable profile, you may also need to keyword Raku and a number of its dependencies.

*/*::raku-overlay ~amd64 # This will keyword *all* modules in the Raku
                         # overlay. Leave this out if you want to keyword
                         # these individually.

After this, you should be able to emerge Raku modules!

#Creating a New Ebuild

Most of the logic of the ebuilds has been consolidated in the raku-module.eclass. Because of this, you only need to inherit the eclass and set a few variables properly.

#Example Ebuild for a Raku Module

# Copyright $CURRENT_YEAR Gentoo Authors
# Distributed under the terms of the GNU General Public License v2
EAPI=7

inherit raku-module

DESCRIPTION="A short description of the module"
HOMEPAGE="The homepage of the module, often an index page of the source repository"
SRC_URI="https://the-download.url/path -> ${P}.tar.gz"

LICENSE="AGPL-3"
SLOT="0"
KEYWORDS="~amd64"

DEPEND="
    dev-raku/some-dependency
"

#Real-world examples

For a real-world example, check out the following modules in this repository.

• dev-raku/io-path-xdg