메인 콘텐츠로 건너뛰기
TILNOTE

Python T-string과 템플릿 문자열 완벽 정리

S
Sunggyu Won
•조회수 22
요약

전통적인 파이썬 문자열 포매팅 방식

파이썬에서 문자열에 값을 넣는 방법으로 f-string, .format(), 그리고 string.Template 클래스가 있습니다. f-string은 코드가 간결하고 즉시 값이 들어가지만, 결과적으로 그냥 문자열만 남고 원래의 구조는 잃어버립니다. .format()은 파이썬 3.6 이전에도 쓸 수 있어 호환성이 높지만, 복잡한 템플릿일수록 가독성이 낮아집니다. string.Template은 보안에 강해 사용자 입력을 다룰 때 유용하지만, 사용법이 다소 불편하고 역시 구조 정보는 사라집니다.

T-string: 파이썬 3.14의 새로운 문자열 템플릿

파이썬 3.14부터 도입된 T-string 기능은 기존 f-string과 거의 동일한 문법을 사용하면서, 결과로 문자열 대신 템플릿 객체를 반환합니다. 이 객체는 문자열의 고정 부분과 값이 들어갈 자리(플레이스홀더), 그리고 그에 대한 정보를 모두 보존합니다. 즉, 템플릿 구조와 데이터가 분리되어 처리할 수 있습니다.

템플릿 객체의 내부 살펴보기

T-string을 사용하면 템플릿 객체 내에서 고정된 문자열과 변수 위치, 각 변수의 표현 방식 등 메타데이터를 따로 꺼내 볼 수 있습니다. 예를 들어, 문자열 부분만 혹은 변수와 그 값을 따로 조회하는 기능이 제공되어, 구조를 그대로 유지한 상태로 다양한 작업이 가능합니다.

T-string의 핵심 장점

T-string은 구조가 보존되기 때문에 텍스트와 데이터를 쉽게 분리할 수 있습니다. 데이터의 변환이나 포맷팅을 템플릿 객체에서 바로 처리할 수 있고, SQL 또는 HTML과 같이 보안이 중요한 곳에서 사용자 데이터 값을 안전하게 처리할 수 있습니다. 템플릿 자체를 번역하거나, 여러 값으로 반복 사용하며, 결과 문자열 생성 시점을 자유롭게 제어할 수도 있습니다.

T-string을 활용한 문자열 생성 예시

T-string을 이용해 템플릿을 다시 문자열로 만드는 과정은 기존 방식과 다릅니다. 템플릿 객체의 각 구성 요소(고정 문자/값 자리)를 순서대로 합치며, 이 때 별도의 가공(예: 형식 지정, 값 변환)을 추가할 수 있습니다.

from string.template_library import template

def build_template(tstring):
    values = []
    for i in tstring:
        if isinstance(i, str):
            values.append(i)
        else:
            values.append(i.do)
    return "".join(values)

이런 방식으로 원하는 문자열을 안전하게 만들 수 있습니다.

값 변환 및 포맷팅, 그리고 후처리

T-string은 값을 단순히 집어넣는 게 아니라, 필요한 경우 타입 변환(conversion)이나 포맷 적용도 손쉽게 할 수 있습니다. 예를 들어, 소수점 자리 지정이나 HTML/URL 인코딩, 값의 이스케이프 처리 등을 템플릿 객체 내에서 직접 적용할 수 있습니다.

from string.template_library import convert

def render_to_string(template):
    values = []
    for part in template:
        if isinstance(part, str):
            values.append(part)
        else:
            val = convert(part)
            if part.format_spec:
                val = format(val, part.format_spec)
            values.append(val)
    return "".join(values)

템플릿 후처리로 데이터 안전성 강화

T-string의 구조화 덕분에, 입력 데이터를 검증하거나 변환하는 함수를 별도 전달해 템플릿의 변수에만 적용할 수 있습니다. 실제로 HTML 이스케이프, URL 인코딩 등 다양한 보안 처리를 쉽게 넣을 수 있습니다. 웹 개발 등 사용자 입력이 직접적으로 HTML이나 SQL에 들어가는 상황에서 매우 유용합니다.

기존 string.Template와 T-string 객체 구별하기

파이썬에는 기존에도 string.Template라는 클래스가 있었지만, T-string 기능의 템플릿 객체는 역할이 다릅니다. 전자는 간단한 치환만 지원하는 반면, T-string은 더 풍부한 구조를 기억하며 변환과 검증 작업에 적합합니다. 모듈 이름과 클래스 이름이 유사하니 헷갈리지 않도록 주의하세요.

요약: T-string이 파이썬에 가져온 변화

새로운 T-string 기능은 파이썬에서 문자열과 데이터를 더 안전하고 유연하게 다루는 길을 열어줍니다. 전통적인 방식과 달리 텍스트의 구조와 값을 분리해 활용함으로써, 가독성, 보안, 재사용성에서 큰 이점을 제공합니다. 문자열 포매팅이 자주 필요한 개발 현장에서 특히 강력한 도구가 될 것입니다.

출처 및 참고 :

#파이썬 3.14#T-string#문자열 템플릿#보안#재사용성