NAME

Dist::Zilla::Plugin::SourceHutMeta - Automatically include SourceHut meta information in META.yml

VERSION

version 1.000

SYNOPSIS

# in dist.ini

[SourceHutMeta]

# to override the homepage

[SourceHutMeta]
homepage = http://some.sort.of.url/project/

# to override the remote repo (defaults to 'origin')
[SourceHutMeta]
remote = sr.ht

DESCRIPTION

Dist::Zilla::Plugin::SourceHutMeta is a Dist::Zilla plugin to include SourceHut https://sr.ht meta information in META.yml and META.json.

It automatically detects if the distribution directory is under git version control and whether the origin is a SourceHut repository and will set the repository and homepage meta in META.yml to the appropriate URLs for SourceHut.

Copy/pasted and slightly adapted from Dist::Zilla::Plugin::GithubMeta

ATTRIBUTES

• remote

  The SourceHut remote repo can be overridden with this attribute. If not provided, it defaults to origin. You can provide multiple remotes to inspect. The first one that looks like a SourceHut remote is used.

• homepage

  You may override the homepage setting by specifying this attribute. This should be a valid URL as understood by MooseX::Types::URI.

• issues

  If true, a bugtracker URL will be added to the distribution metadata for the project's SourceHut todo section.

• user

  If given, the user parameter overrides the username found in the SourceHut repository URL. This is useful if many people might release from their own workstations, but the distribution metadata should always point to one user's repo.

• repo

  If give, the repo parameter overrides the repository name found in the SourceHut repository URL.

METHODS

• metadata

  Required by Dist::Zilla::Role::MetaProvider

SEE ALSO

Dist::Zilla, Dist::Zilla::Plugin::GithubMeta

CONTRIBUTING

If you find any bugs or have improvement suggestions, please send them to me via email.

• email + git
• Sending patches upstream via SourceHut

AUTHORS

• Thomas Klausner domm@plix.at
• Chris Williams chris@bingosnet.co.uk

COPYRIGHT AND LICENSE

This software is copyright (c) 2025 by Thomas Klausner, Chris Williams.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.