xpm

x package manager, a uniform interface to various POSIX package managers
git clone git://src.gearsix.net/xpm
Log | Files | Refs | Atom | README

README.md (1228B)


      1 # xpm
      2 
      3 **x package manager**
      4 
      5 A sh script to provide a generic interface to whatever package manager your system uses.
      6 
      7 The goal of this project is to avoid the requirement for doing the mental check required when interfacing with your systems package manager, useful if you hop between systems frequently.
      8 
      9 
     10 ## install
     11 
     12 `install ./xpm.sh [INSTALL DIR]/xpm`
     13 
     14 **INSTALL DIR** can be any directory in your *$PATH*, common locations are:
     15 
     16 - */usr/local/bin* (requires sudo)
     17 - *~/.local/bin*
     18 
     19 
     20 ## configure
     21 
     22 **tracking**
     23 
     24 xpm keeps track of installed/uninstalled packages (only what you've requested for install, not including its dependencies) in `~/.local/share/xpm/installed.txt`.
     25 
     26 This behaviour can be disabled by setting *XPM_NOTRACK* to 1, either in your environment.
     27 
     28 **hooks**
     29 
     30 xpm supports 'hooks' (inspired by git-hooks). A 'hook' is a script that gets executed *after* running the specified command.
     31 
     32 All you need to do is add the script file to execute in `~/.config/xpm/hooks` and make sure it's executable.
     33 
     34 This is useful if you install package outside of the package manager that require a seperate command to execute, or if you want to add additional behaviour to the default xpm commands.
     35 
     36 
     37 ## authors
     38 
     39 - gearsix