merge master into local branch

.gitignore

@@ -14,3 +14,4 @@ settings.py
 docs/_build/
 docs/_api/
 build/*
+.DS_Store

.travis.yml

@@ -1,4 +1,5 @@
 sudo: false
+dist: precise
 language: python
 cache:
   directories:

README.rst

@@ -56,6 +56,16 @@ Documentation
 .. |PyPI version| image:: https://img.shields.io/pypi/pyversions/sanic.svg
    :target: https://pypi.python.org/pypi/sanic/
    
+
+Examples
+--------
+`Non-Core examples <https://github.com/channelcat/sanic/wiki/Examples/>`_. Examples of plugins and Sanic that are outside the scope of Sanic core.
+
+`Extensions <https://github.com/channelcat/sanic/wiki/Extensions/>`_. Sanic extensions created by the community.
+
+`Projects <https://github.com/channelcat/sanic/wiki/Projects/>`_. Sanic in production use.
+
+
 TODO
 ----
  * http2

docs/sanic/testing.md

@@ -59,7 +59,7 @@ the available arguments to aiohttp can be found
 [in the documentation for ClientSession](https://aiohttp.readthedocs.io/en/stable/client_reference.html#client-session).
 
 
-# pytest-sanic
+## pytest-sanic
 
 [pytest-sanic](https://github.com/yunstanford/pytest-sanic) is a pytest plugin, it helps you to test your code asynchronously.
 Just write tests like,

docs/sanic/versioning.md

@@ -10,11 +10,11 @@ You can pass a version number to the routes directly.
 from sanic import response
 
 
-@app.route('/text', verion=1)
+@app.route('/text', version=1)
 def handle_request(request):
     return response.text('Hello world! Version 1')
 
-@app.route('/text', verion=2)
+@app.route('/text', version=2)
 def handle_request(request):
     return response.text('Hello world! Version 2')
 

sanic/__init__.py

@@ -1,6 +1,6 @@
 from sanic.app import Sanic
 from sanic.blueprints import Blueprint
 
-__version__ = '0.5.4'
+__version__ = '0.6.0'
 
 __all__ = ['Sanic', 'Blueprint']

sanic/app.py

@@ -33,9 +33,7 @@ class Sanic:
             logging.config.dictConfig(log_config)
         # Only set up a default log handler if the
         # end-user application didn't set anything up.
-        if not (logging.root.handlers and
+        if not logging.root.handlers and log.level == logging.NOTSET:
-                log.level == logging.NOTSET and
-                log_config):
             formatter = logging.Formatter(
                 "%(asctime)s: %(levelname)s: %(message)s")
             handler = logging.StreamHandler()

sanic/exceptions.py

@@ -208,44 +208,39 @@ class Unauthorized(SanicException):
     """
     Unauthorized exception (401 HTTP status code).
 
+    :param message: Message describing the exception.
     :param scheme: Name of the authentication scheme to be used.
-    :param challenge: A dict containing values to add to the WWW-Authenticate
+
-        header that is generated. This is especially useful when dealing with
+    When present, kwargs is used to complete the WWW-Authentication header.
-        the Digest scheme. (optional)
 
     Examples::
 
         # With a Basic auth-scheme, realm MUST be present:
-        challenge = {"realm": "Restricted Area"}
+        raise Unauthorized("Auth required.", "Basic", realm="Restricted Area")
-        raise Unauthorized("Auth required.", "Basic", challenge)
 
         # With a Digest auth-scheme, things are a bit more complicated:
-        challenge = {
+        raise Unauthorized("Auth required.",
-            "realm": "Restricted Area",
+                           "Digest",
-            "qop": "auth, auth-int",
+                           realm="Restricted Area",
-            "algorithm": "MD5",
+                           qop="auth, auth-int",
-            "nonce": "abcdef",
+                           algorithm="MD5",
-            "opaque": "zyxwvu"
+                           nonce="abcdef",
-        }
+                           opaque="zyxwvu")
-        raise Unauthorized("Auth required.", "Digest", challenge)
 
-        # With a Bearer auth-scheme, realm is optional:
+        # With a Bearer auth-scheme, realm is optional so you can write:
-        challenge = {"realm": "Restricted Area"}
+        raise Unauthorized("Auth required.", "Bearer")
-        raise Unauthorized("Auth required.", "Bearer", challenge)
+
+        # or, if you want to specify the realm:
+        raise Unauthorized("Auth required.", "Bearer", realm="Restricted Area")
     """
-    pass
+    def __init__(self, message, scheme, **kwargs):
-
-    def __init__(self, message, scheme, challenge=None):
         super().__init__(message)
 
-        chal = ""
+        values = ["{!s}={!r}".format(k, v) for k, v in kwargs.items()]
-
+        challenge = ', '.join(values)
-        if challenge is not None:
-            values = ["{!s}={!r}".format(k, v) for k, v in challenge.items()]
-            chal = ', '.join(values)
 
         self.headers = {
-            "WWW-Authenticate": "{} {}".format(scheme, chal).rstrip()
+            "WWW-Authenticate": "{} {}".format(scheme, challenge).rstrip()
         }
 
 

tests/test_exceptions.py

@@ -33,18 +33,17 @@ def exception_app():
 
     @app.route('/401/basic')
     def handler_401_basic(request):
-        raise Unauthorized("Unauthorized", "Basic", {"realm": "Sanic"})
+        raise Unauthorized("Unauthorized", "Basic", realm="Sanic")
 
     @app.route('/401/digest')
     def handler_401_digest(request):
-        challenge = {
+        raise Unauthorized("Unauthorized",
-            "realm": "Sanic",
+                           "Digest",
-            "qop": "auth, auth-int",
+                           realm="Sanic",
-            "algorithm": "MD5",
+                           qop="auth, auth-int",
-            "nonce": "abcdef",
+                           algorithm="MD5",
-            "opaque": "zyxwvu",
+                           nonce="abcdef",
-        }
+                           opaque="zyxwvu")
-        raise Unauthorized("Unauthorized", "Digest", challenge)
 
     @app.route('/401/bearer')
     def handler_401_bearer(request):

tests/test_exceptions_handler.py

@@ -24,7 +24,7 @@ def handler_3(request):
 
 @exception_handler_app.route('/4')
 def handler_4(request):
-    foo = bar
+    foo = bar    # noqa -- F821 undefined name 'bar' is done to throw exception
     return text(foo)
 
 

tests/test_logging.py

@@ -1,5 +1,7 @@
-import asyncio
 import uuid
+from importlib import reload
+
+from sanic.config import LOGGING
 from sanic.response import text
 from sanic import Sanic
 from io import StringIO
@@ -10,6 +12,11 @@ function: %(funcName)s(); \
 message: %(message)s'''
 
 
+def reset_logging():
+    logging.shutdown()
+    reload(logging)
+
+
 def test_log():
     log_stream = StringIO()
     for handler in logging.root.handlers[:]:
@@ -32,5 +39,19 @@ def test_log():
     log_text = log_stream.getvalue()
     assert rand_string in log_text
 
+
+def test_default_log_fmt():
+
+    reset_logging()
+    Sanic()
+    for fmt in [h.formatter for h in logging.getLogger('sanic').handlers]:
+        assert fmt._fmt == LOGGING['formatters']['simple']['format']
+
+    reset_logging()
+    Sanic(log_config=None)
+    for fmt in [h.formatter for h in logging.getLogger('sanic').handlers]:
+        assert fmt._fmt == "%(asctime)s: %(levelname)s: %(message)s"
+
+
 if __name__ == "__main__":
     test_log()