This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
Meta Package Manager
====================

A CLI and a `BitBar <https: getbitbar.com="">`_ plugin to simplify software
upgrades from several package managers.

Stable release: |release| |versions| |license| |dependencies|

Development: |build| |coverage| |quality|

.. |release| image:: https://img.shields.io/pypi/v/meta-package-manager.svg
:target: https://pypi.python.org/pypi/meta-package-manager
:alt: Last release
.. |versions| image:: https://img.shields.io/pypi/pyversions/meta-package-manager.svg
:target: https://pypi.python.org/pypi/meta-package-manager
:alt: Python versions
.. |license| image:: https://img.shields.io/pypi/l/meta-package-manager.svg
:target: https://www.gnu.org/licenses/gpl-2.0.html
:alt: Software license
.. |dependencies| image:: https://img.shields.io/requires/github/kdeldycke/meta-package-manager/master.svg
:target: https://requires.io/github/kdeldycke/meta-package-manager/requirements/?branch=master
:alt: Requirements freshness
.. |build| image:: https://img.shields.io/travis/kdeldycke/meta-package-manager/develop.svg
:target: https://travis-ci.org/kdeldycke/meta-package-manager
:alt: Unit-tests status
.. |coverage| image:: https://codecov.io/github/kdeldycke/meta-package-manager/coverage.svg?branch=develop
:target: https://codecov.io/github/kdeldycke/meta-package-manager?branch=develop
:alt: Coverage Status
.. |quality| image:: https://img.shields.io/scrutinizer/g/kdeldycke/meta-package-manager.svg
:target: https://scrutinizer-ci.com/g/kdeldycke/meta-package-manager/?branch=develop
:alt: Code Quality

.. figure:: http://imgs.xkcd.com/comics/universal_install_script.png
:alt: Obligatory XKCD.
:align: right

Source: `XKCD #1654 <https: xkcd.com="" 1654=""/>`_.


Supported
---------

Only macOS platform is supported.

================ =================== =============
Package manager Individual upgrade Full upgrade
================ =================== =============
|homebrew|__ ✅ ✅
|cask|__ ✅ ✅
|pip2|__ ✅ ✅
|pip3|__ ✅ ✅
|npm|__ ✅ ✅
|apm|__ ✅ ✅
|gem|__ ✅ ✅
|mas|__ ✅ ✅
================ =================== =============

.. |homebrew| replace::
Homebrew
__ http://brew.sh
.. |cask| replace::
Homebrew Cask
__ https://caskroom.github.io
.. |pip2| replace::
Python 2 ``pip``
__ https://pypi.org
.. |pip3| replace::
Python 3 ``pip``
__ https://pypi.org
.. |npm| replace::
Node's ``npm``
__ https://www.npmjs.com
.. |apm| replace::
Atom's ``apm``
__ https://atom.io/packages
.. |gem| replace::
Ruby's ``gem``
__ https://rubygems.org
.. |mas| replace::
Mac AppStore via ``mas``
__ https://github.com/argon/mas

If you're bored, feel free to add support for new package manager. See the
`list of good candidates
<https: en.wikipedia.org="" wiki="" list_of_software_package_management_systems="">`_.


Usage
-----

Examples of the package's ``mpm`` CLI.

List global options and commands:

.. code-block:: bash

$ 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:

.. code-block:: bash

$ 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
<https: getbitbar.com="" plugins="" dev="" metapackagemanager="" meta_package_manager.7h.py="">`_
and `plugin repository
<https: github.com="" matryer="" bitbar-plugins="" tree="" master="" dev="" metapackagemanager="">`_.

.. image:: https://raw.githubusercontent.com/kdeldycke/meta-package-manager/develop/screenshot.png
:alt: Bitbar plugin screenshot.
:align: left


History
-------

The ``package_manager.py`` script `started its life in my 'dotfile' repository
<https: github.com="" kdeldycke="" dotfiles="" commit="" bfcc51e318b40c4283974548cfa1712d082be121#diff-c8127ac6af9d4a21e366ff740db2eeb5="">`_,
as a rewrite from Bash to Python of the `'brew-updates.sh' script
<https: getbitbar.com="" plugins="" dev="" homebrew="" brew-updates.1h.sh="">`_.

I then `merged both Homebrew and Cask
<https: github.com="" kdeldycke="" dotfiles="" commit="" 792d32bfddfc3511ea10c10513b62e269f145148#diff-c8127ac6af9d4a21e366ff740db2eeb5="">`_
upgrade in the same single script as both were `competing with each other
<https: github.com="" matryer="" bitbar-plugins="" issues="" 493="">`_ when run concurrently.

