.\" Man page generated from reStructuredText.
.
.TH "BOTTLE" "1" "January 14, 2017" "0.12" "Bottle"
.SH NAME
bottle \- command line interface
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
Starting with version 0.10 you can use bottle as a command\-line tool:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ python \-m bottle

Usage: bottle.py [options] package.module:app

Options:
  \-h, \-\-help            show this help message and exit
  \-\-version             show version number.
  \-b ADDRESS, \-\-bind=ADDRESS
                        bind socket to ADDRESS.
  \-s SERVER, \-\-server=SERVER
                        use SERVER as backend.
  \-p PLUGIN, \-\-plugin=PLUGIN
                        install additional plugin/s.
  \-\-debug               start server in debug mode.
  \-\-reload              auto\-reload on file changes.
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
The \fIADDRESS\fP field takes an IP address or an IP:PORT pair and defaults to \fBlocalhost:8080\fP\&. The other parameters should be self\-explanatory.
.sp
Both plugins and applications are specified via import expressions. These consist of an import path (e.g. \fBpackage.module\fP) and an expression to be evaluated in the namespace of that module, separated by a colon. See \fBload()\fP for details. Here are some examples:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Grab the \(aqapp\(aq object from the \(aqmyapp.controller\(aq module and
# start a paste server on port 80 on all interfaces.
python \-m bottle \-server paste \-bind 0.0.0.0:80 myapp.controller:app

# Start a self\-reloading development server and serve the global
# default application. The routes are defined in \(aqtest.py\(aq
python \-m bottle \-\-debug \-\-reload test

# Install a custom debug plugin with some parameters
python \-m bottle \-\-debug \-\-reload \-\-plugin \(aqutils:DebugPlugin(exc=True)\(aq\(aq test

# Serve an application that is created with \(aqmyapp.controller.make_app()\(aq
# on demand.
python \-m bottle \(aqmyapp.controller:make_app()\(aq\(aq
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
Marcel Hellkamp, Federico Ceratto
.SH COPYRIGHT
2009-2017, Marcel Hellkamp
.\" Generated by docutils manpage writer.
.