Manpages - WWW_AUR.3pm

WWW::AUR - API for the Archlinux User Repository website.

use WWW::AUR; my $aur = WWW::AUR->new( basepath => /tmp/aurtmp ); my $pkg = $aur->find( perl-www-aur ); # download_size() can check the file size without downloading… printf “Preparing to download source package file (%d bytes).\n”, $pkg->download_size; $pkg->download; printf “Downloaded pkgfile to %s.\n”, $pkg->src_pkg_path; $pkg->extract; # calls download() if you didnt printf “Extracted pkgfile to %s.\n”, $pkg->src_dir_path; $pkg->build; # calls extract() if you didnt printf “Built binary pkgfile and saved to %s.\n”, $pkg->bin_pkg_path; my $who = $pkg->maintainer(); printf “%s is maintained by %s.\n”, $pkg->name, $who->name; print “Here is all of their maintained packages:\n”; for my $otherpkg ( $who->packages ) { printf “ - %s\n”, $otherpkg->name; } my $login = $aur->login( myname, mypassword ) or die “Failed to login as myname, what a shock”; $login->vote( my-favorite-package ); $login->disown( i-hate-this-package ); $login->upload( ../a-new-package-file.src.pkg.tar.gz, lib ); print “Iterating through ALL packages…\n”; my $iter = $aur->packages; while ( my $pkgobj = $iter->next ) { my %info = $pkgobj->info; print “$info{name} – $info{version}\n”; }

The Archlinux User Repository is a relatively simple website that houses user-submitted packages for ArchLinux. These source packages merely contain what is required to build the package, unlike Archlinux’s official repository which house binary packages.

This module provides an interface for the straight-forward AUR user as well as for AUR author, aka package maintainers. The goal is to be able to do anything with this module that you could with a web browser.

The WWW::AUR::Package module also allows the module user to download and build source packages using makepkg. Installation is left up to the module user and is not implemented in this module.

$OBJ = WWW::AUR->new( %PATH_PARAMS? );

%PATH_PARAMS (Optional)

These parameters are optional. See PATH PARAMETERS.

$OBJ

A WWW::AUR object.

The constructor’s only parameters are for paths to use in objects. Path parameters are propogated to every WWW::AUR::Package object that is created. Package objects are created when using methods such as search and find.

Path parameters are also propogated to objects that create their own WWW::AUR::Package object, in turn. For example they are propogated to the WWW::AUR::Maintainer object created by maintainer, the WWW::AUR::Login object created by login, and the WWW::AUR::Iterator object created by packages.

Path parameters are given as a hash with the keys as follows:

basepath

Specifies a base with which to set the dlpath, extpath, and destpath quickly. Setting the base path sets the other path parameters to paths relative to the basepath. After the ’basepath’ is set, other path parameters can still be overriden with their own values. Defaults to /tmp/WWW-AUR.

dlpath

A directory to store downloaded source package files. Defaults to $basepath/src.

extpath

A directory to store source package directories. These are extracted from the source package file. Defaults to $basepath/build.

destpath

A directory to store built binary package files. Binary package files are built from the source package files by using makepkg. Defaults to $basepath/cache.

• http://github.com/jnbek/perl-www-aur
• http://aur.archlinux.org
• http://www.archlinux.org/pacman/makepkg.8.html

John D Jones III, <jnbek at cpan dot org>

Justin Davis, <juster at cpan dot org>

Mr Davis created and maintained this awesome module for many years. After the AUR4 migration, he became unable to devote the time needed to maintain this module any longer and blessed me with taking over this module’s maintainership. Thanks Justin for doing all the real work on this module and making it so all I needed to do was update a few lines of code here and there and update a couple of tests.

Please email me any bugs you find. I will try to fix them as quick as I can.

Send me an email if you have any questions or need help.

Copyright 2014-2015 Justin Davis.

Copyright 2015-2016 John D Jones III

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

See http://dev.perl.org/licenses/ for more information.