nti.testing 3.1.0__tar.gz → 4.1.0__tar.gz

nti.testing-4.1.0/.pylintrc

@@ -0,0 +1,227 @@
+[MASTER]
+load-plugins=pylint.extensions.bad_builtin,
+   pylint.extensions.broad_try_clause,
+   pylint.extensions.check_elif,
+   pylint.extensions.code_style,
+   pylint.extensions.dict_init_mutate,
+   pylint.extensions.docstyle,
+   pylint.extensions.dunder,
+   pylint.extensions.comparison_placement,
+   pylint.extensions.confusing_elif,
+   pylint.extensions.for_any_all,
+   pylint.extensions.consider_refactoring_into_while_condition,
+   pylint.extensions.mccabe,
+   pylint.extensions.eq_without_hash,
+   pylint.extensions.redefined_variable_type,
+   pylint.extensions.overlapping_exceptions,
+   pylint.extensions.docparams,
+   pylint.extensions.private_import,
+   pylint.extensions.typing,
+
+#    pylint.extensions.set_membership,
+# wants you to turn ``foo in (1, 2)`` into ``foo in {1, 2}``;
+# but for small tuples, the former is actually more
+# performant.
+
+# magic_value wants you to not use arbitrary strings and numbers
+# inline in the code. But it's overzealous and has way too many false
+# positives. Trust people to do the most readable thing.
+#   pylint.extensions.magic_value
+
+# Empty comment would be good, except it detects blank lines within
+# a single comment block.
+#
+# Those are often used to separate paragraphs, like here.
+#   pylint.extensions.empty_comment,
+
+# consider_ternary_expression is a nice check, but is also overzealous.
+# Trust the human to do the readable thing.
+#    pylint.extensions.consider_ternary_expression,
+
+# redefined_loop_name tends to catch us with things like
+# for name in (a, b, c): name = name + '_column' ...
+#    pylint.extensions.redefined_loop_name,
+
+# This wants you to turn ``x in (1, 2)`` into ``x in {1, 2}``.
+# They both result in the LOAD_CONST bytecode, one a tuple one a
+# frozenset. In theory a set lookup using hashing is faster than
+# a linear scan of a tuple; but if the tuple is small, it can often
+# actually be faster to scan the tuple.
+#   pylint.extensions.set_membership,
+
+# Fix zope.cachedescriptors.property.Lazy; the property-classes doesn't seem to
+# do anything.
+# https://stackoverflow.com/questions/51160955/pylint-how-to-specify-a-self-defined-property-decorator-with-property-classes
+# For releases prior to 2.14.2, this needs to be a one-line, quoted string. After that,
+# a multi-line string.
+# - Make zope.cachedescriptors.property.Lazy look like a property;
+#   fixes pylint thinking it is a method.
+# - Run in Pure Python mode (ignore C extensions that respect this);
+#   fixes some issues with zope.interface, like IFoo.providedby(ob)
+#   claiming not to have the right number of parameters...except no, it does not.
+init-hook =
+    import astroid.bases
+    astroid.bases.POSSIBLE_PROPERTIES.add('Lazy')
+    astroid.bases.POSSIBLE_PROPERTIES.add('LazyOnClass')
+    astroid.bases.POSSIBLE_PROPERTIES.add('readproperty')
+    astroid.bases.POSSIBLE_PROPERTIES.add('non_overridable')
+    import os
+    os.environ['PURE_PYTHON'] = ("1")
+    # Ending on a quoted string
+    # breaks pylint 2.14.5 (it strips the trailing quote. This is
+    # probably because it tries to handle one-line quoted strings as well as multi-blocks).
+    # The parens around it fix the issue.
+
+
+[MESSAGES CONTROL]
+
+# Disable the message, report, category or checker with the given id(s). You
+# can either give multiple identifier separated by comma (,) or put this option
+# multiple time (only on the command line, not in the configuration file where
+# it should appear only once).
+# NOTE: comments must go ABOVE the statement. In Python 2, mixing in
+# comments disables all directives that follow, while in Python 3, putting
+# comments at the end of the line does the same thing (though Py3 supports
+# mixing)
+
+
+# invalid-name, ; We get lots of these, especially in scripts. should fix many of them
+# protected-access, ; We have many cases of this; legit ones need to be examinid and commented, then this removed
+# no-self-use, ; common in superclasses with extension points
+# too-few-public-methods, ; Exception and marker classes get tagged with this
+# exec-used, ; should tag individual instances with this, there are some but not too many
+# global-statement,     ; should tag individual instances
+# multiple-statements, ; "from gevent import monkey; monkey.patch_all()"
+# locally-disabled, ; yes, we know we're doing this. don't replace one warning with another
+# cyclic-import, ; most of these are deferred imports
+# too-many-arguments, ; these are almost always because that's what the stdlib does
+# redefined-builtin, ; likewise: these tend to be keyword arguments like len= in the stdlib
+# undefined-all-variable,     ; XXX: This crashes with pylint 1.5.4 on Travis (but not locally on Py2/3
+#     ; or landscape.io on Py3). The file causing the problem is unclear. UPDATE: identified and disabled
+#   that file.
+#   see https://github.com/PyCQA/pylint/issues/846
+# useless-suppression: the only way to avoid repeating it for specific statements everywhere that we
+#   do Py2/Py3 stuff is to put it here. Sadly this means that we might get better but not realize it.
+# duplicate-code: Yeah, the compatibility ssl modules are much the same
+# In pylint 1.8.0, inconsistent-return-statements are created for the wrong reasons.
+# This code raises it, even though there is only one return (the implicit ``return None`` is presumably
+# what triggers it):
+#  def foo():
+#    if baz:
+#      return 1
+# In Pylint 2dev1, needed for Python 3.7, we get spurious "useless return" errors:
+# @property
+# def foo(self):
+#   return None # generates useless-return
+# Pylint 2.4 adds import-outside-toplevel. But we do that a lot to defer imports because of patching.
+# Pylint 2.4 adds self-assigning-variable. But we do *that* to avoid unused-import when we
+# "export" the variable and dont have a __all__.
+# Pylint 2.6+ adds some python-3-only things that dont apply: raise-missing-from, super-with-arguments, consider-using-f-string, redundant-u-string-prefix
+# cyclic import is added because it pylint is spuriously detecting that
+# consider-using-assignment-expr wants you to transform things like:
+#   foo = get_foo()
+#   if foo: ...
+#
+# Into ``if (foo := get_foo()):``
+# But there are a *lot* of those. Trust people to do the right, most
+# readable, thing
+#
+# docstring-first-line-empty: That's actually our standard, based on Django.
+# XXX: unclear on the docstring warnings, missing-type-doc, missing-param-doc,
+# differing-param-doc, differing-type-doc (are the last two replacements for the first two?)
+#
+# They should be addressed, in general they are a good thing, but sometimes they are
+# unnecessary.
+disable=wrong-import-position,
+    wrong-import-order,
+    missing-docstring,
+    ungrouped-imports,
+    invalid-name,
+    too-few-public-methods,
+    global-statement,
+    locally-disabled,
+    too-many-arguments,
+    useless-suppression,
+    duplicate-code,
+    useless-object-inheritance,
+    import-outside-toplevel,
+    self-assigning-variable,
+    consider-using-f-string,
+    consider-using-assignment-expr,
+    use-dict-literal,
+    missing-type-doc,
+    missing-param-doc,
+    differing-param-doc,
+    differing-type-doc,
+    compare-to-zero,
+    docstring-first-line-empty,
+    too-many-try-statements,
+    redefined-variable-type,
+
+enable=consider-using-augmented-assign
+
+[FORMAT]
+max-line-length=100
+max-module-lines=1100
+
+[MISCELLANEOUS]
+# List of note tags to take in consideration, separated by a comma.
+#notes=FIXME,XXX,TODO
+# Disable that, we don't want them to fail the lint CI job.
+notes=
+
+[VARIABLES]
+
+dummy-variables-rgx=_.*
+init-import=true
+
+[TYPECHECK]
+
+# List of members which are set dynamically and missed by pylint inference
+# system, and so shouldnt trigger E1101 when accessed. Python regular
+# expressions are accepted.
+generated-members=REQUEST,acl_users,aq_parent,providedBy
+
+
+# Tells whether missing members accessed in mixin class should be ignored. A
+# mixin class is detected if its name ends with "mixin" (case insensitive).
+# XXX: deprecated in 2.14; replaced with ignored-checks-for-mixins.
+# The defaults for that value seem to be what we want
+#ignore-mixin-members=yes
+
+# List of classes names for which member attributes should not be checked
+# (useful for classes with attributes dynamically set). This can work
+# with qualified names.
+#ignored-classes=SSLContext, SSLSocket, greenlet, Greenlet, parent, dead
+
+
+# List of module names for which member attributes should not be checked
+# (useful for modules/projects where namespaces are manipulated during runtime
+# and thus existing member attributes cannot be deduced by static analysis. It
+# supports qualified module names, as well as Unix pattern matching.
+#ignored-modules=gevent._corecffi,gevent.os,os,greenlet,threading,gevent.libev.corecffi,gevent.socket,gevent.core,gevent.testing.support
+ignored-modules=psycopg2.errors
+
+[DESIGN]
+max-attributes=12
+max-parents=10
+# Bump complexity up one.
+max-complexity=11
+
+[BASIC]
+# Prospector turns ot unsafe-load-any-extension by default, but
+# pylint leaves it off. This is the proximal cause of the
+# undefined-all-variable crash.
+unsafe-load-any-extension = yes
+# This does not seem to work, hence the init-hook
+property-classes=zope.cachedescriptors.property.Lazy,zope.cachedescriptors.property.Cached
+
+[CLASSES]
+# List of interface methods to ignore, separated by a comma. This is used for
+# instance to not check methods defines in Zope's Interface base class.
+
+
+
+# Local Variables:
+# mode: conf
+# End:

