fenra 0.1.0__tar.gz → 0.1.2__tar.gz

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: fenra
-Version: 0.1.0
-Summary: Privacy-first AI cost tracking library
+Version: 0.1.2
+Summary: FinOps platform for AI cost visibility
 Author: Ajdin Ahmetovic
 Author-email: Ajdin Ahmetovic <ahmetovicajdin@gmail.com>
 Requires-Dist: requests>=2.28.0
@@ -13,7 +13,7 @@ Requires-Dist: mypy>=1.0.0 ; extra == 'dev'
 Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
 Requires-Dist: google-genai>=1.0.0 ; extra == 'gemini'
 Requires-Dist: openai>=1.0.0 ; extra == 'openai'
-Requires-Python: >=3.11
+Requires-Python: >=3.10
 Provides-Extra: all
 Provides-Extra: anthropic
 Provides-Extra: dev
@@ -22,7 +22,7 @@ Provides-Extra: openai
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="https://fenra.io/fenra-text.svg" alt="Fenra" width="200">
+  <img src="https://assets.fenra.io/public/header.png" alt="Fenra" width="100%">
 </p>
 
 # Fenra Python SDK
@@ -57,7 +57,17 @@ response = client.chat.completions.create(
 )
 ```
 
-Works with Anthropic and Gemini the same way.
+Works with Anthropic (Claude) and Google (Gemini) the same way.
+
+Set context for cost attribution:
+
+```python
+fenra.set_context(
+    billable_customer_id="cust_123",  # recommended
+    environment="production",
+    feature="chat",
+)
+```
 
 For custom providers or manual tracking:
 
@@ -76,6 +86,13 @@ To disable auto-tracking:
 export FENRA_DISABLE_AUTO_TRACK=1
 ```
 
+To enable debug logging:
+
+```python
+import logging
+logging.getLogger("fenra").setLevel(logging.DEBUG)
+```
+
 ## Support
 
 - [Documentation](https://docs.fenra.io)

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

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://fenra.io/fenra-text.svg" alt="Fenra" width="200">
+  <img src="https://assets.fenra.io/public/header.png" alt="Fenra" width="100%">
 </p>
 
 # Fenra Python SDK
@@ -34,7 +34,17 @@ response = client.chat.completions.create(
 )
 ```
 
-Works with Anthropic and Gemini the same way.
+Works with Anthropic (Claude) and Google (Gemini) the same way.
+
+Set context for cost attribution:
+
+```python
+fenra.set_context(
+    billable_customer_id="cust_123",  # recommended
+    environment="production",
+    feature="chat",
+)
+```
 
 For custom providers or manual tracking:
 
@@ -53,6 +63,13 @@ To disable auto-tracking:
 export FENRA_DISABLE_AUTO_TRACK=1
 ```
 
+To enable debug logging:
+
+```python
+import logging
+logging.getLogger("fenra").setLevel(logging.DEBUG)
+```
+
 ## Support
 
 - [Documentation](https://docs.fenra.io)

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

@@ -1,12 +1,12 @@
 [project]
 name = "fenra"
-version = "0.1.0"
-description = "Privacy-first AI cost tracking library"
+version = "0.1.2"
+description = "FinOps platform for AI cost visibility"
 readme = "README.md"
 authors = [
     { name = "Ajdin Ahmetovic", email = "ahmetovicajdin@gmail.com" }
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies = [
     "requests>=2.28.0",
 ]

{fenra-0.1.0 → fenra-0.1.2}/src/fenra/_core.py

@@ -221,6 +221,21 @@ def enqueue_transaction(transaction: dict[str, Any]) -> None:
         if not config.enabled:
             return
 
+        # Ensure billable_customer_id is set (required by API)
+        if "context" not in transaction:
+            transaction["context"] = {}
+        if not transaction["context"].get("billable_customer_id"):
+            transaction["context"]["billable_customer_id"] = "unknown"
+            logger.warning(
+                "Fenra: billable_customer_id not set. "
+                "Use fenra.set_context(billable_customer_id='...') for customer attribution."
+            )
+
+        logger.debug(
+            f"Fenra: Enqueuing transaction - provider={transaction.get('provider')}, "
+            f"model={transaction.get('model')}, context={transaction.get('context')}"
+        )
+
         _get_queue().put_nowait(transaction)
     except queue.Full:
         logger.warning("Fenra transaction queue is full, dropping transaction")