Skip to main content

Unified API to handle several package managers.

Project description

A CLI and a BitBar plugin to simplify software upgrades from several package managers.

Stable release: Last release Python versions Software license Requirements freshness

Development: Unit-tests status Coverage Status Code Quality

Obligatory XKCD.

Source: XKCD #1654.

Supported

Only macOS platform is supported.

Package manager

Individual upgrade

Full upgrade

Homebrew

Homebrew Cask

Python 2 pip

Python 3 pip

Node’s npm

Atom’s apm

Ruby’s gem

Mac AppStore via mas

If you’re bored, feel free to add support for new package manager. See the list of good candidates.

Usage

Examples of the package’s mpm CLI.

List global options and commands:

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

  CLI for multi-package manager updates and upgrades.

Options:
  -v, --verbosity LEVEL           Either CRITICAL, ERROR, WARNING, INFO or
                                  DEBUG. Defaults to INFO.
  -o, --output-format [simple|plain|json|fancy]
                                  Rendering mode of the output. Defaults to
                                  fancy.
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Commands:
  managers  List supported package managers and their location.
  outdated  List available updates.
  sync      Sync local package info.
  update    Update all packages.

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

$ mpm managers
╒═══════════════════╤══════╤═════════════════════╤═════════╤══════════════╤═══════════╕
 Package manager    ID    CLI path             Found    Executable    Version   
╞═══════════════════╪══════╪═════════════════════╪═════════╪══════════════╪═══════════╡
 Atom's apm        │ apm  │ /usr/local/bin/apm  │ ✅       │ ✅            │ ✅         │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Homebrew          │ brew │ /usr/local/bin/brew │ ✅       │ ✅            │ ✅  1.1.2  │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Homebrew Cask     │ cask │ /usr/local/bin/brew │ ✅       │ ✅            │ ✅  1.1.2  │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Ruby Gems         │ gem  │ /usr/bin/gem        │ ✅       │ ✅            │ ✅         │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Mac AppStore      │ mas  │ /usr/local/bin/mas  │ ✅       │ ✅            │ ✅  1.3.1  │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Node's npm         npm   /usr/local/bin/npm                                 
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
 Python 2's Pip    │ pip2 │ /usr/local/bin/pip2 │ ✅       │ ✅            │ ✅         │
├───────────────────┼──────┼─────────────────────┼─────────┼──────────────┼───────────┤
│ Python 3's Pip     pip3  /usr/local/bin/pip3                                
╘═══════════════════╧══════╧═════════════════════╧═════════╧══════════════╧═══════════╛

BitBar plugin

A copy of the latest stable version of the Meta Package Manager BitBar plugin is always available on BitBar website and plugin repository.

Bitbar plugin screenshot.

History

The package_manager.py script started its life in my ‘dotfile’ repository, as a rewrite from Bash to Python of the ‘brew-updates.sh’ script.

I then merged both Homebrew and Cask upgrade in the same single script as both were competing with each other when run concurrently.

I finally proposed the script for inclusion in the official BitBar plugin repository. It lived there for a couple of weeks and saw a huge amount of contributions by the community.

With its complexity increasing, it was decided to move the plugin to its own repository. For details, see the migration script.

Current status

Active development of the script is continuing here, in the exact same conditions as we were before moving the repository, like nothing happened.

Each time we reach a releaseable script, we simply tag it and push a copy to the BitBar plugin repository. Plain and simple.

At the same time we maintain a Python library on the side. The library is going to handle all idiosyncracies of supported package managers under a unified API.

Once the library is good enough, we’ll evaluate rebasing the original plugin on it, and lay out a plan for a painless transition, from the standalone script to a bare BitBar-plugin depending on the library alone.

In the mean time we have to temporarily manage duplicate code. But at least the whole project is kept in one centralized place, trying to tackle the same issues.

Contributors

License

This software is licensed under the GNU General Public License v2 or later (GPLv2+).

Changes for v2.0.0 (2016-12-04)

  • Rewrite BitBar plugin based on mpm. Closes #13.

  • Render errors with a monospaced font in BitBar plugin.

  • Add missing CHANGES.rst in MANIFEST.in.

  • Make wheels generated under Python 2 environnment available for Python 3 too.

  • Only show latest changes in the long description of the package instead of the full changelog.

  • Add link to full changelog in package’s long description.

  • Bump trove classifiers status out of beta.

  • Fix package keywords.

  • Bump minimal pycodestyle requirement to 2.1.0.

  • Always check for package metadata in Travis CI jobs.

  • Add upgrade_all_cli field for each package manager in JSON output of mpm outdated command.

Full changelog.

Release history Release notifications | RSS feed

This version

2.0.0

Download files

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

Source Distribution

meta-package-manager-2.0.0.tar.gz (27.9 kB view details)

Uploaded Source

Built Distributions

meta_package_manager-2.0.0-py2.py3-none-any.whl (31.2 kB view details)

Uploaded Python 2 Python 3

meta_package_manager-2.0.0-py2.7.egg (25.8 kB view details)

Uploaded Source

File details

Details for the file meta-package-manager-2.0.0.tar.gz.

File metadata

File hashes

Hashes for meta-package-manager-2.0.0.tar.gz
Algorithm Hash digest
SHA256 1fbdafe17e56f3cee1f1d92c6b7ae0f228d68e21a0523503e87e49cdcf792c75
MD5 c7fc58766d2682ff49b09d303430b97b
BLAKE2b-256 a06561fe0b7b732d99bb165d4d3f9cdaf8859321ec57bfd1d58b902f9c9254bb

See more details on using hashes here.

File details

Details for the file meta_package_manager-2.0.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for meta_package_manager-2.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 15327266a7009e5f150173a630b3f9efd95d41604c2efb5f9b9813afe6b6129c
MD5 c0af732d8779a24542e308070198fbd1
BLAKE2b-256 3270b1b444f039ee3c64ff144071f57986fd2a82326c1eb5b3e201cfbb80cba8

See more details on using hashes here.

File details

Details for the file meta_package_manager-2.0.0-py2.7.egg.

File metadata

File hashes

Hashes for meta_package_manager-2.0.0-py2.7.egg
Algorithm Hash digest
SHA256 45f2fadb6047336ca577555cc778faf548095976c0eb79282a0664ad6a3bcaee
MD5 693f93ddb4191b071002b7266d2a48e6
BLAKE2b-256 3dd3f7bd5be24788fbcc99541cc7ba297d9615d1c2f4edb39a574ea0aae70654

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page