PyPI - osbot-utils - Versions diffs - 2.72.0__tar.gz → 2.73.0__tar.gz - Mend

osbot-utils 2.72.0tar.gz → 2.73.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (448) hide show

osbot_utils-2.73.0/PKG-INFO ADDED Viewed

@@ -0,0 +1,212 @@
+Metadata-Version: 2.3
+Name: osbot_utils
+Version: 2.73.0
+Summary: OWASP Security Bot - Utils
+License: MIT
+Author: Dinis Cruz
+Author-email: dinis.cruz@owasp.org
+Requires-Python: >=3.7,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Project-URL: Homepage, https://github.com/owasp-sbot/OSBot-Utils
+Project-URL: Repository, https://github.com/owasp-sbot/OSBot-Utils
+Description-Content-Type: text/markdown
+# OSBot-Utils
+![Current Release](https://img.shields.io/badge/release-v2.73.0-blue)
+![Python](https://img.shields.io/badge/python-3.8+-green)
+![Type-Safe](https://img.shields.io/badge/Type--Safe-✓-brightgreen)
+![Caching](https://img.shields.io/badge/Caching-Built--In-orange)
+[![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
+A comprehensive Python utility toolkit providing **Type-Safe primitives**, decorators, caching layers, HTML/AST helpers, SQLite tooling, SSH execution, LLM request pipelines, tracing, and more — all designed to accelerate building robust, maintainable automation and integration code.
+---
+## ✨ Key Features
+* **🛡️ Type-Safe First**: Strongly typed primitives (`Safe_Str`, `Safe_Int`, `Safe_Float`, etc.) with validation and sanitization
+* **⚡ Multi-layer Caching**: In-memory, per-instance, pickle-on-disk, temp-file, and request/response caches
+* **🗂️ Rich Utilities**: Helpers for HTML parsing/rendering, AST inspection, SSH/SCP execution, SQLite schema management, and more
+* **🧠 LLM Support**: Structured request builders, OpenAI API integration, schema enforcement, and persistent cache
+* **🔍 Tracing & Debugging**: Full function call tracing with configurable depth, locals capture, and pretty output
+* **🧪 Testing Utilities**: Temp SQLite DBs, mockable caches, and easy test helpers
+---
+## 📦 Installation
+```bash
+pip install osbot-utils
+```
+From source:
+```bash
+pip install git+https://github.com/owasp-sbot/OSBot-Utils.git@dev
+```
+---
+## 🚀 Quick Start
+### Using Type-Safe Primitives
+```python
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+class Username(Safe_Str):
+    max_length = 20
+print(Username("alice"))  # 'alice'
+print(Username("invalid username!"))  # 'invalid_username_'
+```
+---
+### Simple In-Memory Caching
+```python
+from osbot_utils.decorators.methods.cache_on_self import cache_on_self
+class DataFetcher:
+    @cache_on_self
+    def fetch(self, x):
+        print("Fetching…")
+        return x * 2
+fetcher = DataFetcher()
+fetcher.fetch(10)  # Calls method
+fetcher.fetch(10)  # Returns cached result
+```
+---
+### HTML Parsing
+```python
+from osbot_utils.helpers.html.Html__To__Html_Dict import html_to_dict
+html_code = "<html><body><h1>Hello</h1></body></html>"
+print(html_to_dict(html_code))
+```
+---
+### SQLite Dynamic Table
+```python
+from osbot_utils.helpers.sqlite.Temp_Sqlite__Table import Temp_Sqlite__Table
+with Temp_Sqlite__Table() as table:
+    table.row_schema = type("Row", (), {"name": str, "age": int})
+    table.create()
+    table.add_row_and_commit(name="Alice", age=30)
+    print(table.rows())
+```
+---
+### LLM Request Execution
+```python
+from osbot_utils.helpers.llms.builders.LLM_Request__Builder__Open_AI import LLM_Request__Builder__Open_AI
+from osbot_utils.helpers.llms.actions.LLM_Request__Execute import LLM_Request__Execute
+builder = LLM_Request__Builder__Open_AI()
+builder.set__model__gpt_4o().add_message__user("Say hi in JSON")
+executor = LLM_Request__Execute(request_builder=builder)
+response = executor.execute(builder.llm_request())
+print(response.response_data)
+```
+---
+## 🏗️ Architecture
+OSBot-Utils is organized into core **Type-Safe foundations** with layered utilities for different domains:
+```
+┌──────────────────────────────────────────────┐
+│                 Your Code                     │
+│  ┌───────────┐  ┌─────────────┐  ┌──────────┐ │
+│  │ Type-Safe │  │  Decorators │  │  Helpers │ │
+│  │ Primitives│  │  & Caching  │  │ (HTML,   │ │
+│  │           │  │             │  │  AST,   │ │
+│  │           │  │             │  │  SQLite)│ │
+│  └───────────┘  └─────────────┘  └──────────┘ │
+└──────────────────────────┬───────────────────┘
+                           │
+┌──────────────────────────▼───────────────────┐
+│                OSBot-Utils                    │
+│  ┌────────────────────────────────────────┐  │
+│  │       Type-Safe Core Classes           │  │
+│  │  Validation / Sanitization / Defaults  │  │
+│  └────────────────────────────────────────┘  │
+│  ┌────────────────────────────────────────┐  │
+│  │    Caching Layers & Decorators         │  │
+│  │  @cache, @cache_on_self, pickle, tmp   │  │
+│  └────────────────────────────────────────┘  │
+│  ┌────────────────────────────────────────┐  │
+│  │ Domain Helpers                          │ │
+│  │ HTML, AST, SSH, LLMs, SQLite, Tracing   │ │
+│  └────────────────────────────────────────┘  │
+└──────────────────────────────────────────────┘
+```
+---
+## 📚 Key Modules
+* **`helpers/safe_*`** — Type-Safe primitives for validated strings, ints, floats
+* **`decorators/methods`** — Caching, exception capture, timing, validation
+* **`helpers/html`** — HTML ↔ dict ↔ tag classes
+* **`helpers/ast`** — Python AST parsing, visiting, merging
+* **`helpers/sqlite`** — High-level SQLite APIs, schema generation, temp DBs
+* **`helpers/ssh`** — SSH/SCP execution with caching
+* **`helpers/llms`** — LLM request/response handling with caching
+* **`helpers/trace`** — Function call tracing with configurable output
+---
+## 🎯 Benefits
+### For Developers
+* Strong runtime type validation with Type-Safe classes
+* Consistent patterns for caching and decorators
+* Rich helper library to avoid reinventing the wheel
+### For Production
+* Deterministic caching with persistence options
+* Safe, validated data structures at integration boundaries
+* Lightweight, dependency-minimal utilities
+### For Teams
+* Standardized approach to cross-cutting concerns (logging, tracing, caching)
+* Modular helpers to fit many contexts (CLI, web apps, serverless)
+---
+## 🤝 Contributing
+Pull requests are welcome!
+Check existing patterns in `/helpers` and `/decorators` for style guidance.
+---
+## 📄 License
+Licensed under the Apache 2.0 License.

osbot_utils-2.73.0/README.md ADDED Viewed

@@ -0,0 +1,190 @@
+# OSBot-Utils
+![Current Release](https://img.shields.io/badge/release-v2.73.0-blue)
+![Python](https://img.shields.io/badge/python-3.8+-green)
+![Type-Safe](https://img.shields.io/badge/Type--Safe-✓-brightgreen)
+![Caching](https://img.shields.io/badge/Caching-Built--In-orange)
+[![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
+A comprehensive Python utility toolkit providing **Type-Safe primitives**, decorators, caching layers, HTML/AST helpers, SQLite tooling, SSH execution, LLM request pipelines, tracing, and more — all designed to accelerate building robust, maintainable automation and integration code.
+---
+## ✨ Key Features
+* **🛡️ Type-Safe First**: Strongly typed primitives (`Safe_Str`, `Safe_Int`, `Safe_Float`, etc.) with validation and sanitization
+* **⚡ Multi-layer Caching**: In-memory, per-instance, pickle-on-disk, temp-file, and request/response caches
+* **🗂️ Rich Utilities**: Helpers for HTML parsing/rendering, AST inspection, SSH/SCP execution, SQLite schema management, and more
+* **🧠 LLM Support**: Structured request builders, OpenAI API integration, schema enforcement, and persistent cache
+* **🔍 Tracing & Debugging**: Full function call tracing with configurable depth, locals capture, and pretty output
+* **🧪 Testing Utilities**: Temp SQLite DBs, mockable caches, and easy test helpers
+---
+## 📦 Installation
+```bash
+pip install osbot-utils
+```
+From source:
+```bash
+pip install git+https://github.com/owasp-sbot/OSBot-Utils.git@dev
+```
+---
+## 🚀 Quick Start
+### Using Type-Safe Primitives
+```python
+from osbot_utils.helpers.safe_str.Safe_Str import Safe_Str
+class Username(Safe_Str):
+    max_length = 20
+print(Username("alice"))  # 'alice'
+print(Username("invalid username!"))  # 'invalid_username_'
+```
+---
+### Simple In-Memory Caching
+```python
+from osbot_utils.decorators.methods.cache_on_self import cache_on_self
+class DataFetcher:
+    @cache_on_self
+    def fetch(self, x):
+        print("Fetching…")
+        return x * 2
+fetcher = DataFetcher()
+fetcher.fetch(10)  # Calls method
+fetcher.fetch(10)  # Returns cached result
+```
+---
+### HTML Parsing
+```python
+from osbot_utils.helpers.html.Html__To__Html_Dict import html_to_dict
+html_code = "<html><body><h1>Hello</h1></body></html>"
+print(html_to_dict(html_code))
+```
+---
+### SQLite Dynamic Table
+```python
+from osbot_utils.helpers.sqlite.Temp_Sqlite__Table import Temp_Sqlite__Table
+with Temp_Sqlite__Table() as table:
+    table.row_schema = type("Row", (), {"name": str, "age": int})
+    table.create()
+    table.add_row_and_commit(name="Alice", age=30)
+    print(table.rows())
+```
+---
+### LLM Request Execution
+```python
+from osbot_utils.helpers.llms.builders.LLM_Request__Builder__Open_AI import LLM_Request__Builder__Open_AI
+from osbot_utils.helpers.llms.actions.LLM_Request__Execute import LLM_Request__Execute
+builder = LLM_Request__Builder__Open_AI()
+builder.set__model__gpt_4o().add_message__user("Say hi in JSON")
+executor = LLM_Request__Execute(request_builder=builder)
+response = executor.execute(builder.llm_request())
+print(response.response_data)
+```
+---
+## 🏗️ Architecture
+OSBot-Utils is organized into core **Type-Safe foundations** with layered utilities for different domains:
+```
+┌──────────────────────────────────────────────┐
+│                 Your Code                     │
+│  ┌───────────┐  ┌─────────────┐  ┌──────────┐ │
+│  │ Type-Safe │  │  Decorators │  │  Helpers │ │
+│  │ Primitives│  │  & Caching  │  │ (HTML,   │ │
+│  │           │  │             │  │  AST,   │ │
+│  │           │  │             │  │  SQLite)│ │
+│  └───────────┘  └─────────────┘  └──────────┘ │
+└──────────────────────────┬───────────────────┘
+                           │
+┌──────────────────────────▼───────────────────┐
+│                OSBot-Utils                    │
+│  ┌────────────────────────────────────────┐  │
+│  │       Type-Safe Core Classes           │  │
+│  │  Validation / Sanitization / Defaults  │  │
+│  └────────────────────────────────────────┘  │
+│  ┌────────────────────────────────────────┐  │
+│  │    Caching Layers & Decorators         │  │
+│  │  @cache, @cache_on_self, pickle, tmp   │  │
+│  └────────────────────────────────────────┘  │
+│  ┌────────────────────────────────────────┐  │
+│  │ Domain Helpers                          │ │
+│  │ HTML, AST, SSH, LLMs, SQLite, Tracing   │ │
+│  └────────────────────────────────────────┘  │
+└──────────────────────────────────────────────┘
+```
+---
+## 📚 Key Modules
+* **`helpers/safe_*`** — Type-Safe primitives for validated strings, ints, floats
+* **`decorators/methods`** — Caching, exception capture, timing, validation
+* **`helpers/html`** — HTML ↔ dict ↔ tag classes
+* **`helpers/ast`** — Python AST parsing, visiting, merging
+* **`helpers/sqlite`** — High-level SQLite APIs, schema generation, temp DBs
+* **`helpers/ssh`** — SSH/SCP execution with caching
+* **`helpers/llms`** — LLM request/response handling with caching
+* **`helpers/trace`** — Function call tracing with configurable output
+---
+## 🎯 Benefits
+### For Developers
+* Strong runtime type validation with Type-Safe classes
+* Consistent patterns for caching and decorators
+* Rich helper library to avoid reinventing the wheel
+### For Production
+* Deterministic caching with persistence options
+* Safe, validated data structures at integration boundaries
+* Lightweight, dependency-minimal utilities
+### For Teams
+* Standardized approach to cross-cutting concerns (logging, tracing, caching)
+* Modular helpers to fit many contexts (CLI, web apps, serverless)
+---
+## 🤝 Contributing
+Pull requests are welcome!
+Check existing patterns in `/helpers` and `/decorators` for style guidance.
+---
+## 📄 License
+Licensed under the Apache 2.0 License.

osbot_utils-2.73.0/osbot_utils/version ADDED Viewed

	@@ -0,0 +1 @@
1	+ v2.73.0

{osbot_utils-2.72.0 → osbot_utils-2.73.0}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [tool.poetry]
 name        = "osbot_utils"
-version     = "v2.72.0"
+version     = "v2.73.0"
 description = "OWASP Security Bot - Utils"
 authors     = ["Dinis Cruz <dinis.cruz@owasp.org>"]
 license     = "MIT"

osbot_utils-2.72.0/PKG-INFO DELETED Viewed

@@ -1,44 +0,0 @@
-Metadata-Version: 2.3
-Name: osbot_utils
-Version: 2.72.0
-Summary: OWASP Security Bot - Utils
-License: MIT
-Author: Dinis Cruz
-Author-email: dinis.cruz@owasp.org
-Requires-Python: >=3.7,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Project-URL: Homepage, https://github.com/owasp-sbot/OSBot-Utils
-Project-URL: Repository, https://github.com/owasp-sbot/OSBot-Utils
-Description-Content-Type: text/markdown
-# OSBot-Utils
-Powerful Python util methods and classes that simplify common apis and tasks.
-![Current Release](https://img.shields.io/badge/release-v2.72.0-blue)
-[![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
-## Install - Release 1.x
-**for main branch**: just get it from pypi
-```
-pip install osbot-utils
-```
-**for dev branch**: add to requirements.txt
-```
-git+https://github.com/owasp-sbot/OSBot-Utils.git@dev
-```

osbot_utils-2.72.0/README.md DELETED Viewed

@@ -1,22 +0,0 @@
-# OSBot-Utils
-Powerful Python util methods and classes that simplify common apis and tasks.
-![Current Release](https://img.shields.io/badge/release-v2.72.0-blue)
-[![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
-## Install - Release 1.x
-**for main branch**: just get it from pypi
-```
-pip install osbot-utils
-```
-**for dev branch**: add to requirements.txt
-```
-git+https://github.com/owasp-sbot/OSBot-Utils.git@dev
-```