thunkmetrc 0.2.2__tar.gz

thunkmetrc-0.2.2/.gitignore

@@ -0,0 +1,122 @@
+# ==============================================================================
+# SECURITY & SECRETS
+# ==============================================================================
+.env
+.env.*
+!.env.example
+.npmrc
+settings.xml
+*.pem
+*.key
+local.properties
+
+# ==============================================================================
+# OS & Environment
+# ==============================================================================
+.DS_Store
+.DS_Store?
+.AppleDouble
+.LSOverride
+Icon
+._*
+.Spotlight-V100
+.Trashes
+.Thumbs.db
+desktop.ini
+ehthumbs.db
+Thumbs.db
+
+# ==============================================================================
+# IDE & Editors
+# ==============================================================================
+# VS Code
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+.history/
+
+# Visual Studio
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# MonoDevelop / Xamarin Studio
+*.userprefs
+
+# IntelliJ / Android Studio
+.idea/
+*.iml
+*.iws
+
+# ==============================================================================
+# Build Artifacts & Directories
+# ==============================================================================
+.temp/
+dist/
+out/
+build/
+bin/
+obj/
+target/
+.gradle/
+.externalNativeBuild
+.cxx
+/captures
+
+# ==============================================================================
+# Languages & Frameworks
+# ==============================================================================
+
+# Go
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+
+# Python
+__pycache__/
+.pytest_cache/
+*.pyc
+sdks/python/dist/
+
+# C# / .NET
+[Dd]ebug/
+[Dd]ebugPublic/
+[Rr]elease/
+[Rr]eleases/
+x64/
+x86/
+Win32/
+ARM/
+ARM64/
+bld/
+[Ll]og/
+[Ll]ogs/
+
+# ==============================================================================
+# Project Specific
+# ==============================================================================
+
+# Scraper Outputs
+specs/metrc-responses
+*.html
+
+# Logs
+*.log
+

thunkmetrc-0.2.2/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: thunkmetrc
+Version: 0.2.2
+Summary: High-level ThunkMetrc Python SDK
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: thunkmetrc-wrapper==0.2.2
+Description-Content-Type: text/markdown
+
+# ThunkMetrc
+
+High-level Python SDK for Metrc with convenience functions like `active_packages_inventory_sync`.
+
+## Installation
+
+```bash
+pip install thunkmetrc
+```
+
+## Usage
+
+```python
+from thunkmetrc import active_packages_inventory_sync
+from thunkmetrc_wrapper import MetrcWrapper
+
+wrapper = MetrcWrapper("https://api.metrc.com", "vendor_key", "user_key")
+
+# Sync active packages inventory
+packages = active_packages_inventory_sync(
+    wrapper,
+    "license_number",
+    last_known_sync=None,
+    buffer_minutes=5
+)
+```
+
+## License
+
+MIT

thunkmetrc-0.2.2/README.md

@@ -0,0 +1,30 @@
+# ThunkMetrc
+
+High-level Python SDK for Metrc with convenience functions like `active_packages_inventory_sync`.
+
+## Installation
+
+```bash
+pip install thunkmetrc
+```
+
+## Usage
+
+```python
+from thunkmetrc import active_packages_inventory_sync
+from thunkmetrc_wrapper import MetrcWrapper
+
+wrapper = MetrcWrapper("https://api.metrc.com", "vendor_key", "user_key")
+
+# Sync active packages inventory
+packages = active_packages_inventory_sync(
+    wrapper,
+    "license_number",
+    last_known_sync=None,
+    buffer_minutes=5
+)
+```
+
+## License
+
+MIT

thunkmetrc-0.2.2/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "thunkmetrc"
+version = "0.2.2"
+description = "High-level ThunkMetrc Python SDK"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "thunkmetrc-wrapper==0.2.2",
+    "python-dateutil>=2.8.2" # Useful for date handling if needed
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/thunkmetrc"]

thunkmetrc-0.2.2/src/thunkmetrc/__init__.py

@@ -0,0 +1,3 @@
+from .inventory import active_packages_inventory_sync
+
+__all__ = ["active_packages_inventory_sync"]

thunkmetrc-0.2.2/src/thunkmetrc/inventory.py

@@ -0,0 +1,78 @@
+from typing import List, Optional, Any, Dict
+from datetime import datetime, timedelta, timezone
+from thunkmetrc.wrapper import MetrcWrapper
+
+async def active_packages_inventory_sync(
+    wrapper: MetrcWrapper,
+    license_number: str,
+    last_known_sync: Optional[datetime] = None,
+    buffer_minutes: int = 5
+) -> List[Dict[str, Any]]:
+    """
+    Syncs all active packages modified within the time window.
+    
+    :param wrapper: MetrcWrapper instance
+    :param license_number: Facility license number
+    :param last_known_sync: Last successful sync time (datetime). If None, defaults to 24h ago.
+    :param buffer_minutes: Buffer to subtract from start time (default 5).
+    :return: List of active packages
+    """
+    end_time = datetime.now(timezone.utc)
+    
+    if last_known_sync:
+        start_time = last_known_sync - timedelta(minutes=buffer_minutes)
+    else:
+        # Default to 24 hours ago if no sync state
+        start_time = end_time - timedelta(hours=24)
+
+    # Ensure UTC if naive (assume UTC if naive, or convert)
+    if start_time.tzinfo is None:
+        start_time = start_time.replace(tzinfo=timezone.utc)
+    if end_time.tzinfo is None:
+        end_time = end_time.replace(tzinfo=timezone.utc)
+
+    # Format as ISO 8601 strings (e.g. 2023-10-26T12:00:00+00:00)
+    # isoformat() produces valid ISO 8601
+    start_str = start_time.isoformat()
+    end_str = end_time.isoformat()
+
+    all_packages: List[Dict[str, Any]] = []
+    page = 1
+    page_size = 20
+
+    while True:
+        # Wrapper method signature (from generator):
+        # async def packages_get_active_v2(self, last_modified_end: Optional[str] = None, last_modified_start: Optional[str] = None, license_number: Optional[str] = None, page_number: Optional[str] = None, page_size: Optional[str] = None, body: Any = None) -> Any:
+        
+        # Note: Argument order matters if positional, but keyword args are safer.
+        # Generated code uses keyword arguments for query params in the wrapper calling client?
+        # Actually wrapper generator adds them as keyword args to the signature defaults.
+        
+        response = await wrapper.packages_get_active_v2(
+            last_modified_end=end_str,
+            last_modified_start=start_str,
+            license_number=license_number,
+            page_number=str(page),
+            page_size=str(page_size)
+        )
+
+        if response:
+            # Response should be a dict if parsed from JSON
+            # e.g. { "Data": [...], "TotalPages": 1 }
+            data = response.get("Data")
+            if isinstance(data, list):
+                all_packages.extend(data)
+            
+            total_pages = response.get("TotalPages")
+            if isinstance(total_pages, int):
+                if page >= total_pages:
+                    break
+            else:
+                # No pagination info or single page?
+                break
+        else:
+            break
+
+        page += 1
+
+    return all_packages