<?xml version="1.0" encoding="UTF-8" ?>
<rdf:RDF xmlns="http://usefulinc.com/ns/doap#" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><Project><name>collective.dist</name>
<shortdesc>Distutils commands to upload files to several servers</shortdesc>
<description>=======================
collective.dist package
=======================

.. contents::

What is collective.dist ?
=========================

I have added in Python 2.6 a new feature to allow people
to deal with several PyPlike servers in .pypirc.

Basically you can use register and upload commands on any server
registered in .pypirc, which changed a bit.

But Plone and Zope runs on Python 2.4.

So this package adds two new commands so you can use what will be 
available in the core in 2.6:

- **mupload**: command that allows uploading the package to several servers
- **mregister**: command that allow registering to several servers

How to use collective.dist ?
============================

**mregister** and **mupload** are replacing `register` and `upload` command
and work with an extended version of the `.pypirc` file.

In order to work with it, change your .pypirc file this way::

    [distutils]
    index-servers = 
        pypi

    [pypi]
    username:user 
    password:password

Where `user` and `password` are your `PyPI` users.

You can then start to use the commands, instead of the usual `register`
and `upload` calls.

A typical call to upload your file would be::

    $ python setup.py mregister sdist bdist_egg mupload

To deal with several PyPI-like servers, you can add them in your
`.pypirc` file::

    [distutils]
    index-servers = 
        pypi
        another

    [pypi]
    username:user 
    password:password

    [another]
    repository:http://another.pypi.server    
    username:user2 
    password:password2
    
Then work with it, with the `-r` option::
    
    $ python setup.py mregister sdist bdist_egg mupload -r http://another.pypi.server

You can even use the section name instead of the url::

    $ python setup.py mregister sdist bdist_egg mupload -r another

And use an alias to make the code simpler::

    $ python setup.py alias to_another mregister sdist bdist_egg mupload -r another  # creates the alias
    $ python setup.py to_another # run the whole sequence

Another usage is to deal with several profiles on PyPI::

    [distutils]
    index-servers = 
        pypi
        pypi-personal

    [pypi]
    username:user 
    password:password

    [pypi-personal]
    username:user2 
    password:password2
 


trunk (2008-09-26)
==================

  - xxx [Ingeniweb]

History
=======

0.2.0 (Unreleased)
::::::::::::::::::

- added more docs

0.1.9 (2008-05-04)
::::::::::::::::::

- moved to collective namespace

0.1.8 (2008-04-02)
::::::::::::::::::

- Fixed the list_classifier call

0.1.7
:::::

- Fixed the -r option in mregister, thanks to Matthew Wilkes

0.1.6
:::::

- fixed realm and repository initialization, thanks to Malthe Borch
- making sure a specific error is raised when the repository does not exists
- fixed url in metadata
- make sure the .pypirc file is properly created
- make sure the -r option is taken from anywhere in the command line

0.1.5
:::::

- fixed non-default pypi upload
- now uses the HOMEDRIVE/HOMEPATH variable if home is not found.

0.1.4
:::::

- changed default pypi

0.1.3
:::::

- fixed 2.4 calls
- make sure the metadata can contain non ascii chars

0.1.2
:::::

- now we have the very same code than the proposed patch
  to python 2.6

0.1.1
:::::

- "host" become "repository", accordingly to Python 2.5
- added a better README

0.1.0
:::::

- added support for `mregister` and `mupload` commands
- initial version created by IngeniSkel</description>
<homepage rdf:resource="http://svn.plone.org/svn/collective/collective.dist" />
<maintainer><foaf:Person><foaf:name>Tarek Ziade</foaf:name>
<foaf:mbox_sha1sum>ce647768fc2915c7851be5591bf96a90966761ef</foaf:mbox_sha1sum></foaf:Person></maintainer>
<release><Version><revision>0.2.0</revision></Version></release>
</Project></rdf:RDF>