rakudo/star

Rakudo Star (Raku distribution)

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 “[email protected]” 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:

• https://git.sr.ht/~tyil/rakudo-star
• https://gitlab.com/tyil/rakudo-star
• https://git.tyil.nl/rakudo-star
• https://github.com/Raku/rakudo-star

License

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