piton3

A local python package manager for python3 and pip3


Keywords
package, manager, local
License
MIT-feh
Install
pip install piton3==0.0.2

Documentation

piton

PyPI version

Piton is a python package manager modelled after NPM. Piton makes it easier for Python developers to share and reuse code. It makes package management simple by doing the following:

  • Install packages locally at python_modules folder

  • Track dependencies in package.json with NodeJS-like semantic versioning

    {
        "pythonDependencies": {
            "djangorestframework": "^3.3.3",
            "django": "^1.9.1"
        },
        "pythonDevDependencies": {
            "django-debug-toolbar": "1.0.0"
        }
    }
    
  • Automatic management of nested dependencies. Packages that are installed via nested dependency are removed automatically once packages requiring it are removed

  • Simplify unreasonably verbose pip commands such as install --upgrade <package> >> requirements.txt and list --outdated to more human friendly npm-like commands. update, outdated, install --save, etc

screenshots

Future Plans

Our plans are implement all the features mentioned in the docs repo.

Installation

pip install piton

Use

piton <command>

Typical use case

piton init //creates a package.json
piton install django --save
piton install django-debug-toolbar --save

IMPORTANT: ADD python_modules as a python path

  • Method 1:

    Add .python_modules to PYTHONPATH in .bash_profile

    Or use piton path --save to do it automatically.

  • Method 2 (more explicit):

    Use the following code at each application entry point:

    def setup_path():
        import sys
        import os
        BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) #OR where the python_modules folder is at
        sys.path.append(os.path.join(BASE_DIR, "python_modules"))
    setup_path()
    
  • Method 3 (recommended):

    Use piton as a task runner:

    1. Define application entry points in package.json under scripts

      {
          "scripts": {
              "develop": "python3 manage.py runserver"
          },
          "pythonDependencies": {
              ...
          }
      }
      
    2. Run task with piton run <task>

Progress

Command Status
init working
outdated working
install working
remove working
update working
bugs tracker planned
run working
list working
prune working
path working

Piton Limitations

Piton is all about making package management local. While it replaces Virtualenv, it is not meant to be a repalcement for setuptools.

Piton continues to use setuptools, and PYPI in the background, along with very limited use of pip. In future versions the dependency on pip will be removed.

Developers

Piton can be run with develop_entry.py without installing.

Deployment:

# Change version number in setup.py
python3 setup.py sdist upload -r pypi
# Amend commit with egg-info