Dist::Zilla::Plugin::Bootstrap::ShareDir::Module - Use a share directory on your dist for a module during bootstrap
This module allows one to load a
ShareDir using a
Bootstrap mechanism so a distribution can use files in its own source tree when building with itself.
This is very much like the
Bootstrap::lib plugin in that it injects libraries into
@INC based on your existing source tree, or a previous build you ran.
And it is syntactically like the
Note that this is really only useful for self consuming plugins and will have no effect on the
run phases of your dist. ( For that, you'll need
[Bootstrap::lib] [Bootstrap::ShareDir::Module] Foo::Bar = shares/foo_bar Foo::Baz = shares/foo_baz [ModuleShareDirs] Foo::Bar = shares/foo_bar Foo::Baz = shares/foo_baz
The only significant difference between this module and
ModuleShareDirs is this module exists to make a
share visible to plugins for the distribution being built, while
ModuleShareDirs exists to export a
share directory visible after install time.
For instance, this bootstraps
ROOT/Your-Dist-Name-$VERSION/shares/foo_bar if it exists and there's only one
$VERSION, otherwise it falls back to simply bootstrapping
[Bootstrap::ShareDir::Module] Foo::Bar = shares/foo_bar Foo::Baz = shares/foo_baz ; These are special cased dir = share try_built = 1
Kent Fredric <firstname.lastname@example.org>
This software is copyright (c) 2017 by Kent Fredric <email@example.com>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.