nti.testing-4.1.0/.readthedocs.yml

@@ -0,0 +1,34 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Some things can only be configured on the RTD dashboard.
+# Those that we may have changed from the default include:
+
+# Analytics code:
+# Show Version Warning: False
+# Single Version: True
+
+# Required
+version: 2
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  builder: html
+  configuration: docs/conf.py
+
+# Set the version of Python and requirements required to build your
+# docs
+
+build:
+  # os is required for some reason
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

{nti.testing-3.1.0 → nti.testing-4.1.0}/CHANGES.rst

@@ -2,6 +2,23 @@
  Changes
 =========
 
+4.1.0 (2024-04-10)
+==================
+
+- Add support for, and require, testgres 1.10. This is needed because
+  they changed the signature for ``get_pg_version``.
+- Drop support for Python 3.8 and 3.9.
+
+
+4.0.0 (2023-10-24)
+==================
+
+- Add support for Python 3.10, 3.11 and 3.12.
+- Drop support for Python 2 and Python 3.6 and 3.7.
+- Add a layer for working with a ``testgres`` Postgres instance.
+- Add methods to the test base classes to support ``unittest.mock`` patches.
+
+
 3.1.0 (2021-09-08)
 ==================
 

nti.testing-4.1.0/COPYRIGHT.txt

