Fix test for UserWarning for older python versions; add note in docs

docs/quickstart.rst

@@ -233,11 +233,17 @@ When you need more flexibility in defining input schemas, you can pass a marshma
         last_name = fields.Str(missing='')
         date_registered = fields.DateTime(dump_only=True)
 
+        class Meta:
+            strict = True
 
-    @use_args(UserSchema)
+
+    @use_args(UserSchema())
     def profile_view(args):
         # ...
 
+.. note::
+    You should always set ``strict=True`` (either as a ``class Meta`` option or in the Schema's constructor) when passing a schema to webargs. This will ensure that the parser's error handler is invoked when expected.
+
 Next Steps
 ----------
 

setup.cfg

@@ -3,5 +3,5 @@ universal = 1
 
 [flake8]
 ignore = E127,E128,E265,E302,N803,N804,N806,E731,E402
-max-line-length = 95
+max-line-length = 100
 exclude = .git,.ropeproject,.tox,docs,.git,setup.py,compat.py,build

tests/test_core.py

@@ -444,7 +444,7 @@ class UserSchema(Schema):
     def test_passing_schema_to_parse(self, parser, web_request):
         web_request.json = {'id': 12, 'email': 'foo@bar.com', 'password': 'bar'}
 
-        result = parser.parse(self.UserSchema(), web_request)
+        result = parser.parse(self.UserSchema(strict=True), web_request)
 
         assert result == {'email': 'foo@bar.com', 'password': 'bar'}
 
@@ -466,9 +466,11 @@ def viewfunc(email, password):
             return {'email': email, 'password': password}
         assert viewfunc() == {'email': 'foo@bar.com', 'password': 'bar'}
 
-    def test_warning_raised_if_schema_is_not_in_strict_mode(self, web_request, parser):
-        with pytest.warns(UserWarning):
-            parser.parse(self.UserSchema(strict=False), web_request)
+    def test_warning_raised_if_schema_is_not_in_strict_mode(
+            self, web_request, parser, recwarn):
+        parser.parse(self.UserSchema(strict=False), web_request)
+        warning = recwarn.pop(UserWarning)
+        assert 'strict=True' in str(warning.message)
 
     def test_error_handler_is_called_when_regardless_of_schema_strict_setting(self,
             web_request, parser):

webargs/core.py

@@ -210,7 +210,7 @@ def load(self, data, argmap):
             schema = argmap2schema(argmap)()
         if not schema.strict:
             warnings.warn("It is highly recommended that you set strict=True on your schema "
-                    "so that the parser's error handler will get invoked.", UserWarning)
+                "so that the parser's error handler will be invoked when expected.", UserWarning)
 
         return schema.load(data)