Initializing (by setting to None)...

...the attributes: `expand.global_name_pattern` and
`expand.global_name_formatter`.

Plus several dosc updates/improvements/fixes...

Author: zuo

CHANGES.rst

@@ -1,14 +1,27 @@
 Changes
 =======
 
+Unreleased (to be updated...)
+-----------------------------
+
+* A minor interface usability fix: from now on, the **expand()**
+  decorator's attributes **global_name_pattern** and
+  **global_name_formatter** are both initially set to **None**
+  (previously, by default, they were not initialized at all, so
+  trying to get any of them without first setting it caused an
+  **AttributeError**).
+
+* Documentation: several updates and minor fixes/improvements.
+
+
 0.4.1 (2023-03-17)
 ------------------
 
-* Added the **unittest_expander.__version__** global constant.
+* Added the **__version__** constant to the **unittest_expander** module.
 
-* improvements and additions related to tests, CI, generation of
+* Improvements and additions related to tests, CI, generation of
   documentation, etc.; in particular: added a script that checks whether
-  *unittest_expander.__version__** is equal to **version** in package
+  **unittest_expander.__version__** is equal to **version** in package
   metadata, and added invocation of that script to the *Install and
   Test* GitHub workflow.
 
@@ -159,7 +172,7 @@ Changes
 ------------------
 
 * Improved signatures of the **foreach()** decorator and the
-  **paramseq** constructor: they take either exactly one positional
+  **paramseq()** constructor: they take either exactly one positional
   argument which must be a test parameter collection (as previously: a
   sequence/mapping/set or a **paramseq** instance, or a callable
   returning an iterable...), or *any number of positional and/or keyword
@@ -196,7 +209,7 @@ Changes
 0.1.2 (2014-08-01)
 ------------------
 
-* The signatures of the **foreach()** decorator and the **paramseq**
+* The signatures of the **foreach()** decorator and the **paramseq()**
   constructor have been unified.
 
 * Tests/documentation-related updates and improvements.

docs/reference.rst

@@ -4,10 +4,10 @@ Module Contents
 .. module:: unittest_expander
 
 The module :mod:`unittest_expander`'s public interface consists of the
-following functions and classes.
+following functions, classes and constants.
 
 (See: :doc:`narrative_documentation` -- for a much richer description of
-them, including a lot of usage examples...)
+most of them, including a lot of usage examples...)
 
 
 The :func:`expand` class decorator
@@ -38,8 +38,12 @@ The :func:`expand` class decorator
 
    .. attribute:: expand.global_name_pattern
 
+      :value: None
+
    .. attribute:: expand.global_name_formatter
 
+      :value: None
+
 
 The :func:`foreach` method/class decorator
 ------------------------------------------
@@ -248,3 +252,14 @@ The :class:`Substitute` class
    .. attribute:: actual_object
 
       The proxied object itself (unwrapped).
+
+
+The :data:`__version__` constant
+--------------------------------
+
+.. data:: __version__
+
+   The version of :mod:`unittest_expander` as a :pep:`440`-compliant
+   identifier.
+
+   :type: str

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = unittest_expander
-version = 0.4.1
+version = 0.4.2.dev0
 description = Easy and flexible unit test parametrization
 long_description = file: README.rst
 long_description_content_type = text/x-rst

unittest_expander.py

@@ -1748,6 +1748,14 @@
   Python standard library (or to any object whose :meth:`format`
   method acts similarily to :meth:`string.Formatter.format`).
 
+.. doctest::
+    :hide:
+
+    >>> expand.global_name_pattern is None
+    True
+    >>> expand.global_name_formatter is None
+    True
+
 For example:
 
 >>> expand.global_name_pattern = '{base_name}__parametrized_{count}'
@@ -2687,7 +2695,7 @@
     'Substitute',
 )
 
-__version__ = '0.4.1'
+__version__ = '0.4.2.dev0'
 
 
 _CLASS_TYPES = (type,) if _PY3 else (type, types.ClassType)
@@ -3039,6 +3047,9 @@ def expand(test_cls=None, **kwargs):
     _expand_test_methods(test_cls)
     return _expand_test_cls(test_cls, into)
 
+expand.global_name_pattern = None
+expand.global_name_formatter = None
+
 
 def _expand_test_methods(test_cls):
     attrs_to_substitute, attrs_to_add = _get_attrs_to_substitute_and_add(test_cls)