Differences between revisions 2 and 3
Revision 2 as of 2006-07-15 04:19:21
Size: 1360
Editor: c210-49-201-80
Comment:
Revision 3 as of 2006-07-18 09:23:42
Size: 2269
Editor: RichardJones
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= What the Cheese Shop Stores =

The Python Cheese Shop stores [http://docs.python.org/dist/meta-data.html information about packages of Python software]. Each package has a name and a number of release versions. The list of release versions will increase as newer versions of the package are submitted to the Cheese Shop.
Line 23: Line 27:
You may submit package distribution files either by: Note that submitting a package distribution file automatically submits the package's meta-data. You may submit package distribution files either by:
Line 30: Line 34:

== Exposing Multiple Releases ==

When a new release of a package is submitted to the Cheese Shop, all previous releases of that package are ''hidden'' from the display. This means that listings and searches will no longer find those releases.

You may use the package admin interface to ''uh-hide'' releases. This may be useful if you have both a ''stable'' and a ''development'' release active at the same time. These will be hidden again on the next submission of meta-data.

What the Cheese Shop Stores

The Python Cheese Shop stores [http://docs.python.org/dist/meta-data.html information about packages of Python software]. Each package has a name and a number of release versions. The list of release versions will increase as newer versions of the package are submitted to the Cheese Shop.

Submitting Packages to the Cheese Shop

There are two types of information that may be submitted to the Cheese Shop:

  1. package meta-data (name, version, description, etc), and
  2. package source and binary distribution files.

Package Meta-Data

You may submit package meta-data either by:

  1. writing a [http://docs.python.org/dist/setup-script.html setup.py file] and using "python setup.py register" (see [http://docs.python.org/dist/package-index.html docs]),

  2. creating a PKG-INFO file (typically generated from a setup.py file) and uploading it, or
  3. using the [http://cheeseshop.python.org/pypi?%3Aaction=submit_form web form] and manually entering the information.

The Cheese Shop assumes that the PKG-INFO file is either ASCII or UTF-8.

Package Distribution Files

Note that submitting a package distribution file automatically submits the package's meta-data. You may submit package distribution files either by:

  1. appending the "upload" command to a setup.py [http://docs.python.org/dist/source-dist.html source dist] or [http://docs.python.org/dist/built-dist.html built dist] command, eg "python setup.py sdist upload", or

  2. logging into the Cheese Shop and using the package management interface to manually upload files.

The "upload" command has a number of options, including being able to sign the upload using GPG. See "python setup.py upload --help" for more information.

Exposing Multiple Releases

When a new release of a package is submitted to the Cheese Shop, all previous releases of that package are hidden from the display. This means that listings and searches will no longer find those releases.

You may use the package admin interface to uh-hide releases. This may be useful if you have both a stable and a development release active at the same time. These will be hidden again on the next submission of meta-data.

CheeseShopTutorial (last edited 2019-06-22 19:01:22 by SumanaHarihareswara)

Unable to edit the page? See the FrontPage for instructions.