|
Size: 4132
Comment:
|
← Revision 41 as of 2019-06-22 19:01:22 ⇥
Size: 799
Comment: remove obsolete information so people will be directed to official guide
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = What the Cheese Shop Stores = | A short introduction on how to install packages from the [[https://pypi.org/pypi|Python Package Index (PyPI)]], and how to make, distribute and upload your own. |
| Line 3: | Line 3: |
| 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. === Selecting Classifiers === View the complete [http://cheeseshop.python.org/pypi?%3Aaction=list_classifiers list of classifiers] you may choose from. See the [http://docs.python.org/dist/meta-data.html meta-data docs] for details about how to include them in your setup.py file. PyPI will attempt to parse the "long_description" from your meta-data as ReStructuredText. If this fails, it will be presented to users as plain text (all whitespace and formatting retained). === Missing Classifier? === Is a classifier you need missing from the [http://cheeseshop.python.org/pypi?%3Aaction=list_classifiers classifiers list]? Python frameworks with plugins or packages that target the framework can get their own category. The category should only be added ''after'' such packages exist. Complimentary packages can link to each other from their descriptions, they do not need a category to link them together; only when packages are provided by different people does a category need to be created. To ask for a category email catalog-sig@python.org. == 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. = Cheesecake scores = Cheesecake is a project that tries to help Python developers via testing and scoring their packages based on some empirical factors, like, for example, whether a package can be installed using standard "python setup.py install" interface. To learn more about it, visit its [http://pycheesecake.org/ homepage]. Starting from August 10th 2006 all packages that were updated/released on PyPI are automatically scored. You can browse full list of scored packages on [http://pypi.pycheesecake.org:8080/ Cheesecake server]. It's still in alpha state, so let us know of any bugs or inconveniences you stumble upon. Cheesecake scores will also be incorporated into PyPI itself in a way that will allow package owners to browse scores on their administration pages. |
'''This guide is no longer being maintained''' - more up-to-date and complete information is in the [[https://packaging.python.org/|Python Packaging User Guide]]. To see what was previously in this page, please visit [[https://wiki.python.org/moin/CheeseShopTutorial?action=recall&rev=40|the previous edit]] in [[https://wiki.python.org/moin/CheeseShopTutorial?action=info|the wiki page history]]. Thank you to the writers who created this documentation! If you believe anything that was this page is missing from the current Python Packaging User Guide, please file [[https://github.com/pypa/packaging.python.org/issues/|an issue]]! |
A short introduction on how to install packages from the Python Package Index (PyPI), and how to make, distribute and upload your own.
This guide is no longer being maintained - more up-to-date and complete information is in the Python Packaging User Guide. To see what was previously in this page, please visit the previous edit in the wiki page history. Thank you to the writers who created this documentation! If you believe anything that was this page is missing from the current Python Packaging User Guide, please file an issue!