Metadata-Version: 2.4
Name: translation-finder
Version: 1.0
Summary: A translation file finder for Weblate, translation tool with tight version control integration
Home-page: https://weblate.org/
Download-URL: https://github.com/WeblateOrg/translation-finder
Author: Michal Čihař
Author-email: michal@cihar.com
License: GPLv3+
Project-URL: Issue Tracker, https://github.com/WeblateOrg/translation-finder/issues
Project-URL: Documentation, https://docs.weblate.org/
Project-URL: Source Code, https://github.com/WeblateOrg/translation-finder
Project-URL: Twitter, https://twitter.com/WeblateOrg
Keywords: i18n l10n gettext translate
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Software Development :: Internationalization
Classifier: Topic :: Software Development :: Localization
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
License-File: LICENSE
Requires-Dist: chardet
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: project-url
Dynamic: requires-dist
Dynamic: summary

translation-finder
==================

A translation file finder for `Weblate`_, translation tool with tight version
control integration.

.. image:: https://travis-ci.com/WeblateOrg/translation-finder.svg?branch=master
    :target: https://travis-ci.com/WeblateOrg/translation-finder
    :alt: Build Status

.. image:: https://codecov.io/github/WeblateOrg/translation-finder/coverage.svg?branch=master
    :target: https://codecov.io/github/WeblateOrg/translation-finder?branch=master
    :alt: Code coverage

.. image:: https://scrutinizer-ci.com/g/WeblateOrg/translation-finder/badges/quality-score.png?b=master
   :target: https://scrutinizer-ci.com/g/WeblateOrg/translation-finder/?branch=master
   :alt: Scrutinizer Code Quality

.. image:: https://api.codacy.com/project/badge/Grade/9dba6b312da04123b3797cf6015ee012
   :alt: Codacy Badge
   :target: https://app.codacy.com/app/Weblate/translation-finder?utm_source=github.com&utm_medium=referral&utm_content=WeblateOrg/translation-finder&utm_campaign=Badge_Grade_Dashboard

.. image:: https://img.shields.io/pypi/v/translation-finder.svg
    :target: https://pypi.org/project/translation-finder/
    :alt: PyPI package

This library is used by `Weblate`_ to discover translation files in a cloned
repository.

Usage
-----

In can be used from Python:

.. code-block:: python

   >>> from translation_finder import discover
   >>> discover('.')
   [
       {
           "filemask": "locales/*/messages.po",
           "file_format": "po",
           "template": None,
       },
       {
           "filemask": "app/src/res/main/values-*/strings.xml",
           "file_format": "aresource",
           "template": "app/src/res/main/values/strings.xml",
       }
   ]

Or command line:

.. code-block:: console

   $ weblate-discovery translation_finder/test_data/
   == Match 1 ==
   file_format    : po
   filemask       : locales/*.po

   == Match 2 ==
   file_format    : aresource
   filemask       : app/src/res/main/values-*/strings.xml
   template       : app/src/res/main/values/strings.xml

.. _Weblate: https://weblate.org/
