CPANPLUS backend for building Archlinux pacman packages
Fetching latest commit…
Cannot retrieve the latest commit at this time
CPANPLUS-Dist-Arch This module is a wrapper used by CPANPLUS to install perl modules using the Archlinux pacman package manager. This makes perl modules easier to remove, upgrade, etc. You will need to have pacman installed, of course, to create package and to install these new packages. Pacman is included with Archlinux but can even be used on other Linux distributions. (see http://wiki.archlinux.org/index.php/Pacman) INSTALLATION To install this module, run the following commands: perl Build.PL ./Build ./Build test ./Build install CPANPLUS SETUP This module is not meant to be used directly. Instead you should use it through the cpanp shell or the cpan2dist utility that is included with CPANPLUS. $ cpan2dist --format CPANPLUS::Dist::Arch Acme::Bleach This lengthly command line can be shortened by specifying CPANPLUS::Dist::Arch as the default 'Dist' type to use in CPANPLUS's configuration. A utility script name 'setupdistarch' is included with this module that can be used to quickly enable or disable packaging perl modules into pacman packages: $ setupdistarch This script will now setup CPANPLUS to automatically package all modules into pacman packages when installing. Are you sure you want to do this? [y/N] y Set CPANPLUS to package all modules through CPANPLUS::Dist::Arch $ See setupdistarch for more information about setupdistarch. If you are having trouble running setupdistarch or cpanp, your PATH may not be set properly, add /usr/bin/perlbin/core and /use/bin/perlbin/vendor to your .profile file in your home directory. # Example ~/.profile export PATH=/usr/bin:/bin:/usr/bin/perlbin/core:/usr/bin/perlbin/vendor Or you can setup CPANPLUS manually: $ cpanp ... CPANPLUS's startup output here ... CPAN Terminal> s conf dist_type CPANPLUS::Dist::Arch Key 'dist_type' was set to 'CPANPLUS::Dist::Arch' CPAN Terminal> s save Configuration successfully saved to CPANPLUS::Config::User (/home/<yournamehere>/.cpanplus/lib/CPANPLUS/Config/User.pm) CPAN Terminal> q Exiting CPANPLUS shell Now you do not have to use the explicit --format flag: $ cpan2dist Acme::Bleach After dist_type is set, CPANPLUS will automatically package anything you install using cpanp. Score! You could then package and install the Acme::Bleach module like so: $ cpanp i Acme::Bleach WHERES IS THE PACKAGE? Packages are stored under the user's home directory, (the HOME environment variable) under the .cpanplus directory. Two seperate directories are created for building packages and for storing the resulting package file. Build Directory : ~/.cpanplus/5.10.0/pacman/build Package Directory : ~/.cpanplus/5.10.0/pacman/pkg Where 5.10.0 represents the version of perl you used to build the package and ~/.cpanplus represents the base directory chosen in your CPANPLUS config. You can change the destination by setting PKGDEST in your /etc/makepkg.conf file. You can also set the PKGDEST environment variable to a directory where you want to store all built packages. SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command. perldoc CPANPLUS::Dist::Arch Email me at <jrcd83 at gmail> or message me as "juster" on the Archlinux BBS at http://bbs.archlinux.org. You can also look for information at: Archlinux Forums http://bbs.archlinux.org RT, CPAN's request tracker http://rt.cpan.org/NoAuth/Bugs.html?Dist=CPANPLUS-Dist-Arch AnnoCPAN, Annotated CPAN documentation http://annocpan.org/dist/CPANPLUS-Dist-Arch CPAN Ratings http://cpanratings.perl.org/d/CPANPLUS-Dist-Arch Search CPAN http://search.cpan.org/dist/CPANPLUS-Dist-Arch/ COPYRIGHT AND LICENCE Copyright (C) 2009 Justin Davis This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.