Cód foinse gréasáin

Forbraítear Weblate ar GitHub. Tá fáilte romhat an cód a fhorc agus iarratais ar tharraingt oscailte. Tá fáilte roimh phaistí in aon fhoirm eile freisin.

See also

Breathnaigh ar Inmheánach láithreán gréasáin chun breathnú ar Weblate ón taobh istigh.

Ag scríobh paiste maith

Scríobh athruithe ar leithligh

Is crá croí é nuair a fhaigheann tú paiste ollmhór a deirtear a shocraíonn 11 fhadhb corr, ach nach n-aontaíonn plé agus tuairimí le 10 gcinn acu nó go raibh 9 gcinn acu socraithe ar bhealach difriúil cheana féin. Ansin, caithfidh an duine atá ag cumasc an t-athrú seo an paiste suimiúil amháin a bhaint as áit éigin laistigh den charn ollmhór foinsí, agus cruthaíonn sé sin go leor oibre breise.

Más fearr, ba chóir go mbeadh gach socrú a réitíonn fadhb ina phaiste/thiomantas féin lena thuairisc/theachtaireacht thiomnaithe féin ina luaitear go díreach cad a cheartaítear ionas gur féidir leis an gcothaitheoir nó le páirtithe leasmhara eile na hathruithe go léir a chur i bhfeidhm go roghnach.

Ina theannta sin, cuireann athruithe ar leithligh ar chumas an roinneadh ina dhá leath i bhfad níos fearr chun fadhbanna agus aischéimniú a rianú amach anseo.

Cáipéisíocht

Is féidir le doiciméadú a bheith ina thasc leadránach; áfach, is gá do dhuine éigin é a chríochnú. Déanann sé rudaí i bhfad níos éasca má chuireann tú an doiciméadú isteach in éineacht le hathruithe cóid. Cuimhnigh le do thoil modhanna, bloic chóid chasta, nó gnéithe atá le feiceáil ag an úsáideoir a dhoiciméadú.

Cásanna tástála

Ligeann na tástálacha dúinn a fhíorú go tapa go bhfuil na gnéithe ag obair mar is ceart dóibh. Chun an cás seo a choinneáil agus a fheabhsú, ní mór gach gné agus feidhm nua a chuirtear leis a thástáil sa tsraith tástála. Ba chóir go mbeadh cás tástála bailí amháin ar a laghad ag gach gné a chuirtear leis a fhíoraíonn go n-oibríonn sí mar atá doiciméadaithe.

Tiomantas teachtaireachtaí

Ba cheart go leanfadh gealltanais Git Tiomantas Coinbhinsiúin sonraíocht.

Seiceáil cineáil

Ba chóir d'aon chód nua leideanna cineáil PEP 484 a úsáid. Táimid ag úsáid mypy chun iad a sheiceáil mar go bhfuil breiseán Django ann a fhágann go bhfuil seiceáil cineáil ar aipeanna Django praiticiúil.

Níor cheart go dtabharfadh cód nua agus athraithe teipeanna nua mypy isteach i gcás ina ndéanann tacaíocht reatha clóscríofa Django é sin praiticiúil. Níl an bunchód clúdaithe go hiomlán ag anótálacha cineáil fós, agus tá sé deacair roinnt coincheapa Django a anótáil go beacht. Dá bhrí sin, ní fhorfheidhmíonn CI mypy ach amháin do mhodúil roghnaithe agus tuairiscíonn sé torthaí eile ar leithligh.

Códú caighdeánach agus linting an cód

Ba chóir don chód treoirlínte códaithe PEP 8 a leanúint agus ba chóir é a fhormáidiú ag baint úsáide as formáideoir cóid ruff.

Chun cáilíocht an chóid a sheiceáil, is féidir leat ruff a úsáid, stóráiltear a chumraíocht i pyproject.toml.

Agus diagnóisic ruff á cur faoi chois, is fearr # ruff: ignore[rule-name] leis an ainm rialach atá inléite ag an duine. Cuir an trácht ar an líne os cionn an ráitis loighciúil nó an bhloic nuair nach leathnaíonn sé sin raon feidhme an choisc. Coinnigh an trácht inlíne nuair a athródh a bhogadh an raon feidhme, a rachadh i bhfeidhm ar shórtáil allmhairithe, nó a rachadh idir trácht disable-next uirlis eile agus an cód atá mar sprioc aige.

