pluggdapps.catchanddebug
- limit
- Maximum number of trace back frames to display in the debug page.
- show_revision
- Show revision information from frame.
- template
- Template file to render the error page. Refer to the plugin to know
more about the context available to the template.
- xmlhttp_key
- When this key is in the request GET variables (not POST!), expect that
this is an XMLHttpRequest, and the response will be more minimal; it
shall not be a complete HTML page.
- html
- Format exception in html and return back an interactive debug page as
response.
pluggdapps.commands
- command_width
- Maximum width of command name column.
- description_width
- Maximum width of description column.
pluggdapps.confdoc
– configuration is not supported by plugin –
pluggdapps.configsqlite3db
- url
- Location of sqlite3 backend file. Will be passed to sqlite3.connect()
API. Can be modified only in the .ini file.
pluggdapps.docroot
- IHTTPResponse
- Name of the plugin to encapsulate HTTP response.
- favicon
- To use a different file for favorite icon, configure the file path
here. File path must be relative to rootloc.
- IHTTPLiveDebug
- Plugin implementing IHTTPLiveDebug interface spec. Will be used to
catch application exception and render them on browser. Provides
browser based debug interface.
- rootloc
- Root location containing the web-site documents.
- encoding
- Default character encoding to use on HTTP response. This can be
customized for each view (or resource-variant)
- IHTTPRouter
- IHTTPRouter plugin. Base router plugin for resolving requests to view-
callable.
- IHTTPOutBound
- A string of comma seperated value, where each value names a
IHTTPOutBound plugin. Transforms will be applied in specified order.
- language
- Default language to use in content negotiation. This can be customized
for each view (or resource-variant)
- IHTTPRequest
- Name of the plugin to encapsulate HTTP request.
- IHTTPSession
- Plugin implementing IHTTPSession interface spec. Will be used to
handle cookie based user-sessions.
- index_page
- Specify the index page for the hosted site.
- IHTTPCookie
- Plugin implementing IHTTPCookie interface spec. Methods from this
plugin will be used to process both request cookies and response
cookies.
- IHTTPInBound
- A string of comma seperated value, where each value names a
IHTTPInBound plugin. Transforms will be applied in specified order.
pluggdapps.docrootrouter
- IHTTPNegotiator
- If configured, will be used to handle server side http negotiation for
best matching resource variant.
- defaultview
- Default view callable plugin. Will be used when request cannot be
resolved to a valid view-callable.
- routemapper
- Route mapper file in asset specification format. A python file
containing a list of dictionaries, where each dictionary element will
be converted to add_view() method-call on the router plugin.
pluggdapps.docrootview
- max_age
- How long this file can remain fresh in a HTTP cache.
pluggdapps.env
- host_name
- Host name for the environment :
- template_dir
- Obsolute file path of template source-tree to be used for the
scaffolding logic.
- target_dir
- Target directory to place the scaffolding logic.
pluggdapps.gzipoutbound
- level
- Compression level while applying gzip.
pluggdapps.httpconnection
- no_keep_alive
- HTTP /1.1, whether to close the connection after every request.
- max_buffer_size
- Maximum size of read / write buffer in bytes.
- read_chunk_size
- Chunk of data, size in bytes, to read at a time.
- connection_timeout
- Timeout in seconds after which an idle connection is gracefully
closed.
pluggdapps.httpcookie
- value_encoding
- While computing signed cookie value, use this encoding before return
the value.
- secret
- Use this to sign the cookie value before sending it with the response.
- max_age_seconds
- Maximum age, in seconds, for a cookie to live after its creation time.
The default is 30 days.
pluggdapps.httpepollserver
- poll_threshold
- A warning limit for number of descriptors being polled by a single
poll instance. Will be used by HTTPIOLoop plugin.
- family
- Family may be set to either AF_INET or AF_INET6 to restrict to
ipv4 or ipv6 addresses, otherwise both will be used if available.
- poll_timeout
- Poll instance will timeout after the specified number of seconds and
perform callbacks (if any) and start a fresh poll. Will be used by
HTTPIOLoop definition
- port
- Port addres to bind the http server. If left empty port paramter
from [pluggdapps] section will be used.
- ssl.cert_reqs
- Whether a certificate is required from the other side of the
connection, and whether it will be validated if provided. It must be
one of the three values CERT_NONE (certificates ignored),
CERT_OPTIONAL (not required, but validated if provided), or
CERT_REQUIRED (required and validated). If the value of this value is
not CERT_NONE, then the ca_certs parameter must point to a file of
CA certificates. SSL options can be set only in the .ini file.
- backlog
- Back log of http request that can be queued at listening port. This
option is directly passed to socket.listen().
- ssl.ca_certs
- The ca_certs file contains a set of concatenated certification
authority. certificates, which are used to validate certificates
passed from the other end of the connection. SSL options can be set
only in the .ini file.
- ssl.certfile
- SSL Certificate file location. SSL options can be set only in the .ini
file.
- host
- Address may be either an IP address or hostname. If it’s a hostname,
the server will listen on all IP addresses associated with the name.
Address may be an empty string or None to listen on all available
interfaces. Family may be set to either socket.AF_INET or
socket.AF_INET6 to restrict to ipv4 or ipv6 addresses, otherwise
both will be used if available. If left empty host parameter from
[pluggdapps] section will be used.
- scheme
- HTTP Scheme to use, either http or https. If left empty scheme
parameter from [pluggdapps] section will be used.
- IHTTPConnection
- Plugin to handle client connections.
- ssl.keyfile
- SSL Key file location. SSL options can be set only in the .ini file.
pluggdapps.httpnegotiator
– configuration is not supported by plugin –
pluggdapps.httprequest
– configuration is not supported by plugin –
pluggdapps.httpresponse
– configuration is not supported by plugin –
pluggdapps.ls
– configuration is not supported by plugin –
pluggdapps.matchrouter
- IHTTPNegotiator
- If configured, will be used to handle server side http negotiation for
best matching resource variant.
- routemapper
- Route mapper file in asset specification format. A python file
containing a list of dictionaries, where each dictionary element will
be converted to add_view() method-call on the router plugin.
- defaultview
- Default view callable plugin. Will be used when request cannot be
resolved to a valid view-callable.
pluggdapps.newwebapp
- webapp_name
- Name of the web application. Since a web application is also a plugin,
it must be a unique name.
- template_dir
- Obsolute file path of template source-tree to be used for the
scaffolding logic.
- target_dir
- Target directory to place the generated modules and directories. If
not specified uses the current working directory.
pluggdapps.pviews
– configuration is not supported by plugin –
pluggdapps.serve
- reload.config
- Relevant when the sub-command is invoked with monitor and reload
switch. Specifies whether the server should be restarted when a
configuration file (.ini) is changed.
- reload.poll_interval
- Relevant when the sub-command is invoked with monitor and reload
switch. Number of seconds to poll for file modifications. When a file
is modified, server is restarted.
- IHTTPServer
- Plugin name implementing IHTTPServer. This is the actual web
server that will be started by the sub-command. Can be modified only
in the .ini file.
pluggdapps.staticview
- max_age
- Response max_age in seconds. How long this file can remain fresh in a
HTTP cache.
pluggdapps.unittest
– configuration is not supported by plugin –
pluggdapps.webadmin
- IHTTPResponse
- Name of the plugin to encapsulate HTTP response.
- language
- Default language to use in content negotiation. This can be customized
for each view (or resource-variant)
- IHTTPRequest
- Name of the plugin to encapsulate HTTP request.
- IHTTPSession
- Plugin implementing IHTTPSession interface spec. Will be used to
handle cookie based user-sessions.
- IHTTPLiveDebug
- Plugin implementing IHTTPLiveDebug interface spec. Will be used to
catch application exception and render them on browser. Provides
browser based debug interface.
- IHTTPOutBound
- A string of comma seperated value, where each value names a
IHTTPOutBound plugin. Transforms will be applied in specified order.
- IHTTPInBound
- A string of comma seperated value, where each value names a
IHTTPInBound plugin. Transforms will be applied in specified order.
- encoding
- Default character encoding to use on HTTP response. This can be
customized for each view (or resource-variant)
- IHTTPRouter
- IHTTPRouter plugin. Base router plugin for resolving requests to view-
callable.
- IHTTPCookie
- Plugin implementing IHTTPCookie interface spec. Methods from this
plugin will be used to process both request cookies and response
cookies.
pluggdapps.webadminrouter
- IHTTPNegotiator
- If configured, will be used to handle server side http negotiation for
best matching resource variant.
- defaultview
- Default view callable plugin. Will be used when request cannot be
resolved to a valid view-callable.
- routemapper
- Route mapper file in asset specification format. A python file
containing a list of dictionaries, where each dictionary element will
be converted to add_view() method-call on the router plugin.
pluggdapps.webapp
- IHTTPOutBound
- A string of comma seperated value, where each value names a
IHTTPOutBound plugin. Transforms will be applied in specified order.
- IHTTPResponse
- Name of the plugin to encapsulate HTTP response.
- language
- Default language to use in content negotiation. This can be customized
for each view (or resource-variant)
- encoding
- Default character encoding to use on HTTP response. This can be
customized for each view (or resource-variant)
- IHTTPRequest
- Name of the plugin to encapsulate HTTP request.
- IHTTPRouter
- IHTTPRouter plugin. Base router plugin for resolving requests to view-
callable.
- IHTTPSession
- Plugin implementing IHTTPSession interface spec. Will be used to
handle cookie based user-sessions.
- IHTTPCookie
- Plugin implementing IHTTPCookie interface spec. Methods from this
plugin will be used to process both request cookies and response
cookies.
- IHTTPInBound
- A string of comma seperated value, where each value names a
IHTTPInBound plugin. Transforms will be applied in specified order.
- IHTTPLiveDebug
- Plugin implementing IHTTPLiveDebug interface spec. Will be used to
catch application exception and render them on browser. Provides
browser based debug interface.