translatekit 0.3.0__tar.gz → 0.3.2__tar.gz

{translatekit-0.3.0 → translatekit-0.3.2}/MANIFEST.in

@@ -1,4 +1,4 @@
-include README.md
-include LICENSE
-include requirements.txt
+include README.md
+include LICENSE
+include requirements.txt
 recursive-include py_translate_kit *.py

{translatekit-0.3.0/translatekit.egg-info → translatekit-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: translatekit
-Version: 0.3.0
+Version: 0.3.2
 Summary: 一个简单快捷的翻译服务工具包，支持自定义脚本扩展
 Home-page: https://github.com/HZBHZB1234/Py-Translate-Kit
 Author: HZBHZB1234
@@ -39,11 +39,8 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Requires-Python: >=3.6.0
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.25.1
-Requires-Dist: beautifulsoup4>=4.9.3
-Requires-Dist: jsonpatch>=1.26
 Provides-Extra: extras
+License-File: LICENSE
 
 # Py-Translate-Kit 🌐
 

{translatekit-0.3.0 → translatekit-0.3.2}/setup.py

@@ -12,7 +12,7 @@ URL = 'https://github.com/HZBHZB1234/Py-Translate-Kit'
 EMAIL = 'HZBHZB1234@outlook.com'
 AUTHOR = 'HZBHZB1234'
 REQUIRES_PYTHON = '>=3.6.0'
-VERSION = '0.3.0'
+VERSION = '0.3.2'
 
 # What packages are required for this module to be executed?
 REQUIRED = [

{translatekit-0.3.0 → translatekit-0.3.2}/translatekit/__init__.py

@@ -66,5 +66,5 @@ __all__ = [
     'kit'
 ]
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 __author__ = "HZBHZB1234"

{translatekit-0.3.0 → translatekit-0.3.2}/translatekit/llm_general.py

@@ -33,7 +33,8 @@ class LLMGeneralTranslator(TranslatorBase):
         "frequency_penalty": 0.0,
         "presence_penalty": 0.0,
         "system_prompt": "你是一个专业的翻译助手，严格按照要求完成翻译任务，只返回翻译结果，不添加任何额外解释、说明或格式。",
-        "response_format": "text"
+        "response_format": "text",
+        "extra_body": {}
     }
 
     DESCRIBE_API_KEY = [
@@ -106,6 +107,13 @@ class LLMGeneralTranslator(TranslatorBase):
             "type": "string",
             "required": False,
             "description": "响应格式定义，可选json_object，text"
+        },
+        {
+            "id": "extra_body",
+            "name": "额外请求体",
+            "type": "dictionary",
+            "required": False,
+            "description": "额外的请求体参数，将以字典形式合并到API请求体中，用于传递特殊参数（如OpenAI的reasoning_effort、seed等）"
         }
     ]
     
@@ -264,6 +272,10 @@ class LLMGeneralTranslator(TranslatorBase):
             "response_format": {"type": self.response_format},
             "messages": self._build_translation_prompt(text)
         }
+
+        # 合并额外请求体参数（extra_body中的键会覆盖已有键）
+        if self.extra_body:
+            request_data.update(self.extra_body)
                 
         try:
             # 发送API请求

{translatekit-0.3.0 → translatekit-0.3.2}/translatekit/null_translator.py

