Merge pull request #45 from renan-siqueira/develop

Develop -> main

Author: renan-siqueira

CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 ___
 
+## [0.6.3] - 2025-04-08
+
+### Added
+- New `core/integration.py` module as the explicit integration layer with Azure OpenAI SDK
+- Unit tests for `integration.py` using Python's built-in `unittest` and mock objects
+- Full parameter structure validation for chat completions
+
+### Changed
+- Renamed `core.py` to `integration.py` and removed it from the public interface
+- Main `__init__.py` no longer exposes internal technical functions
+- `core/__init__.py` is now empty to reinforce its internal-only purpose
+
+### Notes
+- No external dependencies were added
+- All tests pass via `unittest` with `python tests/core/test_integration.py`
+
+- Bumped version to 0.6.3
+___
+
 ## [0.6.2] - 2025-04-07
 
 ### Changed

README.md

@@ -59,17 +59,18 @@ A fast, modular, secure, and auditable Python toolkit to integrate with Azure Op
 
 ___
 
-+ ## 🚀 What's New in v0.6.x
+## 🚀 What's New in v0.6.x
 
 - Object-oriented CLI (`rschat`, `rschat-tools`) — easier to test, extend and reuse
 - Persistent session context — with system prompt validation and full/trimmed history tracking
 - Reproducible model config — centralized via `get_model_config()` and `ModelConfig`
 - Transparent logging — structured logs via `InteractionLogger` (CSV/JSONL)
 - Modular architecture — folders like `core/`, `session/`, `logging/`, `model_config/`, etc.
 
-### v0.6.2
-- All sample templates have been fully aligned with the core architecture and CLI
-- Logging, context, result formatting, and safety checks now follow production-grade standards
+### v0.6.3 - latest
+- `core.py` has been refactored and renamed to `core/integration.py` as a dedicated integration layer
+- Added isolated unit tests using Python’s built-in `unittest` (no external test dependencies)
+- Internal interface `core` is no longer exposed publicly, enforcing architectural boundaries
 
 > Check the full [CHANGELOG](https://github.com/renan-siqueira/rsazure-openai-toolkit/blob/main/CHANGELOG.md) for details.
 ___

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rsazure-openai-toolkit"
-version = "0.6.2"
+version = "0.6.3"
 description = "A fast, modular, secure, and auditable toolkit to integrate with Azure OpenAI — with a friendly CLI and dev-first architecture."
 authors = [{ name = "Renan Siqueira Antonio", email = "[email protected]" }]
 readme = { file = "README.md", content-type = "text/markdown" }

src/rsazure_openai_toolkit/__init__.py

@@ -5,10 +5,6 @@
 
 Top-level exports available when importing as `import rsazure_openai_toolkit as rschat`:
 
-# Core interaction
-- rschat.main(...)
-- rschat.generate_response(...)
-
 # Configuration & utility
 - rschat.get_model_config(...)
 - rschat.ModelConfig(...)
@@ -43,9 +39,6 @@
 __security_policy_url__ = "https://github.com/renan-siqueira/rsazure-openai-toolkit/security/policy"
 
 
-# Core interaction
-from .core import main, generate_response
-
 # Utility
 from .utils import estimate_input_tokens
 
@@ -69,10 +62,6 @@
 
 
 __all__ = [
-    # Core OpenAI interaction
-    "main",
-    "generate_response",
-
     # Config & utils
     "get_model_config",
     "ModelConfig",

src/rsazure_openai_toolkit/cli/cli.py

@@ -28,6 +28,7 @@
 import time
 import click
 import rsazure_openai_toolkit as rschat
+from rsazure_openai_toolkit.core import integration as rschat_core
 
 
 class ChatCLI:
@@ -76,7 +77,7 @@ def _estimate_tokens(self):
     def _send_request(self):
         try:
             start = time.time()
-            self.response = rschat.main(
+            self.response = rschat_core.main(
                 api_key=self.config["api_key"],
                 azure_endpoint=self.config["endpoint"],
                 api_version=self.config["version"],

src/rsazure_openai_toolkit/core/__init__.py

@@ -1,17 +1,4 @@
 """
-rsazure_openai_toolkit.core
-
-Core functionality for interacting with Azure OpenAI.
-
-Exports:
-- main(): High-level request handler.
-- generate_response(): Low-level retry-enabled OpenAI call.
+This module contains internal, low-level logic.
+Nothing should be imported directly from this level.
 """
-
-from .core import main, generate_response
-
-
-__all__ = [
-    "main",
-    "generate_response",
-]