Add many methods to the Mapping, Request and Response classes

build.py

@@ -1,5 +1,3 @@
-from __future__ import division, print_function, unicode_literals, with_statement
-
 import fnmatch
 import os
 import shlex

docs/conf.py

@@ -30,7 +30,7 @@
 
 # General information about the project.
 project = u'Pando'
-copyright = u'2016, Chad Whitacre et al.'
+copyright = u'2016, Chad Whitacre et al'  # RtD theme doubles the period
 
 # The full version, including alpha/beta/rc tags.
 release = open('../version.txt').read().strip()
@@ -50,7 +50,6 @@
 
 # -- Autodoc options
 
-autodoc_default_flags = ['members', 'undoc-members', 'special-members']
 autodoc_member_order = 'bysource'
 
 _autodoc_exclusions = {
@@ -107,10 +106,7 @@ def setup(app):
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'pando', u'Pando Documentation',
-     [u'Chad Whitacre et al.'], 1)
-]
+man_pages = []
 
 
 # -- Options for Texinfo output ------------------------------------------------

docs/reference.rst

@@ -4,4 +4,137 @@
 
 This is the API reference for the Pando library.
 
-.. automodule:: pando
+pando.body_parsers
+==================
+
+.. automodule:: pando.body_parsers
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.exceptions
+================
+
+.. automodule:: pando.exceptions
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.http
+==========
+
+.. automodule:: pando.http
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.http.baseheaders
+----------------------
+
+.. automodule:: pando.http.baseheaders
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.http.mapping
+------------------
+
+.. automodule:: pando.http.mapping
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.http.request
+------------------
+
+.. automodule:: pando.http.request
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.http.response
+-------------------
+
+.. automodule:: pando.http.response
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.logging
+=============
+
+.. automodule:: pando.logging
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.state_chain
+=================
+
+.. automodule:: pando.state_chain
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.testing
+=============
+
+.. automodule:: pando.testing
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.testing.client
+--------------------
+
+.. automodule:: pando.testing.client
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.testing.harness
+---------------------
+
+.. automodule:: pando.testing.harness
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.utils
+===========
+
+.. automodule:: pando.utils
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.website
+=============
+
+.. automodule:: pando.website
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:
+
+pando.wsgi
+==========
+
+.. automodule:: pando.wsgi
+    :members:
+    :undoc-members:
+    :special-members:
+    :show-inheritance:

docs/tutorial.rst

@@ -27,7 +27,7 @@ Step 3: Create a website root::
     (foo)$ mkdir www
     (foo)$ cd www
 
-Step 4: Create a web page, and start pando inside it::
+Step 4: Create a web page and start pando::
 
     (foo)$ echo Greetings, program! > index.html.spt
     (foo)$ python -m pando

pando/__init__.py

@@ -1,16 +1,4 @@
-"""
-.. automodule:: pando.body_parsers
-.. automodule:: pando.exceptions
-.. automodule:: pando.http
-.. automodule:: pando.logging
-.. automodule:: pando.state_chain
-.. automodule:: pando.testing
-.. automodule:: pando.utils
-.. automodule:: pando.website
-.. automodule:: pando.wsgi
-
-"""
-
+from http.cookies import Morsel
 from os.path import dirname, join
 import sys
 import pkg_resources
@@ -32,3 +20,7 @@
         __version__ = f.read()
 
 WINDOWS = sys.platform[:3] == 'win'
+
+if sys.version_info < (3, 8, 0):
+    # https://stackoverflow.com/q/50813091/2729778
+    Morsel._reserved['samesite'] = 'SameSite'

pando/body_parsers.py

@@ -1,8 +1,4 @@
-"""
-:mod:`body_parsers`
-===================
-
-This module contains Pando's built-in body parsers.
+"""This module contains Pando's built-in body parsers.
 
 Body parsers are optional ways to enable Pando to uniformly parse POST body
 content according to its supplied ``Content-Type``.

pando/exceptions.py

@@ -1,9 +1,4 @@
-"""
-:mod:`exceptions`
-=================
-
-Custom exceptions raised by Pando
-"""
+"""Custom exceptions raised by Pando"""
 
 from . import Response
 

pando/http/__init__.py

@@ -1,21 +1,4 @@
-"""
-:mod:`http`
-===========
-
-.. automodule:: pando.http.baseheaders
-    :inherited-members:
-    :show-inheritance:
-.. automodule:: pando.http.mapping
-    :inherited-members:
-    :show-inheritance:
-.. automodule:: pando.http.request
-    :inherited-members:
-    :show-inheritance:
-.. automodule:: pando.http.response
-
-"""
-
-
+#: Dict of HTTP status codes to strings.
 status_strings = {
     100: "Continue",
     101: "Switching Protocols",

pando/http/baseheaders.py

@@ -1,8 +1,3 @@
-"""
-:mod:`baseheaders`
-------------------
-"""
-
 from http.cookies import CookieError, SimpleCookie
 
 from .mapping import BytesMapping, CaseInsensitiveMapping