GitHub - pydotorg/pypi: mirror of PyPI from Bitbucket

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1,663 Commits
doc		doc
static		static
templates		templates
tests		tests
tools		tools
.cvsignore		.cvsignore
.hgignore		.hgignore
CHANGES.txt		CHANGES.txt
LICENSE.txt		LICENSE.txt
MailingLogger.py		MailingLogger.py
Makefile		Makefile
README		README
TODO.txt		TODO.txt
__init__.py		__init__.py
admin.py		admin.py
cgi-server.py		cgi-server.py
config.ini.template		config.ini.template
config.py		config.py
description_utils.py		description_utils.py
dumper.py		dumper.py
favicon.ico		favicon.ico
find_dups.py		find_dups.py
fncache.py		fncache.py
gae.py		gae.py
legacy_passwords.py		legacy_passwords.py
mini_pkg_resources.py		mini_pkg_resources.py
mirrors.txt		mirrors.txt
mod_python.conf		mod_python.conf
oauth.py		oauth.py
oauth_test.py		oauth_test.py
openid2rp.py		openid2rp.py
pkgbase_schema.sql		pkgbase_schema.sql
pypi.cgi		pypi.cgi
pypi.fcgi		pypi.fcgi
pypi.py		pypi.py
pypi.wsgi		pypi.wsgi
register.py		register.py
reqoauth_test.py		reqoauth_test.py
requirements.txt		requirements.txt
rpc.py		rpc.py
setup.py		setup.py
sshkeys_update.c		sshkeys_update.c
sshkeys_update.py		sshkeys_update.py
standalone.py		standalone.py
store.py		store.py
tasks.py		tasks.py
thfcgi.py		thfcgi.py
trove.py		trove.py
verify_filetype.py		verify_filetype.py
verlib.py		verlib.py
versionpredicate.py		versionpredicate.py
webui.py		webui.py

Repository files navigation

Required packages
-----------------

To run the PyPI software, you need Python 2.5+ and PostgreSQL


Quick development setup
-----------------------

Make sure you read http://wiki.python.org/moin/CheeseShopDev#DevelopmentEnvironmentHints
and you have a working PostgreSQL DB.

Make sure your config.ini is up-to-date, initially copying from
config.ini.template. Change CONFIG_FILE at the begining of pypi.wsgi,
so it looks like this::

    CONFIG_FILE = 'config.ini'

Then, you can create a development environment like this, if you have
virtualenv installed::

    $ virtualenv --no-site-packages .
    $ pip install -r requirements.txt

Then you can launch the server using the pypi.wsgi script::

    $ python pypi.wsgi
    Serving on port 8000...

PyPI will be available in your browser at http://localhost:8000

Database Setup
--------------

To fill a database, run pkgbase_schema.sql on an empty Postgres database.
Then run tools/demodata to populate the database with dummy data.

For testing purposes, run tools/mksqlite to create packages.db. Set
[database]driver to sqlite3, and [database]name to packages.db, then
run tools/demodata to populate the database.

PyPI Requires the citext extension to be installed.

TestPyPI Database Setup
-----------------------

testpypi runs under postgres; because I don't care to fill my head with such
trivialities, the setup commands are:

   createdb -O testpypi testpypi
   psql -U testpypi testpypi <pkgbase_schema.sql


Restarting PyPI
---------------

PyPI has 2 different pieces that need started, web server and the task runner.

    # Restart the web server
    $ /etc/init.d/pypi restart
    # Restart the task runner
    $ initctl restart pypi-worker

Clearing a stuck cache
----------------------

Users reporting stale data being displayed? Try:

  curl -X PURGE https://pypi.python.org/pypi/setuptools

(where the URL is the relevant one to the issue, I presume)

To see what fastly thinks it knows about a page (or how it's getting to you) try:

  curl -I -H 'Fastly-Debug: 1'  https://pypi.python.org/pypi/setuptools