Mr Piper 🎻🐍 - Super simple project package manager

Heavily inspired by yarn, Piper offers a dead simple way to manage a project's dependencies (and more).

Piper uses pip and virtualenv under the hood, and (just like NPM and Yarn) always installs packages in a project isolated environment.

Piper makes it easy to make modules installable (and updatable) via a piper.json JSON file, instead of fiddling with setup.py.

🤔 Why?

No need to jump through countless hoops to get a test project going ☺️ (with proper package management)
Keep your environment nice and clean ✨, with auto-removal of unnecessary components
It's easy to make reproducible environments for your CI and deployments (no more "it-works-on-my-machine" syndrome)
Easily make installable modules, no more setup.py fiddling
Piper increases usefulness of some basic pip commands (e.g. check out piper list, piper outdated)
A bunch of convenient utilities are included (e.g. piper why)
Easy install from Github (e.g. piper add requests/requests)
Effortlessly keep your project version and git tags updated

A star makes the developers happy 😊

Installation

$ pip install mr-piper

Usage

Concise docs on usage and API going here

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

|  _____ _
| |  __ (_)
| | |__) | _ __   ___ _ __
| |  ___/ | '_ \ / _ \ '__|
| | |   | | |_) |  __/ |
| |_|   |_| .__/ \___|_|
|         | |
|         |_|
|

Options:
--help  Show this message and exit.

Commands:
add       Install and add a package to requirements
info      info all installed packages
init      Initialise project with virtual environment,...
install   Install all packages in requirement files.
list      List all installed packages
outdated  Deletes virtualenv, requirements folder/files...
remove    Remove a list of packages and their...
upgrade   Upgrade a list of packages.
why       Explain why a package exists
wipe      Wipe virtualenv, requirements folder/files...

Initialize project piper init

e.g. piper init --py 3.6 --outside

Initializing a project creates:

the PIP requirement files (base, dev and frozen lock files)
the virtualenv (either outside or inside the project folder)
a Piper file (where project information is stored)
a Piper lock (where the reproducible working project configuration is stored)
a working setup.py

Example piper.json

{
    "created": "2017-09-20T21:10:07",
    "name": "mr-piper",
    "version": "0.1.3a2",
    "description": "The simple project package manager",
    "source_dir": "mrpiper",
    "repository": "https://github.com/jamespacileo/mr-piper",
    "author": "James Pacileo",
    "author_email": "",
    "keywords": "pip piper mrpiper package manager",
    "license": "MIT",
    "readme_filename": "README.rst",
    "py_modules": [
        "mrpiper.cli"
    ],
    "entry_points": {
        "console_scripts": [
            "piper=mrpiper.cli:cli"
        ]
    },
    "classifiers": [
        "License :: OSI Approved :: MIT License",
        "Programming Language :: Python",
        "Programming Language :: Python :: 2.7",
        "Programming Language :: Python :: 3",
        "Programming Language :: Python :: 3.3",
        "Programming Language :: Python :: 3.4",
        "Programming Language :: Python :: 3.5",
        "Programming Language :: Python :: 3.6",
        "Programming Language :: Python :: Implementation :: CPython",
        "Programming Language :: Python :: Implementation :: PyPy"
    ],
    "data_files": [],
    "package_data": [],
    "exclude_packages": [],
    "dependencies": {
        "requests": "requests>=2.0.0",
        "path.py": "path.py>=10.4",
        "click": "click>=6.7",
        "click-log": "click-log>=0.2.0",
        "delegator.py": "delegator.py>=0.0.13",
        "future": "future>=0.16.0",
        "parse": "parse>=1.8.2",
        "semantic-version": "semantic-version>=2.6.0",
        "simplejson": "simplejson>=3.11.1",
        "tabulate": "tabulate>=0.7.7",
        "crayons": "crayons>=0.1.2",
        "click-spinner": "click-spinner>=0.1.7",
        "emoji": "emoji>=0.4.5"
    },
    "dev_dependencies": {
        "coverage": "coverage>=4.4.1",
        "coveralls": "coveralls>=1.2.0",
        "pytest": "pytest>=3.2.2"
    },
    "private": false
}