django-routines-tr 1.0.9

Reusable Django routines: middleware and i18n helpers.

django-routines-tr

Django projeleri için tekrar kullanılabilir middleware, authentication backend ve yardımcı altyapı rutinleri.

Dil yönlendirmesi, admin erişim kontrolü, çok dilli slug yönetimi, e-posta ile giriş ve görsel sıkıştırma gibi tekrar eden altyapı kodlarını azaltmak için tasarlanmış, hafif ve production odaklı yardımcı araçlar içerir.

---

Özellikler

• Dil duyarlı yönlendirme middleware’i
• Admin erişim güvenlik middleware’i
• Çok dilli slug üretimi (LANGUAGES’a göre otomatik slug set etme)
• Çok dilli slug yönlendirme yardımcı fonksiyonu
• Türkçe karakter uyumlu slugify fonksiyonu
• E-posta ile giriş (authentication backend)
• Model ImageField görsellerini otomatik WEBP’e çevirme ve sıkıştırma yardımcı fonksiyonu

---

Kurulum

pip install django-routines-tr

Not: Görsel sıkıştırma yardımcıları için Pillow gereklidir. Paket bağımlılıkları içinde otomatik kurulur.

---

Middleware Kullanımı

settings.py dosyanıza middleware’leri ekleyin:

MIDDLEWARE = [
    ...
    "django_routines.middleware.language_redirect.LanguageRedirectMiddleware",
    "django_routines.middleware.admin_redirect.AdminRedirectMiddleware",
]

LanguageRedirectMiddleware

• URL’leri aktif dile göre otomatik olarak prefixler
• Static ve media yollarını hariç tutar
• settings.LANGUAGES ayarını dikkate alır
• Çift dil prefix oluşumunu engeller

AdminRedirectMiddleware

• /admin/ paneline sadece superuser erişimine izin verir
• Yetkisiz erişimlerde HTTP 404 döner
• Admin panelinin ifşa edilmesini azaltmaya yardımcı olur

---

Authentication

EmailBackend

Kullanıcıların e-posta adresi ile giriş yapmasını sağlar.

settings.py:

AUTHENTICATION_BACKENDS = [
    "django_routines.backends.email_backend.EmailBackend",
]

Örnek:

from django.contrib.auth import authenticate

user = authenticate(request, username="[e-mail]", password="secret")
if user is not None:
    pass

Not: Kullanıcı modelinizde email alanının unique olması önerilir.

---

Yardımcı Fonksiyonlar

turkce_slugify

Türkçe karakterleri ASCII uyumlu karşılıklarına çevirir ve ardından Django’nun slugify fonksiyonunu uygular.

from django_routines.i18n.slugify import turkce_slugify

slug = turkce_slugify("İstanbul Şehir Rehberi")
# Çıktı: istanbul-sehir-rehberi

---

coklu_dil_slug_uygula

Modelinizde settings.LANGUAGES içinde tanımlı dillere göre otomatik slug üretir ve ilgili slug alanlarına set eder.

• Ana alan: isim → slug
• Diğer diller: isim_en → slug_en, isim_de → slug_de, isim_ar → slug_ar vb.
• Model üzerinde ilgili alan yoksa güvenli şekilde atlanır.
• Slug üretimi için dışarıdan bir slugify_fonksiyonu alır (örneğin turkce_slugify).
• settings.LANGUAGES değiştiğinde otomatik uyum sağlar.

Örnek kullanım (model save içinde):

from django.db import models
from django_routines.i18n.coklu_dil_slug_save import coklu_dil_slug_uygula
from django_routines.i18n.slugify_tr import turkce_slugify

class Blog(models.Model):
    isim = models.CharField(max_length=255)
    slug = models.SlugField(max_length=255, unique=True, blank=True, null=True)

    # Çok dilli alanlar (örnek)
    # isim_en = models.CharField(max_length=255, blank=True, null=True)
    # slug_en = models.SlugField(max_length=255, blank=True, null=True)

    def save(self, *args, **kwargs):
        coklu_dil_slug_uygula(
            nesne=self,
            baslik_alani="isim",
            slug_alani="slug",
            slugify_fonksiyonu=turkce_slugify,
        )
        super().save(*args, **kwargs)

---

redirect_to_correct_i18n_slug

Aktif dile göre doğru slug alanını kontrol eder ve gerekirse doğru slug’a yönlendirme yapar.

from django_routines.i18n.slug_redirect import redirect_to_correct_i18n_slug

response = redirect_to_correct_i18n_slug(
    obj=article,
    current_slug=slug,
    url_name="article_detail",
)

if response:
    return response

---

Görsel Sıkıştırma

resim_sikistir

Model üzerindeki bir ImageField alanını:

• Eski görsel değiştiyse eski_<upload_to>/ klasörüne taşır (local ise taşıma, remote ise copy+delete)
• Görseli WEBP formatına çevirir
• max_kenar ile en büyük kenarı küçültür
• max_kb hedef boyutuna inene kadar kaliteyi düşürür

Örnek kullanım (model save içinde):

from django.db import models
from django_routines.images.compress import resim_sikistir

class Urun(models.Model):
    resim = models.ImageField(upload_to="urun_resimleri/", blank=True, null=True)

    def save(self, *args, **kwargs):
        # save öncesi alanın file'ı set edildiyse sıkıştır
        resim_sikistir(self, "resim", dosya_adi="urun", max_kb=200, max_kenar=1200)
        super().save(*args, **kwargs)

---

Gereksinimler

• Python 3.10+
• Django 4.2+

---

Lisans

Apache Lisansı