From 1e6c5f0975d2ddef4430294c555b1deebb18f93b Mon Sep 17 00:00:00 2001 From: Armin Ronacher Date: Sun, 18 Sep 2011 12:51:10 +0200 Subject: [PATCH] Documented flask.ext. --- CHANGES | 1 + docs/api.rst | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) diff --git a/CHANGES b/CHANGES index 0e23b1fb..79a669f0 100644 --- a/CHANGES +++ b/CHANGES @@ -45,6 +45,7 @@ Relase date to be decided, codename to be chosen. - Added finer control over the session cookie parameters. - HEAD requests to a method view now automatically dispatch to the `get` method if no handler was implemented. +- Implemented the virtual :mod:`flask.ext` package to import extensions from. Version 0.7.3 ------------- diff --git a/docs/api.rst b/docs/api.rst index 1dc25eb1..aca7fda5 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -341,6 +341,23 @@ Configuration .. autoclass:: Config :members: +Extensions +---------- + +.. data:: flask.ext + + This module acts as redirect import module to Flask extensions. It was + added in 0.8 as the canonical way to import Flask extensions and makes + it possible for us to have more flexibility in how we distribute + extensions. + + If you want to use an extension named “Flask-Foo” you would import it + from :data:`~flask.ext` as follows:: + + from flask.ext import foo + + .. versionadded:: 0.8 + Useful Internals ----------------