@@ -1,57 +1,57 @@
-"""
-空翻译器实现，对于所有输入文本都返回原文，用于调试目的
-"""
-
-from typing import Dict, Any, Optional
-from .base import TranslatorBase, TranslationConfig, Metadata
-
-
-class NullTranslator(TranslatorBase):
-    """空翻译器实现类，对于所有输入文本都返回原文，用于调试目的"""
-    
-    # 服务元信息
-    SERVICE_NAME = "null_translator"
-    SUPPORTED_LANGUAGES = {
-        'auto': '自动检测',
-        'en': '英语'
-    }
-    
-    METADATA = Metadata(
-        console_url="",
-        description="空翻译器，对于所有输入文本都返回原文，用于调试目的",
-        documentation_url="",
-        short_description="空翻译器（调试用）",
-        usage_documentation="不发送任何网络请求，直接返回原文，用于调试翻译流程"
-    )
-    
-    def _translate_default(self, text: str, source_lang: str, target_lang: str, **kwargs) -> str:
-        """
-        默认翻译方法，直接返回原文
-        
-        Args:
-            text: 要翻译的文本
-            source_lang: 源语言
-            target_lang: 目标语言
-            **kwargs: 额外参数
-            
-        Returns:
-            原始文本，不做任何翻译
-        """
-        return text
-
-    def _parse_api_response(self, response: Any, **kwargs) -> str:
-        """
-        解析API响应，对于NullTranslator，响应就是原始文本
-        
-        Args:
-            response: API响应（在这里就是原始文本）
-            **kwargs: 额外参数
-            
-        Returns:
-            解析后的翻译文本
-        """
-        return response
-
-    def _validate_languages(self, source_lang: str, target_lang: str):
-        """验证语言对，NullTranslator不做验证，允许所有语言对"""
+"""
+空翻译器实现，对于所有输入文本都返回原文，用于调试目的
+"""
+
+from typing import Dict, Any, Optional
+from .base import TranslatorBase, TranslationConfig, Metadata
+
+
+class NullTranslator(TranslatorBase):
+    """空翻译器实现类，对于所有输入文本都返回原文，用于调试目的"""
+    
+    # 服务元信息
+    SERVICE_NAME = "null_translator"
+    SUPPORTED_LANGUAGES = {
+        'auto': '自动检测',
+        'en': '英语'
+    }
+    
+    METADATA = Metadata(
+        console_url="",
+        description="空翻译器，对于所有输入文本都返回原文，用于调试目的",
+        documentation_url="",
+        short_description="空翻译器（调试用）",
+        usage_documentation="不发送任何网络请求，直接返回原文，用于调试翻译流程"
+    )
+    
+    def _translate_default(self, text: str, source_lang: str, target_lang: str, **kwargs) -> str:
+        """
+        默认翻译方法，直接返回原文
+        
+        Args:
+            text: 要翻译的文本
+            source_lang: 源语言
+            target_lang: 目标语言
+            **kwargs: 额外参数
+            
+        Returns:
+            原始文本，不做任何翻译
+        """
+        return text
+
+    def _parse_api_response(self, response: Any, **kwargs) -> str:
+        """
+        解析API响应，对于NullTranslator，响应就是原始文本
+        
+        Args:
+            response: API响应（在这里就是原始文本）
+            **kwargs: 额外参数
+            
+        Returns:
+            解析后的翻译文本
+        """
+        return response
+
+    def _validate_languages(self, source_lang: str, target_lang: str):
+        """验证语言对，NullTranslator不做验证，允许所有语言对"""
         pass

{translatekit-0.3.0 → translatekit-0.3.2/translatekit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: translatekit
-Version: 0.3.0
+Version: 0.3.2
 Summary: 一个简单快捷的翻译服务工具包，支持自定义脚本扩展
 Home-page: https://github.com/HZBHZB1234/Py-Translate-Kit
 Author: HZBHZB1234
@@ -39,11 +39,8 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Requires-Python: >=3.6.0
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.25.1
-Requires-Dist: beautifulsoup4>=4.9.3
-Requires-Dist: jsonpatch>=1.26
 Provides-Extra: extras
+License-File: LICENSE
 
 # Py-Translate-Kit 🌐
 

{translatekit-0.3.0 → translatekit-0.3.2}/translatekit.egg-info/SOURCES.txt

@@ -1,13 +1,9 @@
-.gitignore
 LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
 requirements.txt
 setup.py
-docs/TRANSLATION_CONFIG.md
-docs/example.py
-docs/kit.md
 test/test_argu.py
 translatekit/__init__.py
 translatekit/baidu.py
@@ -27,12 +23,6 @@ translatekit/qcri.py
 translatekit/sizhi.py
 translatekit/tencent-hunyuan.py
 translatekit/tencent.py
-translatekit/test2.py
-translatekit/test_ai.py
-translatekit/test_ai_pro.py
-translatekit/test_format.py
-translatekit/test_re.py
-translatekit/test_self.py
 translatekit/yandex.py
 translatekit/youdao.py
 translatekit.egg-info/PKG-INFO

translatekit-0.3.0/.gitignore

@@ -1,222 +0,0 @@
-# custom gitignore
-prompt.md
-dev
-test.py
-test*.py
-!test_argu.py
-test_assets/
-*.docx
-*.pdf
-*.pptx
-.iflowignore
-iflow.md
-.kit
-.vscode
-.rmv
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[codz]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py.cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-.pybuilder/
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-# pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
-
-# pipenv
-#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-#   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
-#Pipfile.lock
-
-# UV
-#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#uv.lock
-
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
-#poetry.toml
-
-# pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
-#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
-#pdm.lock
-#pdm.toml
-.pdm-python
-.pdm-build/
-
-# pixi
-#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
-#pixi.lock
-#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
-#   in the .venv directory. It is recommended not to include this directory in version control.
-.pixi
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.envrc
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Pyre type checker
-.pyre/
-
-# pytype static type analyzer
-.pytype/
-
-# Cython debug symbols
-cython_debug/
-
-# PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
-
-# Abstra
-# Abstra is an AI-powered process automation framework.
-# Ignore directories containing user credentials, local state, and settings.
-# Learn more at https://abstra.io/docs
-.abstra/
-
-# Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
-#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
-#  you could uncomment the following to ignore the entire vscode folder
-# .vscode/
-
-# Ruff stuff:
-.ruff_cache/
-
-# PyPI configuration file
-.pypirc
-
-# Cursor
-#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
-#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
-#  refer to https://docs.cursor.com/context/ignore-files
-.cursorignore
-.cursorindexingignore
-
-# Marimo
-marimo/_static/
-marimo/_lsp/
-__marimo__/

translatekit-0.3.0/docs/TRANSLATION_CONFIG.md

@@ -1,120 +0,0 @@
-# 翻译配置参数详解
-
-本文档详细介绍了 Py-Translate-Kit 中 [TranslationConfig](file:///e:/desktop/limbus%20transfer/Py-Translate-Kit/translatekit/kit.py#L287-L317) 类的所有配置参数，帮助用户更好地理解和使用该翻译工具包。
-
-## 配置参数分类
-
-### 1. API配置
-
-- **api_setting**: `Dict[str, str] = None`
-  - 用于存储API密钥的字典，不同翻译服务需要不同的密钥格式
-  - 默认为None，若未提供则初始化为空字典
-  - 使用示例：`{"appkey": "your_app_key", "secret": "your_secret"}`
-
-### 2. 翻译参数
-
-- **source_lang**: `str = "auto"`
-  - 源语言代码，指定待翻译文本的语言
-  - 默认为"auto"，表示自动检测语言
-  - 支持的语言代码因翻译服务而异
-
-- **target_lang**: `str = "en"`
-  - 目标语言代码，指定翻译后的语言
-  - 默认为"en"（英语）
-
-- **method**: `str = "default"`
-  - 翻译方法选择，用于指定使用哪种翻译策略
-  - 默认为"default"方法
-
-### 3. 文本处理
-
-- **text_max_length**: `int = 2000`
-  - 单次翻译文本的最大长度
-  - 默认值为2000字符，超过此长度的文本将被分块处理
-
-- **split_strategy**: `SplitStrategy = SplitStrategy.SENTENCE`
-  - 文本分割策略，可选值包括：
-    - [SplitStrategy.SENTENCE](translatekit/base.py#L615-L620): 按句子分割
-    - [SplitStrategy.PARAGRAPH](translatekit/base.py#L621-L625): 按段落分割
-    - [SplitStrategy.FIXED_LENGTH](translatekit/base.py#L626-L650): 按固定长度分割
-    - [SplitStrategy.SEMANTIC](translatekit/base.py#L651-L655): 语义分割(待实现)
-
-- **enable_preprocessing**: `bool = True`
-  - 是否启用预处理功能
-  - 默认启用，预处理需要手动添加相关函数
-  - 预处理函数列表默认为空
-
-- **enable_postprocessing**: `bool = True`
-  - 是否启用后处理功能
-  - 默认启用，后处理需要手动添加相关函数
-  - 后处理函数列表默认为空
-
-### 4. 重试与容错
-
-- **max_retries**: `int = 3`
-  - 最大重试次数，当翻译请求失败时的重试次数
-  - 默认为3次
-
-- **retry_strategy**: `RetryStrategy = RetryStrategy.EXPONENTIAL`
-  - 重试策略，可选值包括：
-    - [RetryStrategy.EXPONENTIAL](translatekit/base.py#L687-L696): 指数退避策略
-    - [RetryStrategy.LINEAR](translatekit/base.py#L687-L696): 线性退避策略
-    - [RetryStrategy.ADAPTIVE](translatekit/base.py#L687-L696): 自适应策略
-
-- **timeout**: `float = 30.0`
-  - 请求超时时间（秒）
-  - 默认为30.0秒
-
-### 5. 并发设置
-
-- **max_workers**: `int = 5`
-  - 最大工作线程数，用于并发处理翻译任务
-  - 默认为5个线程
-
-- **batch_size**: `int = 10`
-  - 批处理大小，批量翻译时每批处理的文本数量
-  - 默认为10条
-
-### 6. 高级功能
-
-- **enable_cache**: `bool = False`
-  - 是否启用缓存功能
-  - 默认关闭，开启后可缓存翻译结果，自动匹配相同文本，可以减少重复翻译
-
-- **cache_size**: `Optional[int] = None`
-  - 缓存大小限制
-  - 默认为None，表示无限制
-
-- **enable_metrics**: `bool = False`
-  - 是否启用性能指标收集
-  - 默认关闭，开启后可以追踪翻译使用量
-
-- **debug_mode**: `bool = False`
-  - 是否启用调试模式
-  - 默认关闭，开启后会将logger.level设置为DEBUG，输出更多日志信息
-
-## 使用示例
-
-```python
-import translatekit as tkit
-
-# 创建带自定义配置的翻译器
-config = tkit.TranslationConfig(
-    api_setting={"appkey": "your_app_key"},
-    debug_mode=True,
-    enable_cache=True,
-    cache_size=1000,
-    source_lang="zh",
-    target_lang="en",
-    text_max_length=5000,
-    max_retries=5,
-    timeout=60.0
-)
-
-# 创建翻译器实例
-translator = tkit.BaiduTranslator(config=config)
-
-# 使用翻译器
-result = translator.translate("你好，世界！")
-print(result)
-```