Browse Source

Drop Extension==dev requirement

pip doesn't install links included in the description of projects
anymore. Therefore ==dev install doesn't work anymore.
pull/1220/head
Daniel Neuhäuser 11 years ago committed by Markus Unterwaditzer
parent
commit
43d6b8a5fc
  1. 70
      docs/extensiondev.rst

70
docs/extensiondev.rst

@ -355,43 +355,39 @@ new releases. These approved extensions are listed on the `Flask
Extension Registry`_ and marked appropriately. If you want your own Extension Registry`_ and marked appropriately. If you want your own
extension to be approved you have to follow these guidelines: extension to be approved you have to follow these guidelines:
0. An approved Flask extension requires a maintainer. In the event an 0. An approved Flask extension requires a maintainer. In the event an
extension author would like to move beyond the project, the project should extension author would like to move beyond the project, the project should
find a new maintainer including full source hosting transition and PyPI find a new maintainer including full source hosting transition and PyPI
access. If no maintainer is available, give access to the Flask core team. access. If no maintainer is available, give access to the Flask core team.
1. An approved Flask extension must provide exactly one package or module 1. An approved Flask extension must provide exactly one package or module
named ``flask_extensionname``. They might also reside inside a named ``flask_extensionname``. They might also reside inside a
``flaskext`` namespace packages though this is discouraged now. ``flaskext`` namespace packages though this is discouraged now.
2. It must ship a testing suite that can either be invoked with ``make test`` 2. It must ship a testing suite that can either be invoked with ``make test``
or ``python setup.py test``. For test suites invoked with ``make or ``python setup.py test``. For test suites invoked with ``make
test`` the extension has to ensure that all dependencies for the test test`` the extension has to ensure that all dependencies for the test
are installed automatically. If tests are invoked with ``python setup.py are installed automatically. If tests are invoked with ``python setup.py
test``, test dependencies can be specified in the :file:`setup.py` file. The test``, test dependencies can be specified in the `setup.py` file. The
test suite also has to be part of the distribution. test suite also has to be part of the distribution.
3. APIs of approved extensions will be checked for the following 3. APIs of approved extensions will be checked for the following
characteristics: characteristics:
- an approved extension has to support multiple applications - an approved extension has to support multiple applications
running in the same Python process. running in the same Python process.
- it must be possible to use the factory pattern for creating - it must be possible to use the factory pattern for creating
applications. applications.
4. The license must be BSD/MIT/WTFPL licensed. 4. The license must be BSD/MIT/WTFPL licensed.
5. The naming scheme for official extensions is *Flask-ExtensionName* or 5. The naming scheme for official extensions is *Flask-ExtensionName* or
*ExtensionName-Flask*. *ExtensionName-Flask*.
6. Approved extensions must define all their dependencies in the 6. Approved extensions must define all their dependencies in the
:file:`setup.py` file unless a dependency cannot be met because it is not `setup.py` file unless a dependency cannot be met because it is not
available on PyPI. available on PyPI.
7. The extension must have documentation that uses one of the two Flask 7. The extension must have documentation that uses one of the two Flask
themes for Sphinx documentation. themes for Sphinx documentation.
8. The setup.py description (and thus the PyPI description) has to 8. The ``zip_safe`` flag in the setup script must be set to ``False``,
link to the documentation, website (if there is one) and there even if the extension would be safe for zipping.
must be a link to automatically install the development version 9. An extension currently has to support Python 2.6 as well as
(``PackageName==dev``). Python 2.7
9. The ``zip_safe`` flag in the setup script must be set to ``False``,
even if the extension would be safe for zipping.
10. An extension currently has to support Python 2.6 as well as
Python 2.7
.. _ext-import-transition: .. _ext-import-transition:

Loading…
Cancel
Save