diff options
| author | Chris McDonough <chrism@agendaless.com> | 2010-08-06 20:42:35 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2010-08-06 20:42:35 +0000 |
| commit | 26a0fd57b7cdd5423fdc3a3cf36bd1c7a3fb8453 (patch) | |
| tree | e39cfd2895b155c5c884bb9ebe893fc353262c0e /docs | |
| parent | 141a00c3a69647218f9d444f98e094455a2d2373 (diff) | |
| download | pyramid-26a0fd57b7cdd5423fdc3a3cf36bd1c7a3fb8453.tar.gz pyramid-26a0fd57b7cdd5423fdc3a3cf36bd1c7a3fb8453.tar.bz2 pyramid-26a0fd57b7cdd5423fdc3a3cf36bd1c7a3fb8453.zip | |
Describe what a microframework is.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/designdefense.rst | 22 |
1 files changed, 17 insertions, 5 deletions
diff --git a/docs/designdefense.rst b/docs/designdefense.rst index 126922f7f..ac8f128fb 100644 --- a/docs/designdefense.rst +++ b/docs/designdefense.rst @@ -1204,18 +1204,30 @@ effort. Microframeworks Have Smaller Hello World Programs ------------------------------------------------- +Self-described "microframeworks" exist: `Bottle +<http://bottle.paws.de>`_ and `Flask <http://flask.pocoo.org/>`_ are +two that are becoming popular. `Bobo <http://bobo.digicool.com/>`_ +doesn't describe itself as a microframework, but its intended userbase +is much the same. Many others exist. We've actually even (only as a +teaching tool, not as any sort of official project) `created one using +BFG <http://bfg.repoze.org/videos#groundhog1>`_. Microframeworks are +small frameworks with one common feature: each allows its users to +create a fully functional application that lives in a single Python +file. + Some developers and microframework authors point out that BFG's "hello -world" program is longer (by about five lines) than the equivalent -program in their favorite microframework. Guilty as charged; in a -contest of "whose is shortest", BFG indeed loses. +world" single-file program is longer (by about five lines) than the +equivalent program in their favorite microframework. Guilty as +charged; in a contest of "whose is shortest", BFG indeed loses. -This loss isn't for lack of trying: BFG aims to be useful in the same +This loss isn't for lack of trying. BFG aims to be useful in the same circumstance in which microframeworks claim dominance: single-file applications. But BFG doesn't sacrifice its ability to credibly support larger applications in order to achieve hello-world LoC parity with the current crop of microframeworks. BFG's design instead tries to avoid some common pitfalls associated with naive declarative -configuration schemes. +configuration schemes. The subsections which follow explain the +rationale. .. _you_dont_own_modulescope: |