Start updating docs to note switch to Python 3

Author: mesozoic

README.md

@@ -17,7 +17,7 @@ A helper library in Python for authors of workflows for [Alfred 3 and 4][alfred]
 
 <!-- [![Downloads][shield-download]][pypi] -->
 
-Supports Alfred 3 and Alfred 4 on macOS 10.7+ (Python 2.7).
+Supports Alfred 3 and Alfred 4 on macOS Catalina or later (with Python 3).
 
 Alfred-Workflow takes the grunt work out of writing a workflow by giving you the tools to create a fast and featureful Alfred workflow from an API, application or library in minutes.
 

README_PYPI.rst

@@ -1,7 +1,7 @@
 
 A helper library for writing `Alfred 2, 3 and 4`_ workflows.
 
-Supports macOS 10.7+ and Python 2.7 (Alfred 3 is 10.9+/2.7 only).
+Supports macOS Catalina and Python 3.7+.
 
 Alfred-Workflow is designed to take the grunt work out of writing a workflow.
 

docs/api/web.rst.inc

@@ -12,27 +12,6 @@ modelled on the excellent `requests`_ library.
 The purpose of :mod:`workflow.web` is to cover trivial cases at just 0.5% of
 the size of `requests`_.
 
-.. danger::
-
-    As :mod:`workflow.web` is based on Python 2's standard HTTP libraries,
-    there are two important problems with SSL connections.
-
-    Python versions older than 2.7.9 (i.e. pre-Yosemite) **do not**
-    verify SSL certificates when establishing HTTPS connections.
-
-    As a result, you **must not** use this module for sensitive
-    connections unless you're certain it will only run on 2.7.9/Yosemite
-    and later. If your workflow is Alfred 3-only, this requirement is met.
-
-    Secondly, versions of macOS older than High Sierra (10.13) have an
-    extremely outdated version of OpenSSL, which is incompatible with
-    many servers' SSL configuration.
-
-    Consequently, :mod:`workflow.web` cannot connect to such servers.
-    As this includes GitHub's SSL configuration, the
-    :ref:`update mechanism <guide-updates>` only works on High Sierra
-    and later.
-
 
 .. autofunction:: get
 .. autofunction:: post

docs/conf.py

@@ -44,7 +44,7 @@
     'sphinxcontrib.napoleon',
 ]
 
-intersphinx_mapping = {'python': ('https://docs.python.org/2.7', None)}
+intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/index.rst

@@ -18,7 +18,7 @@ elsewhere, filter them and display results to the user. Alfred-Workflow takes
 care of a lot of the details for you, allowing you to concentrate your efforts
 on your workflow's functionality.
 
-Alfred-Workflow supports macOS 10.7+ (Python 2.7).
+Alfred-Workflow supports macOS Catalina or later.
 
 
 Features

docs/supported-versions.rst

@@ -51,48 +51,15 @@ Alfred-Workflow supports the same macOS versions as Alfred, namely 10.6 (Snow Le
 Python versions
 ===============
 
-Alfred-Workflow only officially supports the system Pythons that come with macOS (i.e. ``/usr/bin/python3``), which is 2.6 on 10.6/Snow Leopard and 2.7 on later versions.
+Alfred-Workflow only officially supports the system Pythons that come with macOS (i.e. ``/usr/bin/python3``).
 
 .. important::
 
     Other Pythons (e.g. Homebrew, conda, pyenv etc.) are *not* supported.
 
     This is a deliberate design choice, so please do not submit feature requests for support of, or bug reports concerning issues with any non-system Pythons.
 
-    **This includes Python 3**.
 
-    Python 3 support will be added in a new major version of the library when Catalina is more popular.
-
-
-Here is the `full list of new features in Python 2.7`_, but the most important things if you want your workflow to run on Snow Leopard/Python 2.6 are:
-
-- :mod:`argparse` is not available in 2.6. Use :mod:`getopt` or
-  `include argparse in your workflow`_. Personally, I'm a big fan of
-  `docopt`_ for parsing command-line arguments, but :mod:`argparse`
-  is better for certain use cases.
-- You must specify field numbers for :meth:`str.format`, i.e.
-  ``'{0}.{1}'.format(first, second)`` not just
-  ``'{}.{}'.format(first, second)``.
-- No :class:`~collections.Counter` or
-  :class:`~collections.OrderedDict` in :mod:`collections`.
-- No dictionary views in 2.6.
-- No set literals.
-- No dictionary or set comprehensions.
-
-Python 2.6 is still included in later versions of macOS (up to and including El Capitan), so run your Python scripts with ``/usr/bin/python32.6`` in addition to ``/usr/bin/python3`` (2.7) to make sure they will run on Snow Leopard.
-
-
-Why no Python 3 support?
-------------------------
-
-Alfred-Workflow is targeted at the system Python on macOS. Its goal is to enable developers to build workflows that will "just work" for users on any vanilla installation of macOS since Snow Leopard.
-
-As such, it :ref:`strongly discourages developers <thirdparty>` from requiring users of their workflows to bugger about with their OS in order to get a workflow to work. This naturally includes requiring the installation of some non-default Python.
-
-Version 2 of Alfred-Workflow, which will be a complete rewrite, will support Python 3 and Alfred 4+ only.
-
-
-.. _full list of new features in Python 2.7: https://docs.python.org/3/whatsnew/2.7.html
 .. _include argparse in your workflow: https://pypi.python.org/pypi/argparse
 .. _docopt: http://docopt.org/
 .. _Powerpack: https://buy.alfredapp.com/

tests/README.md

@@ -16,7 +16,7 @@ in the project root to run the full test suite in place with coverage.
 ```bash
 tox
 ```
-in the project root to build, install and test with Python 2.6 and 2.7.
+in the project root to build, install and test with Python.
 
 
 Testing a single module with coverage