René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Misleading descriptions in the introduce of \"Template\"","articleBody":"# Documentation\n\u003eThe template can then be combined with functions that operate on the template’s structure to produce a [str](https://docs.python.org/3.14/library/stdtypes.html#str) or a string-like result. For example, sanitizing input:\n\n\u003e```evil = \"\u003cscript\u003ealert('evil')\u003c/script\u003e\"\n\u003etemplate = t\"\u003cp\u003e{evil}\u003c/p\u003e\"\n\u003eassert html(template) == \"\u003cp\u003e\u0026lt;script\u0026gt;alert('evil')\u0026lt;/script\u0026gt;\u003c/p\u003e\"\n\n\u003eAs another example, generating HTML attributes from data:\n\n\u003e```attributes = {\"src\": \"shrubbery.jpg\", \"alt\": \"looks nice\"}\n\u003etemplate = t\"\u003cimg {attributes}\u003e\"\n\u003eassert html(template) == '\u003cimg src=\"shrubbery.jpg\" alt=\"looks nice\" /\u003e'\n\n\u003eCompared to using an f-string, the html function has access to template attributes containing the original information: static strings, interpolations, and values from the original scope. Unlike existing templating approaches, t-strings build from the well-known f-string syntax and rules. Template systems thus benefit from Python tooling as they are much closer to the Python language, syntax, scoping, and more.\n\nIn [PEP-750](https://peps.python.org/pep-0750/), the author assumed that you had defined the function `html`:\n\u003eFor example, imagine we want to generate some HTML. Using template strings, we can define an html() function that allows us to automatically sanitize content:\n\n\u003e```evil = \"\u003cscript\u003ealert('evil')\u003c/script\u003e\"\n\u003etemplate = t\"\u003cp\u003e{evil}\u003c/p\u003e\"\n\u003eassert html(template) == \"\u003cp\u003e\u0026lt;script\u0026gt;alert('evil')\u0026lt;/script\u0026gt;\u003c/p\u003e\"\n\n\u003eLikewise, our hypothetical html() function can make it easy for developers to add attributes to HTML elements using a dictionary:\n\n\u003e```attributes = {\"src\": \"shrubbery.jpg\", \"alt\": \"looks nice\"}\n\u003etemplate = t\"\u003cimg {attributes} /\u003e\"\n\u003eassert html(template) == '\u003cimg src=\"shrubbery.jpg\" alt=\"looks nice\" /\u003e'\n\nHowever, in the document, the operation \"define\" was gone, so that some users will mistakenly think that there is a function `html` that has been defined.\n\nI think that it is better to explain that the function `html` should be defined by user, like this:\n\u003eThe template can then be combined with functions that operate on the template’s structure to produce a [str](https://docs.python.org/3.14/library/stdtypes.html#str) or a string-like result. For example, sanitizing input (assuming that you have defined a function `html` that can deal with the input to html):\n","author":{"url":"https://github.com/Locked-chess-official","@type":"Person","name":"Locked-chess-official"},"datePublished":"2025-07-26T15:30:39.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":6},"url":"https://github.com/137119/cpython/issues/137119"}