NAME
Dist::Zilla::Plugin::Upload::OrePAN2 - Dist::Zilla release plugin to inject into a local OrePAN2 repository
VERSION
version 0.0001
SYNOPSIS
[Upload::OrePAN2]
directory = /home/geekruthie/path/to/my/orepan2 # mandatory; must be absolute!
username = GEEKRUTH # default: DUMMY
DESCRIPTION
This Dist::Zilla plugin lets you inject a completed release into an OrePAN2 repository.
ATTRIBUTES
clobber
-
If this attribute is set to true, it will allow the releaser to overwrite the file if it already exists. The default is false.
directory
-
This mandatory attribute must be the absolute path to your OrePAN2 repository.
username
-
Use this attribute to set the CPAN-like username that is used in the OrePAN2 repository. It is optional; the default is
DUMMY
, which, while it may or may not be descriptive, might also be good enough for a small, private OrePAN2 repo.
DIAGNOSTICS
If the file already exists and clobber
is not set to true, or if the file cannot properly be injected into the repository, the release will halt at that point.
BUGS AND LIMITATIONS
I'm not at all certain what this will do if you're on Windows; I don't have a Windows machine handy to test on, so if someone would let me know, that'd be great. I'd like to enhance this later to install to an OrePAN2::Server instance using POST requests, but it cannot do that...yet.
SEE ALSO
AUTHOR
D Ruth Holloway <ruth@hiruthie.me>
COPYRIGHT AND LICENSE
This software is copyright (c) 2022 by D Ruth Holloway.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.