[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