NAME
CPAN::Meta::X - List of custom (x_*) keys in CPAN distribution metadata being used in the wild
VERSION
This document describes version 0.003 of CPAN::Meta::X (from Perl distribution CPAN-Meta-X), released on 2021-04-15.
DESCRIPTION
The CPAN distribution metadata specification allows custom keys (those that begin with x_ or X_) to be added to the metadata. This document tries to catalog the custom keys that are being used by CPAN authors.
In addition to custom metadata keys, this document also lists:
custom phases and relationships in the prereqs hash that are being used by people
custom keys in resources hash
LIST OF CUSTOM DISTRIBUTION METADATA KEYS
x_Dist_Zilla key
A big structure recording information related to Dist::Zilla which presumably is used to build the current distribution. Some of the things being put in here include: perl version used to build the distribution, Dist::Zilla plugins used to build the distribution, and so on.
x_authority key
x_contributors key
List of contributors in a release.
Examples:
TBD
References:
x_deprecated key
x_examples key
List prerequisites for example scripts.
References:
x_generated_by_perl key
x_help_wanted key
x_provides_scripts key
List scripts that are being provided in the distribution. The structure is modelled after the standard provides hash.
Examples:
So say your distribution provides a "csv2json" script, your META.json would contain:
"x_provides_scripts": {
"csv2json": {
"version": "0.1",
"file": "bin/csv2json"
}
}References:
x_spdx_expression key
x_serialization_backend key
x_static_install key
LIST OF CUSTOM PREREQS PHASES
x_benchmarks phase
Express that the current distribution is benchmarking the specified module.
References:
x_mentions phase
Express that the current distribution is mentioning the specified module.
References:
x_spec phase
Express that the current distribution is following a specification defined in the specified module.
References:
LIST OF CUSTOM PREREQS RELATIONSHIPS
x_benchmarks relationship
See "x_benchmarks phase".
x_mentions relationship
See "x_mentions phase".
x_spec relationship
See "x_spec phase".
LIST OF CUSTOM RESOURCES
x_IRC resource
x_identifier resource
x_mailinglist resource
x_wiki resource
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/CPAN-Meta-X.
SOURCE
Source repository is at https://github.com/perlancar/perl-CPAN-Meta-X.
BUGS
Please report any bugs or feature requests on the bugtracker website https://github.com/perlancar/perl-CPAN-Meta-X/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
CPAN::Meta::Spec - Specification for CPAN distribution metadata
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2021 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.