Skip to main content

Use proxypypi to set up a transparent caching proxy to PyPI (https://pypy.python.org/) to:

  1. make your installs res/ilient against Internet/PyPI issues,

  2. speed up your installs significantly (after the first one),

  3. prevent problems installing packages that are removed from distribution by the author,

  4. allow installation of packages from within a firewalled environment where the host performing the installation does not have Internet access, and

  5. allow hosting and installation of private packages.

When the proxy is asked about a package it doesn’t know it automatically goes off and fetches the file download list for the package, rewriting all references (PyPI and external) so they appear to be local. On request of one of those now-local package file references it performs a background fetch of the file contents and serves up the new file data to the pip request (thus keeping that request alive despite its very short timeout duration).

Why Another One?

There’s a lot of PyPI-alike implementations and “proxy” servers out there. This proxy differs from almost all others (save devpi-server) in that it automatically relocates package download files from the Internet to your local server. It differs from devpi-server in that it has no external database requirement (just a filesystem is needed) making deployment much simpler (at least for me).

Usage

Setup of proxypypi requires:

  1. “pip install proxypypi”

  2. cd to some directory you would like files to be cached in

  3. proxypypi run

There are some command-line arguments (see “proxypypi -h”) that allow some run-time behaviour control. Notably “-d” which can configure the directory to cache in.

Additionally the proxy may run in the background, in which case you need to supply three additional command-line arguments: “-P” (PID file), “-l” (log file) and “-o” (console output file) and use one of the daemon control commands instead of “run”. See “proxypypi -h” for the commands.

Once running you may perform pip installs using the proxy by including the proxy in the pip command line using the “-i” argument:

pip install -i http://proxy_host:proxy_port/simple/ package_to_install

Any packages not cached will be fetched into the cache and the install will continue as normal.

Private (or Manually Downloaded) Packages

Package distribution files added to the root of the package directory served by proxypypi will be served alongside those it proxies requests for. You may, if you wish, make package-named subdirectories, but it’s not necessary.

Upgrading Cached Packages

This isn’t done yet :-)

Version History

  • 1.0 first public releae

  • 1.0.1 clear up handling of paths to daemon files

  • 1.2 handle external files that don’t exist (issue 1, thanks George Hickman)

  • 1.2.1 fix a name collision issue

  • 1.2.2 remove partial download for missing external file

Release files for proxypypi 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for proxypypi 1.2.2
File Size Uploaded
proxypypi-1.2.2.tar.gz 11.3 kB Details

Release files / proxypypi-1.2.2.tar.gz

Download URL proxypypi-1.2.2.tar.gz
Size 11.3 kB
Tags Source
SHA-256 checksum
How to use checksums
72783899ddee7913a657d3ae6f668a2a6f05434602daa7ab5d49fab34392c0c1
BLAKE2b-256 checksum
How to use checksums
752deae11d68cd9e1e01eea95fea2f51d76782a8dba3fda10904b6646962d6cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.2.2 This release

1 release file

1.2.1

1 release file

1.2

1 release file

1.0.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page