=========================================
ChiShop/DjangoPyPI
=========================================
:Version: 0.1

Installation
============

Install dependencies::

    $ python setup.py install

Initial configuration::

    $ $EDITOR chishop/settings.py

Run the PyPI server::

    $ python setup.py devserver

Please note that ``chishop/media/dists`` has to be writable by the
user the web-server is running as.

In production
-------------

You may want to copy the file ``chishop/production_example.py`` and modify
for use as your production settings.

Channels
========

Channels permit package authors to post development, stage testing, stable and
other types of packages and tag them with a channel. A package consumer can then
set easy_install to use the channel URL to find links to packages.

Channels are designed to allow packages to continue to be developed while a
known-stable set of packages are deployed (ex: development vs. production).

Using Setuptools
================

Add the following to your ``~/.pypirc`` file::

    [distutils]
    index-servers =
        pypi
        local


    [pypi]
    username:user
    password:secret

    [local]

    username:user
    password:secret
    repository:http://localhost:8000

Uploading a package: Python >=2.6
--------------------------------------------

To push the package to the local pypi::

    $ python setup.py register -r local sdist upload -r local


Uploading a package: Python <2.6
-------------------------------------------

If you don't have Python 2.6 please run the command below to install the backport of the extension::

     $ easy_install -U collective.dist

instead of using register and dist command, you can use "mregister" and "mupload", that are a backport of python 2.6 register and upload commands, that supports multiple servers.

To push the package to the local pypi::

    $ python setup.py mregister -r local sdist mupload -r local

.. # vim: syntax=rst expandtab tabstop=4 shiftwidth=4 shiftround