b1sl-python 0.1.0__tar.gz → 0.1.2__tar.gz

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/.env.example

@@ -27,3 +27,7 @@ SAP_B1_INTEGRATION=0
 # B1SL_ETAG_CACHE_SIZE=256
 # B1SL_CONNECT_TIMEOUT=10
 # B1SL_READ_TIMEOUT=60
+
+# --- Safety & Debugging ---
+# Set to 1 to intercept all write requests (POST, PATCH, DELETE) without hitting SAP.
+B1SL_DRY_RUN=0

b1sl_python-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  PYTHON_VERSION: ${{ vars.PYTHON_VERSION || '3.12' }}
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Lint & Test 🧪
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Set up Python
+      run: uv python install ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev
+
+    - name: Run linting (Ruff)
+      run: uv run ruff check .
+
+    - name: Run unit tests (Pytest)
+      run: uv run pytest tests/unit/

b1sl_python-0.1.2/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  PYTHON_VERSION: ${{ vars.PYTHON_VERSION || '3.12' }}
+
+jobs:
+  test:
+    name: Run Unit Tests 🧪
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+      - name: Run unit tests
+        run: uv run pytest tests/unit/
+
+  build-n-publish:
+    name: Build & publish 📦
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Required for Trusted Publishing if used
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      - name: Build distribution
+        run: uv build
+      - name: Publish package to PyPI 🐍
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: uv publish

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/Makefile

@@ -52,6 +52,21 @@ lint:
 	$(VENV)/bin/ruff check src tests
 	$(VENV)/bin/mypy src
 
+# Release automation (Pro mode)
+# Usage: make release v=0.1.x
+release: lint test
+	@if [ -z "$(v)" ]; then \
+		echo "❌ Error: Version required. Example: make release v=0.1.2"; \
+		exit 1; \
+	fi
+	@echo "🚀 Preparing release v$(v)..."
+	git add .
+	git commit -m "chore: Release v$(v) - Automated build"
+	git tag -a v$(v) -m "v$(v)"
+	@echo "📤 Pushing to GitHub (Branch main + Tags)..."
+	git push origin main --tags
+	@echo "✅ Done! GitHub Actions will handle the PyPI publication."
+
 clean:
 	@echo "🧹 Cleaning temporary files..."
 	rm -rf .pytest_cache .mypy_cache .coverage htmlcov .ruff_cache coverage.xml

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: b1sl-python
-Version: 0.1.0
+Version: 0.1.2
 Summary: A framework-agnostic Python SDK for SAP Business One Service Layer and SAP HANA. (Unofficial)
+Project-URL: Homepage, https://github.com/operator-ita/b1sl-python
+Project-URL: Repository, https://github.com/operator-ita/b1sl-python
+Project-URL: Bug Tracker, https://github.com/operator-ita/b1sl-python/issues
+Project-URL: Documentation, https://github.com/operator-ita/b1sl-python/tree/main/docs
 Author: Eliceo Guzman
 License: MIT
 License-File: LICENSE
@@ -17,7 +21,10 @@ Requires-Dist: httpx<1,>=0.28.1
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: python-dotenv>=1.2.2
 Provides-Extra: all
-Requires-Dist: b1sl[django,generator,hana]; extra == 'all'
+Requires-Dist: beautifulsoup4>=4.14.3; extra == 'all'
+Requires-Dist: django<6,>=4.2; extra == 'all'
+Requires-Dist: hdbcli<3,>=2.20.0; extra == 'all'
+Requires-Dist: lxml>=6.0.2; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
@@ -38,10 +45,10 @@ Provides-Extra: hana
 Requires-Dist: hdbcli<3,>=2.20.0; extra == 'hana'
 Description-Content-Type: text/markdown
 
-# b1sl
+# b1sl-python
 ### Modern, async-first Python SDK for SAP Business One Service Layer.
 
