tornado/demos
Ben Darnell f7818e799a *: Switch from percent formatting to f-strings
Automated change using pyupgrade in two passes (once to go from percent
formatting to str.format, then to go from str.format to f-strings),
followed by black.

This left a few uses of str.format for unknown reasons.
2024-06-13 15:25:50 -04:00
..
blog *: Update black 2024-06-04 14:19:52 -04:00
chat *: Remove redundant (object) base classes 2024-06-13 13:51:48 -04:00
facebook web: Rename "secure_cookie" methods to "signed_cookie" 2023-01-23 18:51:53 +00:00
file_upload all: Support lazy imports of submodules 2022-11-27 15:41:27 -05:00
google_auth *: Update black 2024-06-04 14:19:52 -04:00
helloworld all: Support lazy imports of submodules 2022-11-27 15:41:27 -05:00
s3server web,demos: Remove more uses of deprecated datetime utc methods 2023-11-01 21:40:54 -04:00
tcpecho docs,demos: Update for asyncio.run pattern 2022-06-03 14:50:20 -04:00
websocket all: Support lazy imports of submodules 2022-11-27 15:41:27 -05:00
webspider *: Switch from percent formatting to f-strings 2024-06-13 15:25:50 -04:00
README.rst auth: Deprecate TwitterMixin 2023-07-07 20:38:00 -04:00

README.rst

Tornado Demo Apps
-----------------

This directory contains several example apps that illustrate the usage of
various Tornado features. If you're not sure where to start, try the ``chat``,
``blog``, or ``websocket`` demos.

.. note::

    These applications require features due to be introduced in Tornado 6.3
    which is not yet released. Unless you are testing the new release,
    use the GitHub branch selector to access the ``stable`` branch
    (or the ``branchX.y`` branch corresponding to the version of Tornado you
    are using) to get a suitable version of the demos.

    TODO: remove this when 6.3 ships.

Web Applications
~~~~~~~~~~~~~~~~

- ``blog``: A simple database-backed blogging platform, including
  HTML templates and authentication.
- ``chat``: A chat room demonstrating live updates via long polling.
- ``websocket``: Similar to ``chat`` but with WebSockets instead of
  long polling.
- ``helloworld``: The simplest possible Tornado web page.
- ``s3server``: Implements a basic subset of the Amazon S3 API.

Feature demos
~~~~~~~~~~~~~

- ``facebook``: Authentication with the Facebook Graph API.
- ``file_upload``: Client and server support for streaming HTTP request 
  payloads.
- ``tcpecho``: Using the lower-level ``IOStream`` interfaces for non-HTTP
  networking.
- ``webspider``: Concurrent usage of ``AsyncHTTPClient``, using queues and
  semaphores.