pypa/pip — Issue #473: Document the Effect of --use-mirrors and improperly named packages
Author: dstufft
Created: 2012-03-04 13:54:13+00:00
State: open

Currently PyPI redirects an incorrectly cased name to the proper name (e.g. django -> Django), however the current official mirrors do not do that.

This has the affect that all packages that are being attempted to be installed without the name typed exactly right, will succeed in most cases, but will continue to fail when PyPI is down. This can cause some apparent wierdness to people who don't understand the reasoning (why pip install django works when PyPI is up, but not when it's down, meanwhile other packages install just fine).

I would suggest documenting this (hopefully edge) case as a possible gotcha and to help educate folks to use the proper name for their packages, especially in their requirements files.