Python documentation/3.12/latest/howto/clinic

This project is used as a preview, not yet used for production workflow. Integrations efforts are ongoing as well as figuring out the funding.

Please refer to https://devguide.python.org/documentation/translating/ for guidance about the translations.

This project is in a trial period, be cautious while contributing. Setup can still change before being approved as a libre project.

Source strings

428	Strings	100%	Browse Translate
8,331	Words	100%
54,557	Characters	100%

This translation is being used as source strings within this component.

Strings status

Strings Words Characters
428 8,331 54,557	All strings	Browse Translate Zen
428 8,331 54,557	Read-only strings	Browse Translate Zen
2 63 421	Strings with any failing checks	Browse Translate Zen
2 63 421	Failing check: Ellipsis	Browse Translate Zen

Overview

Project website	docs.python.org
Instructions for translators	See devguide.python.org/documentation/translating.
Project maintainers	rafaelff josix m-aciek
Translation license	Creative Commons Zero v1.0 Universal
Translation process	Translations can be made directly. Translation suggestions can be made. Any authenticated user can contribute. The translation uses bilingual files.
Source code repository	`git@github.com:m-aciek/python-docs-weblate.git`
Repository branch	main
Last remote commit	[3.12] gh-128049: Fix type confusion bug with the return value of a custom ExceptionGroup split function (GH-128079) (#128140) `f03de0d` github-actions[bot] authored 8 hours ago
Last commit in Weblate	[3.12] gh-128049: Fix type confusion bug with the return value of a custom ExceptionGroup split function (GH-128079) (#128140) `f03de0d` github-actions[bot] authored 8 hours ago
Weblate repository	`https://hosted.weblate.org/git/python-docs/latest/bugs/`
File mask	`*/latest/howto/clinic.po`
Translation file	Not available
Last change	Nov. 8, 2023, 10:19 p.m.
Last change made by	None
Language	English
Language code	en
Text direction	Left to right
Number of speakers	1,728,900,209
Number of plurals	2
Plural type	One/other
Plurals	Singular	1
Plurals	Plural	0, 2, 3, 4, 5, 6, 7, 8, 9, 10, …
Plural formula	`n != 1`

2 weeks ago

String statistics

	Strings percent	Hosted strings	Words percent	Hosted words	Characters percent	Hosted characters
Total		428		8,331		54,557
Translated	100%	428	100%	8,331	100%	54,557
Needs editing	0%	0	0%	0	0%	0
Read-only	100%	428	100%	8,331	100%	54,557
Failing checks	1%	2	1%	63	1%	421
Strings with suggestions	0%	0	0%	0	0%	0
Untranslated strings	0%	0	0%	0	0%	0

Last 12 months Previous

Activity in last 12 months


Dec	Jan	Feb	Mar	Apr	May	Jun	Jul	Aug	Sep	Oct	Nov

Quick numbers

8,331

Hosted words

428

Hosted strings

100%

Translated

Contributors

and previous 30 days

Trends of last 30 days

—

Hosted words

+100%

—

Hosted strings

+100%

—

Translated

+100%

—

Contributors

—

None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only Since Python comments are different from C comments, Argument Clinic blocks embedded in Python files look slightly different. They look like this: a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only It's actually possible to use Argument Clinic to preprocess Python files. There's no point to using Argument Clinic blocks, of course, as the output wouldn't make any sense to the Python interpreter. But using Argument Clinic to run Python blocks lets you use Python as a Python preprocessor! a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only Using Argument Clinic in Python files a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only When this happens, just open your file, find the ``dump buffer`` block that Argument Clinic added to your file (it'll be at the very bottom), then move it above the ``PyMethodDef`` structure where that macro is used. a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only In this situation, Argument Clinic writes the extra code to the "buffer" destination. This may mean that you get a complaint from Argument Clinic: a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only However, this causes one ticklish problem: where should Argument Clinic put this extra code when using the "block" output preset? It can't go in the output block, because that could be deactivated by the ``#ifdef``. (That's the whole point!) a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only That means the macro always works. If the function is defined, this turns into the correct structure, including the trailing comma. If the function is undefined, this turns into nothing. a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only Here's where Argument Clinic gets very clever. It actually detects that the Argument Clinic block might be deactivated by the ``#ifdef``. When that happens, it generates a little extra code that looks like this:: a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only Perhaps you're wondering: what if ``HAVE_FUNCTIONNAME`` isn't defined? The ``MODULE_FUNCTIONNAME_METHODDEF`` macro won't be defined either! a year ago
None Source string added Python documentation 3.12 latest/howto/clinic English	English 0 characters edited Read only (You can find the real name for this macro inside the generated code. Or you can calculate it yourself: it's the name of your function as defined on the first line of your block, but with periods changed to underscores, uppercased, and ``"_METHODDEF"`` added to the end.) a year ago

Browse all translation changes

Quick downloads

428	All strings, converted files enriched with comments; suitable for offline translation	CSV	gettext MO	gettext PO	TBX	TMX	XLIFF 1.1 with gettext extensions	XLIFF 1.1	XLSX

Customize download

File format*

gettext PO XLIFF 1.1 with gettext extensions XLIFF 1.1 TBX TMX gettext MO CSV XLSX

Search

Advanced query builder

Query examples

Review strings changed by other users	`changed:>="1 month ago" AND NOT changed_by:anonymous`	Add
Translated strings	`state:>=translated`	Add
Strings with comments	`has:comment`	Add
Strings with any failing checks	`has:check`	Add
Strings with suggestions from others	`has:suggestion AND NOT suggestion_author:anonymous`	Add
Approved strings with suggestions	`state:approved AND has:suggestion`	Add
All untranslated strings added the past month	`added:>="1 month ago" AND state:<=needs-editing`	Add
Strings changed in the past two weeks	`changed:>="2 weeks ago"`	Add

Shortcut	Action
`?`	Open available keyboard shortcuts.
`Alt` + `Home`	Navigate to the first translation in the current search.
`Alt` + `End`	Navigate to the last translation in the current search.
`Alt` + `PageUp` or `Ctrl` + `↑` or `Alt` + `↑` or `Cmd` + `↑` or	Navigate to the last translation in the current search.
`Alt` + `PageDown` or `Ctrl` + `↓` or `Alt` + `↓` or `Cmd` + `↓` or	Navigate to the next translation in the current search.
`Ctrl` + `Enter` or `Cmd` + `Enter`	Submit current form; this works the same as pressing Save and continue while editing translation.
`Ctrl` + `Shift` + `Enter` or `Cmd` + `Shift` +`Enter`	Unmark translation as Needing edit and submit it.
`Alt` + `Enter` or `Option` + `Enter`	Submit the string as a suggestion; this works the same as pressing Suggest while editing translation.
`Ctrl` + `E` or `Cmd` + `E`	Focus on translation editor.
`Ctrl` + `U` or `Cmd` + `U`	Focus on comment editor.
`Ctrl` + `M` or `Cmd` + `M`	Shows Automatic suggestions tab.
`Ctrl` + `1` to `Ctrl` + `9` or `Cmd` + `1` to `Cmd` + `9`	Copies placeable of a given number from source string.
`Ctrl` + `M` followed by `1` to `9` or `Cmd` + `M` followed by `1` to `9`	Copy the machine translation of a given number to current translation.
`Ctrl` + `I` followed by `1` to `9` or `Cmd` + `I` followed by `1` to `9`	Ignore one item in the list of failing checks.
`Ctrl` + `J` or `Cmd` + `J`	Shows the Nearby strings tab.
`Ctrl` + `S` or `Cmd` + `S`	Focus on search field.
`Ctrl` + `O` or `Cmd` + `O`	Copy the source string.
`Ctrl` + `Y` or `Cmd` + `Y`	Toggle the Needs editing checkbox.
`→`	Browse the next translation string.
`←`	Browse the previous translation string.