transifex-python 3.7.0__tar.gz → 3.8.0__tar.gz

{transifex_python-3.7.0/transifex_python.egg-info → transifex_python-3.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: transifex-python
-Version: 3.7.0
+Version: 3.8.0
 Summary: Transifex Python Toolkit
 Home-page: https://github.com/transifex/transifex-python
 Author: Transifex
@@ -69,6 +69,53 @@ To learn more about using Transifex Python toolkit check:
 * For a general overview visit [Transifex Native overview](https://developers.transifex.com/docs/native?utm_campaign=tx-native&utm_source=github&utm_medium=link)
 * For some common questions & answers check our [Transifex Native community](https://community.transifex.com/c/transifex-native/17)
 
+# Django settings reference
+
+The Transifex Native Django sdk is controlled via a set of configuration options defined in Django settings:
+
+- TRANSIFEX_TOKEN: API token that connects your application to a Transifex project.
+Must be set for both pushing source strings and fetching translations.
+
+- TRANSIFEX_SECRET: Secret used together with the token for authenticated operations against CDS (e.g. pushing source content, invalidating cache).
+
+- TRANSIFEX_CDS_HOST: Override the default CDS host (https://cds.svc.transifex.net).
+
+- TRANSIFEX_FILTER_STATUS: Optional CDS filter[status] parameter used when fetching translations (e.g. "reviewed", "proofread"). If not set, CDS returns all available statuses.
+
+- TRANSIFEX_FILTER_TAGS: Optional CDS filter[tags] parameter used when fetching translations. Use this to limit fetched content to specific tags.
+
+- TRANSIFEX_MISSING_POLICY: Custom “missing translation” policy class.
+Defaults to the built-in SourceStringPolicy when not provided.
+
+- TRANSIFEX_ERROR_POLICY: Custom error handling policy class.
+Defaults to SourceErrorPolicy.
+
+- TRANSIFEX_CACHE
+Custom cache implementation. Defaults to an in-memory cache (MemoryCache) if not provided. Can be used to integrate with a shared cache (e.g. Redis, memcached).
+
+- SKIP_TRANSLATIONS_SYNC: If True, disables automatic translation sync (OTA) for this environment.
+
+- TRANSIFEX_SYNC_INTERVAL: Interval in seconds for the background sync daemon that fetches translations. Default: 30 * 60 (30 minutes). Set to 0 to disable periodic sync and only fetch on startup.
+
+- TRANSIFEX_FETCH_ALL_LANGUAGES: When True, fetch translations for all languages configured in CDS. When False (default), only fetch translations for languages listed in Django’s LANGUAGES setting.
+
+- TRANSIFEX_FETCH_TIMEOUT:
+Approximate maximum time in seconds for one fetch of languages and
+translations from CDS, including retries. It can be exceeded, e.g. by DNS
+resolution, a host with several IP addresses, or a response that keeps
+sending data slowly (the read timeout applies between received bytes, not to
+the whole response). Languages are fetched in LANGUAGES order; those not
+reached in time are skipped until the next sync, or for the life of the
+process if TRANSIFEX_SYNC_INTERVAL is 0.
+0 (default) = no global timeout: if CDS keeps answering 202, the fetch, and
+so startup, waits until it stops. Set it when translations are fetched at
+startup, e.g. under gunicorn.
+
+- TRANSIFEX_REQUEST_TIMEOUT:
+Timeout in seconds for each request made when fetching from CDS, either a
+number greater than 0 or a `(connect, read)` tuple as accepted by `requests`.
+Invalid values are logged and the default is used. Defaults to `(10, 60)`.
+
 # License
 
 Licensed under Apache License 2.0, see `LICENSE` file.

transifex_python-3.8.0/README.md

@@ -0,0 +1,95 @@
+![Test suite](https://github.com/transifex/transifex-python/workflows/Test%20suite/badge.svg?branch=master)
+[![codecov](https://codecov.io/gh/transifex/transifex-python/branch/master/graph/badge.svg)](https://codecov.io/gh/transifex/transifex-python)
+
+# Transifex Python Toolkit
+
+Transifex Python Toolkit is a collection of tools that allow you to easily localize your Django and Python applications using Transifex. The toolkit features fetching translations over the air (OTA) to your apps.
+
+This project adheres to the Contributor Covenant [code of conduct](/CODE_OF_CONDUCT.md). To contribute to Transifex Python Toolkit, please check out the [contribution guidelines](/CONTRIBUTING.md).
+
+# Upgrade to v2
+
+If you are upgrading from the `1.x.x` version, please read this [migration guide](https://github.com/transifex/transifex-python/blob/HEAD/UPGRADE_TO_V2.md), as there are breaking changes in place.
+
+# Quick starting guide
+
+1. Install toolkit in your code `$ pip install transifex-python`
+2. Add a provided TOKEN and SECRET in your config, connecting your application with a Transifex project
+3. Add internationalization commands in your code
+```HTML+Django
+  <!-- Django app template example -->
+
+  {% load transifex %}
+  <p>{% t "Hello!" %}</p>
+  <p>{% t "I want to be translated." %}</p>
+  ```
+
+```python
+  # Django view sample
+  from transifex.native.django import t
+
+  output = {
+      "msg1": t("Welcome aboard!"),
+      "msg2": t("It's great to have you here!"),
+  }
+  return JsonResponse(output)
+  ```
+4. Push strings to your connected Transifex project `./manage.py transifex push`
+5. When translations are added in your Transifex project are automatically made available
+
+To learn more about using Transifex Python toolkit check:
+* [Quickstart guide for Django web application](https://developers.transifex.com/docs/django-sdk?utm_campaign=tx-native&utm_source=github&utm_medium=link)
+* [Quickstart guide for Python application](https://developers.transifex.com/docs/python-sdk?utm_campaign=tx-native&utm_source=github&utm_medium=link)
+* For a general overview visit [Transifex Native overview](https://developers.transifex.com/docs/native?utm_campaign=tx-native&utm_source=github&utm_medium=link)
+* For some common questions & answers check our [Transifex Native community](https://community.transifex.com/c/transifex-native/17)
+
+# Django settings reference
+
+The Transifex Native Django sdk is controlled via a set of configuration options defined in Django settings:
+
+- TRANSIFEX_TOKEN: API token that connects your application to a Transifex project.
+Must be set for both pushing source strings and fetching translations.
+
+- TRANSIFEX_SECRET: Secret used together with the token for authenticated operations against CDS (e.g. pushing source content, invalidating cache).
+
+- TRANSIFEX_CDS_HOST: Override the default CDS host (https://cds.svc.transifex.net).
+
+- TRANSIFEX_FILTER_STATUS: Optional CDS filter[status] parameter used when fetching translations (e.g. "reviewed", "proofread"). If not set, CDS returns all available statuses.
+
+- TRANSIFEX_FILTER_TAGS: Optional CDS filter[tags] parameter used when fetching translations. Use this to limit fetched content to specific tags.
+
+- TRANSIFEX_MISSING_POLICY: Custom “missing translation” policy class.
+Defaults to the built-in SourceStringPolicy when not provided.
+
+- TRANSIFEX_ERROR_POLICY: Custom error handling policy class.
+Defaults to SourceErrorPolicy.
+
+- TRANSIFEX_CACHE
+Custom cache implementation. Defaults to an in-memory cache (MemoryCache) if not provided. Can be used to integrate with a shared cache (e.g. Redis, memcached).
+
+- SKIP_TRANSLATIONS_SYNC: If True, disables automatic translation sync (OTA) for this environment.
+
+- TRANSIFEX_SYNC_INTERVAL: Interval in seconds for the background sync daemon that fetches translations. Default: 30 * 60 (30 minutes). Set to 0 to disable periodic sync and only fetch on startup.
+
+- TRANSIFEX_FETCH_ALL_LANGUAGES: When True, fetch translations for all languages configured in CDS. When False (default), only fetch translations for languages listed in Django’s LANGUAGES setting.
+
+- TRANSIFEX_FETCH_TIMEOUT:
+Approximate maximum time in seconds for one fetch of languages and
+translations from CDS, including retries. It can be exceeded, e.g. by DNS
+resolution, a host with several IP addresses, or a response that keeps
+sending data slowly (the read timeout applies between received bytes, not to
+the whole response). Languages are fetched in LANGUAGES order; those not
+reached in time are skipped until the next sync, or for the life of the
+process if TRANSIFEX_SYNC_INTERVAL is 0.
+0 (default) = no global timeout: if CDS keeps answering 202, the fetch, and
+so startup, waits until it stops. Set it when translations are fetched at
+startup, e.g. under gunicorn.
+
+- TRANSIFEX_REQUEST_TIMEOUT:
+Timeout in seconds for each request made when fetching from CDS, either a
+number greater than 0 or a `(connect, read)` tuple as accepted by `requests`.
+Invalid values are logged and the default is used. Defaults to `(10, 60)`.
+
+# License
+
+Licensed under Apache License 2.0, see `LICENSE` file.

{transifex_python-3.7.0 → transifex_python-3.8.0}/tests/native/core/test_cds.py

@@ -1,12 +1,13 @@
 from operator import itemgetter
 
 import pytest
+import requests
 import responses
-from mock import patch
-from transifex.native.cds import CDSHandler
+from urllib3.exceptions import ReadTimeoutError
+from mock import patch, MagicMock
+from transifex.native.cds import DEFAULT_REQUEST_TIMEOUT, CDSHandler
 from transifex.native.parsing import SourceString
 
-
 class TestCDSHandler(object):
 
     def _lang_lists_equal(self, list_1, list_2):
@@ -635,3 +636,301 @@ class TestCDSHandler(object):
             for x in ('Unprocessable Entity', 'None')
         ]
         assert patched_logger.error.call_args[0][0] in messages
+
+    @staticmethod
+    def _json_response(status_code, payload=None):
+        response = MagicMock()
+        response.ok = status_code < 400
+        response.status_code = status_code
+        response.headers = {}
+        response.json.return_value = payload
+        return response
+
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_retry_get_request_raises_timeout_on_202_at_deadline(
+        self, mock_get, mock_time, mock_sleep
+    ):
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=5)
+        mock_get.return_value = self._json_response(202)
+        # deadline 0 -> 5; requests at 0.1 and 2.2; after the second 202
+        # the 2s retry delay would pass the deadline
+        mock_time.side_effect = [0, 0.1, 0.1, 2.2, 3.5]
+
+        with pytest.raises(requests.Timeout):
+            cds_handler.retry_get_request('https://some.host/languages')
+
+        assert mock_get.call_count == 2
+        assert mock_sleep.call_count == 1
+
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.requests.get')
+    def test_retry_get_request_returns_unexpected_status(
+        self, mock_get, mock_sleep
+    ):
+        cds_handler = CDSHandler(['el'], 'some_token')
+        response = self._json_response(600)
+        mock_get.return_value = response
+
+        assert cds_handler.retry_get_request('https://some.host/x') is response
+        assert mock_get.call_count == 1
+        mock_sleep.assert_not_called()
+
+    @patch('transifex.native.cds.logger')
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_translations_202_at_deadline_is_a_timeout(
+        self, mock_get, mock_time, mock_sleep, patched_logger
+    ):
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=1)
+        cds_handler.etags.set('el', 'old-etag')
+        mock_get.return_value = self._json_response(202, {'data': {}})
+        # deadline 0 -> 1; checked at 0.1, request at 0.2, 202 at 0.3 leaves
+        # less than the 2s retry delay
+        mock_time.side_effect = [0, 0.1, 0.2, 0.3]
+
+        translations = cds_handler.fetch_translations(language_code='el')
+
+        assert translations == {'el': (False, {})}
+        assert cds_handler.etags.get('el') == 'old-etag'
+        patched_logger.error.assert_called_once_with(
+            'Error retrieving translations from CDS: Timeout')
+
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_request_timeout_is_capped_by_deadline(self, mock_get, mock_time):
+        mock_get.return_value = self._json_response(200, {'data': []})
+        mock_time.side_effect = [0, 3]
+
+        CDSHandler(['el'], 'some_token', fetch_timeout=5).fetch_languages()
+
+        assert mock_get.call_args[1]['timeout'] == (2, 2)
+
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_no_request_once_deadline_has_passed(self, mock_get, mock_time):
+        mock_time.side_effect = [0, 6]
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=5)
+
+        with pytest.raises(requests.Timeout):
+            cds_handler.retry_get_request('https://some.host/languages')
+        mock_get.assert_not_called()
+
+    @patch('transifex.native.cds.logger')
+    def test_invalid_fetch_timeout_disables_it(self, patched_logger):
+        for value, expected in ((None, 0), ('30', 30), (2, 2), ('abc', 0)):
+            cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=value)
+            assert cds_handler.fetch_timeout == expected
+        patched_logger.error.assert_called_once_with(
+            'Invalid fetch_timeout `abc`, fetch timeout disabled')
+
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_requests_use_request_timeout(self, mock_get):
+        mock_get.return_value = self._json_response(200, {'data': []})
+
+        for request_timeout, expected in (
+            (None, (10, 60)),
+            ((3, 7), (3, 7)),
+            (5, 5),
+        ):
+            mock_get.reset_mock()
+            kwargs = {} if request_timeout is None else {
+                'request_timeout': request_timeout}
+            cds_handler = CDSHandler(['el'], 'some_token', **kwargs)
+
+            cds_handler.fetch_languages()
+            cds_handler.fetch_translations(language_code='el')
+
+            timeouts = [c[1]['timeout'] for c in mock_get.call_args_list]
+            assert timeouts == [expected, expected]
+
+    @patch('transifex.native.cds.logger')
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_logs_request_timeouts(self, mock_get, patched_logger):
+        cds_handler = CDSHandler(['el'], 'some_token')
+
+        for exception in (requests.ReadTimeout(), requests.ConnectTimeout()):
+            mock_get.side_effect = exception
+            patched_logger.reset_mock()
+
+            assert cds_handler.fetch_languages() == []
+            assert cds_handler.fetch_translations(language_code='el') == {
+                'el': (False, {})
+            }
+            assert [c[0][0] for c in patched_logger.error.call_args_list] == [
+                'Error retrieving languages from CDS: Timeout',
+                'Error retrieving translations from CDS: Timeout',
+            ]
+
+    @patch('transifex.native.cds.logger')
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_timeout_bounds_whole_fetch(
+        self, mock_get, mock_time, patched_logger
+    ):
+        cds_handler = CDSHandler(['el', 'en'], 'some_token', fetch_timeout=5)
+        mock_get.side_effect = [
+            self._json_response(200, {'data': [{'code': 'el'},
+                                               {'code': 'en'}]}),
+            self._json_response(200, {'data': {'key': {'string': 'x'}}}),
+        ]
+        # deadline 0 -> 5; languages request at 0.5, first language checked
+        # and requested at 1, second language checked at 10
+        mock_time.side_effect = [0, 0.5, 1, 1, 10]
+
+        translations = cds_handler.fetch_translations()
+
+        assert mock_get.call_count == 2
+        assert sorted(translations.values(), key=lambda v: v[0]) == [
+            (False, {}),
+            (True, {'key': {'string': 'x'}}),
+        ]
+        skipped = [lang for lang, (refresh, _) in translations.items()
+                   if not refresh]
+        patched_logger.error.assert_called_once_with(
+            'Error retrieving translations from CDS: fetch timeout reached, '
+            'skipped `{}`'.format(skipped[0])
+        )
+
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_number_request_timeout_is_capped_by_deadline(
+        self, mock_get, mock_time
+    ):
+        mock_get.return_value = self._json_response(200, {'data': []})
+        mock_time.side_effect = [0, 3]
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=5,
+                                 request_timeout=30)
+
+        cds_handler.fetch_languages()
+
+        assert mock_get.call_args[1]['timeout'] == 2
+
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_retry_get_request_returns_5xx_at_deadline(
+        self, mock_get, mock_time, mock_sleep
+    ):
+        response = self._json_response(503)
+        mock_get.return_value = response
+        # deadline 0 -> 1; request at 0.1, 503 at 0.2 leaves less than 2s
+        mock_time.side_effect = [0, 0.1, 0.2]
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=1)
+
+        assert cds_handler.retry_get_request('https://some.host/x') is response
+        assert mock_get.call_count == 1
+        mock_sleep.assert_not_called()
+
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_none_request_timeout_parts_are_capped_by_deadline(
+        self, mock_get, mock_time
+    ):
+        mock_get.return_value = self._json_response(200, {'data': []})
+
+        for request_timeout, expected in (((2, None), (2, 3)), (None, 3)):
+            mock_time.side_effect = [0, 2]
+            cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=5,
+                                     request_timeout=request_timeout)
+
+            assert cds_handler.fetch_languages() == []
+            assert mock_get.call_args[1]['timeout'] == expected
+
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.requests.get')
+    def test_retry_get_request_5xx_retries_without_deadline(
+        self, mock_get, mock_sleep
+    ):
+        response = self._json_response(503)
+        mock_get.return_value = response
+
+        cds_handler = CDSHandler(['el'], 'some_token')
+        assert cds_handler.retry_get_request('https://some.host/x') is response
+
+        assert mock_get.call_count == 4
+        assert [c[0][0] for c in mock_sleep.call_args_list] == [2, 4, 6]
+
+    @patch('transifex.native.cds.time.sleep')
+    @patch('transifex.native.cds.time.monotonic')
+    @patch('transifex.native.cds.requests.get')
+    def test_retry_get_request_202_then_200_within_deadline(
+        self, mock_get, mock_time, mock_sleep
+    ):
+        ok = self._json_response(200, {'data': []})
+        mock_get.side_effect = [self._json_response(202), ok]
+        # deadline 0 -> 10; requests at 0.1 and 2.2, 202 checked at 0.2
+        mock_time.side_effect = [0, 0.1, 0.2, 2.2]
+        cds_handler = CDSHandler(['el'], 'some_token', fetch_timeout=10)
+
+        assert cds_handler.retry_get_request('https://some.host/x') is ok
+        mock_sleep.assert_called_once_with(2)
+
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_translations_follows_configured_language_order(
+        self, mock_get
+    ):
+        languages = self._json_response(200, {'data': [
+            {'code': 'el'}, {'code': 'en'}, {'code': 'fr'}, {'code': 'de'}]})
+        content = self._json_response(200, {'data': {}})
+
+        for fetch_all_langs, expected in (
+            (False, ['fr', 'el']),
+            (True, ['fr', 'el', 'en', 'de']),
+        ):
+            mock_get.reset_mock()
+            mock_get.side_effect = [languages] + [content] * 4
+            cds_handler = CDSHandler(['fr', 'it', 'el', 'fr'], 'some_token',
+                                     host='https://some.host',
+                                     fetch_all_langs=fetch_all_langs)
+
+            cds_handler.fetch_translations()
+
+            requested = [c[0][0].rsplit('/', 1)[1]
+                         for c in mock_get.call_args_list[1:]]
+            assert requested == expected
+
+    @patch('transifex.native.cds.requests.get')
+    def test_fetch_all_langs_without_configured_languages(self, mock_get):
+        mock_get.side_effect = [
+            self._json_response(200, {'data': [{'code': 'el'}]}),
+            self._json_response(200, {'data': {}}),
+        ]
+        cds_handler = CDSHandler(None, 'some_token',
+                                 host='https://some.host',
+                                 fetch_all_langs=True)
+
+        assert cds_handler.fetch_translations() == {'el': (True, {})}
+
+    @patch('transifex.native.cds.logger')
+    def test_invalid_request_timeout_uses_default(self, patched_logger):
+        for value, expected in (
+            (None, None),
+            (5, 5),
+            ((3, None), (3, None)),
+            ([3, 30], (3, 30)),
+            (0, DEFAULT_REQUEST_TIMEOUT),
+            ('30', DEFAULT_REQUEST_TIMEOUT),
+            (True, DEFAULT_REQUEST_TIMEOUT),
+            ((1, 2, 3), DEFAULT_REQUEST_TIMEOUT),
+        ):
+            cds_handler = CDSHandler(['el'], 'some_token',
+                                     request_timeout=value)
+            assert cds_handler.request_timeout == expected
+        assert patched_logger.error.call_count == 4
+
+    @patch('transifex.native.cds.logger')
+    @patch('transifex.native.cds.requests.get')
+    def test_read_timeout_in_body_is_logged_as_timeout(
+        self, mock_get, patched_logger
+    ):
+        mock_get.side_effect = requests.ConnectionError(
+            ReadTimeoutError(None, None, 'Read timed out.'))
+        cds_handler = CDSHandler(['el'], 'some_token',
+                                 host='https://some.host')
+
+        assert cds_handler.fetch_translations('el') == {'el': (False, {})}
+        patched_logger.error.assert_called_once_with(
+            'Error retrieving translations from CDS: Timeout')

{transifex_python-3.7.0 → transifex_python-3.8.0}/tests/native/core/test_init.py

@@ -52,3 +52,14 @@ class TestModuleInit(object):
         assert isinstance(_tx._missing_policy, SourceStringPolicy)
         assert isinstance(_tx._error_policy, SourceStringErrorPolicy)
         assert isinstance(_tx._cache, MemoryCache)
+
+    def test_init_passes_timeouts_to_cds_handler(self, reset_tx):
+        native.init('mytoken', ['lang1'], fetch_timeout=7,
+                    request_timeout=(1, 2))
+        assert _tx._cds_handler.fetch_timeout == 7
+        assert _tx._cds_handler.request_timeout == (1, 2)
+
+    def test_init_default_request_timeout(self, reset_tx):
+        native.init('mytoken', ['lang1'])
+        assert _tx._cds_handler.fetch_timeout == 0
+        assert _tx._cds_handler.request_timeout == (10, 60)

transifex_python-3.8.0/tests/native/django/test_apps.py

@@ -0,0 +1,20 @@
+from django.apps import apps
+from mock import patch
+from transifex.native.django import settings as native_settings
+from transifex.native.django.apps import NativeConfig
+
+
+def _native_config():
+    return next(config for config in apps.get_app_configs()
+                if isinstance(config, NativeConfig))
+
+
+@patch.object(native_settings, 'TRANSIFEX_REQUEST_TIMEOUT', (1, 2))
+@patch.object(native_settings, 'TRANSIFEX_FETCH_TIMEOUT', 7)
+@patch('transifex.native.django.apps.init')
+def test_ready_passes_timeout_settings(mock_init):
+    _native_config().ready()
+
+    kwargs = mock_init.call_args[1]
+    assert kwargs['fetch_timeout'] == 7
+    assert kwargs['request_timeout'] == (1, 2)

{transifex_python-3.7.0 → transifex_python-3.8.0}/transifex/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-11-14T10:11:09+0200",
+ "date": "2026-11-13T15:12:29+0200",
  "dirty": false,
  "error": null,
- "full-revisionid": "dbd2ca382211f853affe61e70a2ff4dcfd33fac2",
- "version": "3.7.0"
+ "full-revisionid": "55901f750a65c35413540bf26f11f31562a75e4f",
+ "version": "3.8.0"
 }
 '''  # END VERSION_JSON
 

{transifex_python-3.7.0 → transifex_python-3.8.0}/transifex/native/__init__.py

@@ -8,6 +8,8 @@ def init(
     fetch_all_langs=False,
     filter_tags=None,
     filter_status=None,
+    fetch_timeout=0,
+    request_timeout=None,
 ):
     """Initialize the framework.
 
@@ -25,6 +27,10 @@ def init(
     :param bool fetch_all_langs: force pull all remote languages
     :param str filter_tags: fetch only content with tags
     :param str filter_status: fetch only content with specific translation status
+    :param int fetch_timeout: maximum time in seconds to wait when fetching
+    translations or locales from CDS
+    :param request_timeout: seconds for each CDS fetch request, a number or
+        a (connect, read) tuple; defaults to (10, 60)
     """
     if not tx.initialized:
         tx.init(
@@ -38,6 +44,8 @@ def init(
             fetch_all_langs=fetch_all_langs,
             filter_tags=filter_tags,
             filter_status=filter_status,
+            fetch_timeout=fetch_timeout,
+            request_timeout=request_timeout,
         )