Is é an cur chuige is fusa chun seo go léir a fhorfheidhmiú ná prek a shuiteáil. Is athchur i bhfeidhm tríú páirtí é seo den uirlis pre-commit a úsáideann Weblate. Tá sé san áireamh sna spleáchais forbartha atá dearbhaithe i pyproject.toml, mar sin nuair a shuiteálann tú na spleáchais sin, beidh prek ar fáil.

Chun gach comhad a sheiceáil de láimh, rith:

uv run prek run --all-files

Más fearr leat an cliant bunaidh pre-commit, úsáideann sé an chumraíocht chéanna ó .pre-commit-config.yaml.

Códú slán

Ba cheart aon chód le haghaidh Weblate a scríobh agus Prionsabail Slándála trí Dhearadh san áireamh.

Treoirlínte na hintleachta saorga

Agus ábhar á chur leis an tionscadal, tugann tú cead dúinn é a úsáid mar atá, agus ní mór duit a chinntiú go bhfuil cead agat é a dháileadh chugainn. Trí athrú a chur isteach chugainn, aontaíonn tú gur féidir leis an tionscadal na hathruithe a ghlacadh agus gur cheart iad a athdháileadh faoin gceadúnas tionscadail. Ba chóir d’údair a bheith ar an eolas go soiléir gurb orthu féin atá an dualgas a chinntiú nach gcuirtear aon chód neamhcheadúnaithe isteach sa tionscadal.

Tá sé seo neamhspleách ar cibé an n-úsáidtear AI nó nach n-úsáidtear.

Agus iarratas tarraingthe á chur isteach agat, ba cheart duit a chinntiú i gcónaí, ar ndóigh, go bhfuil an togra d’ardchaighdeán agus gurb é an iarracht is fearr a dhéantar ná ár dtreoirlínte a leanúint. Riail bhunúsach ordóige is ea má fheiceann duine gur rinneadh an ranníocaíocht le cabhair ó intleacht shaorga, go bhfuil níos mó oibre le déanamh agat.

Is féidir linn cód atá scríofa le cabhair ó shaorga a ghlacadh isteach sa tionscadal, ach ní mór don chód cloí le caighdeáin chódaithe fós, a bheith scríofa go soiléir, a bheith doiciméadaithe, cásanna tástála a bheith ann, agus cloí leis na ceanglais ghnáthúla go léir atá againn.

Recording acting users

Use acting_user_context(user) from weblate.utils.change_origin around operations that change model settings outside an authenticated request. Request authentication establishes this context automatically. Models read the actor with get_acting_user(); they no longer retain acting_user attributes. Nested contexts restore the previous actor, and passing None explicitly clears it. Use the anonymous user for intentional anonymous changes and the appropriate bot for automated operations.

Continue passing an explicit user when recording history. The actor context does not supply missing users to Change automatically and does not replace permission checks or content authorship. Pending file writes retain their own persisted actors and authors.

Wrap deferred transaction callbacks with capture_change_origin() when registering them. This captures both the origin and actor before their scopes exit. Celery tasks propagate the actor through a separate internal header; only the user identifier is serialized. Origin metadata stored in history does not include this identifier. Tasks with an invalid or deleted actor fail without executing their body.

Writing repository files

Create and update repository files atomically. Write the complete content to a temporary file on the destination filesystem, then replace the destination only after writing succeeds. Do not truncate repository files in place or copy over an existing destination directly. Repository locks are still required to coordinate concurrent operations; atomic replacement does not replace locking.

Use TranslationFormat.save_atomic(filename, callback) for file format writers. The callback receives a binary file handle. In add-ons, use BaseAddon.write_repo_file(filename, content) with bytes or UTF-8 text. These helpers select a temporary directory on the destination filesystem and clean up temporary files when writing or replacement fails. Pass the repository temporary directory to save_atomic() when it is available. The add-on helper preserves existing file permissions, including executable bits, before replacement.

Direct external tools to temporary output, check that generation succeeded, and install the completed content using an atomic helper. Keep path validation and repository locking around these operations. Atomic replacement applies to each file separately; these helpers do not provide transactions across multiple files or guarantee durability through power loss.