sapling-py 4.3.0__tar.gz → 4.4.0__tar.gz

{sapling_py-4.3.0/sapling_py.egg-info → sapling_py-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sapling-py
-Version: 4.3.0
+Version: 4.4.0
 Summary: Sapling Python Client
 Author-email: Sapling Intelligence <info@sapling.ai>
 License: Apache License 2.0
@@ -31,8 +31,8 @@ Compare against leading grammar checking tools and APIs like Grammarly (Grammerl
 
 Sapling is a toolkit for helping developers build language model-powered applications.
 The API provides spelling and grammar checking, autocomplete, tone detection, rephrasing, AI detection,
-zero-shot text classification, structured data extraction, PII detection and redaction, content safety
-scoring, SEO analysis, and more.
+zero-shot text classification, structured data extraction, translation, PII detection and redaction,
+content safety scoring, SEO analysis, and more.
 
 Key Features:
 - **60% More Corrections**: Outperforms [competing solutions](https://sapling.ai/comparison/api#sapling) at similar accuracy levels using state-of-the-art generative AI models.

{sapling_py-4.3.0 → sapling_py-4.4.0}/README.md

@@ -9,8 +9,8 @@ Compare against leading grammar checking tools and APIs like Grammarly (Grammerl
 
 Sapling is a toolkit for helping developers build language model-powered applications.
 The API provides spelling and grammar checking, autocomplete, tone detection, rephrasing, AI detection,
-zero-shot text classification, structured data extraction, PII detection and redaction, content safety
-scoring, SEO analysis, and more.
+zero-shot text classification, structured data extraction, translation, PII detection and redaction,
+content safety scoring, SEO analysis, and more.
 
 Key Features:
 - **60% More Corrections**: Outperforms [competing solutions](https://sapling.ai/comparison/api#sapling) at similar accuracy levels using state-of-the-art generative AI models.

{sapling_py-4.3.0 → sapling_py-4.4.0}/sapling/client.py

@@ -718,6 +718,63 @@ class SaplingClient:
             data['context'] = context
         return self._request(url, data)
 
+    def translate(
+        self,
+        text,
+        target_lang,
+        source_lang=None,
+        formality=None,
+    ):
+        '''
+        Translates text into a target language with an LLM, preserving line
+        breaks, markup and placeholders in place. The response reports the
+        language the text was actually written in (detected, not assumed from
+        the hint).
+
+        Example::
+
+            client.translate(
+                'Hello world.\\nSee you at 5pm.',
+                target_lang='fr',
+            )
+            # {'translation': 'Bonjour le monde.\\nÀ 17h.',
+            #  'source_lang': 'en', 'source_lang_name': 'English',
+            #  'target_lang': 'fr', 'target_lang_name': 'French'}
+
+        :param text: Text to translate, up to 5,000 characters. Markup and
+            whitespace are preserved, not stripped.
+        :type text: str
+        :param target_lang: Language to translate into: an ISO 639 code
+            (``'fr'``, ``'zh-TW'``) or an English language name
+            (``'French'``). Region variants ``zh-CN``/``zh-TW``/``zh-HK``,
+            ``pt-BR``/``pt-PT``, ``en-GB``/``en-US``, ``fr-CA`` and ``es-419``
+            are supported as targets.
+        :type target_lang: str
+        :param source_lang: Optional hint for the source language, same forms
+            as ``target_lang``. The text itself wins if they disagree.
+        :type source_lang: str
+        :param formality: Optional register: ``'formal'`` (vous/Sie/usted) or
+            ``'informal'`` (tu/du/tú). Omit for the model default.
+        :type formality: str
+        :rtype: dict
+        :return:
+            - translation: The translated text, structure preserved.
+            - source_lang / source_lang_name: The detected source language
+              (``'und'`` and ``None`` when undetermined).
+            - target_lang / target_lang_name: The normalized target.
+        '''
+        url = self.url_endpoint + 'translate'
+        data = {
+            'key': self.api_key,
+            'text': text,
+            'target_lang': target_lang,
+        }
+        if source_lang is not None:
+            data['source_lang'] = source_lang
+        if formality is not None:
+            data['formality'] = formality
+        return self._request(url, data)
+
     def tone(
         self,
         text,

sapling_py-4.4.0/sapling/version.py

@@ -0,0 +1 @@
+__version__ = '4.4.0'

{sapling_py-4.3.0 → sapling_py-4.4.0/sapling_py.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sapling-py
-Version: 4.3.0
+Version: 4.4.0
 Summary: Sapling Python Client
 Author-email: Sapling Intelligence <info@sapling.ai>
 License: Apache License 2.0
@@ -31,8 +31,8 @@ Compare against leading grammar checking tools and APIs like Grammarly (Grammerl
 
 Sapling is a toolkit for helping developers build language model-powered applications.
 The API provides spelling and grammar checking, autocomplete, tone detection, rephrasing, AI detection,
-zero-shot text classification, structured data extraction, PII detection and redaction, content safety
-scoring, SEO analysis, and more.
+zero-shot text classification, structured data extraction, translation, PII detection and redaction,
+content safety scoring, SEO analysis, and more.
 
 Key Features:
 - **60% More Corrections**: Outperforms [competing solutions](https://sapling.ai/comparison/api#sapling) at similar accuracy levels using state-of-the-art generative AI models.

{sapling_py-4.3.0 → sapling_py-4.4.0}/sapling_py.egg-info/SOURCES.txt

@@ -15,4 +15,5 @@ test/test_client.py
 test/test_extract.py
 test/test_pii.py
 test/test_safety.py
-test/test_seo.py
+test/test_seo.py
+test/test_translate.py

sapling_py-4.4.0/test/test_translate.py

@@ -0,0 +1,81 @@
+import json
+
+import pytest
+import responses
+
+from sapling import SaplingClient, SaplingError
+
+API_KEY = 'a' * 32
+BASE = 'https://api.sapling.ai/api/v1/'
+
+TEXT = 'Hello world.\nSee you at 5pm.'
+
+TRANSLATE_RESPONSE = {
+    'translation': 'Bonjour le monde.\nÀ 17h.',
+    'source_lang': 'en',
+    'source_lang_name': 'English',
+    'target_lang': 'fr',
+    'target_lang_name': 'French',
+}
+
+
+@pytest.fixture
+def client():
+    return SaplingClient(api_key=API_KEY)
+
+
+def _last_request_body():
+    return json.loads(responses.calls[-1].request.body)
+
+
+@responses.activate
+def test_translate_returns_json_and_sends_key(client):
+    responses.add(responses.POST, BASE + 'translate',
+                  json=TRANSLATE_RESPONSE, status=200)
+    result = client.translate(TEXT, target_lang='fr')
+    assert result == TRANSLATE_RESPONSE
+    body = _last_request_body()
+    assert body == {'key': API_KEY, 'text': TEXT, 'target_lang': 'fr'}
+
+
+@responses.activate
+def test_translate_posts_to_translate_endpoint(client):
+    responses.add(responses.POST, BASE + 'translate',
+                  json=TRANSLATE_RESPONSE, status=200)
+    client.translate(TEXT, target_lang='fr')
+    assert responses.calls[-1].request.url == BASE + 'translate'
+
+
+@responses.activate
+def test_translate_optional_params_sent_only_when_given(client):
+    responses.add(responses.POST, BASE + 'translate',
+                  json=TRANSLATE_RESPONSE, status=200)
+    client.translate(TEXT, target_lang='fr')
+    body = _last_request_body()
+    assert 'source_lang' not in body
+    assert 'formality' not in body
+
+    client.translate(TEXT, target_lang='fr',
+                     source_lang='en', formality='formal')
+    body = _last_request_body()
+    assert body['source_lang'] == 'en'
+    assert body['formality'] == 'formal'
+
+
+@responses.activate
+def test_translate_accepts_names_and_region_variants(client):
+    responses.add(responses.POST, BASE + 'translate',
+                  json=dict(TRANSLATE_RESPONSE, target_lang='zh-TW',
+                            target_lang_name='Traditional Chinese'),
+                  status=200)
+    result = client.translate(TEXT, target_lang='Traditional Chinese')
+    assert result['target_lang'] == 'zh-TW'
+    assert _last_request_body()['target_lang'] == 'Traditional Chinese'
+
+
+@responses.activate
+def test_translate_http_error_raises_sapling_error(client):
+    responses.add(responses.POST, BASE + 'translate',
+                  json={'msg': 'Unknown language: "Klingon".'}, status=400)
+    with pytest.raises(SaplingError):
+        client.translate(TEXT, target_lang='Klingon')

sapling_py-4.3.0/sapling/version.py

@@ -1 +0,0 @@
-__version__ = '4.3.0'