blob: 5cb5b1abe6e8f76dca50cf78c1719139587af153 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.. Bottle documentation master file, created by
sphinx-quickstart on Thu Feb 18 13:47:50 2010.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. highlight:: python
.. _mako: http://www.makotemplates.org/
.. _cheetah: http://www.cheetahtemplate.org/
.. _jinja2: http://jinja.pocoo.org/2/
.. _paste: http://pythonpaste.org/
.. _fapws3: http://github.com/william-os4y/fapws3
.. _flup: http://trac.saddi.com/flup
.. _cherrypy: http://www.cherrypy.org/
.. _WSGI: http://www.wsgi.org/wsgi/
.. _Python: http://python.org/
.. _testing: http://github.com/defnull/bottle/raw/master/bottle.py
Bottle: Python Web Framework
==================================
Bottle is a fast, simple and lightweight WSGI_ micro web-framework for Python_ with no external dependencies and packed into a single file.
.. rubric:: Core Features
* **Routes:** Mapping URLs to code with a simple but powerful pattern syntax.
* **Templates:** Fast build-in template engine and support for mako_, jinja2_ and cheetah_ templates.
* **Server:** Build-in HTTP development server and support for paste_, fapws3_, flup_, cherrypy_ or any other WSGI_ capable server.
* **Plug&Run:** All in a single file and no dependencies other than the Python standard library.
.. rubric:: Download, Install and Dependencies
You can install the latest stable release with ``easy_install -U bottle`` or just download the newest testing_ version into your project directory. There are no (hard [1]_) dependencies other than the Python standard library. Bottle runs with **Python 2.5+ and 3.x** (using 2to3)
.. rubric:: Example
This is a minimal bottle application serving a single URL::
from bottle import route, run
@route('/')
def index():
return 'Hello World!'
run(host='localhost', port=8080)
.. rubric:: Documentation
.. toctree::
:maxdepth: 2
intro
tutorial
api
stpl
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
.. rubric:: Footnotes
.. [1] Usage of the template or server adapter classes of course requires the corresponding template or server modules.
|