I finally `proposed the script for inclusion
<https: github.com="" matryer="" bitbar-plugins="" pull="" 466="">`_ in the official `BitBar
plugin repository <https: github.com="" matryer="" bitbar-plugins="">`_. 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
<https: github.com="" matryer="" bitbar-plugins="" issues="" 525="">`_ to `its own repository
<https: github.com="" kdeldycke="" meta-package-manager="">`_. For details, see the
`migration script
<https: gist.github.com="" kdeldycke="" 13712cb70e9c1cf4f338eb10dcc059f0="">`_.


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
------------

* `Kevin Deldycke <https: github.com="" kdeldycke="">`_
* `Brian Hartvigsen <https: github.com="" tresni="">`_


License
-------

This software is licensed under the `GNU General Public License v2 or later
(GPLv2+)
<https: github.com="" kdeldycke="" meta-package-manager="" blob="" master="" license="">`_.

Changelog
=========

`1.11.0 (2016-11-30) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.10.0...v1.11.0="">`_
----------------------------------------------------------------------------------------------------

* Allow rendering of output data into ``json``.
* Sort list of outdated packages by lower-cased package IDs.
* Bump minimal requirement of ``brew`` to 1.0.0 and ``cask`` to 1.1.0.
* Fix fetching of outdated ``cask`` packages.
* Fix update of ``cask`` packages.


`1.10.0 (2016-10-04) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.9.0...develop="">`_
---------------------------------------------------------------------------------------------------

* Add optionnal ``version`` property on package manager definitions.
* Allow each package manager to set requirement on its own version.
* Let ``mas`` report its own version.
* Bump minimal requirement of ``mas`` to 1.3.1.
* Fetch currently installed version from ``mas``. Closes #4.
* Fix parsing of ``mas`` package versions after the 1.3.1 release.
* Cache lazy properties to speed metadata computation.
* Shows detailed state of package managers in CLI.


`1.9.0 (2016-09-23) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.8.0...v1.9.0="">`_
-------------------------------------------------------------------------------------------------

* Fix ``bumpversion`` configuration to target ``CHANGES.rst`` instead of
``README.rst``.
* Render list of detected managers in a table.
* Use ``conda`` in Travis tests to install specific versions of Python across
the range of macOS workers.
* Drop support for PyPy while we search a way to install it on macOS with
Travis.
* Let ``mpm`` auto-detect package manager definitions.
* Show package manager IDs in ``mpm managers`` CLI output.
* Rename ``package_manager.7h.py`` BitBar plugin to
``meta_package_manager.7h.py``.
* Give each package manager its own dedicated short string ID.
* Keep a cache of instanciated package manager.
* Add unittests around package manager definitions.
* Do not display location of inactive managers, even if hard-coded.
* Split-up CLI-producing methods and CLI running methods in ``PackageManager``
base class.
* Add a new ``update`` CLI sub-command.
* Add a new ``sync`` CLI sub-command.
* Rename managers' ``active`` property to ``available``.
* Move all package manager definitions in a dedicated folder.
* Add simple CLI unittests. Closes #2.
* Implement ``outdated`` CLI sub-command.
* Allow selection of table rendering.
* Fix parsing of unversioned cask packages. Closes #6.


`1.8.0 (2016-08-22) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.7.0...v1.8.0="">`_
-------------------------------------------------------------------------------------------------

* Move the plugin to its own repository.
* Rename ``package-manager`` project to ``meta-package-manager``.
* Add a ``README.rst`` file.
* License under GPLv2+.
* Add ``.gitignore`` config.
* Add Python package skeleton. Closes #1.
* Split ``CHANGES.rst`` out of ``README.rst``.
* Add Travis CI configuration.
* Use semver-like 3-components version number.
* Copy all BitBar plugin code to Python module.
* Give each supported package manager its own module file.
* Add minimal ``mpm`` meta CLI to list supported package managers.
* Add default ``bumpversion``, ``isort``, ``nosetests``, ``coverage``, ``pep8``
and ``pylint`` default configuration.


`1.7.0 (2016-08-16) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.6.0...v1.7.0="">`_
-------------------------------------------------------------------------------------------------

* Fix issues with ``$PATH`` not having Homebrew/Macports.
* New workaround for full ``pip`` upgrade command.
* Workaround for Homebrew Cask full upgrade command.
* Grammar fix when 0 packages need updated.


`1.6.0 (2016-08-10) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.5.0...v1.6.0="">`_
-------------------------------------------------------------------------------------------------

* Work around the lacks of full ``pip`` upgrade command.
* Fix ``UnicodeDecodeError`` on parsing CLI output.


`1.5.0 (2016-07-25) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.4.0...v1.5.0="">`_
-------------------------------------------------------------------------------------------------

* Add support for ``mas``.
* Don't show all ``stderr`` as ``err`` (check return code for error state).


`1.4.0 (2016-07-10) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.3.0...v1.4.0="">`_
-------------------------------------------------------------------------------------------------

* Don't attempt to parse empty lines.
* Check for linked ``npm`` packages.
* Support system or Homebrew Ruby Gems (with proper ``sudo`` setup).


`1.3.0 (2016-07-09) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.2.0...v1.3.0="">`_
-------------------------------------------------------------------------------------------------

* Add changelog.
* Add reference to package manager's issues.
* Force Cask update before evaluating available packages.
* Add sample of command output as version parsing can be tricky.


`1.2.0 (2016-07-08) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.1.0...v1.2.0="">`_
-------------------------------------------------------------------------------------------------

* Add support for both ``pip2`` and ``pip3``, Node's ``npm``, Atom's ``apm``,
Ruby's ``gem``.
* Fixup ``brew cask`` checking.
* Don't die on errors.


`1.1.0 (2016-07-07) <https: github.com="" kdeldycke="" meta-package-manager="" compare="" v1.0.0...v1.1.0="">`_
-------------------------------------------------------------------------------------------------

* Add support for Python's ``pip``.


`1.0.0 (2016-07-05) <https: github.com="" kdeldycke="" meta-package-manager="" commit="" 170ce9="">`_
---------------------------------------------------------------------------------------

* Initial public release.
* Add support for Homebrew and Cask.
Release History

Release History

1.11.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.10.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.9.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.8.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
meta_package_manager-1.11.0-py2.7.egg (26.3 kB) Copy SHA256 Checksum SHA256 2.7 Egg Nov 30, 2016
meta_package_manager-1.11.0-py2-none-any.whl (32.9 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Nov 30, 2016
meta-package-manager-1.11.0.tar.gz (28.8 kB) Copy SHA256 Checksum SHA256 Source Nov 30, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting