flask

No description

Find a file

Ron DuPlain d16491145d Update module helpers to avoid Python imports. This avoids errors in creating Flask instances where there are import errors in the module or package matching the import name. Those runtime errors will be apparent to the user soon enough, but tools which build Flask instances meta-programmatically benefit from a Flask which does not __import__.		2012-01-07 17:52:38 -05:00
artwork	Updated license, relicensed logo under debian-ish license	2010-06-19 13:49:01 +02:00
docs	typo fix	2012-01-07 21:11:35 +02:00
examples	Updated the docs and examples to non-failing teardown handlers	2011-08-25 20:56:43 +01:00
flask	Update module helpers to avoid Python imports.	2012-01-07 17:52:38 -05:00
scripts	Refactored flask.ext process to not swallow exceptions on weird Pythons.	2011-09-27 13:33:23 +02:00
.gitignore	Added a tox-test command that runs Flask tests with tox	2010-07-27 01:29:21 +02:00
.gitmodules	added theme submodule	2010-05-07 20:23:38 +02:00
AUTHORS	Added changelog entry and entry into authors file	2011-01-24 13:50:14 +01:00
CHANGES	Store session after callbacks. This fixes #351	2011-11-20 16:54:40 +01:00
LICENSE	Added upgrading notes	2010-06-19 17:17:50 +02:00
Makefile	Use the better test runner in the makefile	2011-08-26 11:24:42 +01:00
MANIFEST.in	Updated manifests	2011-08-26 11:48:09 +01:00
README	Updated README	2011-08-26 11:55:11 +01:00
run-tests.py	Do not break extension tests if tested with installed extensions.	2011-09-23 02:04:21 +02:00
setup.cfg	Added logo with new slogan	2010-05-12 01:29:25 +02:00
setup.py	Prepare for an 0.8.1 release	2011-10-02 01:06:22 +02:00
tox.ini	Added a tox-test command that runs Flask tests with tox	2010-07-27 01:29:21 +02:00

README

                          // Flask //

              web development, one drop at a time


    ~ What is Flask?

      Flask is a microframework for Python based on Werkzeug
      and Jinja2.  It's intended for small scale applications
      and was developed with best intentions in mind.

    ~ Is it ready?

      It's still not 1.0 but it's shaping up nicely and is
      already widely used.  Consider the API to slightly
      improve over time but we don't plan on breaking it.

    ~ What do I need?

      Jinja 2.4 and Werkzeug 0.6.1.  `pip` or `easy_install` will
      install them for you if you do `easy_install Flask`.
      I encourage you to use a virtualenv.  Check the docs for
      complete installation and usage instructions.

    ~ Where are the docs?

      Go to http://flask.pocoo.org/docs/ for a prebuilt version
      of the current documentation.  Otherwise build them yourself
      from the sphinx sources in the docs folder.

    ~ Where are the tests?

      Good that you're asking.  The tests are in the
      flask/testsuite package.  To run the tests use the
      `run-tests.py` file:

        $ python run-tests.py

      If it's not enough output for you, you can use the
      `--verbose` flag:

        $ python run-tests.py --verbose

      If you just want one particular testcase to run you can
      provide it on the command line:

        $ python run-tests.py test_to_run

    ~ Where can I get help?

      Either use the #pocoo IRC channel on irc.freenode.net or
      ask on the mailinglist: http://flask.pocoo.org/mailinglist/