A PURL specification for Raku modules

[lizmat]

The Package URL specification is:

The Package URL core specification defines a versioned and formalized format, syntax, and rules used to represent and validate purl.

A purl or package URL is an attempt to standardize existing approaches to reliably identify and locate software packages.

A purl is a URL string used to identify and locate a software package in a mostly universal and uniform way across programming languages, package managers, packaging conventions, tools, APIs and databases.

Such a package URL is useful to reliably reference the same software package using a simple and expressive syntax and conventions based on familiar URLs.

With the work that I've done on SBOM (Software Bill Of Materials) and PURL it became clear to me that the Raku Programming Language would benefit from having a registered PURL type.

[lizmat]

I therefore intend to create a Pull Request in the https://github.com/lizmat/purl-spec repo with the following information:

raku
----
``raku`` for library / module distributions in the Raku Programming Language.

- There is no default repository.
- The ``namespace`` refers to the ``auth`` of the distribution, for example `zef:lizmat`, where the token before the `:` indicates the ecosystem in which the distribution resides. 
- The ``name`` is the distribution name and is case sensitive.
- The ``version`` is the module or distribution version.
- Optional qualifiers may include:
  - ``repository_url``:  the URL where the source of the distribution can be found
  - ``download_url``: URL from where the distribution can be downloaded

- Examples::

      pkg:raku/zef:lizmat/SBOM::CycloneDX@0.07?download_url=https://360.zef.pm/S/BO/SBOM_CYCLONEDX/e9df9ac7d473c289aae4df19ea10c0289bb04851.tar.gz&repository_url=https://github.com/lizmat/SBOM-CycloneDX
      pkg:raku/cpan:TIMOTIMO/JSON::Fast@0.19?download_url=https://cpan.metacpan.org/authors/id//T/TI/TIMOTIMO/Perl6/JSON-Fast-0.19.tar.gz&repository_url=https://github.com/timo/json_fast

And remove perl6 from the "Other candidates list to define". :-)

Please let me know if I missed anything!

[lizmat]

Added mention of "api" version, after a conversation with @ugexe++

raku
----
``raku`` for library / module distributions in the Raku Programming Language.

- There is no default repository.
- The ``namespace`` refers to the ``auth`` of the distribution, for example `zef:lizmat`, where the token before the `:` indicates the ecosystem in which the distribution resides (currently either "zef" or "cpan"). 
- The ``name`` is the distribution name and is case sensitive, and may include any Unicode character that is legal in an identifier.
- The ``version`` is the module or distribution version, optionally followed by a slash and the API level.  Absence of API level means API level 0 (generally means only one API is available).
- Optional qualifiers may include:
  - ``repository_url``:  the URL where the source of the distribution can be found
  - ``download_url``: URL from where the distribution can be downloaded

- Examples::

      pkg:raku/zef:lizmat/SBOM::CycloneDX@0.07
      pkg:raku/cpan:TIMOTIMO/JSON::Fast@0.19
      pkg:raku/zef:vrurg/Cro::RPC::JSON@0.1.6/2
      pkg:raku/zef:lizmat/SBOM::CycloneDX@0.07?download_url=https://360.zef.pm/S/BO/SBOM_CYCLONEDX/e9df9ac7d473c289aae4df19ea10c0289bb04851.tar.gz&repository_url=https://github.com/lizmat/SBOM-CycloneDX
      pkg:raku/cpan:TIMOTIMO/JSON::Fast@0.19?download_url=https://cpan.metacpan.org/authors/id//T/TI/TIMOTIMO/Perl6/JSON-Fast-0.19.tar.gz&repository_url=https://github.com/timo/json_fast

[sjn]

lgtm! (modulus our conversation today 😁)

[lizmat]

package-url/purl-spec#536 created.

[lizmat]

Superseded by package-url/purl-spec#550