Dist::Zilla::Plugin::Dpkg - Generate Dpkg files for your perl module
version 0.05
# [Dpkg] # architecture = amd64 # default_template = package/debian/default
Dist::Zilla::Plugin::Dpkg generates Debian' controls files that you can use with debhelper to generate packages of your perl module.
There are a handful of tools that provide similar functionality. Most of them expect your perl module to have a standard installation mechanism. This module was born of a need for customization. It's projects used per-package perlbrews and all manner of custom bits.
This plugin uses Text::Template. The following variables will be passed to any templates that are processed, using attributes as values:
Each of the aforementioned template methods has an accompanying method that provides a default template. Most of these are undefined and therefore unused. This subclassing behavior allows you to create subclasses of Dist::Zilla::Plugin::Dpkg that provide default templates for many of the files.
The idea is to allow the easy creation of something like a Dist::Zilla::Plugin::Dpkg::Starman that provides boilerplate code for a Starman-based application.
The architecture of the package we're building. Defaults to any.
any
If set, the specified file is used as a template for the compat file.
compat
A default compat file template that will be used it a template isn't provided to compat_template.
compat_template
If set, the specified file is used as a template for the conffiles file.
conffiles
A default conffiles file template that will be used it a template isn't provided to conffiles_template.
conffiles_template
If set, the specified file is used as a template for the config file.
config
A default config file template that will be used it a template isn't provided to config_template.
config_template
If set, the specified file is used as a template for the control file. If not set uses an internal default.
control
A default control file template that will be used it a template isn't provided to control_template.
control_template
If set, the specified file is used as a template for the default file.
default
A default default file template that will be used it a template isn't provided to default_template.
default_template
If set, the specified file is used as a template for the init file.
init
A default init file template that will be used it a template isn't provided to init_template.
init_template
If set, the specified file is used as a template for the install file.
install
A default install file template that will be used it a template isn't provided to install_template.
install_template
Source binary dependencies. Defaults to debhelper (= 7.0.50~)>.
debhelper (
http://www.debian.org/doc/debian-policy/ch-relationships.html#s-sourcebinarydeps
Binary dependencies. Defaults to <C${misc:Depends}, ${shlibs:Depends}, ${perl:Depends}>.
http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
The description of the package we're making. Should use the form of:
Synopsis Multi-line description tacked on the end
http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description.
The name of the package we're making. Defaults to the lowercased version of the package name. Uses Dist::Zilla's name attribute.
name
The priority of the package we're making. Defaults to extra.
extra
http://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities.
The section of the package we're making. Defaults to lib.
lib
http://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections.
The name of this package converted to a form suitable for environment variable use. Foo-Bar becomes FOO_BAR. Defaults to name upper-cased with hyphens converted to underscores.
If set, the specified file is used as a template for the postinst file.
postinst
A default postinst file template that will be used it a template isn't provided to postinst_template.
postinst_template
If set, the specified file is used as a template for the postrm file.
postrm
A default postrm file template that will be used it a template isn't provided to postrm_template.
postrm_template
If set, the specified file is used as a template for the rules file.
rules
A default rules file template that will be used it a template isn't provided to rules_template.
rules_template
Predicate that is true if there is a conffiles_template
Cory G Watson <gphat@cpan.org>
This software is copyright (c) 2013 by Infinity Interactive, Inc.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::Dpkg, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::Dpkg
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::Dpkg
For more information on module installation, please visit the detailed CPAN module installation guide.