hamtaa-texttools 1.3.2__tar.gz → 2.1.0__tar.gz

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hamtaa-texttools
-Version: 1.3.2
+Version: 2.1.0
 Summary: A high-level NLP toolkit built on top of modern LLMs.
 Author-email: Tohidi <the.mohammad.tohidi@gmail.com>, Erfan Moosavi <erfanmoosavi84@gmail.com>, Montazer <montazerh82@gmail.com>, Givechi <mohamad.m.givechi@gmail.com>, Zareshahi <a.zareshahi1377@gmail.com>
 Maintainer-email: Erfan Moosavi <erfanmoosavi84@gmail.com>, Tohidi <the.mohammad.tohidi@gmail.com>
@@ -11,9 +11,10 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Text Processing
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: dotenv>=0.9.9
 Requires-Dist: openai>=1.97.1
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
@@ -30,30 +31,27 @@ Dynamic: license-file
 
 It provides both **sync (`TheTool`)** and **async (`AsyncTheTool`)** APIs for maximum flexibility.
 
-It provides ready-to-use utilities for **translation, question detection, keyword extraction, categorization, NER extraction, and more** - designed to help you integrate AI-powered text processing into your applications with minimal effort.
-
-**Note:** Most features of `texttools` are reliable when you use `google/gemma-3n-e4b-it` model.
+It provides ready-to-use utilities for **translation, question detection, categorization, NER extraction, and more** - designed to help you integrate AI-powered text processing into your applications with minimal effort.
 
 ---
 
 ## ✨ Features
 
-TextTools provides a rich collection of high-level NLP utilities,
+TextTools provides a collection of high-level NLP utilities.
 Each tool is designed to work with structured outputs.
 
-- **`categorize()`** - Classifies text into given categories
-- **`extract_keywords()`** - Extracts keywords from the text
-- **`extract_entities()`** - Named Entity Recognition (NER) system
-- **`is_question()`** - Binary question detection
-- **`text_to_question()`** - Generates questions from text
-- **`merge_questions()`** - Merges multiple questions into one
-- **`rewrite()`** - Rewrites text in a different way
-- **`subject_to_question()`** - Generates questions about a given subject
-- **`summarize()`** - Text summarization
-- **`translate()`** - Text translation
-- **`propositionize()`** - Convert text to atomic independent meaningful sentences 
-- **`check_fact()`** - Check whether a statement is relevant to the source text
-- **`run_custom()`** - Allows users to define a custom tool with an arbitrary BaseModel
+- **`categorize()`** - Classify text into given categories
+- **`extract_keywords()`** - Extract keywords from the text
+- **`extract_entities()`** - Perform Named Entity Recognition (NER)
+- **`is_question()`** - Detect if the input is phrased as a question
+- **`to_question()`** - Generate questions from the given text / subject
+- **`merge_questions()`** - Merge multiple questions into one
+- **`augment()`** - Rewrite text in different augmentations
+- **`summarize()`** - Summarize the given text
+- **`translate()`** - Translate text between languages
+- **`propositionize()`** - Convert a text into atomic, independent, meaningful sentences 
+- **`is_fact()`** - Check whether a statement is a fact based on the source text
+- **`run_custom()`** - Custom tool that can do almost anything
 
 ---
 
@@ -71,14 +69,14 @@ pip install -U hamtaa-texttools
 
 | Status | Meaning | Tools | Safe for Production? |
 |--------|---------|----------|-------------------|
-| **✅ Production** | Evaluated, tested, stable. | `categorize()` (list mode), `extract_keywords()`, `extract_entities()`, `is_question()`, `text_to_question()`, `merge_questions()`, `rewrite()`, `subject_to_question()`, `summarize()`, `run_custom()` | **Yes** - ready for reliable use. |
-| **🧪 Experimental** | Added to the package but **not fully evaluated**. Functional, but quality may vary. | `categorize()` (tree mode), `translate()`, `propositionize()`, `check_fact()` | **Use with caution** - outputs not yet validated. |
+| **✅ Production** | Evaluated and tested. | `categorize()`, `extract_keywords()`, `extract_entities()`, `is_question()`, `to_question()`, `merge_questions()`, `augment()`, `summarize()`, `run_custom()` | **Yes** - ready for reliable use. |
+| **🧪 Experimental** | Added to the package but **not fully evaluated**. |  `translate()`, `propositionize()`, `is_fact()` | **Use with caution** |
 
 ---
 
