Skip to main content

CLI providing unifying interface to all package managers.

Project description

CLI providing unifying interface to all package managers.

Stable release: Last release Python versions Software license Requirements freshness

Development: Unit-tests status Documentation Status Coverage Status Code Quality

Obligatory XKCD.

Source: XKCD #1654.

Features

  • Search and list all package managers on the system.
  • Supports macOS and Linux.
  • List installed packages.
  • Search for packages.
  • List outdated packages.
  • Sync local package infos.
  • Upgrade all outdated packages.
  • Apply commands per-package manager or to all of them.
  • Export results in JSON or user-friendly tables.
  • Provides a BitBar plugin for friendly macOS integration.

Supported package managers

Package manager Version macOS Linux Windows sync installed search install outdated upgrade
Homebrew >= 1.7.4      
Homebrew Cask >= 1.7.4      
Python 2 pip >= 9.0.0      
Python 3 pip >= 9.0.0      
Node’s npm >= 4.0.*      
Atom’s apm        
Ruby’s gem        
Mac AppStore via mas >= 1.3.1        
apt >= 1.0.0      
composer >= 1.4.0    

If you’re bored, feel free to add support for new package manager. See good candidates at:

Installation

This package is available on PyPi, so you can install the latest stable release and its dependencies with a simple pip call:

$ pip install meta-package-manager

Documentation

Docs are hosted on Read the Docs.

Usage

Examples of the package’s mpm CLI.

List global options and commands:

$ mpm
Usage: mpm [OPTIONS] COMMAND [ARGS]...

  CLI for multi-package manager upgrades.

Options:
  -v, --verbosity LEVEL           Either CRITICAL, ERROR, WARNING, INFO or
                                  DEBUG. Defaults to INFO.
  -m, --manager [apm|apt|brew|cask|gem|mas|npm|pip2|pip3]
                                  Restrict sub-command to a subset of package
                                  managers. Repeat to select multiple
                                  managers. Defaults to all.
  --ignore-auto-updates / --include-auto-updates
                                  Report all outdated packages, including
                                  those tagged as auto-updating. Defaults to
                                  include all packages. Only applies for
                                  'outdated' and 'upgrade' commands.
  -o, --output-format [ascii|csv|double|fancy_grid|github|grid|html|jira|json|latex|latex_booktabs|mediawiki|moinmoin|orgtbl|pipe|plain|psql|rst|simple|textile|tsv|vertical]
                                  Rendering mode of the output. Defaults to
                                  fancy-grid.
  --stats / --no-stats            Print statistics or not at the end of
                                  output. Active by default.
  --stop-on-error / --continue-on-error
                                  Stop right away or continue operations on
                                  manager CLI error. Defaults to stop.
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Commands:
  installed  List installed packages.
  managers   List supported package managers and their location.
  outdated   List outdated packages.
  search     Search packages.
  sync       Sync local package info.
  upgrade    Upgrade all packages.

List all supported package managers and their status on current system (macOS):

$ mpm managers
╒═══════════════════╤══════════╤═══════════════╤════════════════════════════╤══════════════╤═════════════╕
│ Package manager   │ ID       │ Supported     │ CLI                        │ Executable   │ Version     │
╞═══════════════════╪══════════╪═══════════════╪════════════════════════════╪══════════════╪═════════════╡
│ Atom's apm        │ apm      │ ✓             │ ✓  /usr/local/bin/apm      │ ✓            │ ✓  1.18.1   │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ APT               │ apt      │ ✘  Linux only │ ✓  /usr/bin/apt            │ ✓            │ ✘           │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ PHP's Composer    │ composer │ ✓             │ ✓  /usr/local/bin/composer │ ✓            │ ✓  1.8.0    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Homebrew          │ brew     │ ✓             │ ✓  /usr/local/bin/brew     │ ✓            │ ✓  1.2.5    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Homebrew Cask     │ cask     │ ✓             │ ✓  /usr/local/bin/brew     │ ✓            │ ✓  1.2.5    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Ruby Gems         │ gem      │ ✓             │ ✓  /usr/bin/gem            │ ✓            │ ✓  2.0.14.1 │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Mac AppStore      │ mas      │ ✓             │ ✓  /usr/local/bin/mas      │ ✓            │ ✓  1.3.1    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Node's npm        │ npm      │ ✓             │ ✓  /usr/local/bin/npm      │ ✓            │ ✓  5.3.0    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Python 2's Pip    │ pip2     │ ✓             │ ✓  /usr/local/bin/pip2     │ ✓            │ ✓  9.0.1    │
├───────────────────┼──────────┼───────────────┼────────────────────────────┼──────────────┼─────────────┤
│ Python 3's Pip    │ pip3     │ ✓             │ ✓  /usr/local/bin/pip3     │ ✓            │ ✓  9.0.1    │
╘═══════════════════╧══════════╧═══════════════╧════════════════════════════╧══════════════╧═════════════╛

Changes for v2.8.0 (2019-01-03)

  • Add support for PHP composer.
  • Remove cask-specific version, sync and search command. Closes #47.
  • Vanilla brew and cask CLIs now shares the same version requirements.
  • Bump minimal requirement of brew and cask to 1.7.4.
  • Activate unittests in Python 3.7.
  • Drop Travis unittests on deprecated Ubuntu Precise targets and vintage Mac OS X 10.10 and 10.11.
  • Use latest macOS 10.12 and 10.13 Travis images.

Full changelog.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for meta-package-manager, version 2.8.0
Filename, size File type Python version Upload date Hashes
Filename, size meta_package_manager-2.8.0-py2.py3-none-any.whl (56.4 kB) File type Wheel Python version 3.7 Upload date Hashes View hashes
Filename, size meta_package_manager-2.8.0-py3.7.egg (48.5 kB) File type Egg Python version 3.7 Upload date Hashes View hashes
Filename, size meta-package-manager-2.8.0.tar.gz (53.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page