@@ -0,0 +1,2 @@
+Copyright (c) 2011-2022 NextThought, LLC
+Copyright (c) 2023 Jason Madden

nti.testing-4.1.0/LICENSE

@@ -0,0 +1,11 @@
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this software except in compliance with the License.
+You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

{nti.testing-3.1.0 → nti.testing-4.1.0}/MANIFEST.in

@@ -12,6 +12,10 @@ recursive-include src *.txt
 recursive-include src *.py
 
 include *.txt
+include *.yml
 include .isort.cfg
+include .pylintrc
+include .readthedocs.yml
 recursive-include docs *.py
 recursive-include docs *.rst
+recursive-include docs *.css

{nti.testing-3.1.0 → nti.testing-4.1.0}/PKG-INFO

@@ -1,31 +1,51 @@
 Metadata-Version: 2.1
 Name: nti.testing
-Version: 3.1.0
+Version: 4.1.0
 Summary: Support for testing code
-Home-page: https://github.com/NextThought/nti.testing
+Home-page: https://github.com/OpenNTI/nti.testing
 Author: Jason Madden
 Author-email: jason@nextthought.com
 License: Apache
 Project-URL: Documentation, https://ntitesting.readthedocs.io/en/latest/
 Keywords: nose2 testing zope3 ZTK hamcrest
-Platform: UNKNOWN
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Testing
 Classifier: Framework :: Zope3
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: ZODB>=5.6.0
+Requires-Dist: zope.interface>=5.4.0
+Requires-Dist: pyhamcrest
+Requires-Dist: six
+Requires-Dist: setuptools
+Requires-Dist: transaction
+Requires-Dist: zope.component
+Requires-Dist: zope.configuration
+Requires-Dist: zope.dottedname
+Requires-Dist: zope.exceptions
+Requires-Dist: zope.schema
+Requires-Dist: zope.testing
 Provides-Extra: test
