diff --git a/Lib/string/templatelib.py b/Lib/string/templatelib.py
index 14b40e1e36e30b..8164872432ad09 100644
--- a/Lib/string/templatelib.py
+++ b/Lib/string/templatelib.py
@@ -1,15 +1,22 @@
"""Support for template string literals (t-strings)."""
-__all__ = [
- "Interpolation",
- "Template",
-]
-
t = t"{0}"
Template = type(t)
Interpolation = type(t.interpolations[0])
del t
+def convert(obj, /, conversion):
+ """Convert *obj* using formatted string literal semantics."""
+ if conversion is None:
+ return obj
+ if conversion == 'r':
+ return repr(obj)
+ if conversion == 's':
+ return str(obj)
+ if conversion == 'a':
+ return ascii(obj)
+ raise ValueError(f'invalid conversion specifier: {conversion}')
+
def _template_unpickle(*args):
import itertools
diff --git a/Lib/test/test_string/test_templatelib.py b/Lib/test/test_string/test_templatelib.py
index adaf590e64dad6..1c86717155fd5a 100644
--- a/Lib/test/test_string/test_templatelib.py
+++ b/Lib/test/test_string/test_templatelib.py
@@ -1,7 +1,7 @@
import pickle
import unittest
from collections.abc import Iterator, Iterable
-from string.templatelib import Template, Interpolation
+from string.templatelib import Template, Interpolation, convert
from test.test_string._support import TStringBaseCase, fstring
@@ -169,5 +169,25 @@ def test_exhausted(self):
self.assertRaises(StopIteration, next, template_iter)
+class TestFunctions(unittest.TestCase):
+ def test_convert(self):
+ from fractions import Fraction
+
+ for obj in ('Café', None, 3.14, Fraction(1, 2)):
+ with self.subTest(f'{obj=}'):
+ self.assertEqual(convert(obj, None), obj)
+ self.assertEqual(convert(obj, 's'), str(obj))
+ self.assertEqual(convert(obj, 'r'), repr(obj))
+ self.assertEqual(convert(obj, 'a'), ascii(obj))
+
+ # Invalid conversion specifier
+ with self.assertRaises(ValueError):
+ convert(obj, 'z')
+ with self.assertRaises(ValueError):
+ convert(obj, 1)
+ with self.assertRaises(ValueError):
+ convert(obj, object())
+
+
if __name__ == '__main__':
unittest.main()
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy