Feature: detect

Author: spirokristollari

README.md

@@ -114,6 +114,19 @@ cd examples
 python glossaries_management.py
 ```
 
+### Language Detection
+- **[language_detection.py](examples/language_detection.py)** - Language detection examples
+  - Single string detection
+  - Multiple strings detection
+  - Detection with hint parameter
+  - Detection with passlist to restrict languages
+  - Combined hint and passlist
+
+```bash
+cd examples
+python language_detection.py
+```
+
 ## 🔧 API Reference
 
 ### Core Components
@@ -295,6 +308,34 @@ csv_data = lara.glossaries.export("gls_1A2b3C4d5E6f7G8h9I0jKl", "csv/table-uni",
 counts = lara.glossaries.counts("gls_1A2b3C4d5E6f7G8h9I0jKl")
 ```
 
+### 🌐 Language Detection
+
+```python
+# Basic language detection
+result = lara.detect("Hello, world!")
+print(f"Detected language: {result.language}")
+print(f"Content type: {result.content_type}")
+
+# Detect multiple strings
+result = lara.detect(["Hello", "Bonjour", "Hola"])
+
+# Detection with hint
+result = lara.detect("Hello", hint="en")
+
+# Detection with passlist (restrict to specific languages)
+result = lara.detect(
+    "Guten Tag",
+    passlist=["de-DE", "en-US", "fr-FR"]
+)
+
+# Combined hint and passlist
+result = lara.detect(
+    "Buongiorno",
+    hint="it",
+    passlist=["it-IT", "es-ES", "pt-PT"]
+)
+```
+
 ### Translation Options
 
 ```python

examples/language_detection.py

@@ -0,0 +1,81 @@
+from lara_sdk import Credentials, Translator
+import os
+
+"""
+Language detection examples for the Lara Python SDK
+
+This example demonstrates:
+- Detecting language of a single string
+- Detecting language of multiple strings
+- Using hint parameter to improve detection
+- Using passlist to restrict detected languages
+"""
+
+def main():
+    # All examples can use environment variables for credentials:
+    # export LARA_ACCESS_KEY_ID="your-access-key-id"
+    # export LARA_ACCESS_KEY_SECRET="your-access-key-secret"
+    # Falls back to placeholders if not set
+    access_key_id = os.getenv("LARA_ACCESS_KEY_ID", "your-access-key-id")
+    access_key_secret = os.getenv("LARA_ACCESS_KEY_SECRET", "your-access-key-secret")
+
+    credentials = Credentials(access_key_id, access_key_secret)
+    lara = Translator(credentials)
+    
+    try:
+        # Example 1: Detect language of a single string
+        print("=== Single String Detection ===")
+        result1 = lara.detect("Bonjour, comment allez-vous?")
+        print("Text: Bonjour, comment allez-vous?")
+        print(f"Detected language: {result1.language}")
+        print(f"Content type: {result1.content_type}\n")
+
+        # Example 2: Detect language of multiple strings
+        print("=== Multiple Strings Detection ===")
+        texts = [
+            "Hello, how are you?",
+            "Hola, ¿cómo estás?",
+            "Ciao, come stai?"
+        ]
+        result2 = lara.detect(texts)
+        print(f"Texts: {texts}")
+        print(f"Detected language: {result2.language}")
+        print(f"Content type: {result2.content_type}\n")
+
+        # Example 3: Using hint parameter
+        print("=== Detection with Hint ===")
+        result3 = lara.detect("Hello", hint="en")
+        print("Text: Hello")
+        print(f"Hint: en")
+        print(f"Detected language: {result3.language}")
+        print(f"Content type: {result3.content_type}\n")
+
+        # Example 4: Using passlist to restrict detected languages
+        print("=== Detection with Passlist ===")
+        result4 = lara.detect(
+            "Guten Tag",
+            passlist=["de-DE", "en-US", "fr-FR"]
+        )
+        print("Text: Guten Tag")
+        print(f"Passlist: ['de-DE', 'en-US', 'fr-FR']")
+        print(f"Detected language: {result4.language}")
+        print(f"Content type: {result4.content_type}\n")
+
+        # Example 5: Combined hint and passlist
+        print("=== Detection with Hint and Passlist ===")
+        result5 = lara.detect(
+            "Buongiorno",
+            hint="it",
+            passlist=["it-IT", "es-ES", "pt-PT"]
+        )
+        print("Text: Buongiorno")
+        print(f"Hint: it")
+        print(f"Passlist: ['it-IT', 'es-ES', 'pt-PT']")
+        print(f"Detected language: {result5.language}")
+        print(f"Content type: {result5.content_type}\n")
+
+    except Exception as error:
+        print(f"Error: {error}")
+
+if __name__ == "__main__":
+    main()

src/lara_sdk/__init__.py

@@ -1,7 +1,7 @@
 from ._client import LaraObject
 from ._credentials import Credentials
 from ._errors import LaraApiError, LaraError
-from ._translator import Memory, MemoryImport, TextBlock, TextResult, Memories, Translator, TranslatePriority, UseCache, Documents, Document, DocumentStatus, DocxExtractionParams, DocumentExtractionParams
+from ._translator import Memory, MemoryImport, TextBlock, TextResult, DetectResult, Memories, Translator, TranslatePriority, UseCache, Documents, Document, DocumentStatus, DocxExtractionParams, DocumentExtractionParams
 
 # This constant is auto-generated by the build script.
 # Manual modifications will be overwritten and may cause unexpected behavior.

src/lara_sdk/_translator.py

@@ -141,6 +141,12 @@ def __init__(self, **kwargs):
                 self.translation = [TextBlock(**e) for e in translation]
 
 
+class DetectResult(LaraObject):
+    def __init__(self, **kwargs):
+        self.language: str = kwargs.get('language')
+        self.content_type: str = kwargs.get('content_type')
+
+
 # Translator SDK -------------------------------------------------------------------------------------------------------
 
 
@@ -455,4 +461,14 @@ def translate(self, text: Union[str, Iterable[str], Iterable[TextBlock]], *,
         if no_trace is True:
             request_headers['X-No-Trace'] = 'true'
 
-        return TextResult(**self._client.post('/translate', body, headers=request_headers))
+        return TextResult(**self._client.post('/translate', body, headers=request_headers))
+
+    def detect(self, text: Union[str, List[str]], *, hint: Optional[str] = None,
+               passlist: Optional[List[str]] = None) -> DetectResult:
+        body = {
+            'q': text,
+            'hint': hint,
+            'passlist': passlist
+        }
+        
+        return DetectResult(**self._client.post('/detect', body))