+Requires-Dist: Acquisition; extra == "test"
+Requires-Dist: zope.site; extra == "test"
+Requires-Dist: zope.testrunner; extra == "test"
+Requires-Dist: testgres>=1.10; extra == "test"
+Requires-Dist: psycopg2-binary; platform_python_implementation != "PyPy" and extra == "test"
 Provides-Extra: docs
-License-File: LICENSE
+Requires-Dist: Sphinx; extra == "docs"
+Requires-Dist: furo; extra == "docs"
+Provides-Extra: testgres
+Requires-Dist: testgres>=1.10; extra == "testgres"
+Requires-Dist: psycopg2-binary; platform_python_implementation != "PyPy" and extra == "testgres"
 
 =============
  nti.testing
@@ -61,8 +81,9 @@ Installation
 nti.testing can be installed using pip, either from the git repository
 or from PyPI::
 
-  pip install nti.testing
+  pip install nti.testing[testgres]
 
+Use the ``testgres`` extra to be able to use `nti.testing.layers.postgres`.
 
 PyHamcrest
 ==========
@@ -208,7 +229,7 @@ Test Fixtures
 
 Support for test fixtures can be found in `nti.testing.base` and
 `nti.testing.layers`. The ``base`` package includes fully-fleshed
-out base classes for direct use, while the ``layers`` package includes
+out base classes for direct use, while the ``layers`` package mostly includes
 mixins that can be used to construct your own test layers.
 
 The ``base`` package makes a distinction between "normal" and "shared"
@@ -280,6 +301,23 @@ ZODB in `nti.testing.zodb`. See the API documentation for details.
  Changes
 =========
 
+4.1.0 (2024-04-10)
+==================
+
+- Add support for, and require, testgres 1.10. This is needed because
+  they changed the signature for ``get_pg_version``.
+- Drop support for Python 3.8 and 3.9.
+
+
+4.0.0 (2023-10-24)
+==================
+
+- Add support for Python 3.10, 3.11 and 3.12.
+- Drop support for Python 2 and Python 3.6 and 3.7.
+- Add a layer for working with a ``testgres`` Postgres instance.
+- Add methods to the test base classes to support ``unittest.mock`` patches.
+
+
 3.1.0 (2021-09-08)
 ==================
 
@@ -375,5 +413,3 @@ ZODB in `nti.testing.zodb`. See the API documentation for details.
 - Add Python 3 support.
 
 - Initial PyPI release.
-
-

{nti.testing-3.1.0 → nti.testing-4.1.0}/README.rst

@@ -32,8 +32,9 @@ Installation
 nti.testing can be installed using pip, either from the git repository
 or from PyPI::
 
-  pip install nti.testing
+  pip install nti.testing[testgres]
 
+Use the ``testgres`` extra to be able to use `nti.testing.layers.postgres`.
 
 PyHamcrest
 ==========
@@ -179,7 +180,7 @@ Test Fixtures
 
 Support for test fixtures can be found in `nti.testing.base` and
 `nti.testing.layers`. The ``base`` package includes fully-fleshed
-out base classes for direct use, while the ``layers`` package includes
+out base classes for direct use, while the ``layers`` package mostly includes
 mixins that can be used to construct your own test layers.
 
 The ``base`` package makes a distinction between "normal" and "shared"

nti.testing-4.1.0/docs/_static/custom.css