-## ⚙️ `with_analysis`, `logprobs`, `output_lang`, `user_prompt`, `temperature`, `validator`, `priority` and `timeout` parameters
+## ⚙️ Additional Parameters
 
-TextTools provides several optional flags to customize LLM behavior:
+- **`raise_on_error: bool`** → (`TheTool/AsyncTheTool` parameter) Raise errors (True) or return them in output (False). Default is True.
 
 - **`with_analysis: bool`** → Adds a reasoning step before generating the final output.
 **Note:** This doubles token usage per call.
@@ -88,17 +86,17 @@ TextTools provides several optional flags to customize LLM behavior:
 
 - **`output_lang: str`** → Forces the model to respond in a specific language.
 
-- **`user_prompt: str`** → Allows you to inject a custom instruction or into the model alongside the main template. This gives you fine-grained control over how the model interprets or modifies the input text.
+- **`user_prompt: str`** → Allows you to inject a custom instruction into the model alongside the main template.
 
-- **`temperature: float`** → Determines how creative the model should respond. Takes a float number from `0.0` to `2.0`.
+- **`temperature: float`** → Determines how creative the model should respond. Takes a float number between `0.0` and `2.0`.
 
-- **`validator: Callable (Experimental)`** → Forces TheTool to validate the output result based on your custom validator. Validator should return a boolean. If the validator fails, TheTool will retry to get another output by modifying `temperature`. You can also specify `max_validation_retries=<N>`.
+- **`validator: Callable (Experimental)`** → Forces the tool to validate the output result based on your validator function. Validator should return a boolean. If the validator fails, TheTool will retry to get another output by modifying `temperature`. You can also specify `max_validation_retries=<N>`.
 
-- **`priority: int (Experimental)`** → Task execution priority level. Affects processing order in queues.
+- **`priority: int (Experimental)`** → Affects processing order in queues.  
 **Note:** This feature works if it's supported by the model and vLLM.
 
-- **`timeout: float`** → Maximum time in seconds to wait for the response before raising a timeout error
-**Note:** This feature only exists in `AsyncTheTool`.
+- **`timeout: float`** → Maximum time in seconds to wait for the response before raising a timeout error.  
+**Note:** This feature is only available in `AsyncTheTool`.
 
 
 ---
@@ -110,12 +108,14 @@ Every tool of `TextTools` returns a `ToolOutput` object which is a BaseModel wit
 - **`analysis: str`**
 - **`logprobs: list`**
 - **`errors: list[str]`**
-- **`ToolOutputMetadata`** →
+- **`ToolOutputMetadata`**  
     - **`tool_name: str`**
     - **`processed_at: datetime`**
     - **`execution_time: float`**
 
-**Note:** You can use `repr(ToolOutput)` to print your output with all the details.
+- Serialize output to JSON using the `to_json()` method.
+- Verify operation success with the `is_successful()` method.
+- Convert output to a dictionary with the `to_dict()` method.
 
 ---
 
@@ -133,13 +133,13 @@ Every tool of `TextTools` returns a `ToolOutput` object which is a BaseModel wit
 from openai import OpenAI
 from texttools import TheTool
 
-client = OpenAI(base_url = "your_url", API_KEY = "your_api_key")
+client = OpenAI(base_url="your_url", API_KEY="your_api_key")
 model = "model_name"
 
 the_tool = TheTool(client=client, model=model)
 
 detection = the_tool.is_question("Is this project open source?")
-print(repr(detection))
+print(detection.to_json())
 ```
 
 ---
@@ -157,30 +157,23 @@ async def main():
 
     async_the_tool = AsyncTheTool(client=async_client, model=model)
     
-    translation_task = async_the_tool.translate("سلام، حالت چطوره؟", target_language="English")
-    keywords_task = async_the_tool.extract_keywords("Tomorrow, we will be dead by the car crash")
+    translation_task = async_the_tool.translate("سلام، حالت چطوره؟", target_lang="English")
+    keywords_task = async_the_tool.extract_keywords("This open source project is great for processing large datasets!")
 
     (translation, keywords) = await asyncio.gather(translation_task, keywords_task)
-    print(repr(translation))
-    print(repr(keywords))
+    
+    print(translation.to_json())
+    print(keywords.to_json())
 
 asyncio.run(main())
 ```
 
 ---
 
