Skip to main content

A minimal PyPI implementation meant for use behind a firewall.

Project description

What is MinistryOfPackages?

A simple Python package index server implementation, meant for internal use (at least for now). The expectation is that it runs behind a firewall, and also most likely a reverse proxy. It requires PyYAML and Tornado (http://www.tornadoweb.org), and it’s tested with pip and Python 2.7 It is not tested with easy_install, and easy_install support is not a near-term goal or priority (Please use pip)

What Works Now?

Right now, MinistryOfPackages is usable for simple use cases:

  1. It has DirectoryListing support, and that’s completely generic. It’s meant to be used by command line tools, but the browser presentation works – it just doesn’t have all the fancy icons :)

  2. You can do, for example, ‘python setup.py sdist upload -r http://localhost:8080/dist’, and then leverage the directory listing capability to go to http://localhost/packages and browse to confirm your package made it into the repository.

  3. You can ‘pip install -i http://localhost:8080/packages <pkg>’ on the package you uploaded in point 2 above.

  4. If you want to check internal first and fall back to pypi.python.org, there’s no global pip config file (yet), so you need to export two environment variables, either in your personal shell init, or in the global shell initialization files:

    PIP_INDEX_URL=http://your.index.internal/packages PIP_EXTRA_INDEX_URL=http://pypi.python.org/simple

These features still need more testing and a little polish, but they generally work.

What’s Up Next?

  1. Completion of a data model (using Redis) to support more of the CLI and browser UI features (like ‘register’).

  2. Fleshing out a proper browser interface.

What’s After That?

  1. Proxying requests to PyPI for pip, so MinistryOfPackages can be your primary index server for everything.

  2. Package caching.

  3. PyPI Mirroring (this can technically be done now, but it’s not a good solution as it stands).

Feature requests, new ideas, and pull requests are welcome.

Why are you doing this?

I’m after a few different things with this project:

  1. I want something that’s blindingly easy to deploy. I don’t want to muck with WSGI, CGI, FCGI, whatever. I want to write code and run it, and have something that works. Having used Tornado for numerous other projects (some ‘web scale’), I can tell you it works :)

  2. I want some enterprise-y features like proxy requests and package caching. Those will come later, but I didn’t want to start this using a huge multi-headed framework because I want to get to them sooner than later :)

  3. I want to understand distutils, Python package distribution, and all that stuff better.

Project details


Download files

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

Source Distribution

MinistryOfPackages-0.9.5.tar.gz (13.0 kB view details)

Uploaded Source

File details

Details for the file MinistryOfPackages-0.9.5.tar.gz.

File metadata

File hashes

Hashes for MinistryOfPackages-0.9.5.tar.gz
Algorithm Hash digest
SHA256 3a81fbf3b1da6dadc759228f57393e6d373b6f7eddb95460bc9eeabd5d131a13
MD5 77a89a02bb68cce00d100c03737f0687
BLAKE2b-256 ed758b34469e0fce4f59d1a7a0736c7e1b395eeea0413a9c1c3e1ee2295e59d4

See more details on using hashes here.

Supported by

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