View source for Tools/epm

{{dirs}}

'''epm''' is a command line to to manage EPMs with the following usage:
 Usage:
    epm *command* [options]
 
    Where *command* is one of:
 
            build
            disable
            enable
            install
            link_lib
            list
            rebuild
            uninstall
            unpack
 
 Options:
    --verbose
    --force
    --help
    --man
    --epm package_path
        Read metadata from the epm at package_path when building.
 
    --version
        Set the version when building.

== Commands ==
; build : Builds a new <PACKAGE>.epm file. Uses metadata provided by PACKAGE.epmi if provided by <code>--epm</code> flag. Uses first argument after the command as the .epm filename and remaining arguments as files that should be packaged in the EPM. E.g. <code>tools/epm build my_epm cfd.d/my_epm.pl plugins/EPrints/Screen/MyEPM.pm --epm /home/eprints/my_epm.epmi</code>
; disable : Disables an EPM in a particular repository archive.  First argument is the archive ID and the second argument is the EPM to be disable. E.g. <code>tools/epm disable my_archive my_epm</code>.
; enable : Enables an EPM in a particular repository archive.  First argument is the archive ID and the second argument is the EPM to be enable. E.g. <code>tools/epm enable my_archive my_epm</code>
; install : Instalsl EPM specified within a .epm file to the repository under lib/epm/ as well as appropriate locations within lib/.  E.g. <code>tools/epm install /home/eprints/MyEPM.epm</code>
; link_lib : Take a source directory of an EPM in lib/epm/PACKAGE and symlink to it from the correct locations in lib/.  Using <code>--force</code> flag replaces any files currently in those locations in lib/.  E.g. <code>tools/epm link_lib my_epm</code>
; list : List the current EPM packages installed and their versions. E.g. <code>tools/epm list</code>
; rebuild : Rebuilds the .epm and .epmi files in lib/epm/PACKAGE based on the existing files non-epm files in that directory.  E.g.  <code>tools/epm rebuild my_epm</code>
; uninstall : Uninstalls specified EPM from repository including removing from lib/epm/, appropriate locations in lib/ and disabling configuration files within any archives using the EPM. E.g. <code>tools/epm uninstall my_epm</code>
; unpack : Unpacks the files in a .epm file and writes them to the current directory.  E.g. <code>tools/epm unpack /home/eprints/MyEPM.epm</code>