Module::Build::CipUX(3) 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 "[email protected]", or through the web interface at <http://rt.cpan.org>.

AUTHOR

Christian Kuelker "<[email protected]>"

LICENSE AND COPYRIGHT

Copyright (C) 2008 - 2009, Christian Kuelker "<[email protected]>". All rights reserved.

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.