string.templatelib — 템플릿 문자열 지원#

이 모듈은 PEP 750에 정의된 템플릿 문자열(t-string)에 대한 지원을 제공합니다. 템플릿 문자열은 t 접두사를 사용하여 생성되며, 결합되기 전의 문자열 리터럴 부분과 보간된 값 모두에 대한 접근을 제공합니다.

사용 가능 여부: 템플릿 문자열은 STM32 기반 OpenMV Cam에서는 지원되지 않습니다. Alif 및 i.MX RT 기반 OpenMV Cam에서만 사용할 수 있습니다.

클래스#

class string.templatelib.Template(*args)#

템플릿 문자열을 나타냅니다. Template 객체는 일반적으로 t-string 구문(t"...")으로 생성되지만 생성자를 사용하여 직접 구성할 수도 있습니다.

strings#

보간 사이에 나타나는 문자열 리터럴의 튜플입니다.

interpolations#

보간된 표현식을 나타내는 Interpolation 객체의 튜플입니다.

values#

템플릿의 각 보간에서 value 속성을 담은 튜플을 반환하는 읽기 전용 속성입니다.

__iter__() → Iterator#

템플릿 내용을 순회하며, 나타나는 순서대로 문자열 부분과 Interpolation 객체를 산출합니다. 빈 문자열은 생략됩니다.

__add__(other: Template) → Template#

두 템플릿을 연결합니다. 두 템플릿의 문자열과 보간을 결합한 새로운 Template을 반환합니다.

예외 발생:

TypeError – other가 Template이 아닌 경우

문자열을 리터럴로 처리해야 하는지 보간으로 처리해야 하는지에 대한 모호함을 피하기 위해 str과의 템플릿 연결은 금지됩니다:

t1 = t"Hello "
t2 = t"World"
result = t1 + t2  # Valid

# TypeError: cannot concatenate str to Template
result = t1 + "World"
class string.templatelib.Interpolation(value: Any, expression: str = '', conversion: str | None = None, format_spec: str = '')#

템플릿 문자열 내의 보간된 표현식을 나타냅니다. 모든 인수는 키워드 인수로 전달할 수 있습니다.

value#

보간된 표현식의 평가된 값입니다.

expression#

템플릿 문자열에 나타난 그대로의 표현식의 문자열 표현입니다.

conversion#

변환 지정자('s' 또는 'r')가 있으면 그것이고, 없으면 None입니다. MicroPython은 'a' 변환을 지원하지 않는다는 점에 유의하세요.

format_spec#

형식 사양 문자열이 있으면 그것이고, 없으면 빈 문자열입니다.

템플릿 문자열 구문#

템플릿 문자열은 f-string과 동일한 구문을 사용하되 t 접두사를 붙입니다:

name = "World"
template = t"Hello {name}!"

# Access template components
print(template.strings)        # ('Hello ', '!')
print(template.values)         # ('World',)
print(template.interpolations[0].expression)  # 'name'

변환 지정자#

템플릿 문자열은 변환 지정자를 메타데이터로 저장합니다. f-string과 달리 변환은 자동으로 적용되지 않습니다:

value = "test"
t = t"{value!r}"
# t.interpolations[0].value == "test" (not repr(value))
# t.interpolations[0].conversion == "r"

처리 코드는 필요할 때 변환을 명시적으로 적용해야 합니다.

형식 사양#

형식 사양은 Interpolation 객체에 메타데이터로 저장됩니다. f-string과 달리 형식 지정은 자동으로 적용되지 않습니다:

pi = 3.14159
t = t"{pi:.2f}"
# t.interpolations[0].value == 3.14159 (not formatted)
# t.interpolations[0].format_spec == ".2f"

PEP 750에 따라 처리 코드가 형식 사양을 사용할 필요는 없지만, 존재할 경우에는 이를 존중하고 가능한 한 f-string 동작과 일치시켜야 합니다.

디버그 형식#

디버그 형식 {expr=}이 지원됩니다:

x = 42
t = t"{x=}"
# t.strings == ("x=", "")
# t.interpolations[0].expression == "x"
# t.interpolations[0].conversion == "r"

중요

PEP 750에 따라 f-string과 달리 템플릿 문자열은 변환이나 형식 사양을 자동으로 적용하지 않습니다. 이는 처리 코드가 이것들을 어떻게 다룰지 제어할 수 있도록 의도된 설계입니다. 처리 코드는 이러한 속성을 명시적으로 처리해야 합니다.

MicroPython은 format() 내장 함수를 제공하지 않습니다. 대신 str.format() 같은 문자열 형식 지정 메서드를 사용하세요.

사용 예제#

형식 지원 없는 기본 처리:

def simple_process(template):
    """Simple template processing"""
    parts = []
    for item in template:
        if isinstance(item, str):
            parts.append(item)
        else:
            parts.append(str(item.value))
    return "".join(parts)

형식 지원을 포함한 템플릿 처리:

from string.templatelib import Template, Interpolation

def convert(value, conversion):
    """Apply conversion specifier to value"""
    if conversion == "r":
        return repr(value)
    elif conversion == "s":
        return str(value)
    return value

def process_template(template):
    """Process template with conversion and format support"""
    result = []
    for part in template:
        if isinstance(part, str):
            result.append(part)
        else:  # Interpolation
            value = convert(part.value, part.conversion)
            if part.format_spec:
                # Apply format specification using str.format
                value = ("{:" + part.format_spec + "}").format(value)
            else:
                value = str(value)
            result.append(value)
    return "".join(result)

pi = 3.14159
name = "Alice"
t = t"{name!r}: {pi:.2f}"
print(process_template(t))
# Output: "'Alice': 3.14"

# Other format specifications work too
value = 42
print(process_template(t"{value:>10}"))  # "        42"
print(process_template(t"{value:04d}"))  # "0042"

HTML 이스케이프 예제:

def html_escape(value):
    """Escape HTML special characters"""
    if not isinstance(value, str):
        value = str(value)
    return value.replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;")

def safe_html(template):
    """Convert template to HTML-safe string"""
    result = []
    for part in template:
        if isinstance(part, str):
            result.append(part)
        else:
            result.append(html_escape(part.value))
    return "".join(result)

user_input = "<script>alert('xss')</script>"
t = t"User said: {user_input}"
print(safe_html(t))
# Output: "User said: &lt;script&gt;alert('xss')&lt;/script&gt;"

함께 보기#