வலைபெயர்ப்பு தொகுதிகளுக்கு பங்களிக்கிறது¶

முக்கிய களஞ்சியத்தைத் தவிர, வலைபெயர்ப்பு பல பைத்தான் தொகுதிகளைக் கொண்டுள்ளது. இவை அனைத்தும் ஒரே கட்டமைப்பைப் பின்பற்றுகின்றன, மேலும் இந்த ஆவணம் அவை அனைத்தையும் உள்ளடக்கியது.

எடுத்துக்காட்டாக, இது பின்வருவனவற்றை உள்ளடக்குகிறது:

wlc, Python client library, see வலைபெயர்ப்பு கிளையன்ட்
translation-finder, used to discover translatable files in the repository
language-data, language definitions for Weblate, see மொழி வரையறைகள்

குறியீட்டு வழிகாட்டுதல்கள்¶

Any code for Weblate should be written with Security by Design Principles in mind.

எந்தவொரு குறியீடும் நடத்தை விளக்கும் ஆவணங்களுடன் வர வேண்டும். ஆவணப்படுத்தும் முறைகள், சிக்கலான குறியீடு தொகுதிகள் அல்லது பயனர் புலப்படும் நற்பொருத்தங்கள் மறந்துவிடாதீர்கள்.

Any new code should utilize PEP 484 type hints. We're not checking this in our CI yet as existing code does not yet include them.

Git commits should follow Conventional Commits specification.

இயங்கும் சோதனைகள்¶

The tests are executed using py.test. First you need to install test requirements:

uv pip install -e '.[dev]'

களஞ்சிய செக்அவுட்டில் சோதனைச்சூட்டை நீங்கள் செயல்படுத்தலாம்:

py.test

குறியீட்டு மற்றும் குறியீட்டைக் குறைத்தல்¶

The code should follow PEP-8 coding guidelines and should be formatted using ruff code formatter.

To check the code quality, you can use ruff, its configuration is stored in pyproject.toml.

The easiest approach to enforce all this is to install pre-commit. The repository contains configuration for it to verify the committed files are sane. After installing it (it is already included in the pyproject.toml) turn it on by running pre-commit install in Weblate checkout. This way all your changes will be automatically checked.

எல்லா கோப்புகளையும் சரிபார்க்க, கைமுறையாக சோதனையைத் தூண்டலாம்:

pre-commit run --all