NAME
Dist::Zilla::Plugin::SimpleBootstrap - Bootstrap a Dist::Zilla library
SYNOPSIS
# in dist.ini
[SimpleBootstrap]
# use a plugin under lib/
[Plugin::Under::Development]DESCRIPTION
Allow using a plugin being developed in its own dist.ini. Unlike [Bootstrap::lib], it doesn't try to use a version of the module that has been built by Dist::Zilla, instead always using modules directly from lib/.
Additionally, it ensures that the modules are available during the build phase. Dist::Zilla localizes @INC during the initial loading of modules, so modifications made at that time wouldn't normally persist. This allows things like Pod::Weaver plugins to be used from the lib/ directory.
If a share/ directory exists, it will be set as the share directory for the distribution.
OPTIONS
- lib
-
Can be used to specify an alternate directory to bootstrap, rather than lib.
-
Specifies the dist share directory for the distribution.
If module_share is not specified, this defaults to share.
Defaults to share.
-
Specifies module share directories. Should be formatted as:
module_share = My::Module = share
KNOWN ISSUES
This module will not work well when used with Test::DZil.
SEE ALSO
[Bootstrap::lib], a significantly more complex plugin, which doesn't solve the problem of
@INCbeing localized. Also does not include handling for share directories.[lib], a simple plugin, but which doesn't solve the problem of
@INCbeing localized. Also does not include handling for share directories.
BUGS
Please report any bugs or feature requests on the bugtracker website https://github.com/haarg/Dist-Zilla-Plugin-SimpleBootstrap/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.
AUTHOR
Graham Knop <haarg@haarg.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2024 by Graham Knop.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.