Translation Finder

Translation file discovery library used by Weblate to identify translation files and their configuration in source repositories.

Discovery can operate on file listings alone or inspect the filesystem when more accurate detection is needed, such as determining file encoding or distinguishing formats with similar syntax.

Maintained by Weblate — a privacy-respecting localization platform built on open-source foundations.

Usage

It can be used from Python:

>>> from translation_finder import discover
>>> from pprint import pprint
>>> results = discover("translation_finder/test_data/")
>>> len(results)
40
>>> pprint(results[0].match)
{'file_format': 'aresource',
 'filemask': 'app/src/res/main/values-*/strings.xml',
 'name': 'android',
 'template': 'app/src/res/main/values/strings.xml'}
>>> pprint(results[1].match)
{'file_format': 'po',
 'filemask': 'locales/*.po',
 'name': 'translation',
 'new_base': 'locales/messages.pot'}

Additional information about discovery can be obtained from meta attribute:

>>> pprint(results[0].meta)
{'discovery': 'TransifexDiscovery', 'origin': 'Transifex', 'priority': 500}
>>> pprint(results[22].meta)
{'discovery': 'GettextDiscovery', 'origin': None, 'priority': 1000}

Or command line:

$ weblate-discovery translation_finder/test_data/
== Match 1 (Transifex) ==
file_format    : aresource
filemask       : app/src/res/main/values-*/strings.xml
name           : android
template       : app/src/res/main/values/strings.xml
...

== Match 7 ==
file_format    : po
filemask       : locales/*.po
new_base       : locales/messages.pot

Non-printable characters in command-line results are displayed as visible escapes (for example, \n and \x1b). The Python API returns the original values unchanged.

Metadata

Release files for translation-finder 3.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for translation-finder 3.6.1
File	Size	Uploaded
translation_finder-3.6.1.tar.gz	114.6 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for translation-finder 3.6.1
File	Interpreter	ABI	Platform	Reset
translation_finder-3.6.1-py3-none-any.whl 123.9 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 238.5 kB

Release files / translation_finder-3.6.1.tar.gz

Download URL	translation_finder-3.6.1.tar.gz
Size	114.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`a69dfec578bf0d3fc018ee0ca0229a61625e4f8a6d95d46bc93b62b242695b0a`
BLAKE2b-256 checksum How to use checksums	`81d1be11c2cb9797de2a90f992ce96829e9b68884944aa93950ef08526a8d4bf`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / translation_finder-3.6.1-py3-none-any.whl

Download URL	translation_finder-3.6.1-py3-none-any.whl
Size	123.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9716af2c395f330ff003b273eca66df1cc6acb3deb20bd1177a56f7968049eb0`
BLAKE2b-256 checksum How to use checksums	`aeed30515b9e4bce86f7e9fa463e202fc5458a6195bfac8274ba5dc9ca84afec`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`