[Distutils] classifier for setuptools plugins
zooko
zooko at zooko.com
Thu Mar 12 16:37:40 CET 2009
> I stumbled on the "Googling for setuptools plus Mercurial leads to
> an outdated plugin" problem the other day. I e-mailed the author
> and asked him to update the page with a link to setuptools_hg, but
> haven't gotten response yet. Alternatively, people could give a nod
> to setuptools_hg with a link in their blog, etc. and eventually
> this should skew the Google ranking :P
>
> http://pypi.python.org/pypi/setuptools_hg
Please add the "Framework :: Setuptools Plugin" classifier to your
metadata so that setuptools_hg will appear on this search:
http://pypi.python.org/pypi?:action=browse&c=524
There follows a patch that I submitted to recommend this in the
setuptools docs. I thought that PJE had already accepted this patch,
but it isn't there. PJE: please accept the following patch.
Regards,
Zooko
diff -rN -u old-dw/setuptools.txt new-dw/setuptools.txt
--- old-dw/setuptools.txt 2008-08-11 11:38:07.000000000 -0600
+++ new-dw/setuptools.txt 2008-08-11 11:38:07.000000000 -0600
@@ -2384,6 +2384,16 @@
how setuptools' own commands are installed: the setuptools
project's setup
script defines entry points for them!
+If your command would be useful to other Python developers, then
consider
+uploading it to the `Python Package Index`_. If you do, please
include the
+Trove Classifier "Framework :: Setuptools Plugin" in the classifiers
so that
+your command will appear in the list of `packages which are setuptools
+plugins`_.
+
+.. _Python Package Index: http://pypi.python.org/pypi
+.. _packages which are setuptools plugins: http://pypi.python.org/
pypi?:action=browse&c=524
+
+
Adding ``setup()`` Arguments
----------------------------
@@ -2546,6 +2556,17 @@
control system itself. It *may*, however, use
``distutils.log.warn()`` to
inform the user of the missing program(s).
+Please model your naming conventions and documentation after the other
+setuptools revision control plugins: `setuptools_bzr`_,
`setuptools_mtn`_,'
+`setuptools_darcs`_. Please include the Trove Classifier "Framework ::
+Setuptools Plugin" in the classifiers so that your command will
appear in the
+list of `packages which are setuptools plugins`_.
+
+.. _setuptools_bzr: http://pypi.python.org/pypi/setuptools_bzr
+.. _setuptools_mtn: http://pypi.python.org/pypi/setuptools_mtn
+.. _setuptools_darcs: http://pypi.python.org/pypi/setuptools_darcs
+.. _packages which are setuptools plugins: http://pypi.python.org/
pypi?:action=browse&c=524
+
Subclassing ``Command``
-----------------------
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: doc-classifier-and-rcs.diff.txt
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20090312/418f1d59/attachment.txt>
More information about the Distutils-SIG
mailing list