@@ -0,0 +1,95 @@
+/* Font definitions */
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Bold-Italic.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Bold-Italic.woff') format('woff');
+  font-weight: 700;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Bold.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Bold.woff') format('woff');
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-ExtraBold-Italic.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-ExtraBold-Italic.woff') format('woff');
+  font-weight: 800;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-ExtraBold.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-ExtraBold.woff') format('woff');
+  font-weight: 800;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Italic.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Italic.woff') format('woff');
+  font-weight: 400;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Medium-Italic.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Medium-Italic.woff') format('woff');
+  font-weight: 500;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Medium.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Medium.woff') format('woff');
+  font-weight: 500;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff2/JetBrainsMono-Regular.woff2') format('woff2'),
+    url('https://cdn.jsdelivr.net/gh/JetBrains/JetBrainsMono/web/woff/JetBrainsMono-Regular.woff') format('woff');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+
+article {
+/* Furo theme makes this 1.5 which uses soo much space */
+    line-height: 1.1;
+}
+
+.admonition-opinion p.admonition-title {
+    background-color: rgba(255, 150, 235, 0.44);
+}
+
+div.admonition-opinion.admonition {
+    border-left: .2rem solid rgba(255, 150, 235, 0.44);
+}
+
+
+.admonition-design-options p.admonition-title {
+    background-color: rgba(173, 28, 237, 0.44);
+}
+
+div.admonition-design-options.admonition {
+    border-left: .2rem solid rgba(173, 28, 237, 0.44);
+}

{nti.testing-3.1.0 → nti.testing-4.1.0}/docs/conf.py

@@ -36,9 +36,11 @@ rqmt = pkg_resources.require('nti.testing')[0]
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
+    'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.todo',
     'sphinx.ext.viewcode',
-    'sphinx.ext.doctest',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -55,7 +57,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'nti.testing'
-copyright = u'2017, NextThought'
+copyright = u'2017, NextThought, 2023 Jason Madden'
 author = u'NextThought'
 
 # The version info for the project you're documenting, acts as replacement for
@@ -72,7 +74,7 @@ release = rqmt.version
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -93,7 +95,24 @@ default_role = 'obj'
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_rtd_theme'
+# furo: A customizable theme. Intended for smaller datasets, so if we
+# grow too large we may want something different, like
+# sphinx_book_theme.
+#
+# Theme gallery:https://sphinx-themes.org/
+# Furo docs:See https://pradyunsg.me/furo/
+# With Furo, we don't need to have individual ``.. contents::`` directives;
+# if we move away from it we might want to add them back.
+html_theme = 'furo'
+html_css_files = [
+    'custom.css',
+]
+html_theme_options = {
+    'light_css_variables': {
+        'font-stack': '"SF Pro",-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji"',
+        'font-stack--monospace': '"JetBrainsMono", "JetBrains Mono", "JetBrains Mono Regular", "JetBrainsMono-Regular", ui-monospace, profont, monospace',
+    },
+}
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -168,15 +187,16 @@ texinfo_documents = [
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    'https://docs.python.org/': None,
-    'https://zopecomponent.readthedocs.io/en/latest': None,
-    'https://zopeconfiguration.readthedocs.io/en/latest': None,
-    'https://zopeexceptions.readthedocs.io/en/latest': None,
-    'https://zopeschema.readthedocs.io/en/latest': None,
-    'https://zopeinterface.readthedocs.io/en/latest': None,
-    'https://zodb-docs.readthedocs.io/en/latest': None,
+    'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
+    'python': ('http://docs.python.org/', None,),
+    'sqlalchemy': ('https://docs.sqlalchemy.org', None,),
+    'zopecomponent': ('https://zopecomponent.readthedocs.io/en/latest', None,),
+    'zopeconfiguration': ('https://zopeconfiguration.readthedocs.io/en/latest', None,),
+    'zopeexceptions': ('https://zopeexceptions.readthedocs.io/en/latest', None,),
+    'zopeschema': ('https://zopeschema.readthedocs.io/en/latest', None,),
+    'zopeinterface': ('https://zopeinterface.readthedocs.io/en/latest', None,),
+    'zodb': ('https://zodb-docs.readthedocs.io/en/latest', None,),
 }
-
 extlinks = {
     'issue': ('https://github.com/NextThought/nti.testing/issues/%s',
               'issue #'),
@@ -189,6 +209,7 @@ extlinks = {
 autodoc_default_options = {
     'members': None,
     'show-inheritance': None,
+    'special-members': '__enter__, __exit__',
 }
 #autodoc_member_order = 'groupwise'
 autoclass_content = 'both'

nti.testing-4.1.0/docs/layers.rst

@@ -0,0 +1,10 @@
+====================
+ nti.testing.layers
+====================
+
+.. automodule:: nti.testing.layers
+   :ignore-module-all:
+
+.. automodule:: nti.testing.layers.zope
+.. automodule:: nti.testing.layers.cleanup
+.. automodule:: nti.testing.layers.postgres