/ 
Dist-Zilla-PluginBundle-DBIO-0.900001
/ Dist::Zilla::PluginBundle::DBIO

NAME

Dist::Zilla::PluginBundle::DBIO - Dist::Zilla plugin bundle for DBIO distributions

VERSION

version 0.900001

SYNOPSIS

# New DBIO distribution — LICENSE committed in repo
name = DBIO-PostgreSQL-Async
author = DBIO Authors
license = Perl_5

[@DBIO]

# Distribution derived from DBIx::Class code — LICENSE committed in repo
name = DBIO-PostgreSQL
author = DBIO & DBIx::Class Authors
license = Perl_5

[@DBIO]
heritage = 1

# DBIO core — copyright from 2005, explicit copyright_holder override
name = DBIO
author = DBIx::Class & DBIO Contributors (see AUTHORS file)
license = Perl_5
copyright_year = 2005

[@DBIO]
core = 1
heritage = 1
copyright_holder = DBIO Contributors

DESCRIPTION

Standard Dist::Zilla plugin bundle for all DBIO distributions.

All distributions

Every distribution using [@DBIO] gets:

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.

Driver distributions (default)

Version is taken from git tags via Dist::Zilla::PluginBundle::Git::VersionManager. For brand-new distributions without any tags yet, the first version will be 0.900000. The release workflow uses @Git::VersionManager (which includes NextRelease), followed by Dist::Zilla::Plugin::ConfirmRelease, Dist::Zilla::Plugin::UploadToCPAN, and Dist::Zilla::Plugin::Git::Push.

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 script/. The release workflow uses NextRelease + Git::Commit/Tag/Push directly rather than @Git::VersionManager.

ATTRIBUTES

core

Set to 1 for the DBIO core distribution. Switches to Dist::Zilla::Plugin::VersionFromMainModule for versioning, Dist::Zilla::Plugin::MakeMaker::Awesome for building, enables Dist::Zilla::Plugin::ExecDir for script/, and uses a simplified git release workflow without @Git::VersionManager.

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.

Override the copyright holder string. If not set, defaults to DBIO & DBIx::Class Authors for heritage distributions and DBIO Authors for all others.

AUTHOR

DBIO & DBIx::Class 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.