-![b1sl Banner](docs/assets/hero_banner.png)
+![b1sl Banner](https://raw.githubusercontent.com/operator-ita/b1sl-python/refs/heads/main/docs/assets/hero_banner.png)
 
 [![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
@@ -59,7 +66,9 @@ b1sl is a high-performance SDK designed for the SAP B1 Service Layer, focusing o
 *   **Smart Session Management**: Automatic 401 re-authentication with internal locking to prevent license exhaustion.
 *   **Session Hydration**: Reuse existing `B1SESSION` IDs across serverless functions or Temporal activities.
 *   **Optimistic Concurrency**: Automated ETag handling with smart cache invalidation on 412 conflicts.
+*   **Pythonic Querying**: Fluent OData builder with operator overloading and type-safe fields.
 *   **Observability**: Structured logging and event hooks for performance monitoring.
+*   **Safe Development**: Global and per-request **Dry Run** mode to intercept writing requests.
 
 ---
 
@@ -67,10 +76,10 @@ b1sl is a high-performance SDK designed for the SAP B1 Service Layer, focusing o
 
 ```bash
 # Using pip
-pip install b1sl
+pip install b1sl-python
 
 # Using uv
-uv add b1sl
+uv add b1sl-python
 ```
 
 ---
@@ -86,8 +95,13 @@ async def main():
     
     async with AsyncB1Client(config) as b1:
         # Full type hints for items and major entities
-        item = await b1.items.get("C1000")
-        print(f"Item: {item.ItemName}")
+        item = await b1.items.get("I1000")
+        
+        # 1. Native Pythonic access (snake_case)
+        print(f"Item: {item.item_name}")
+        
+        # 2. Dynamic access by SAP Alias (perfect for UDFs!)
+        print(f"Stock: {item.get('QuantityOnStock')}")
 
 if __name__ == "__main__":
     asyncio.run(main())
@@ -95,6 +109,28 @@ if __name__ == "__main__":
 
 ---
 
+## Pythonic Querying
+
+Experience the best way to interact with SAP Service Layer. No more string concatenation!
+
+```python
+from b1sl.b1sl.fields import Item
+from datetime import date
+
+# Fluent queries are type-safe, readable, and support IDE autocomplete
+items = await b1.items.filter(
+    (Item.quantity_on_stock > 0) & (Item.valid_from >= date(2024, 1, 1))
+).select(
+    Item.item_code, 
+    Item.item_name
+).top(5).execute()
+
+for item in items:
+    print(f"[{item.item_code}] {item.item_name}")
+```
+
+---
+
 ## Advanced Usage: FastAPI Integration
 
 b1sl is optimized for modern web frameworks. We recommend using the Lifespan pattern to share a single connection pool:
@@ -154,7 +190,7 @@ This SDK is optimized for modern Service Layer environments and defaults to **v2
 *   **Minimum for ETags**: Requires Service Layer **1.21+** (March 2021).
 *   **Backward Compatibility**: Supports **v1 (OData V2)** through client configuration.
 
-For a detailed history of Service Layer features and specific version support, see the [Full Compatibility Timeline](docs/01-compatibility.md).
+For a detailed history of Service Layer features and specific version support, see the [Full Compatibility Timeline](https://github.com/operator-ita/b1sl-python/blob/main/docs/02-compatibility.md).
 
 ---
 

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/README.md

@@ -1,7 +1,7 @@
-# b1sl
+# b1sl-python
 ### Modern, async-first Python SDK for SAP Business One Service Layer.
 
-![b1sl Banner](docs/assets/hero_banner.png)
+![b1sl Banner](https://raw.githubusercontent.com/operator-ita/b1sl-python/refs/heads/main/docs/assets/hero_banner.png)
 
 [![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
@@ -19,7 +19,9 @@ b1sl is a high-performance SDK designed for the SAP B1 Service Layer, focusing o
 *   **Smart Session Management**: Automatic 401 re-authentication with internal locking to prevent license exhaustion.
 *   **Session Hydration**: Reuse existing `B1SESSION` IDs across serverless functions or Temporal activities.
 *   **Optimistic Concurrency**: Automated ETag handling with smart cache invalidation on 412 conflicts.
+*   **Pythonic Querying**: Fluent OData builder with operator overloading and type-safe fields.
 *   **Observability**: Structured logging and event hooks for performance monitoring.
+*   **Safe Development**: Global and per-request **Dry Run** mode to intercept writing requests.
 
 ---
 
@@ -27,10 +29,10 @@ b1sl is a high-performance SDK designed for the SAP B1 Service Layer, focusing o
 
 ```bash
 # Using pip
-pip install b1sl
+pip install b1sl-python
 
 # Using uv
-uv add b1sl
+uv add b1sl-python
 ```
 
 ---
@@ -46,8 +48,13 @@ async def main():
     
     async with AsyncB1Client(config) as b1:
         # Full type hints for items and major entities
-        item = await b1.items.get("C1000")
-        print(f"Item: {item.ItemName}")
+        item = await b1.items.get("I1000")
+        
+        # 1. Native Pythonic access (snake_case)
+        print(f"Item: {item.item_name}")
+        
+        # 2. Dynamic access by SAP Alias (perfect for UDFs!)
+        print(f"Stock: {item.get('QuantityOnStock')}")
 
 if __name__ == "__main__":
     asyncio.run(main())
@@ -55,6 +62,28 @@ if __name__ == "__main__":
 
 ---
 
+## Pythonic Querying
+
+Experience the best way to interact with SAP Service Layer. No more string concatenation!
+
+```python
+from b1sl.b1sl.fields import Item
+from datetime import date
+
+# Fluent queries are type-safe, readable, and support IDE autocomplete
+items = await b1.items.filter(
+    (Item.quantity_on_stock > 0) & (Item.valid_from >= date(2024, 1, 1))
+).select(
+    Item.item_code, 
+    Item.item_name
+).top(5).execute()
+
+for item in items:
+    print(f"[{item.item_code}] {item.item_name}")
+```
+
+---
+
 ## Advanced Usage: FastAPI Integration
 
 b1sl is optimized for modern web frameworks. We recommend using the Lifespan pattern to share a single connection pool:
@@ -114,7 +143,7 @@ This SDK is optimized for modern Service Layer environments and defaults to **v2
 *   **Minimum for ETags**: Requires Service Layer **1.21+** (March 2021).
 *   **Backward Compatibility**: Supports **v1 (OData V2)** through client configuration.
 
-For a detailed history of Service Layer features and specific version support, see the [Full Compatibility Timeline](docs/01-compatibility.md).
+For a detailed history of Service Layer features and specific version support, see the [Full Compatibility Timeline](https://github.com/operator-ita/b1sl-python/blob/main/docs/02-compatibility.md).
 
 ---
 

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "b1sl-python"
-version = "0.1.0"
+version = "0.1.2"
 description = "A framework-agnostic Python SDK for SAP Business One Service Layer and SAP HANA. (Unofficial)"
 readme = "README.md"
 requires-python = ">=3.11,<3.13"
@@ -30,6 +30,12 @@ dependencies = [
     "python-dotenv>=1.2.2",
 ]
 
+[project.urls]
+Homepage = "https://github.com/operator-ita/b1sl-python"
+Repository = "https://github.com/operator-ita/b1sl-python"
+"Bug Tracker" = "https://github.com/operator-ita/b1sl-python/issues"
+Documentation = "https://github.com/operator-ita/b1sl-python/tree/main/docs"
+
 [project.optional-dependencies]
 hana = ["hdbcli>=2.20.0,<3"]
 django = ["django>=4.2,<6"]
@@ -51,7 +57,7 @@ dev = [
     "pytest-cov",
 ]
 
-all = ["b1sl[hana,django,generator]"]
+all = ["b1sl-python[hana,django,generator]"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/b1sl"]
@@ -60,6 +66,8 @@ exclude = [
     "/metadata",
     "/examples",
     "/docs",
+    "/skills",
+    "agents.md",
 ]
 
 [tool.hatch.build.targets.sdist]
@@ -69,6 +77,8 @@ exclude = [
     "/examples",
     "/docs",
     "/.env",
+    "/skills",
+    "agents.md",
 ]
 
 [tool.pytest.ini_options]
@@ -82,24 +92,33 @@ addopts = "--tb=short --cov=src --cov-report=term-missing"
 
 [tool.mypy]
 files = ["src"]
-strict = true
+strict = false
 ignore_missing_imports = true
+exclude = ["_generated"]
+check_untyped_defs = true
+warn_unreachable = true
+disable_error_code = ["attr-defined", "misc", "override", "assignment", "call-arg", "valid-type", "type-var", "unreachable", "call-overload", "arg-type", "union-attr"]
 
 [tool.ruff]
 line-length = 88
 target-version = "py311"
+extend-exclude = [
+    "src/b1sl/b1sl/models/_generated",
+    "src/b1sl/b1sl/resources/_generated",
+]
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I"]
-ignore = ["E501"]
+ignore = ["E501", "W291", "W293"]
 
 [tool.ruff.format]
 quote-style = "double"
 indent-style = "space"
 
 [tool.ruff.lint.extend-per-file-ignores]
-"src/b1sl/b1sl/models/_generated/**" = ["F401", "F841"]
-"src/b1sl/b1sl/resources/_generated/**" = ["F401", "F841"]
+"src/b1sl/b1sl/entities/__init__.py" = ["F401", "F403", "F405"]
+"examples/**" = ["E402", "F841"]
+"scripts/**" = ["E701", "F401"]
 
 [tool.pyright]
 include = ["src", "scripts"]

b1sl_python-0.1.2/scratch/investigate_enum.py

@@ -0,0 +1,56 @@
+from enum import StrEnum
+import json
+
+# Current implementation pattern
+class OldField(StrEnum):
+    ITEM_CODE = "ItemCode"
+
+# Proposed implementation pattern
+class ODataExpression(str):
+    def __and__(self, other):
+        return ODataExpression(f"({self} and {other})")
+    
+    def __or__(self, other):
+        return ODataExpression(f"({self} or {other})")
+
+class ODataField(str):
+    def __eq__(self, other):
+        val = f"'{other}'" if isinstance(other, str) else str(other)
+        return ODataExpression(f"{self} eq {val}")
+
+class NewFields:
+    ITEM_CODE = ODataField("ItemCode")
+
+def test_investigation():
+    print("--- 1. String Interoperability (F-Strings) ---")
+    print(f"Old: {OldField.ITEM_CODE}")
+    print(f"New: {NewFields.ITEM_CODE}")
+    assert str(OldField.ITEM_CODE) == str(NewFields.ITEM_CODE)
+
+    print("\n--- 2. JSON Serialization ---")
+    print(f"Old: {json.dumps(OldField.ITEM_CODE)}")
+    print(f"New: {json.dumps(NewFields.ITEM_CODE)}")
+    assert json.dumps(OldField.ITEM_CODE) == json.dumps(NewFields.ITEM_CODE)
+
+    print("\n--- 3. Equality Overloading ---")
+    old_eq = (OldField.ITEM_CODE == "ItemCode")
+    new_eq = (NewFields.ITEM_CODE == "A001")
+    print(f"Old eq 'ItemCode': {old_eq} (type: {type(old_eq)})")
+    print(f"New eq 'A001': {new_eq} (type: {type(new_eq)})")
+    
+    print("\n--- 4. Logic Composition ---")
+    try:
+        composed = (NewFields.ITEM_CODE == "A001") & (ODataField("Valid") == "tYES")
+        print(f"Composed Filter: {composed}")
+        assert composed == "(ItemCode eq 'A001' and Valid eq 'tYES')"
+    except Exception as e:
+        print(f"Failed to compose: {e}")
+
+    print("\n--- 5. Membership / Iteration ---")
+    # StrEnum is iterable
+    print(f"Old is iterable: {hasattr(OldField, '__iter__')}")
+    # Custom class needs implementation
+    print(f"New is iterable: {hasattr(NewFields, '__iter__')}")
+
+if __name__ == "__main__":
+    test_investigation()

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/src/b1sl/b1sl/__init__.py

@@ -5,16 +5,6 @@ b1sl.b1sl — SDK for SAP B1 Service Layer (OData).
 import logging
 import warnings
 
-try:
-    from pydantic import ArbitraryTypeWarning
-
-    warnings.filterwarnings("ignore", category=ArbitraryTypeWarning, module=r"b1sl\..*")
-except ImportError:
-    warnings.filterwarnings("ignore", module=r"b1sl\..*|pydantic\..*")
-
-# Standard library pattern: prevent "No handlers could be found"
-logging.getLogger("b1sl").addHandler(logging.NullHandler())
-
 from b1sl.b1sl.async_client import AsyncB1Client
 from b1sl.b1sl.async_rest_adapter import AsyncRestAdapter
 from b1sl.b1sl.base_adapter import HookContext, ObservabilityConfig
@@ -28,29 +18,39 @@ from b1sl.b1sl.resources.base import GenericResource, ODataQuery
 from b1sl.b1sl.rest_adapter import RestAdapter
 
 try:
-    from b1sl.b1sl import entities
+    from pydantic import ArbitraryTypeWarning
+
+    warnings.filterwarnings("ignore", category=ArbitraryTypeWarning, module=r"b1sl\..*")  # type: ignore
+except ImportError:
+    warnings.filterwarnings("ignore", module=r"b1sl\..*|pydantic\..*")
+
+# Standard library pattern: prevent "No handlers could be found"
+logging.getLogger("b1sl").addHandler(logging.NullHandler())
+
+try:
+    from b1sl.b1sl import entities  # type: ignore
 except ImportError:
-    entities = None  # Before code generation
+    entities = None  # type: ignore # Before code generation
 
 try:
-    from b1sl.b1sl import fields
+    from b1sl.b1sl import fields  # type: ignore
 except ImportError:
-    fields = None
+    fields = None  # type: ignore
 
 __all__ = [
-    "B1Client",
     "AsyncB1Client",
+    "B1Client",
     "B1Config",
-    "B1Env",
     "B1Environment",
-    "RestAdapter",
     "AsyncRestAdapter",
-    "GenericResource",
+    "RestAdapter",
+    "B1Env",
+    "SAPConcurrencyError",
     "AsyncGenericResource",
+    "GenericResource",
+    "ODataQuery",
     "entities",
     "fields",
-    "ODataQuery",
     "HookContext",
     "ObservabilityConfig",
-    "SAPConcurrencyError",
 ]

{b1sl_python-0.1.0 → b1sl_python-0.1.2}/src/b1sl/b1sl/async_client.py

@@ -8,17 +8,20 @@ from b1sl.b1sl.base_adapter import ObservabilityConfig
 from b1sl.b1sl.config import B1Config
 
 if TYPE_CHECKING:
-    from b1sl.b1sl.models.base import B1Model
-    from b1sl.b1sl.resources.async_base import AsyncGenericResource
-    from b1sl.b1sl.resources.udo import AsyncUDOResource
-    
+    from b1sl.b1sl.models._generated.entities.businesspartners import (
+        Activity,
+        BusinessPartner,
+    )
+    from b1sl.b1sl.models._generated.entities.finance import JournalEntry
+    from b1sl.b1sl.models._generated.entities.general import Document, Payment, User
+
     # Models for typing convenience aliases
     from b1sl.b1sl.models._generated.entities.inventory import Item
-    from b1sl.b1sl.models._generated.entities.businesspartners import BusinessPartner, Activity
-    from b1sl.b1sl.models._generated.entities.general import Document, Payment, User
     from b1sl.b1sl.models._generated.entities.production import ProductionOrder
-    from b1sl.b1sl.models._generated.entities.finance import JournalEntry
     from b1sl.b1sl.models._generated.entities.sales import ServiceCall
+    from b1sl.b1sl.models.base import B1Model
+    from b1sl.b1sl.resources.async_base import AsyncGenericResource
+    from b1sl.b1sl.resources.udo import AsyncUDOResource
 
 
 class AsyncB1Client:
@@ -75,6 +78,28 @@ class AsyncB1Client:
         """
         return self._adapter.session_id
 
+    def dry_run(self, enabled: bool = True):
+        """
+        Context manager to temporarily enable or disable Dry Run mode
+        **for the current asyncio task only** (task-safe via ContextVar).
+
+        Usage::
+
+            async with AsyncB1Client(config) as b1:
+                # Intercept writes for just this block
+                with b1.dry_run():
+                    await b1.items.create(new_item)  # intercepted
+
+                # Force real execution even if global dry_run is True
+                with b1.dry_run(enabled=False):
+                    await b1.items.update(item)  # sent to SAP
+
+        Note:
+            Use ``with`` (sync CM), **not** ``async with``, even in async code.
+            This is correct Python — the CM guards a state variable, not I/O.
+        """
+        return self._adapter.dry_run(enabled)
+
     async def connect(self) -> None:
         """
         Initializes the underlying HTTP client and logs in.