Module::Build::CipUX(3pm)

User Contributed Perl Documentation

Module::Build::CipUX(3pm)

NAME¶

Module::Build::CipUX - Extension for building CipUX

VERSION¶

This document describes Module::Build::CipUX version 0.4.0

SYNOPSIS¶

    use Module::Build::CipUX;
    my $build = Module::Build::CipUX->new(
        module_name     =>  'xxxx',
        license         =>  'gpl',
        ...
        cipux_paths       =>  {
            'schema' =>  q(/etc/ldap/schema),
            'setup'  =>  q(/etc/cipux/setup),
        },
        # cipux_schema   =>  [ glob('extras/*.schema') ],
        # cipux_setup =>  [ glob('extras/*.setup') ],
        # build target
        schema_files => {
             'etc/ldap/schema/cipux.schema' => 'schema/cipux.schema',
        },
        setup_files => {
            'etc/cipux/setup/courier.schema'        => 'setup/courier.schema',
            'etc/cipux/setup/debian-cipux.conf'     => 'setup/debian-cipux.conf',
            'etc/cipux/setup/debian-edu-cipux.conf' => 'setup/debian-edu-cipux.conf',
            'etc/cipux/setup/debian-edu-ldap.acl'   => 'setup/debian-edu-ldap.acl',
            'etc/cipux/setup/debian-edu-ldap.ldif'  => 'setup/debian-edu-ldap.ldif',
            'etc/cipux/setup/debian-ldap.acl'       => 'setup/debian-ldap.acl',
            'etc/cipux/setup/debian-ldap.ldif'      => 'setup/debian-ldap.ldif',
            'etc/cipux/setup/lis.schema'            => 'setup/lis.schema',
        },
                );
    my $elem_ar = $builder->get_all_elements;
    foreach my $e (@{$elem_ar}){
        $builder->add_build_element($e);
    }
    $build->create_build_script();

DESCRIPTION¶

The goal of this module is build and install CipUX plugins in Perl and also handle CipUX core modules, subclassing the Module::Build and adding some extra funtionalities to it.

For a description of the interface see Module::Build::API.

This is a list of new parameters in the Module::Build::new method:

cipux_paths

    Define the install paths of the components using a hash with the following keys:
    setup
        The default value is /etc/cipux/setup.
    schema
        The default value is /etc/ldap/schema.

cipux_setup

    List of setup files to install.

cipux_schema

    List of LDAP schema files to install.

INTERFACE¶

cipuxrelease

  [version 0.1.0]
  Make a cipux release tarball

CONSTRUCTOR¶

new¶

New inscance of Module::Build::CipUX.

  my $build = Module::Build::CipUX->new();

SUBROUTINES/METHODS¶

ACTION_cipuxpo2mo( @params )¶

Build action which converts *.po files to *.mo files using gettext.

ACTION_cipuxrelease( @params )¶

Build a simple CipUX release tarball.

_get_prop( $self )¶

Returns private properties from the hash in Build.PL. This was inspired by Module::Build::IkiWiki. This violates ProhibitAccessOfPrivateData. If someone knows how to do better, drop a mail to cipux-devel mailing list.

$cipux_elements_ar = get_all_elements()¶

Retrieve all elements and return a array reference to it.

 $cipux_elements_ar = get_all_elements();

add_all_elements()¶

Call get_all_elements and add all elements to the build list by add_build_element.

$results_hr = search_files({ PARAM })¶

PARAM:
source_prefix # cgi
source_extension # pl
destination_prefix # webcgi
destination_extension # cgi
verbose # 1|0

Search a given directory for files of given extension, change the extension and construct a new path with the file name. It returns a hash reference.

var_dump({ PARAM })¶

PARAM:
var_r (mandatory) reference to variable
name (mandatory) name of variable
file (optional) filename if wish is to dump to file
fh (optional) if not defined *STDOUT; other file handle or handle

Dump a variable to STDOUT. Or if parameter is given, dump it to a file or to another location given by a handle.

$files_hr = find_bin750_files()¶

Find all files for mode 750 and return hash reference. Uses find_files_by_element.

process_bin750_files()¶

Process files.

$files_hr = find_bin755_files()¶

Find all files for mode 755 and return hash reference. Uses find_files_by_element.

process_bin755_files¶

Process files.

$files_hr = find_sbin750_files()¶

Find all files for mode 750 and return hash reference. Uses find_files_by_element.

process_sbin750_files¶

Process files.

$files_hr = find_sbin755_files()¶

Find all files for mode 755 and return hash reference. Uses find_files_by_element.

process_sbin755_files¶

Process files.

$files_hr = find_webcgi_files()¶

Find all files for element webcgi and return hash reference. Uses find_files_by_element.

process_webcgi_files¶

Process files.

$files_hr = find_initscript_files()¶

Find all files for element initscript and return hash reference. Uses find_files_by_element.

process_initscript_files¶

Process files.

$files_hr = find_conf644_files()¶

Find all files for element conf644 and return hash reference. Uses find_files_by_element.

process_conf644_files¶

Process files.

$files_hr = find_conf600_files()¶

Find all files for element conf600 and return hash reference. Uses find_files_by_element.

process_conf600_files¶

Process files.

find_bootcfg_files¶

Find files.

process_bootcfg_files¶

Process files.

find_bootcfgobject_files¶

Find files.

find_bootcfgstorage_files¶

Find files.

find_bootcfgaccess_files¶

Find files.

find_bootcfgtask_files¶

Find files.

process_bootcfgobject_files¶

Process files.

process_bootcfgstorage_files¶

Process files.

process_bootcfgaccess_files¶

Process files.

process_bootcfgtask_files¶

Process files.

$files_hr = find_locale_files()¶

Find all files for element locale and return hash reference. Uses find_files_by_element.

process_locale_files¶

Process files.

$files_hr|undef = find_files_by_element( { element=>$element } )¶

Add $element . '_files' to include list. Returns reference to hash of all files in that directory if the directory exists; otherwise returns undef

@files = process_files_element( { element=>$element } )¶

Execute find_${elelemt}_files method. Returns list of files for trivial files. For non-trivial files it does...:

General:

 make a path
 skip .svn dirs
 change extension for some files, copy otherwise
 make some files executable
 change some modes

PO:

 check number of *.pot files
 identify the *.pot file
 build file name from *.pot file for *.mo file
 build *.mo file from *.po file with msgfmt

DIAGNOSTICS¶

Error messages are from the base class. This package generates no exceptions.

"Couldn't mkdir $podir: $!";": Occurs if it is not possible to make a directory in blib/po

CONFIGURATION AND ENVIRONMENT¶

Module::Build::CipUX requires no configuration files or environment variables.

DEPENDENCIES¶

Module::Build

INCOMPATIBILITIES¶

None reported.

BUGS AND LIMITATIONS¶

No bugs have been reported.

Please report any bugs or feature requests to "bug-module-build-cipux@rt.cpan.org", or through the web interface at <http://rt.cpan.org>.

AUTHOR¶

Christian Kuelker "<christian.kuelker@cipworx.org>"

LICENSE AND COPYRIGHT¶

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

DISCLAIMER OF WARRANTY¶

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

2015-07-24

perl v5.20.2

Source file:	Module::Build::CipUX.3pm.en.gz (from libmodule-build-cipux-perl )
Source last updated:	2015-07-24T09:02:52Z
Converted to HTML:	2024-10-21T18:48:02Z