-## 👍 Use Cases
+## ✅ Use Cases
 
 Use **TextTools** when you need to:
 
-- 🔍 **Classify** large datasets quickly without model training  
-- 🌍 **Translate** and process multilingual corpora with ease  
+- 🔍 **Classify** large datasets quickly without model training   
 - 🧩 **Integrate** LLMs into production pipelines (structured outputs)  
 - 📊 **Analyze** large text collections using embeddings and categorization  
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome!  
-Feel free to **open issues, suggest new features, or submit pull requests**.  

hamtaa_texttools-2.1.0/README.md

@@ -0,0 +1,157 @@
+# TextTools
+
+![PyPI](https://img.shields.io/pypi/v/hamtaa-texttools)
+![License](https://img.shields.io/pypi/l/hamtaa-texttools)
+
+## 📌 Overview
+
+**TextTools** is a high-level **NLP toolkit** built on top of **LLMs**.  
+
+It provides both **sync (`TheTool`)** and **async (`AsyncTheTool`)** APIs for maximum flexibility.
+
+It provides ready-to-use utilities for **translation, question detection, categorization, NER extraction, and more** - designed to help you integrate AI-powered text processing into your applications with minimal effort.
+
+---
+
+## ✨ Features
+
+TextTools provides a collection of high-level NLP utilities.
+Each tool is designed to work with structured outputs.
+
+- **`categorize()`** - Classify text into given categories
+- **`extract_keywords()`** - Extract keywords from the text
+- **`extract_entities()`** - Perform Named Entity Recognition (NER)
+- **`is_question()`** - Detect if the input is phrased as a question
+- **`to_question()`** - Generate questions from the given text / subject
+- **`merge_questions()`** - Merge multiple questions into one
+- **`augment()`** - Rewrite text in different augmentations
+- **`summarize()`** - Summarize the given text
+- **`translate()`** - Translate text between languages
+- **`propositionize()`** - Convert a text into atomic, independent, meaningful sentences 
+- **`is_fact()`** - Check whether a statement is a fact based on the source text
+- **`run_custom()`** - Custom tool that can do almost anything
+
+---
+
+## 🚀 Installation
+
+Install the latest release via PyPI:
+
+```bash
+pip install -U hamtaa-texttools
+```
+
+---
+
+## 📊 Tool Quality Tiers
+
+| Status | Meaning | Tools | Safe for Production? |
+|--------|---------|----------|-------------------|
+| **✅ Production** | Evaluated and tested. | `categorize()`, `extract_keywords()`, `extract_entities()`, `is_question()`, `to_question()`, `merge_questions()`, `augment()`, `summarize()`, `run_custom()` | **Yes** - ready for reliable use. |
+| **🧪 Experimental** | Added to the package but **not fully evaluated**. |  `translate()`, `propositionize()`, `is_fact()` | **Use with caution** |
+
+---
+
+## ⚙️ Additional Parameters
+
+- **`raise_on_error: bool`** → (`TheTool/AsyncTheTool` parameter) Raise errors (True) or return them in output (False). Default is True.
+
+- **`with_analysis: bool`** → Adds a reasoning step before generating the final output.
+**Note:** This doubles token usage per call.
+
+- **`logprobs: bool`** → Returns token-level probabilities for the generated output. You can also specify `top_logprobs=<N>` to get the top N alternative tokens and their probabilities.  
+**Note:** This feature works if it's supported by the model.
+
+- **`output_lang: str`** → Forces the model to respond in a specific language.
+
+- **`user_prompt: str`** → Allows you to inject a custom instruction into the model alongside the main template.
+
+- **`temperature: float`** → Determines how creative the model should respond. Takes a float number between `0.0` and `2.0`.
+
+- **`validator: Callable (Experimental)`** → Forces the tool to validate the output result based on your validator function. Validator should return a boolean. If the validator fails, TheTool will retry to get another output by modifying `temperature`. You can also specify `max_validation_retries=<N>`.
+
+- **`priority: int (Experimental)`** → Affects processing order in queues.  
+**Note:** This feature works if it's supported by the model and vLLM.
+
+- **`timeout: float`** → Maximum time in seconds to wait for the response before raising a timeout error.  
+**Note:** This feature is only available in `AsyncTheTool`.
+
+
+---
+
+## 🧩 ToolOutput
+
+Every tool of `TextTools` returns a `ToolOutput` object which is a BaseModel with attributes:
+- **`result: Any`**
+- **`analysis: str`**
+- **`logprobs: list`**
+- **`errors: list[str]`**
+- **`ToolOutputMetadata`**  
+    - **`tool_name: str`**
+    - **`processed_at: datetime`**
+    - **`execution_time: float`**
+
+- Serialize output to JSON using the `to_json()` method.
+- Verify operation success with the `is_successful()` method.
+- Convert output to a dictionary with the `to_dict()` method.
+
+---
+
+## 🧨 Sync vs Async
+| Tool         | Style   | Use case                                    |
+|--------------|---------|---------------------------------------------|
+| `TheTool`    | Sync    | Simple scripts, sequential workflows        |
+| `AsyncTheTool` | Async | High-throughput apps, APIs, concurrent tasks |
+
+---
+
+## ⚡ Quick Start (Sync)
+
+```python
+from openai import OpenAI
+from texttools import TheTool
+
+client = OpenAI(base_url="your_url", API_KEY="your_api_key")
+model = "model_name"
+
+the_tool = TheTool(client=client, model=model)
+
+detection = the_tool.is_question("Is this project open source?")
+print(detection.to_json())
+```
+
+---
+
+## ⚡ Quick Start (Async)
+
+```python
+import asyncio
+from openai import AsyncOpenAI
+from texttools import AsyncTheTool
+
+async def main():
+    async_client = AsyncOpenAI(base_url="your_url", api_key="your_api_key")
+    model = "model_name"
+
+    async_the_tool = AsyncTheTool(client=async_client, model=model)
+    
+    translation_task = async_the_tool.translate("سلام، حالت چطوره؟", target_lang="English")
+    keywords_task = async_the_tool.extract_keywords("This open source project is great for processing large datasets!")
+
+    (translation, keywords) = await asyncio.gather(translation_task, keywords_task)
+    
+    print(translation.to_json())
+    print(keywords.to_json())
+
+asyncio.run(main())
+```
+
+---
+
+## ✅ Use Cases
+
+Use **TextTools** when you need to:
+
+- 🔍 **Classify** large datasets quickly without model training   
+- 🧩 **Integrate** LLMs into production pipelines (structured outputs)  
+- 📊 **Analyze** large text collections using embeddings and categorization  

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/hamtaa_texttools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hamtaa-texttools
-Version: 1.3.2
+Version: 2.1.0
 Summary: A high-level NLP toolkit built on top of modern LLMs.
 Author-email: Tohidi <the.mohammad.tohidi@gmail.com>, Erfan Moosavi <erfanmoosavi84@gmail.com>, Montazer <montazerh82@gmail.com>, Givechi <mohamad.m.givechi@gmail.com>, Zareshahi <a.zareshahi1377@gmail.com>
 Maintainer-email: Erfan Moosavi <erfanmoosavi84@gmail.com>, Tohidi <the.mohammad.tohidi@gmail.com>
@@ -11,9 +11,10 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Text Processing
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: dotenv>=0.9.9
 Requires-Dist: openai>=1.97.1
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
@@ -30,30 +31,27 @@ Dynamic: license-file
 
 It provides both **sync (`TheTool`)** and **async (`AsyncTheTool`)** APIs for maximum flexibility.
 
-It provides ready-to-use utilities for **translation, question detection, keyword extraction, categorization, NER extraction, and more** - designed to help you integrate AI-powered text processing into your applications with minimal effort.
-
-**Note:** Most features of `texttools` are reliable when you use `google/gemma-3n-e4b-it` model.
+It provides ready-to-use utilities for **translation, question detection, categorization, NER extraction, and more** - designed to help you integrate AI-powered text processing into your applications with minimal effort.
 
 ---
 
 ## ✨ Features
 
-TextTools provides a rich collection of high-level NLP utilities,
+TextTools provides a collection of high-level NLP utilities.
 Each tool is designed to work with structured outputs.
 
-- **`categorize()`** - Classifies text into given categories
-- **`extract_keywords()`** - Extracts keywords from the text
-- **`extract_entities()`** - Named Entity Recognition (NER) system
-- **`is_question()`** - Binary question detection
-- **`text_to_question()`** - Generates questions from text
-- **`merge_questions()`** - Merges multiple questions into one
-- **`rewrite()`** - Rewrites text in a different way
-- **`subject_to_question()`** - Generates questions about a given subject
-- **`summarize()`** - Text summarization
-- **`translate()`** - Text translation
-- **`propositionize()`** - Convert text to atomic independent meaningful sentences 
-- **`check_fact()`** - Check whether a statement is relevant to the source text
-- **`run_custom()`** - Allows users to define a custom tool with an arbitrary BaseModel
+- **`categorize()`** - Classify text into given categories
+- **`extract_keywords()`** - Extract keywords from the text
+- **`extract_entities()`** - Perform Named Entity Recognition (NER)
+- **`is_question()`** - Detect if the input is phrased as a question
+- **`to_question()`** - Generate questions from the given text / subject
+- **`merge_questions()`** - Merge multiple questions into one
+- **`augment()`** - Rewrite text in different augmentations
+- **`summarize()`** - Summarize the given text
+- **`translate()`** - Translate text between languages
+- **`propositionize()`** - Convert a text into atomic, independent, meaningful sentences 
+- **`is_fact()`** - Check whether a statement is a fact based on the source text
+- **`run_custom()`** - Custom tool that can do almost anything
 
 ---
 
@@ -71,14 +69,14 @@ pip install -U hamtaa-texttools
 
 | Status | Meaning | Tools | Safe for Production? |
 |--------|---------|----------|-------------------|
-| **✅ Production** | Evaluated, tested, stable. | `categorize()` (list mode), `extract_keywords()`, `extract_entities()`, `is_question()`, `text_to_question()`, `merge_questions()`, `rewrite()`, `subject_to_question()`, `summarize()`, `run_custom()` | **Yes** - ready for reliable use. |
-| **🧪 Experimental** | Added to the package but **not fully evaluated**. Functional, but quality may vary. | `categorize()` (tree mode), `translate()`, `propositionize()`, `check_fact()` | **Use with caution** - outputs not yet validated. |
+| **✅ Production** | Evaluated and tested. | `categorize()`, `extract_keywords()`, `extract_entities()`, `is_question()`, `to_question()`, `merge_questions()`, `augment()`, `summarize()`, `run_custom()` | **Yes** - ready for reliable use. |
+| **🧪 Experimental** | Added to the package but **not fully evaluated**. |  `translate()`, `propositionize()`, `is_fact()` | **Use with caution** |
 
 ---
 
-## ⚙️ `with_analysis`, `logprobs`, `output_lang`, `user_prompt`, `temperature`, `validator`, `priority` and `timeout` parameters
+## ⚙️ Additional Parameters
 
-TextTools provides several optional flags to customize LLM behavior:
+- **`raise_on_error: bool`** → (`TheTool/AsyncTheTool` parameter) Raise errors (True) or return them in output (False). Default is True.
 
 - **`with_analysis: bool`** → Adds a reasoning step before generating the final output.
 **Note:** This doubles token usage per call.
@@ -88,17 +86,17 @@ TextTools provides several optional flags to customize LLM behavior:
 
 - **`output_lang: str`** → Forces the model to respond in a specific language.
 
-- **`user_prompt: str`** → Allows you to inject a custom instruction or into the model alongside the main template. This gives you fine-grained control over how the model interprets or modifies the input text.
+- **`user_prompt: str`** → Allows you to inject a custom instruction into the model alongside the main template.
 
-- **`temperature: float`** → Determines how creative the model should respond. Takes a float number from `0.0` to `2.0`.
+- **`temperature: float`** → Determines how creative the model should respond. Takes a float number between `0.0` and `2.0`.
 
-- **`validator: Callable (Experimental)`** → Forces TheTool to validate the output result based on your custom validator. Validator should return a boolean. If the validator fails, TheTool will retry to get another output by modifying `temperature`. You can also specify `max_validation_retries=<N>`.
+- **`validator: Callable (Experimental)`** → Forces the tool to validate the output result based on your validator function. Validator should return a boolean. If the validator fails, TheTool will retry to get another output by modifying `temperature`. You can also specify `max_validation_retries=<N>`.
 
-- **`priority: int (Experimental)`** → Task execution priority level. Affects processing order in queues.
+- **`priority: int (Experimental)`** → Affects processing order in queues.  
 **Note:** This feature works if it's supported by the model and vLLM.
 
-- **`timeout: float`** → Maximum time in seconds to wait for the response before raising a timeout error
-**Note:** This feature only exists in `AsyncTheTool`.
+- **`timeout: float`** → Maximum time in seconds to wait for the response before raising a timeout error.  
+**Note:** This feature is only available in `AsyncTheTool`.
 
 
 ---
@@ -110,12 +108,14 @@ Every tool of `TextTools` returns a `ToolOutput` object which is a BaseModel wit
 - **`analysis: str`**
 - **`logprobs: list`**
 - **`errors: list[str]`**
-- **`ToolOutputMetadata`** →
+- **`ToolOutputMetadata`**  
     - **`tool_name: str`**
     - **`processed_at: datetime`**
     - **`execution_time: float`**
 
-**Note:** You can use `repr(ToolOutput)` to print your output with all the details.
+- Serialize output to JSON using the `to_json()` method.
+- Verify operation success with the `is_successful()` method.
+- Convert output to a dictionary with the `to_dict()` method.
 
 ---
 
@@ -133,13 +133,13 @@ Every tool of `TextTools` returns a `ToolOutput` object which is a BaseModel wit
 from openai import OpenAI
 from texttools import TheTool
 
-client = OpenAI(base_url = "your_url", API_KEY = "your_api_key")
+client = OpenAI(base_url="your_url", API_KEY="your_api_key")
 model = "model_name"
 
 the_tool = TheTool(client=client, model=model)
 
 detection = the_tool.is_question("Is this project open source?")
-print(repr(detection))
+print(detection.to_json())
 ```
 
 ---
@@ -157,30 +157,23 @@ async def main():
 
     async_the_tool = AsyncTheTool(client=async_client, model=model)
     
-    translation_task = async_the_tool.translate("سلام، حالت چطوره؟", target_language="English")
-    keywords_task = async_the_tool.extract_keywords("Tomorrow, we will be dead by the car crash")
+    translation_task = async_the_tool.translate("سلام، حالت چطوره؟", target_lang="English")
+    keywords_task = async_the_tool.extract_keywords("This open source project is great for processing large datasets!")
 
     (translation, keywords) = await asyncio.gather(translation_task, keywords_task)
-    print(repr(translation))
-    print(repr(keywords))
+    
+    print(translation.to_json())
+    print(keywords.to_json())
 
 asyncio.run(main())
 ```
 
 ---
 
-## 👍 Use Cases
+## ✅ Use Cases
 
 Use **TextTools** when you need to:
 
-- 🔍 **Classify** large datasets quickly without model training  
-- 🌍 **Translate** and process multilingual corpora with ease  
+- 🔍 **Classify** large datasets quickly without model training   
 - 🧩 **Integrate** LLMs into production pipelines (structured outputs)  
 - 📊 **Analyze** large text collections using embeddings and categorization  
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome!  
-Feel free to **open issues, suggest new features, or submit pull requests**.  

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/hamtaa_texttools.egg-info/SOURCES.txt

@@ -6,31 +6,29 @@ hamtaa_texttools.egg-info/SOURCES.txt
 hamtaa_texttools.egg-info/dependency_links.txt
 hamtaa_texttools.egg-info/requires.txt
 hamtaa_texttools.egg-info/top_level.txt
-tests/test_all_async_tools.py
-tests/test_all_tools.py
-tests/test_output_validation.py
+tests/test_category_tree.py
+tests/test_to_chunks.py
 texttools/__init__.py
 texttools/models.py
 texttools/py.typed
 texttools/core/__init__.py
-texttools/core/engine.py
 texttools/core/exceptions.py
 texttools/core/internal_models.py
+texttools/core/utils.py
 texttools/core/operators/__init__.py
 texttools/core/operators/async_operator.py
 texttools/core/operators/sync_operator.py
+texttools/prompts/augment.yaml
 texttools/prompts/categorize.yaml
-texttools/prompts/check_fact.yaml
 texttools/prompts/extract_entities.yaml
 texttools/prompts/extract_keywords.yaml
+texttools/prompts/is_fact.yaml
 texttools/prompts/is_question.yaml
 texttools/prompts/merge_questions.yaml
 texttools/prompts/propositionize.yaml
-texttools/prompts/rewrite.yaml
 texttools/prompts/run_custom.yaml
-texttools/prompts/subject_to_question.yaml
 texttools/prompts/summarize.yaml
-texttools/prompts/text_to_question.yaml
+texttools/prompts/to_question.yaml
 texttools/prompts/translate.yaml
 texttools/tools/__init__.py
 texttools/tools/async_tools.py

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/hamtaa_texttools.egg-info/requires.txt

@@ -1,3 +1,4 @@
+dotenv>=0.9.9
 openai>=1.97.1
 pydantic>=2.0.0
 pyyaml>=6.0

{hamtaa_texttools-1.3.2 → hamtaa_texttools-2.1.0}/pyproject.toml

@@ -1,45 +1,46 @@
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "hamtaa-texttools"
-version = "1.3.2"
-authors = [
-  {name = "Tohidi", email = "the.mohammad.tohidi@gmail.com"},
-  {name = "Erfan Moosavi", email = "erfanmoosavi84@gmail.com"},
-  {name = "Montazer", email = "montazerh82@gmail.com"},
-  {name = "Givechi", email = "mohamad.m.givechi@gmail.com"},
-  {name = "Zareshahi", email = "a.zareshahi1377@gmail.com"},
-]
-maintainers = [
-    {name = "Erfan Moosavi", email = "erfanmoosavi84@gmail.com"},
-    {name = "Tohidi", email = "the.mohammad.tohidi@gmail.com"},
-]
-description = "A high-level NLP toolkit built on top of modern LLMs."
-readme = "README.md"
-license = {text = "MIT"}
-requires-python = ">=3.9"
-dependencies = [
-  "openai>=1.97.1",
-  "pydantic>=2.0.0",
-  "pyyaml>=6.0",
-]
-keywords = ["nlp", "llm", "text-processing", "openai"]
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "License :: OSI Approved :: MIT License",
-    "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    "Topic :: Text Processing",
-    "Operating System :: OS Independent",
-]
-
-[tool.setuptools.packages.find]
-where = ["."]
-include = ["texttools*"]
-
-[tool.setuptools]
-include-package-data = true
-
-[tool.setuptools.package-data]
-"texttools" = ["prompts/*.yaml", "py.typed"]
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hamtaa-texttools"
+version = "2.1.0"
+authors = [
+  {name = "Tohidi", email = "the.mohammad.tohidi@gmail.com"},
+  {name = "Erfan Moosavi", email = "erfanmoosavi84@gmail.com"},
+  {name = "Montazer", email = "montazerh82@gmail.com"},
+  {name = "Givechi", email = "mohamad.m.givechi@gmail.com"},
+  {name = "Zareshahi", email = "a.zareshahi1377@gmail.com"},
+]
+maintainers = [
+    {name = "Erfan Moosavi", email = "erfanmoosavi84@gmail.com"},
+    {name = "Tohidi", email = "the.mohammad.tohidi@gmail.com"},
+]
+description = "A high-level NLP toolkit built on top of modern LLMs."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+dependencies = [
+  "dotenv>=0.9.9",
+  "openai>=1.97.1",
+  "pydantic>=2.0.0",
+  "pyyaml>=6.0",
+]
+keywords = ["nlp", "llm", "text-processing", "openai"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Text Processing",
+    "Operating System :: OS Independent",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["texttools*"]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"texttools" = ["prompts/*.yaml", "py.typed"]