Arch Linux Forums

hi all,

here is a script which manages a local repository and lets you edit
PKGBUILDs and other related files, automatically generates checksums,
build packages, add them to your local repo and so on.
it also has AUR support for submitting tarballs, leaving comments, etc.

get it from here:
http://sourceforge.net/projects/pkgman/
and AUR package:
http://aur.archlinux.org/packages.php?ID=17100
you need abs, curl and pacman and optionally namcap and desktop-file-utils.

output of "pkgman -h":

pkgman provides a unified tool to ease the workflow with pacman packages:
edit and backup PKGBUILDs, compile and build packages, manage a local repository and submit tarballs to AUR
For a more detailed description please read the manual page.

Usage: pkgman [packagename] [options] [parameters]

Initialize directory structure for use with pkgman:
    --runmefirst                check $Localpackages for directories matching ABS or AUR packages and index them

Most simple usage:
    <packagename>       check if <packagename> exists either in ABS or AUR, copy files
                                    or download and untar the source tarball to $Localpackages dir and edit files
    Possible options are:
        -a, --abs               synchronize abs repositories specified in /etc/abs.conf
        -b, --backup            toggle BackupTarball to yes or no depending on its setting in pkgman.conf
        -m, --makepkg           toggle UseMakepkg to yes or no depending on its setting in pkgman.conf
        -r, --repoadd           toggle UseRepoadd to yes or no depending on its setting in pkgman.conf
        -w, --switch            toggle SwitchToBuildDirectory to yes or no depending on its setting in pkgman.conf

Create a new PKGBUILD source tarball:
    <packagename> -n, --new     choose template from $TemplatesDir, copy it to $Localpackages/<packagename>
    Possible options to use with "-n|--new":
        -b, --backup            toggle BackupTarball to yes or no depending on its setting in pkgman.conf
        -m, --makepkg           toggle UseMakepkg to yes or no depending on its setting in pkgman.conf
        -r, --repoadd           toggle UseRepoadd to yes or no depending on its setting in pkgman.conf
        -s, --submit            submit newly created src.tar.gz to AUR
        -w, --switch            toggle SwitchToBuildDirectory to yes or no depending on its setting in pkgman.conf

Edit an existing PKGBUILD source tarball:
    <packagename> -e, --edit    edit files in package or backup directory
    Possible options to use with "-e|--edit":
        -b, --backup            toggle BackupTarball to yes or no depending on its setting in pkgman.conf
        -m, --makepkg           toggle UseMakepkg to yes or no depending on its setting in pkgman.conf
        -r, --repoadd           toggle UseRepoadd to yes or no depending on its setting in pkgman.conf
        -s, --submit            submit edited src.tar.gz to AUR
        -v <version>, --pkgbuildversion <version>     edit given backed up version
        -w, --switch            toggle SwitchToBuildDirectory to yes or no depending on its setting in pkgman.conf

<packagename> directory and backup directory maintenance:
    <packagename> -l, --list    show the files in backup directory and some information
    -l, --list                  show available package directories in $Localpackages
    <packagename> --cleanup     menu with options for removing files in $Localpackages/<packagename>:
                                one can either choose to delete files except source files ending on bz2, deb, jar, gz, tgz, rar, rpm, run, zip or
                                delete ALL files in $Localpackages/<packagename>
    --cleanup                   menu with options for removing files in each <packagename> directory in $Localpackages:
                                one can either choose to delete files except source files ending on bz2, deb, jar, gz, tgz, rar, rpm, run, zip or
                                delete ALL files in each <packagename> directory in $Localpackages
    <packagename> -c, --check   check backed up packages
    <packagename> -d, --delete  delete files in backup directory
    <packagename> --Deleteall   delete ALL files in backup directory

Local repository maintenance:
    -r, --repoadd               ask for package in backup directory to add to $LocalRepository
    Further option for "-r|--repoadd":
        -l, --list              show packages in $LocalRepository
    R, --Reporemove             remove <packagename> package from $LocalRepository

ABS/AUR related options:
    -a, --abs                  synchronize abs repositories specified in /etc/abs.conf
    -C, --comment               add a comment if package is in AUR/Community; this works with any package
    --Disown                    disown an AUR package owned by user 
    --getownpackages            resync own packages in /home/vlad/apps/arch/pkgbuild-self with AUR
    --listversions              show available ABS/AUR versions of already installed packages from /home/vlad/apps/arch/pkgbuild-self
    -o, --own                   list only own packages submitted to AUR found in /home/vlad/apps/arch/pkgbuild-self
    -s, --submit                submit a backed up tarball to AUR

Miscellaneous options:
    -h                          display short help
    --help                      show man page; same as "man pkgman"
    -i, --info                  list settings according to pkgman.conf
    -V, --version               show version information

Layout options:
    --default                   switch back to default color layout (if changed in pkgman.conf)
    --lightbg                   change color layout 
    --nocolor                  don't use any colors

RTFM online:
http://sourceforge.net/apps/mediawiki/p … n_man_page

first of all copy the pkgman.conf and AUR.conf files from /usr/share/pkgman to ~/.config/pkgman/ ,
edit these two files and then run

pkgman --runmefirst

pkgman doesn´t install anything. if you want it just builds the package and moves it to your local repository. install it then with pacman.
it also has no dependency handling. there are many other tools which provide this.

the main intention was to keep track of package versions, different PKGBUILD versions and own AUR submitted tarballs; also to keep a clean local repository and clean build directories.

pkgman is stable now. i´m using it for months without any issues.
however, if there are problems or feedback please post them here.

vlad

changelog:

