Python 3.14 t-string Nedir? Template String Literals Rehberi (2026)

t-string Temel Örnek (Basic t-string Example)

# Python 3.14 t-string kullanımı
isim = "Mahmut"
mesaj = t"Merhaba {isim}, hoş geldin!"

# mesaj artık bir str değil, Template nesnesi!
print(type(mesaj))  # <class 'Template'>

# Template'in parçalarına erişebilirsiniz
print(mesaj.strings)        # ('Merhaba ', ', hoş geldin!')
print(mesaj.interpolations)  # (Interpolation('isim', 'Mahmut', ''),)

Karşılaştırma Tablosu (Comparison Table)

Pratik Fark (Practical Difference)

kullanici = "<script>alert('hack')</script>"

# f-string: TEHLİKELİ! ❌
html_f = f"<div>{kullanici}</div>"
# Çıktı: <div><script>alert('hack')</script></div>

# t-string: GÜVENLİ! ✅
html_t = t"<div>{kullanici}</div>"
# Template nesnesi — henüz string değil
# İşleyici fonksiyon ile escape edebilirsiniz

Template Nesnesi Yapısı (Template Object Structure)

from string.templatelib import Template, Interpolation

isim = "Alesta"
yas = 10

# t-string oluştur
tpl = t"Firma: {isim}, Yaş: {yas}"

# Template nesnesinin özellikleri
print(tpl.strings)
# ('Firma: ', ', Yaş: ', '')

print(tpl.interpolations)
# (Interpolation('isim', 'Alesta', ''),
#  Interpolation('yas', 10, ''))

# Her Interpolation nesnesinde:
# - .expression: kaynak koddaki ifade ('isim')
# - .value: gerçek değer ('Alesta')
# - .conversion: format spec ('')

Özel İşleyici Fonksiyon (Custom Processor Function)

from string.templatelib import Template

def html_escape(tpl: Template) -> str:
    """t-string'i HTML-safe string'e dönüştürür"""
    import html
    parts = []
    for i, s in enumerate(tpl.strings):
        parts.append(s)
        if i < len(tpl.interpolations):
            value = tpl.interpolations[i].value
            # Değeri HTML escape et
            parts.append(html.escape(str(value)))
    return "".join(parts)

# Kullanım
kullanici_adi = '<b>Mahmut</b> & "arkadaşları"'
sonuc = html_escape(t"Hoş geldin {kullanici_adi}!")
print(sonuc)
# Hoş geldin &lt;b&gt;Mahmut&lt;/b&gt; &amp; &quot;arkadaşları&quot;!

Örnek 1: Loglama Sistemi (Logging System)

from string.templatelib import Template
import json

def structured_log(tpl: Template) -> dict:
    """t-string'den yapılandırılmış log oluşturur"""
    message_parts = []
    context = {}

    for i, s in enumerate(tpl.strings):
        message_parts.append(s)
        if i < len(tpl.interpolations):
            interp = tpl.interpolations[i]
            message_parts.append(str(interp.value))
            # Her değişkeni context'e ekle
            context[interp.expression] = interp.value

    return {
        "message": "".join(message_parts),
        "context": context
    }

user_id = 42
action = "login"
ip = "192.168.1.1"

log = structured_log(t"Kullanıcı {user_id} {action} yaptı, IP: {ip}")
print(json.dumps(log, indent=2, ensure_ascii=False))
# {
#   "message": "Kullanıcı 42 login yaptı, IP: 192.168.1.1",
#   "context": {"user_id": 42, "action": "login", "ip": "192.168.1.1"}
# }

Örnek 2: Çok Dilli Mesaj Sistemi (i18n System)

from string.templatelib import Template

translations = {
    "tr": {"greeting": "Merhaba {name}, {count} yeni mesajın var!"},
    "en": {"greeting": "Hello {name}, you have {count} new messages!"},
}

def i18n_render(tpl: Template, lang: str = "tr") -> str:
    """t-string ile çoklu dil desteği"""
    # Değişkenleri topla
    values = {}
    for interp in tpl.interpolations:
        values[interp.expression] = interp.value

    # Hedef dildeki şablonu al ve formatla
    template_key = "greeting"  # Gerçek projede otomatik tespit
    return translations[lang][template_key].format(**values)

name = "Mahmut"
count = 5
mesaj = t"Merhaba {name}, {count} yeni mesajın var!"

print(i18n_render(mesaj, "tr"))  # Merhaba Mahmut, 5 yeni mesajın var!
print(i18n_render(mesaj, "en"))  # Hello Mahmut, you have 5 new messages!

Güvenli SQL Sorgusu (Safe SQL Query Builder)

from string.templatelib import Template

def safe_sql(tpl: Template) -> tuple[str, list]:
    """t-string'den parametrize SQL sorgusu oluşturur"""
    sql_parts = []
    params = []

    for i, s in enumerate(tpl.strings):
        sql_parts.append(s)
        if i < len(tpl.interpolations):
            sql_parts.append("?")  # Parametre placeholder
            params.append(tpl.interpolations[i].value)

    return "".join(sql_parts), params

# Kullanım — f-string kadar kolay, ama GÜVENLİ!
kullanici_id = 42
durum = "aktif"

sql, params = safe_sql(t"SELECT * FROM users WHERE id = {kullanici_id} AND status = {durum}")
print(sql)     # SELECT * FROM users WHERE id = ? AND status = ?
print(params)  # [42, 'aktif']

