NAME
Dist::Zilla::PluginBundle::DBIO - Dist::Zilla plugin bundle for DBIO distributions
VERSION
version 0.900002
SYNOPSIS
# Standard DBIO driver distribution
name = DBIO-MyDriver
[@DBIO]
# Distribution containing code derived from DBIx::Class
name = DBIO-PostgreSQL
[@DBIO]
heritage = 1
# DBIO core distribution
name = DBIO
copyright_year = 2005
[@DBIO]
core = 1
heritage = 1DESCRIPTION
Standard Dist::Zilla plugin bundle for all DBIO distributions.
All distributions
Every distribution using [@DBIO] gets:
Dist::Zilla::Plugin::Git::GatherDir — gathers files from git
Dist::Zilla::Plugin::MetaProvides::Package + Dist::Zilla::Plugin::Prereqs::FromCPANfile — metadata from cpanfile
Dist::Zilla::Plugin::PodWeaver — POD generation via
@DBIOor@DBIO::HeritageDist::Zilla::Plugin::ExtraTests — moves xt/ tests into t/ for release
Dist::Zilla::Plugin::DBIO::CodebergMeta — repository, bugtracker and homepage META resources, derived offline from the git remote (Codeberg/Forgejo or GitHub)
Dist::Zilla::Plugin::Git::CheckFor::CorrectBranch — enforces release from
main
The LICENSE file must be committed in the repository. It is included in the distribution as-is. No license file is generated during the build. Heritage distributions use the original DBIx::Class license with DBIO attribution. Non-heritage distributions use a standard Perl_5 license.
Versioning
Version is read from the main module's $VERSION via Dist::Zilla::Plugin::VersionFromMainModule (core) or via Dist::Zilla::PluginBundle::Git::VersionManager (drivers). Only the main module carries $VERSION — sub-modules are not versioned.
RewriteVersion::Transitional is configured with global = 0 and finder = [:MainModule] so only the main module is patched on version bump.
Heritage distributions (heritage = 1)
For distributions containing code derived from DBIx::Class. Uses Pod::Weaver::PluginBundle::DBIO::Heritage which adds a DBIx::Class copyright and attribution block to the generated POD. The copyright_holder defaults to DBIO & DBIx::Class Authors.
Core distribution (core = 1)
Uses Dist::Zilla::Plugin::VersionFromMainModule (version from $VERSION in the main module) and Dist::Zilla::Plugin::MakeMaker::Awesome instead of the standard MakeMaker. Also enables Dist::Zilla::Plugin::ExecDir for bin/. The release workflow uses NextRelease + Git::Commit/Tag/Push directly rather than @Git::VersionManager.
ATTRIBUTES
heritage
Set to 1 for distributions derived from DBIx::Class code. Switches Dist::Zilla::Plugin::PodWeaver to use Pod::Weaver::PluginBundle::DBIO::Heritage instead of Pod::Weaver::PluginBundle::DBIO, which adds a DBIx::Class copyright and attribution block to the generated POD. Also changes the default copyright_holder to DBIO & DBIx::Class Authors. Default: 0.
copyright_holder
Override the copyright holder string. If not set, defaults to DBIO & DBIx::Class Authors for heritage distributions and DBIO Authors for all others.
share_skill
Names of the agent skills this distribution owns (is the source of truth for). They are shipped as a sharedir (share/skills/) and exposed at runtime via DBIO::Skills. Repeatable; if omitted, the set is derived from the dist name. See Dist::Zilla::Plugin::DBIO::GatherSkills.
AUTHOR
DBIO Authors
COPYRIGHT AND LICENSE
Copyright (C) 2026 DBIO Authors
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.