Allow to use the package with Python 3.11. (#223)

Caution: No security audit has been done so far as Python 3.11 does not
have a final version, yet.

This commit is a quick hack to get tests running:

Python 3.11 requires coverage >= 6 which is not supported by
coverage-python-version, so we cannot use it any longer resulting
in a drop of the coverage as Python 2 compatibility code no longer
gets excluded from coverage.

The only sane way to fix this mess is to drop Python 2 support.

Author: Michael Howitz

.github/workflows/tests.yml

@@ -29,6 +29,7 @@ jobs:
         - ["3.8",   "py38"]
         - ["3.9",   "py39"]
         - ["3.10",  "py310"]
+        - ["3.11.0-alpha.6",  "py311"]
         - ["3.9",   "docs"]
         - ["3.9",   "coverage"]
         - ["3.9",   "py39-datetime"]

.gitignore

@@ -28,4 +28,5 @@ lib64
 log/
 parts/
 pyvenv.cfg
+testing.log
 var/

.meta.toml

@@ -2,15 +2,15 @@
 # https://github.com/zopefoundation/meta/tree/master/config/pure-python
 [meta]
 template = "pure-python"
-commit-id = "886173bf647a6e80a985544c32053c932b1949e2"
+commit-id = "3a251aab94eff9cf2aa2fd87d7266593251e4b76"
 
 [python]
 with-pypy = false
 with-legacy-python = true
 with-docs = true
 with-sphinx-doctests = true
 with-windows = true
-with-future-python = false
+with-future-python = true
 
 [tox]
 use-flake8 = true
@@ -41,8 +41,6 @@ testenv-additional = [
     "deps =",
     "    coverage",
     "    coverage-python-version",
-    "    # Until repoze.sphinx.autointerface supports Sphinx 4.x we cannot use it:",
-    "    Sphinx < 4",
     "    -cconstraints.txt",
     "setenv =",
     "    COVERAGE_FILE=.coverage",

CHANGES.rst

@@ -4,7 +4,8 @@ Changes
 5.3 (unreleased)
 ----------------
 
-- Nothing changed yet.
+- Allow to use the package with Python 3.11 -- Caution: No security audit has
+  been done so far.
 
 
 5.2 (2021-11-19)

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+<!--
+Generated from:
+https://github.com/zopefoundation/meta/tree/master/config/pure-python
+--> 
+# Contributing to zopefoundation projects
+
+The projects under the zopefoundation GitHub organization are open source and
+welcome contributions in different forms:
+
+* bug reports
+* code improvements and bug fixes
+* documentation improvements
+* pull request reviews
+
+For any changes in the repository besides trivial typo fixes you are required
+to sign the contributor agreement. See
+https://www.zope.dev/developer/becoming-a-committer.html for details.
+
+Please visit our [Developer
+Guidelines](https://www.zope.dev/developer/guidelines.html) if you'd like to
+contribute code changes and our [guidelines for reporting
+bugs](https://www.zope.dev/developer/reporting-bugs.html) if you want to file a
+bug report.

MANIFEST.in

@@ -1,5 +1,6 @@
 # Generated from:
 # https://github.com/zopefoundation/meta/tree/master/config/pure-python
+include *.md
 include *.rst
 include *.txt
 include buildout.cfg

constraints.txt

@@ -3,8 +3,11 @@
 # Pin Versions / Version Ranges if necessary.
 isort >= 4.3.2
 # Needed for Appveyor as long as PY2 is supported:
-pytest < 5
-pytest-html < 2
+pytest < 5 ; python_version < '3.11'
+# Python 3.11 needs pytest > 5
+pytest >= 5 ; python_version >= '3.11'
 # coverage 6+ no longer supports Python 2 and coverage results of older
 # versions cannot not combined with newer ones:
-coverage < 6
+coverage < 6; python_version < '3.11'
+# Python 3.11 requires coverage >= 6,
+coverage >= 6; python_version >= '3.11'

setup.cfg

@@ -19,3 +19,14 @@ ignore =
     docs/_build/html/_sources/roadmap/*
     docs/_build/html/_sources/upgrade_dependencies/*
     docs/_build/html/_sources/usage/*
+
+[isort]
+force_single_line = True
+combine_as_imports = True
+sections = FUTURE,STDLIB,THIRDPARTY,ZOPE,FIRSTPARTY,LOCALFOLDER
+known_third_party = six, docutils, pkg_resources
+known_zope =
+known_first_party =
+default_section = ZOPE
+line_length = 79
+lines_after_imports = 2

setup.py

@@ -13,11 +13,11 @@
 ##############################################################################
 """Setup for RestrictedPython package"""
 
+import os
+
 from setuptools import find_packages
 from setuptools import setup
 
-import os
-
 
 def read(*rnames):
     with open(os.path.join(os.path.dirname(__file__), *rnames)) as f:
@@ -70,7 +70,7 @@ def read(*rnames):
     package_dir={'': 'src'},
     install_requires=[
     ],
-    python_requires=">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <3.11",  # NOQA: E501
+    python_requires=">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <3.12",  # NOQA: E501
     tests_require=tests_require,
     extras_require={
         'test': tests_require,

src/RestrictedPython/Eval.py

@@ -12,11 +12,11 @@
 ##############################################################################
 """Restricted Python Expressions."""
 
+import ast
+
 from ._compat import IS_PY2
 from .compile import compile_restricted_eval
 
-import ast
-
 
 if IS_PY2:  # pragma: PY2
     from string import maketrans