# Kötü niyetli giriş denemesi
hack = "1; DROP TABLE users; --"
sql2, params2 = safe_sql(t"SELECT * FROM users WHERE id = {hack}")
print(sql2)     # SELECT * FROM users WHERE id = ?
print(params2)  # ["1; DROP TABLE users; --"]  — güvenli parametre olarak

HTML Template Engine (Mini HTML Templating)

from string.templatelib import Template
import html

def render_html(tpl: Template) -> str:
    """XSS-safe HTML render"""
    parts = []
    for i, s in enumerate(tpl.strings):
        parts.append(s)  # Statik HTML — güvenli
        if i < len(tpl.interpolations):
            value = tpl.interpolations[i].value
            # Kullanıcı verisini escape et
            parts.append(html.escape(str(value)))
    return "".join(parts)

# Blog yazısı render
baslik = 'Python 3.14 & t-string "Rehberi"'
yazar = "<script>alert('xss')</script>"
tarih = "2026-04-04"

sayfa = render_html(t"""
<article>
    <h1>{baslik}</h1>
    <p class="meta">Yazar: {yazar} | Tarih: {tarih}</p>
    <div class="content">İçerik burada...</div>
</article>
""")
print(sayfa)
# Tüm tehlikeli karakterler escape edilmiş olacak ✅

? Deferred Annotation Evaluation (PEP 649)

# Python 3.14 öncesi: annotation'lar hemen evaluate edilirdi
# Bu, forward reference sorunlarına neden oluyordu

# Python 3.14 sonrası: annotation'lar lazy evaluate ediliyor
class Dugum:
    def __init__(self, deger: int, sonraki: "Dugum | None" = None):
        self.deger = deger
        self.sonraki = sonraki

    # Artık tırnak işareti gerekmez!
    def bagla(self, sonraki: Dugum) -> None:  # ✅ Doğrudan çalışır
        self.sonraki = sonraki

? concurrent.interpreters Modülü

from concurrent.interpreters import Interpreter

# Her interpreter'ın kendi GIL'i var!
interp = Interpreter()
interp.exec("print('Merhaba bağımsız interpreter!')")
# Gerçek paralel Python çalışması — GIL kısıtlaması yok

? compression.zstd — Zstandard Sıkıştırma

import compression.zstd as zstd

# Zstandard ile sıkıştır (gzip'ten 3-5x daha hızlı)
veri = b"Python 3.14 t-string template string literals " * 1000
sikistirilmis = zstd.compress(veri)
print(f"Orijinal: {len(veri)} byte")
print(f"Sıkıştırılmış: {len(sikistirilmis)} byte")
print(f"Oran: {len(sikistirilmis)/len(veri):.1%}")

? Yeni UUID Fonksiyonları ve REPL İyileştirmeleri

import uuid

# Yeni UUID versiyonları (RFC 9562)
print(uuid.uuid6())  # Zaman bazlı, sıralı
print(uuid.uuid7())  # Unix timestamp bazlı — ÖNERİLEN
print(uuid.uuid8())  # Özel amaçlı

# Python 3.14 REPL artık syntax highlighting destekliyor!
# Terminal'de renkli kod yazma deneyimi ?

Benchmark Sonuçları (Benchmark Results)

import timeit

# f-string benchmark
f_time = timeit.timeit(
    'f"Merhaba {isim}, yaşın {yas}"',
    setup='isim="Test"; yas=25',
    number=1_000_000
)

# t-string benchmark (sadece Template oluşturma)
t_time = timeit.timeit(
    't"Merhaba {isim}, yaşın {yas}"',
    setup='isim="Test"; yas=25',
    number=1_000_000
)

print(f"f-string: {f_time:.3f}s")   # ~0.08s
print(f"t-string: {t_time:.3f}s")   # ~0.12s
print(f"Fark: {((t_time/f_time)-1)*100:.1f}% daha yavaş")
# t-string yaklaşık %40-50 daha yavaş — AMA...

Adım 1: Python 3.14 Kurulumu

# pyenv ile kurulum (önerilen)
pyenv install 3.14.3
pyenv local 3.14.3

# Veya doğrudan indirme
# https://www.python.org/downloads/release/python-3143/

# Sürüm kontrolü
python --version
# Python 3.14.3

Adım 2: Güvenlik Açıklarını Tespit Et

# Projenizde f-string ile SQL/HTML oluşturulan yerleri bulun
# Bu satırları t-string'e çevirin

# ÖNCESİ (tehlikeli) ❌
query = f"SELECT * FROM users WHERE name = '{user_input}'"

# SONRASI (güvenli) ✅
query_tpl = t"SELECT * FROM users WHERE name = {user_input}"
query, params = safe_sql(query_tpl)

Adım 3: Kademeli Geçiş Stratejisi

# 1. Önce güvenlik kritik noktaları (SQL, HTML) geçirin
# 2. Sonra loglama sistemini geçirin
# 3. En son genel string formatting'i geçirin

# Geriye uyumlu wrapper fonksiyonu
def compat_render(tpl) -> str:
    """Hem Template hem str kabul eder"""
    if isinstance(tpl, str):
        return tpl  # Eski kod — olduğu gibi
    # Template nesnesi — güvenli render
    return render_template(tpl)