Weblate kaynak kodları#
Weblate, GitHub üzerinde geliştirilmektedir. Kodu çatallayabilir ve çekme istekleri yapabilirsiniz. Başka herhangi bir biçimdeki yamalar da kabul edilir.
Ayrıca bakınız
Weblate platformunun içeriden nasıl göründüğünü anlamak için Weblate iç yapısı bölümüne bakabilirsiniz.
Kodlama rehberi#
Weblate için geliştirilen kodlar Tasarım ilkelerine uygun güvenlik göz önünde bulundurularak yazılmalıdır.
Tüm kodlar, kodun davranışını açıklayan belgelerle birlikte iletilmelidir. Yöntemler, karmaşık kod blokları veya kullanıcı tarafından görülebilen özellikleri belgelemeyi unutmayın.
Herhangi bir yeni kod PEP 484 türünde ipuçları kullanmalıdır. Var olan kod henüz bunları içermediğinden bunu henüz CI ile denetlemiyoruz.
Kodlama standardı ve kodu temizlemek#
Kod, PEP-8 kodlama yönergelerine uymalı ve black kod biçimlendiricisi ile biçimlendirilmelidir.
Kod kalitesini denetlemek için flake8 kullanabilirsiniz. Önerilen eklentiler .pre-commit-config.yaml
içinde bulunur ve geçerli yapılandırması setup.cfg
dosyasındadır.
Tüm bunları dayatmak için en kolay yaklaşım pre-commit kurmaktır. Depoda, gönderilen dosyaların düzgün olduğunu doğrulayacak bir yapılandırma bulunur. Kurulumdan sonra (requirements-lint.txt
içinde bulunur) Weblate checkout sırasında pre-commit install
komutunu çalıştırarak açın. Böylece tüm değişiklikleriniz kendiliğinden denetlenir.
Denetimi el ile de başlatabilirsiniz. Tüm dosyaları denetlemek için şunu yürütün:
pre-commit run --all