Change to TBD

Author: davepeck

peps/pep-0750.rst

@@ -109,14 +109,14 @@ Template String Literals
 ------------------------
 
 This PEP introduces a new string prefix, ``t``, to define template string literals.
-These literals resolve to a new type, ``Template``, found in a new top-level 
-standard library module, ``templatelib``.
+These literals resolve to a new type, ``Template``, found in the standard library 
+module ``<<TBD>>``.
 
 The following code creates a ``Template`` instance:
 
 .. code-block:: python
 
-    from templatelib import Template
+    from TBD import Template
     template = t"This is a template string."
     assert isinstance(template, Template)
 
@@ -135,7 +135,7 @@ see the `Raw Template Strings`_ section below for more information.
 The ``Template`` Type
 ---------------------
 
-Template strings evaluate to an instance of a new type, ``templatelib.Template``:
+Template strings evaluate to an instance of a new type, ``<<TBD>>.Template``:
 
 .. code-block:: python
 
@@ -200,7 +200,7 @@ The ``Interpolation`` Type
 --------------------------
 
 The ``Interpolation`` type represents an expression inside a template string.
-Like ``Template``, it is a new class found in the ``templatelib`` module:
+Like ``Template``, it is a new class found in the ``<<TBD>>`` module:
 
 .. code-block:: python
 
@@ -318,7 +318,7 @@ interpolations in uppercase:
 
 .. code-block:: python
 
-    from templatelib import Template, Interpolation
+    from TBD import Template, Interpolation
 
     def lower_upper(template: Template) -> str:
         """Render static parts lowercased and interpolations uppercased."""
@@ -640,7 +640,7 @@ specifiers like ``:.2f``. The full code is fairly simple:
 
 .. code-block:: python
 
-    from templatelib import Template, Interpolation
+    from TBD import Template, Interpolation
 
     def convert(value: object, conv: Literal["a", "r", "s"] | None) -> object:
         if conv == "a":
@@ -713,7 +713,7 @@ We can implement an improved version of ``StructuredMessage`` using template str
 .. code-block:: python
 
     import json
-    from templatelib import Interpolation, Template
+    from TBD import Interpolation, Template
     from typing import Mapping
 
     class TemplateMessage:
@@ -770,7 +770,7 @@ and a ``ValuesFormatter`` for JSON output:
 
     import json
     from logging import Formatter, LogRecord
-    from templatelib import Interpolation, Template
+    from TBD import Interpolation, Template
     from typing import Any, Mapping
 
 
@@ -938,7 +938,7 @@ best practice for many template function implementations:
 
 .. code-block:: python
 
-    from templatelib import Template, Interpolation
+    from TBD import Template, Interpolation
 
     def process(template: Template) -> Any:
         for arg in template.args:
@@ -1314,13 +1314,19 @@ We rejected this in favor of the simpler approach of using plain ``str`` and
 allowing combination of ``r`` and ``t`` prefixes.
 
 
-Other Homes for ``Template`` and ``Interpolation``
---------------------------------------------------
+The Final Home for ``Template`` and ``Interpolation``
+-----------------------------------------------------
 
 Previous versions of this PEP proposed placing the ``Template`` and 
-``Interpolation`` types in the ``types`` module. Members of the Python core 
-team internally discussed the various options and ultimately decided to create 
-a new top-level standard library module, ``templatelib``. 
+``Interpolation`` types in: ``types``, ``collections``, ``collections.abc``,
+and even in a new top-level module, ``templatelib``. As of this writing, no core
+team consensus has emerged on the final location for these types. The current
+PEP leaves this open for a final decision.
+
+One argument in favor of a new top-level ``templatelib`` module is that it would 
+allow for future addition of related methods (like ``convert()`` and ``from_format_string()``) 
+and for potential future template processing code to be added to submodules 
+(``templatelib.shell``, etc.).
 
 
 Enable Full Reconstruction of Original Template Literal