v4.0.x - Remove legacy python and add python3.8 support (#499)

* Drop support for legacy Python 2.7

* Upgrade Python syntax with pyupgrade --py3-plus

* Trim testing matrix to remove python2

* re-enable python3.8 in travis as tests that are not allowed to fail

* Remove some six

* The future is now

* Remove Python 2 imports

* Add back example, but change py27 to py36

* Remove redundant compat.py

* Blacken

* Credit hugovk in changelog

WIP Updating Sphinx Docs and AutoDoc

* Fix AutoDoc and update Sphinx theme to python_doc_theme

* Fix #420, autodoc even undocumented (docstring-less) method signatures

* Doc theme 'nature'. Add global TOC to doc sidebar

* Comment last reference to package six

* Changelog is now a consistent format

* Yet another documentation fix for links and title hierarchy

* Start work on new SVG logo

test SVG in README

trying to test new SVG logo in README

Apply centering

Apply readme logo centering

Trying to align image

Trying random shit

trying align right

add emoji

Large logo has higher priority

Change title hierarchy

Actually use a H1

Try again

try and organise badges

revert link back to point at master

* updated new take on VCR logo as SVG code

* Testing modern logo in docs

* Add sanitize for rendering SVG

* Switch to alabaster theme

* Update vcrpy logo (#503)

* Add credit for V4 logo changes.

* Add rewind and play animation

* Add svg into ReadTheDocs static assets so that it can be hosted so the animations work.

* Need to embedd the SVG for ReadTheDocs somewhere so I can get the link to later embed in the README

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Sean Bailey <sean@seanbailey.io>

tox.ini

@@ -3,8 +3,8 @@ skip_missing_interpreters=true
 envlist = 
   cov-clean,
   lint,
-  {py27,py35,py36,py37,py38,pypy,pypy3}-{requests,httplib2,urllib3,tornado4,boto3},
-  {py35,py36,py37,py38}-{aiohttp},
+  {py35,py36,py37,py38}-{requests,httplib2,urllib3,tornado4,boto3,aiohttp},
+  {pypy3}-{requests,httplib2,urllib3,tornado4,boto3},
   cov-report
 
 
@@ -34,6 +34,27 @@ deps =
   flake8 
   black
 
+[testenv:docs]
+# Running sphinx from inside the "docs" directory
+# ensures it will not pick up any stray files that might
+# get into a virtual environment under the top-level directory
+# or other artifacts under build/
+changedir = docs
+# The only dependency is sphinx
+# If we were using extensions packaged separately,
+# we would specify them here.
+# A better practice is to specify a specific version of sphinx.
+deps =
+    sphinx
+    sphinx_rtd_theme
+# This is the sphinx command to generate HTML.
+# In other circumstances, we might want to generate a PDF or an ebook
+commands =
+    sphinx-build -W -b html -d {envtmpdir}/doctrees . {envtmpdir}/html
+# We use Python 3.7. Tox sometimes tries to autodetect it based on the name of
+# the testenv, but "docs" does not give useful clues so we have to be explicit.
+basepython = python3.7
+
 [testenv]
 # Need to use develop install so that paths
 # for aggregate code coverage combine
@@ -51,17 +72,17 @@ deps =
     requests: requests>=2.22.0
     httplib2: httplib2
     urllib3: urllib3
-    {py27,py35,py36,pypy}-tornado4: tornado>=4,<5
-    {py27,py35,py36,pypy}-tornado4: pytest-tornado
-    {py27,py35,py36}-tornado4: pycurl
+    {py35,py36}-tornado4: tornado>=4,<5
+    {py35,py36}-tornado4: pytest-tornado
+    {py35,py36}-tornado4: pycurl
     boto3: boto3
     boto3: urllib3
     aiohttp: aiohttp
     aiohttp: pytest-asyncio
     aiohttp: pytest-aiohttp
 depends = 
-  {py27,py35,py36,py37,pypy}-{lint,requests,httplib2,urllib3,tornado4,boto3},{py35,py36,py37}-{aiohttp}: cov-clean
-  cov-report: {py27,py35,py36,py37,pypy}-{lint,requests,httplib2,urllib3,tornado4,boto3},{py35,py36,py37}-{aiohttp}
+  lint,{py35,py36,py37,py38,pypy3}-{requests,httplib2,urllib3,tornado4,boto3},{py35,py36,py37,py38}-{aiohttp}: cov-clean
+  cov-report: lint,{py35,py36,py37,py38,pypy3}-{requests,httplib2,urllib3,tornado4,boto3},{py35,py36,py37,py38}-{aiohttp}
 passenv =
     AWS_ACCESS_KEY_ID
     AWS_DEFAULT_REGION