/ 
Dist-Zilla-PluginBundle-Author-GETTY-0.316
/ Dist::Zilla::Plugin::Author::GETTY::GiteaMeta

NAME

Dist::Zilla::Plugin::Author::GETTY::GiteaMeta - Add Gitea/Forgejo (incl. Codeberg) repository metadata to META.{json,yml}

VERSION

version 0.316

DESCRIPTION

Derives the repository, bugtracker and homepage META resources from the distribution's git remote URL, for distributions hosted on a Gitea or Forgejo instance — Codeberg, or a self-hosted forge. Gitea, Forgejo and Codeberg all share the same web URL layout (https://host/owner/repo, .../issues, the repo page as homepage), so a single plugin covers the whole family — only the "host" differs. Works fully offline: no API token and no network access, unlike the external Dist::Zilla::Plugin::Codeberg::Meta (which targets the GitLab API and does not actually work against the Forgejo API).

Within Dist::Zilla::PluginBundle::Author::GETTY this plugin is the Gitea/Forgejo counterpart of Dist::Zilla::Plugin::GithubMeta: the bundle auto-selects it (passing the detected "host") for dists whose remote points at a known Gitea host, or when gitea = 1 is set. It is additive — GitHub-hosted distributions keep using GithubMeta unchanged.

The owner/repo slug is taken from the git remote and the URLs are built for "host". If the remote does not point at that host (and there is no "repo" override), no target is found and the plugin adds no resources at all — it never emits metadata for the wrong forge.

remote

Name of the git remote to read the repository URL from. Default: origin.

host

The forge host the URLs are built for, and the host the git remote is required to point at. Default: codeberg.org. The bundle sets this to the dist's actual remote host; override it directly for standalone use against a self-hosted Gitea/Forgejo instance.

repo

Override the owner/repo slug. Must be given in owner/repo form. By default the slug is extracted from the git remote URL.

issues

Set the bugtracker resource to the repository's issues page. Default: true.

homepage

What to put in the homepage resource: repo (the forge repository page, the default), metacpan (the metacpan.org release page), or none.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-dist-zilla-pluginbundle-author-getty/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012-2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

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