version 2.4:
       *pkgman now respects the PKGDEST and SRCDEST variables from makepkg.conf. (though it still moves the src.tar.gz and .pkg.tar.gz to package backup directory).

version 2.5:
       *pkgman uses PKGDEST if SRCDEST not set in makepkg.conf.

version 2.6 -> r26:
       *changed version system: version 2.6 is now r26!
       *minor changes: > pkgman uses now the $SHELL variable.
                                > new and more comprehensible manpage description (thanks to bender02)

version r27:
       *changed SRCDEST since it's only a cache dir. all files (pkg.tar.gz and src.tar.gz) go to PKGDEST.

version r28:
       *added new variable ShellCommand to pkgman.conf. Default is $SHELL.
       *One might use an external application (like screen or xterm) to switch to build directory and edit files simultaneously.

version r30:
       *minor changes. nothing crucial

r32: *OverwriteExistingPackage isn't used anymore. one can delete it from ~/.config/pkgman/pkgman.conf.
       *minor changes

version r33:
       *"-l|--list" also shows installed package version and available ABS/AUR PKGBUILD version for given package.
       *"-a|--abs" can now also be used with other options (like "-e")

r39: * when backing up src.tarballs it asks whether to backup the source file or not
       * more detailed "--list" option - also shows if package is installed or not and available ABS/AUR version
       * added prompt to clean up directory after makepkg
       * when checking pkg.tar.gz also possibility to check for conflicts with files of already installed packages
       * use $PAGER instead of less
       * --help directly shows the manpage
       * --shorthelp shows a brief usage overview
       * added a custom prompt, but only when using bash (is somehow experimental - works fine here for me)
       * minor internal changes
       * pkgman also reads ~/.aurvote file for getting aur name and password. if one already uses aurvote then there is no need for the
         ~/.config/pkgman/AUR.conf file.

r40: * new manual page & rewrite of usage function
       * both option "--flush" and "--flushall" were omitted in favor of the more versatile "--cleanup" option
       * pkgman <packagename> checks now if <packagename> is owned by user
       * backup option after each editing
       * added license
       * minor internal changes

r41: * just small bug fixes, nothing crucial.

r42: * more bugs fixed.

r45: * new options added:
          >   --listversions: list local and available versions of installed packages from LocalPackages directory
          >  --getownpackages: synchronize local own packages with AUR
       * added new variable in pkgman.conf:
          > ListOutputInPager: output of, for example, "--list" or "--own" is piped into $PAGER
       * added a new optional dependency "desktop-file-utils" for validating desktop entry files
       * also supports now auto-generation of sha sums not only md5
       * internal fixes due to AUR interface changes:
          > use of json interface
          > correct parsing of package category
       * added 2 proto files (located under /usr/share/pacman):
          >  proto.desktop: a template for *.desktop files
          > PKGBUILD-lib32.proto: a template for lib32 packages for x86_64
       * some code changes and fixes

r46: * added new option to pkgman.conf (AutoGenerateSums).
         > if AutoGenerateSums=no then pkgman asks whether to generate checksums or not.
         > if set to yes it behaves like in former versions.

r52: * "--getownpackages" with more than 100 packages works again
       * added new option "--cachecopy":
          For each package in CacheCopyList (new variable in pkgman.conf) get existing package from pacman's cache directory - if
          CopyPkgFromCache (new variable in pkgman.conf) is set to yes - and/or create a source tarball of PKGBUILD and related files from ABS -
          if CopySrcFromABS (new variable in pkgman.conf) is set to yes - and copy them to package backup directory.
       * added new variables to pkgman.conf:
           > "CacheCopyList=file" - batch backup file, one package per line - default location is "$HOME/.config/pkgman/package.list".
           > "CopySrcFromABS=[yes|no]"
           > "CopyPkgFromCache=[yes|no]"
       * some bugfixes
       * docs completed
       * CacheCopyList should look like
         

package1
package2
#this is a comment
!  this too
package3
!package4

r54: * renamed "--listversions" option to "--diffversions". makes more sense!
          from the man page:
              pkgman --diffversions
              Show differing ABS/AUR versions of installed packages from LocalPackages.

r55: * minor changes.

r57: * testing release
       * added a new option "--rollback":
           "pkgman <packagename> --rollback" - checks  http://arm.kh.nu for available package versions,
                                                      lets you choose one, fetches the package and
                                                      moves it to the <packagename> backup directory (if "--repoadd" is used).

r59: * stable release
       * new option "--rollback" (see r57):
               it checks http://arm.kh.nu (Arch Rollback Machine) for available package versions,
               downloads chosen file and moves it to local repository (if "-r|--repoadd"  is used).
        * posting files/comments/etc to AUR should work now again.

r65: *stable release
       * new option "-M,--meta" to create metapackages and add them and their dependencies to local repository.
          it searches for deps inside the backup directories, pacman's cache and if the packages are not available, it tries to fetch the missing
          dependencies from the Arch Rollback Machine site (http://arm.kh.nu).

r66: * minor fixes

r68: * some bugfixes
       * "--repoadd" and "--Reporemove" now accurately removes old packages from LocalRepository

r69: * small bugfixes when listing packages with similar names
       * curl retries now 5 times if connection is not established

r75: * "--cachecopy" does not try to dl sourcefiles when backing up ABS PKGBUILDs
       * some work on package splitting
       * further internal changes

r76: * minor mistakes with "ln" purged

r79: * mostly small changes
       * "--cleanup" now also removes uninstalled packages from LocalRepository

r81 & r80: * added AUR v1.6.0 support (use more json)
                * small ARM changes ("--rollback")

Last edited by DonVla (2009-11-08 14:08:13)