Rakudo Star

A user-friendly distribution of the Raku programming language.

Docker Image

Please refer to Rakudo-Star on Docker Hub for an image
Find the related Docker files on the “Raku Docker” GitHub repository

What’s in this GIT repo

There are currently two different tools within this repo. The so called RSTAR utility,
which manages the Linux build, and the chocolatey bases build script, which manages the Windows MSI build.

RSTAR utility

BASH based tool, should work on any Linux OS (and maybe also macOS?)
More information can be found in the related Wiki page

The the rstar utility is written in bash, all additional features should be
also based on bash. Using other utilities is accepted, but effort should be made to
avoid introducing new utilities. Furthermore, all code should be linted against
shellcheck and not produce any warnings.

build-with-choco.ps1 script

A Powershell script, which internally uses chocolatey to create a Windows MSI package
More information to be added in the wiki

Community Modules

One of Rakudo Star’s main features is in supplying users with a number of
popular community modules.

You should always prefer to use a pinned version of a module, wherever versions are available!

modules.txt

This modules file contains references to all community modules to be bundled with Rakudo Star.
It is a space-separated format. The first column is the name of
the module, the second the protocol to use, with the third column being the
URL to fetch it from. Columns following the third have different meaning
depending on the protocol.

Bugs, Feedback and Patches

Bugs

Please open an GitHub Issue for any found bug!
- If you’re reporting a RSTAR bug, please include the full logs of rstar with
  RSTAR_DEBUG=1, and the output of rstar sysinfo in your message.

Feedback

Mail and IRC

If you have a question about Rakudo Star, you probably want to write to the “perl6-users@perl.org” mailing list or ask the irc.libera.chat/#raku-star IRC channel.

GitHub Platform

Knowledge and documentation related to Rakudo Star can be published in the related wiki.
There is also Star discussions for any kind of ongoing discussions, alignements, FAQ’s, …
- Once things are discussed, agreed, finalized, they should be documented in the Wiki, see above!

Patches And Code Contributions

Please send your pull requests to the RAKUDO Star repository!
Also, try to be generous with comments. Especially when introducing new utility
functions, a little description of what it does and what problem it is intended
to solve go a long way.

Various GIT Repositories

The main git repository lives at https://github.com/rakudo/star. This should
be used as the reference to clone from.

Additionally, there are old mirrors of this repository at other places and from previous maintainers. You may find additional helpful information there, which can help to get a better understanding and some history of the Star package:

License

The software in this repository is distributed under the terms of the Artistic
License 2.0, unless specified otherwise.