Flask-Images icon indicating copy to clipboard operation
Flask-Images copied to clipboard

Add plugin to Flask Extensions page

Open iurisilvio opened this issue 10 years ago • 6 comments

  • [x] An approved Flask extension requires a maintainer. In the event an extension author would like to move beyond the project, the project should find a new maintainer including full source hosting transition and PyPI access. If no maintainer is available, give access to the Flask core team.
  • [x] An approved Flask extension must provide exactly one package or module named flask_extensionname. They might also reside inside a flaskext namespace packages though this is discouraged now.
  • [x] 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 test the extension has to ensure that all dependencies for the test are installed automatically. If tests are invoked with python setup.py test, test dependencies can be specified in the setup.py file. The test suite also has to be part of the distribution.
  • [x] APIs of approved extensions will be checked for the following characteristics: an approved extension has to support multiple applications running in the same Python process. it must be possible to use the factory pattern for creating applications.
  • [x] The license must be BSD/MIT/WTFPL licensed.
  • [x] The naming scheme for official extensions is Flask-ExtensionName or ExtensionName-Flask.
  • [x] Approved extensions must define all their dependencies in the setup.py file unless a dependency cannot be met because it is not available on PyPI.
  • [ ] The extension must have documentation that uses one of the two Flask themes for Sphinx documentation.
  • [x] The zip_safe flag in the setup script must be set to False, even if the extension would be safe for zipping.
  • [x] An extension currently has to support Python 2.6 as well as Python 2.7

iurisilvio avatar Apr 01 '14 00:04 iurisilvio

Do you know how one goes about doing this? =P

mikeboers avatar Apr 01 '14 16:04 mikeboers

You have to pull request your extension is Flask Extensions Registry. Flask has some docs about how to approve the extension.

http://flask.pocoo.org/docs/extensiondev/#approved-extensions

iurisilvio avatar Apr 01 '14 17:04 iurisilvio

I copied the guidelines to approved extensions in the issue to make it happen.

You can add it to the registry even without it, but it will not have the approved extension flag.

iurisilvio avatar Apr 16 '14 19:04 iurisilvio

Looks like it is down to the docs theme, and a little bit more testing...

mikeboers avatar Apr 16 '14 19:04 mikeboers

So, you just have to publish the docs.

All other requirements are ok.

iurisilvio avatar Apr 26 '14 12:04 iurisilvio

At some point in recent history I translated the existing docs from Markdown to Sphinx. They are still kinda gross, but there they are.

What do you think?

mikeboers avatar Jan 11 '15 19:01 mikeboers