Browse files

Started extensions introduction document

  • Loading branch information...
mitsuhiko committed Sep 18, 2011
1 parent e944167 commit 933d203828164ef4eabcce29667207deb2409569
Showing with 49 additions and 0 deletions.
  1. +1 −0 docs/
  2. +48 −0 docs/extensions.rst
@@ -20,6 +20,7 @@ instructions for web development with Flask.
+ extensions
@@ -0,0 +1,48 @@
+Flask Extensions
+Flask extensions extend the functionality of Flask in various different
+ways. For instance they add support for databases and other common tasks.
+Finding Extensions
+Flask extensions are listed on the `Flask Extension Registry`_ and can be
+downloaded with ``easy_install`` or ``pip``. If you add a Flask extension
+as dependency to your ``requirements.rst`` or ```` file they are
+usually installed with a simple command or when your application installs.
+Using Extensions
+Extensions typically have documentation that goes along that shows how to
+use it. There are no general rules in how extensions are supposed to
+behave but they are imported from common locations. If you have an
+extension called ``Flask-Foo`` or ``Foo-Flask`` it will be always
+importable from ````::
+ from flask.ext import foo
+Flask < 0.8
+If you are using Flask 0.7 or earlier the :data:`flask.ext` package will not
+exist, instead you have to import from ```` or ``flask_foo``
+depending on how the extension is distributed.
+We recommend importing from ``flask.ext`` even with older versions of
+Flask however. If you have an application that needs to work with
+versions of Flask older than 0.8 you should activate the
+``flaskext_compat`` module which provides the ``flask.ext`` module. You
+can download it from github: ``_
+You can use it like this::
+ import flaskext_compat
+ from flask.ext import foo
+Once the ``flaskext_compat`` module is imported the :data:`flask.ext` will
+exist and you can start importing from there.
+.. _Flask Extension Registry:

0 comments on commit 933d203

Please sign in to comment.