deb-python-autobahn/doc
HawkOwl 88957b29fa remove from docs 2015-09-15 16:43:31 +08:00
..
_extensions work on docs 2014-08-06 01:08:08 +02:00
_static add wamp-demos link, with image 2015-06-17 22:51:58 -06:00
_templates doc cleanup 2014-08-10 12:08:10 +02:00
reference doc fixes and WAMP session lifecycle section 2015-01-05 13:01:24 +01:00
wamp more samllish things 2015-08-06 16:24:04 +02:00
websocket work on docs 2014-08-05 14:15:51 +02:00
work Ensure we use on_progress everywhere 2015-03-16 14:13:46 -06:00
.gitignore cleanup build 2014-08-05 18:44:11 +02:00
Makefile small fixes in preparation for release 2015-08-06 15:58:01 +02:00
README.md Fix documentation build 2015-05-14 13:17:26 -06:00
SConstruct fix docs; undo previous commit 2015-06-11 14:40:21 +02:00
asynchronous-programming.rst small fixes in preparation for release 2015-08-06 15:58:01 +02:00
changelog.rst fix regression in 0.10.8 with connectTCP and WebSocket (fixes #500) 2015-09-15 10:07:46 +02:00
conf.py small fixes in preparation for release 2015-08-06 15:58:01 +02:00
contents.rst added 'contribute' page to docs (fixes #257) 2014-08-25 16:58:10 +02:00
contribute.rst coverage commands so we can see coverage across all Pythons 2015-04-06 15:51:11 -06:00
index.rst remove from docs 2015-09-15 16:43:31 +08:00
installation.rst re-wording and improving some of the Autobahn documentation 2015-06-17 14:37:13 -06:00
serve.py pep8: W291 - trailing whitespace 2015-02-19 19:22:23 +01:00
spelling_wordlist.txt remove from docs 2015-09-15 16:43:31 +08:00

README.md

Documentation

The documentation is generated using Sphinx and the generated documentation is hosted here.

Prerequisites

You will need to have Python and SCons installed. To install the rest of the build dependencies

make install_deps

Note: If you want to use this in a virtualenv, you'll have to install the SCons package for your distribution and use virtualenv --system-site-packages to build the venv. Then, activate it and install dependencies as above. To run SCons you'll have to do python `which scons` so that it uses the interpreter from your virtualenv.

Then, to get help on available build targets, just type

make

Cheatsheets

Linking to Python objects

To link to a Autobahn class:

:py:class:`autobahn.websocket.protocol.WebSocketProtocol`

To link to a Python stdlib class:

:py:class:`zipfile.ZipFile`

Or to link to Python 2 or Python 3 specifically:

:py:class:`zipfile.ZipFile <py2:zipfile.ZipFile>`
:py:class:`zipfile.ZipFile <py3:zipfile.ZipFile>`

To link to a Twisted class:

:tx:`twisted.internet.defer.Deferred`