update copyright date and add example section with category

Signed-off-by: Harsha Narayana <harsha2k4@gmail.com>
This commit is contained in:
Harsha Narayana 2018-12-08 12:34:52 +05:30
parent e6fba01682
commit 939b5ea095
No known key found for this signature in database
GPG Key ID: 8AF211CB60D4B28C
3 changed files with 58 additions and 1 deletions

View File

@ -38,7 +38,7 @@ master_doc = 'index'
# General information about the project. # General information about the project.
project = 'Sanic' project = 'Sanic'
copyright = '2016, Sanic contributors' copyright = '2018, Sanic contributors'
author = 'Sanic contributors' author = 'Sanic contributors'
# The version info for the project you're documenting, acts as replacement for # The version info for the project you're documenting, acts as replacement for

View File

@ -31,6 +31,7 @@ Guides
sanic/extensions sanic/extensions
sanic/contributing sanic/contributing
sanic/api_reference sanic/api_reference
sanic/examples
Module Documentation Module Documentation

56
docs/sanic/examples.rst Normal file
View File

@ -0,0 +1,56 @@
Examples
========
This section of the documentation is a simple collection of example code that can help you get a quick start
on your application development. Most of these examples are categorized and provide you with a link to the
working code example in the `Sanic Repository <https://github.com/huge-success/sanic/tree/master/examples>`_
Basic Examples
--------------
This section of the examples are a collection of code that provide a simple use case example of the sanic application.
Simple Apps
^^^^^^^^^^^
A simple sanic application with a single ``async`` method with ``text`` and ``json`` type response.
.. literalinclude:: ../../examples/teapot.py
.. literalinclude:: ../../examples/simple_server.py
Simple App with ``Sanic Views``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Showcasing the simple mechanism of using :class:`sanic.viewes.HTTPMethodView` as well as a way to extend the same
into providing a custom ``async`` behavior for ``view``.
.. literalinclude:: ../../examples/simple_async_view.py
URL Redirect
^^^^^^^^^^^^
.. literalinclude:: ../../examples/redirect_example.py
Named URL redirection
^^^^^^^^^^^^^^^^^^^^^
``Sanic`` provides an easy to use way of redirecting the requests via a helper method called ``url_for`` that takes a
unique url name as argument and returns you the actual route assigned for it. This will help in simplifying the
efforts required in redirecting the user between different section of the application.
.. literalinclude:: ../../examples/url_for_example.py
Custom Logging
^^^^^^^^^^^^^^
Even though ``Sanic`` comes with a battery of Logging support it allows the end users to customize the way logging
is handled in the application runtime.
.. literalinclude:: ../../examples/override_logging.py