Folks: Part of this patch documents the existence of the "Framework :: Setuptools Plugin" classifier and says when to use it. Another part documents the naming conventions which the developers of the various revision control plugins agreed to. Regards, Zooko P.S. Note that the git and hg revision control plugins didn't yet go through a renaming to conform to the agreed convention. I did for the setuptools_darcs plugin that I maintain -- you can see the leftover evidence of it here: http://pypi.python.org/pypi/setuptools_darcs_plugin I'm Cc:'ing the maintainers of the setuptools-git and setuptools-hg plugins to remind them of the existence of this convention in case they want to switch. 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`` -----------------------