fin-infra 0.1.69__py3-none-any.whl → 0.4.0__py3-none-any.whl

fin_infra/cli/cmds/scaffold_cmds.py

@@ -12,7 +12,6 @@ Usage:
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Optional
 
 import click
 import typer
@@ -54,47 +53,47 @@ def cmd_scaffold(
         "--overwrite/--no-overwrite",
         help="Overwrite existing files",
     ),
-    models_filename: Optional[str] = typer.Option(
+    models_filename: str | None = typer.Option(
         None,
         "--models-filename",
         help="Custom filename for models (default: {domain}.py)",
     ),
-    schemas_filename: Optional[str] = typer.Option(
+    schemas_filename: str | None = typer.Option(
         None,
         "--schemas-filename",
         help="Custom filename for schemas (default: {domain}_schemas.py)",
     ),
-    repository_filename: Optional[str] = typer.Option(
+    repository_filename: str | None = typer.Option(
         None,
         "--repository-filename",
         help="Custom filename for repository (default: {domain}_repository.py)",
     ),
 ) -> None:
     """Generate SQLAlchemy models, Pydantic schemas, and repository code from templates.
-    
+
     The scaffold command generates production-ready persistence layer code that works
     seamlessly with svc-infra's add_sql_resources() for automatic CRUD APIs.
-    
+
     Examples:
         # Basic scaffold (models + schemas + repository)
         fin-infra scaffold budgets --dest-dir app/models/
-        
+
         # Financial goals tracking
         fin-infra scaffold goals --dest-dir app/models/goals/
-        
+
         # With multi-tenancy and soft deletes
         fin-infra scaffold budgets --dest-dir app/models/ \
             --include-tenant --include-soft-delete
-        
+
         # Without repository (use svc-infra SqlRepository directly)
         fin-infra scaffold goals --dest-dir app/models/ \\
             --no-with-repository
-        
+
         # Custom filenames
         fin-infra scaffold budgets --dest-dir app/models/ \\
             --models-filename custom_budget.py \\
             --schemas-filename custom_schemas.py
-    
+
     After scaffolding, integrate with svc-infra:
         1. Run migrations: svc-infra revision -m "add budgets" --autogenerate
         2. Apply: svc-infra upgrade head
@@ -103,7 +102,7 @@ def cmd_scaffold(
     # Validate required parameters
     if dest_dir is None:
         typer.secho(
-            "❌ Error: --dest-dir is required",
+            "[X] Error: --dest-dir is required",
             fg=typer.colors.RED,
             err=True,
         )
@@ -138,7 +137,7 @@ def cmd_scaffold(
         )
     else:
         typer.secho(
-            f"❌ Unknown domain: {domain}. Must be one of: budgets, goals",
+            f"[X] Unknown domain: {domain}. Must be one of: budgets, goals",
             fg=typer.colors.RED,
             err=True,
         )
@@ -146,7 +145,7 @@ def cmd_scaffold(
 
     # Display results
     typer.echo("")
-    typer.secho("📦 Scaffold Results:", bold=True)
+    typer.secho(" Scaffold Results:", bold=True)
     typer.echo("")
 
     files = result.get("files", [])
@@ -158,7 +157,7 @@ def cmd_scaffold(
         action = file_info.get("action", "unknown")
 
         if action == "wrote":
-            typer.secho(f"  ✓ Created: {path}", fg=typer.colors.GREEN)
+            typer.secho(f"  [OK] Created: {path}", fg=typer.colors.GREEN)
             wrote_count += 1
         elif action == "skipped":
             reason = file_info.get("reason", "unknown")
@@ -169,7 +168,7 @@ def cmd_scaffold(
 
     # Summary
     typer.echo("")
-    typer.secho(f"✨ Done! Created {wrote_count} file(s), skipped {skipped_count}.", bold=True)
+    typer.secho(f" Done! Created {wrote_count} file(s), skipped {skipped_count}.", bold=True)
     typer.echo("")
 
     # Next steps
@@ -188,7 +187,7 @@ def cmd_scaffold(
         }
         route_prefix = prefix_map.get(domain, f"/{domain}")
 
-        typer.secho("📝 Next Steps:", bold=True)
+        typer.secho(" Next Steps:", bold=True)
         typer.echo("")
         typer.echo("  1. Review generated files and customize as needed")
         typer.echo("  2. Run migrations:")

fin_infra/clients/__init__.py

@@ -1,3 +1,25 @@
-from .base import BankingClient, MarketDataClient, CreditClient
+"""DEPRECATED: Use fin_infra.providers instead.
+
+This module is deprecated and will be removed in a future version.
+All ABCs have been consolidated into fin_infra.providers.base.
+
+Migration:
+    # Old (deprecated)
+    from fin_infra.clients import BankingClient, MarketDataClient
+
+    # New
+    from fin_infra.providers.base import BankingProvider, MarketDataProvider
+"""
+
+import warnings
+
+from .base import BankingClient, CreditClient, MarketDataClient
+
+warnings.warn(
+    "fin_infra.clients is deprecated. Use fin_infra.providers instead. "
+    "This module will be removed in a future version.",
+    DeprecationWarning,
+    stacklevel=2,
+)
 
 __all__ = ["BankingClient", "MarketDataClient", "CreditClient"]

fin_infra/clients/base.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import abc
-from typing import Iterable, Sequence
+from collections.abc import Iterable, Sequence
 
 from ..models import Account, Quote, Transaction
 

fin_infra/clients/plaid.py

@@ -1,9 +1,9 @@
 from __future__ import annotations
 
-from typing import Sequence
+from collections.abc import Sequence
 
-from .base import BankingClient
 from ..models import Account
+from .base import BankingClient
 
 
 class PlaidClient(BankingClient):

fin_infra/compliance/__init__.py

@@ -20,8 +20,9 @@ Example:
 from __future__ import annotations
 
 import logging
+from collections.abc import Callable
 from datetime import datetime
-from typing import Any, Callable, TYPE_CHECKING, cast
+from typing import TYPE_CHECKING, Any, cast
 
 if TYPE_CHECKING:
     from fastapi import FastAPI, Request, Response
@@ -32,7 +33,7 @@ logger = logging.getLogger(__name__)
 
 
 def log_compliance_event(
-    app: "FastAPI",
+    app: FastAPI,
     event: str,
     context: dict[str, Any] | None = None,
 ) -> None:
@@ -62,7 +63,7 @@ def log_compliance_event(
 
 
 def add_compliance_tracking(
-    app: "FastAPI",
+    app: FastAPI,
     *,
     track_banking: bool = True,
     track_credit: bool = True,
@@ -111,7 +112,7 @@ def add_compliance_tracking(
     """
 
     @app.middleware("http")
-    async def compliance_tracking_middleware(request: "Request", call_next: Callable) -> "Response":
+    async def compliance_tracking_middleware(request: Request, call_next: Callable) -> Response:
         """Middleware to track compliance events for financial endpoints."""
         path = request.url.path
         method = request.method

fin_infra/credit/add.py

@@ -25,15 +25,14 @@ Example:
 import logging
 from typing import cast
 
-from fastapi import FastAPI, Depends, HTTPException, status
-
-from svc_infra.api.fastapi.dual.protected import user_router, RequireUser
+from fastapi import Depends, FastAPI, HTTPException, status
 from svc_infra.api.fastapi.docs.scoped import add_prefixed_docs
+from svc_infra.api.fastapi.dual.protected import RequireUser, user_router
 from svc_infra.cache import resource
 from svc_infra.webhooks import add_webhooks
 
+from fin_infra.models.credit import CreditReport, CreditScore
 from fin_infra.providers.base import CreditProvider
-from fin_infra.models.credit import CreditScore, CreditReport
 
 logger = logging.getLogger(__name__)
 
@@ -156,8 +155,8 @@ def add_credit(
         if enable_webhooks and hasattr(app.state, "webhooks_outbox"):
             try:
                 # Get webhook service from app state
-                from svc_infra.webhooks.service import WebhookService
                 from svc_infra.db.outbox import OutboxStore
+                from svc_infra.webhooks.service import WebhookService
 
                 outbox: OutboxStore = app.state.webhooks_outbox
                 subs = app.state.webhooks_subscriptions
@@ -176,7 +175,7 @@ def add_credit(
                 # Don't fail request if webhook publishing fails
                 logger.warning(f"Failed to publish credit.score_changed webhook: {e}")
 
-        return cast(CreditScore, score)
+        return cast("CreditScore", score)
 
     @router.post("/report", response_model=CreditReport)
     @credit_resource.cache_read(ttl=cache_ttl, suffix="report")
@@ -220,7 +219,7 @@ def add_credit(
                 detail="Credit bureau service unavailable",
             )
 
-        return cast(CreditReport, report)
+        return cast("CreditReport", report)
 
     # Mount router with dual routes (with/without trailing slash)
     app.include_router(router, include_in_schema=True)

fin_infra/credit/experian/auth.py

@@ -86,7 +86,7 @@ class ExperianAuthManager:
             >>> headers = {"Authorization": f"Bearer {token}"}
         """
         # Call the cached implementation with client_id for cache key
-        return cast(str, await self._get_token_cached(client_id=self.client_id))
+        return cast("str", await self._get_token_cached(client_id=self.client_id))
 
     @cache_read(
         key="oauth_token:experian:{client_id}",  # Use client_id for uniqueness
@@ -141,7 +141,7 @@ class ExperianAuthManager:
 
         # Parse and return token
         data = response.json()
-        return cast(str, data["access_token"])
+        return cast("str", data["access_token"])
 
     async def invalidate(self) -> None:
         """Invalidate cached token for THIS client (force refresh on next get_token call).

fin_infra/credit/experian/client.py

@@ -155,7 +155,7 @@ class ExperianClient:
                 **kwargs,
             )
             response.raise_for_status()
-            return cast(dict[str, Any], response.json())
+            return cast("dict[str, Any]", response.json())
 
         except httpx.HTTPStatusError as e:
             # Parse error response

fin_infra/credit/experian/parser.py

@@ -1,11 +1,11 @@
 """Response parsers for Experian API data to fin_infra models.
 
 Converts Experian API JSON responses to typed Pydantic models:
-- parse_credit_score(): dict → CreditScore
-- parse_credit_report(): dict → CreditReport
-- parse_account(): dict → CreditAccount
-- parse_inquiry(): dict → CreditInquiry
-- parse_public_record(): dict → PublicRecord
+- parse_credit_score(): dict -> CreditScore
+- parse_credit_report(): dict -> CreditReport
+- parse_account(): dict -> CreditAccount
+- parse_inquiry(): dict -> CreditInquiry
+- parse_public_record(): dict -> PublicRecord
 
 Example:
     >>> data = await client.get_credit_score("user123")

fin_infra/credit/experian/provider.py

@@ -30,7 +30,7 @@ Example:
 """
 
 import logging
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from typing import Literal, cast
 
 from fin_infra.credit.experian.auth import ExperianAuthManager
@@ -177,7 +177,7 @@ class ExperianProvider(CreditProvider):
 
         # FCRA Audit Log - REQUIRED for regulatory compliance (15 USC § 1681b)
         # This log must be retained for at least 2 years per FCRA requirements
-        timestamp = datetime.now(timezone.utc).isoformat()
+        timestamp = datetime.now(UTC).isoformat()
         fcra_audit_logger.info(
             "FCRA_CREDIT_PULL",
             extra={
@@ -266,7 +266,7 @@ class ExperianProvider(CreditProvider):
         # FCRA Audit Log - REQUIRED for regulatory compliance (15 USC § 1681b)
         # Full credit report pulls have stricter requirements than score-only pulls
         # This log must be retained for at least 2 years per FCRA requirements
-        timestamp = datetime.now(timezone.utc).isoformat()
+        timestamp = datetime.now(UTC).isoformat()
         fcra_audit_logger.info(
             "FCRA_CREDIT_PULL",
             extra={
@@ -360,4 +360,4 @@ class ExperianProvider(CreditProvider):
             signature_key=signature_key,
         )
 
-        return cast(str, data.get("subscriptionId", "unknown"))
+        return cast("str", data.get("subscriptionId", "unknown"))

fin_infra/crypto/__init__.py

@@ -13,7 +13,7 @@ Quick start:
 
 from __future__ import annotations
 
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from typing import TYPE_CHECKING, Literal
 
 if TYPE_CHECKING:
@@ -29,8 +29,8 @@ def easy_crypto(
     """Create a crypto data provider with zero or minimal configuration.
 
     Auto-detects provider based on environment variables:
-    1. If COINGECKO_API_KEY is set → CoinGecko Pro
-    2. Otherwise → CoinGecko Free (no key needed)
+    1. If COINGECKO_API_KEY is set -> CoinGecko Pro
+    2. Otherwise -> CoinGecko Free (no key needed)
 
     Args:
         provider: Provider name ("coingecko"). If None, defaults to coingecko.
@@ -74,7 +74,7 @@ def easy_crypto(
 
 
 def add_crypto_data(
-    app: "FastAPI",
+    app: FastAPI,
     *,
     provider: str | CryptoDataProvider | None = None,
     prefix: str = "/crypto",
@@ -131,9 +131,9 @@ def add_crypto_data(
             >>> add_observability(app)
             >>> crypto = add_crypto_data(app)
     """
-    from svc_infra.api.fastapi.dual.public import public_router
-    from svc_infra.api.fastapi.docs.scoped import add_prefixed_docs
     from fastapi import HTTPException, Query
+    from svc_infra.api.fastapi.docs.scoped import add_prefixed_docs
+    from svc_infra.api.fastapi.dual.public import public_router
 
     # Initialize provider if string or None
     if isinstance(provider, str):
@@ -168,11 +168,11 @@ def add_crypto_data(
                 "price": float(ticker.price),
                 "as_of": ticker.as_of.isoformat()
                 if ticker.as_of
-                else datetime.now(timezone.utc).isoformat(),
+                else datetime.now(UTC).isoformat(),
             }
         except Exception as e:
             raise HTTPException(
-                status_code=400, detail=f"Error fetching ticker for {symbol}: {str(e)}"
+                status_code=400, detail=f"Error fetching ticker for {symbol}: {e!s}"
             )
 
     @router.get("/ohlcv/{symbol}")
@@ -216,9 +216,7 @@ def add_crypto_data(
                 ],
             }
         except Exception as e:
-            raise HTTPException(
-                status_code=400, detail=f"Error fetching OHLCV for {symbol}: {str(e)}"
-            )
+            raise HTTPException(status_code=400, detail=f"Error fetching OHLCV for {symbol}: {e!s}")
 
     # Mount router
     app.include_router(router, include_in_schema=True)

fin_infra/crypto/insights.py

@@ -8,6 +8,7 @@ CRITICAL: Uses ai-infra.llm.LLM (NEVER custom LLM clients).
 
 from __future__ import annotations
 
+import logging
 from datetime import datetime
 from decimal import Decimal
 from typing import TYPE_CHECKING
@@ -17,6 +18,8 @@ from pydantic import BaseModel, Field
 if TYPE_CHECKING:
     from ai_infra.llm import LLM
 
+logger = logging.getLogger(__name__)
+
 
 class CryptoInsight(BaseModel):
     """Personalized cryptocurrency insight.
@@ -284,8 +287,6 @@ Provide your insight:"""
             )
         )
     except Exception as e:
-        # Graceful degradation - log error but don't fail
-        # In production, use svc-infra logging
-        print(f"Warning: LLM insight generation failed: {e}")
+        logger.warning("LLM insight generation failed: %s", e)
 
     return insights

fin_infra/documents/add.py

@@ -23,23 +23,22 @@ Quick Start:
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from fastapi import FastAPI
-
     from svc_infra.storage.base import StorageBackend
 
     from .ease import FinancialDocumentManager
 
 
 def add_documents(
-    app: "FastAPI",
-    storage: Optional["StorageBackend"] = None,
+    app: FastAPI,
+    storage: StorageBackend | None = None,
     default_ocr_provider: str = "tesseract",
     prefix: str = "/documents",
-    tags: Optional[list[str]] = None,
-) -> "FinancialDocumentManager":
+    tags: list[str] | None = None,
+) -> FinancialDocumentManager:
     """
     Add financial document management endpoints to FastAPI app.
 
@@ -87,7 +86,6 @@ def add_documents(
         - Stores manager on app.state.financial_documents
     """
     from fastapi import HTTPException
-
     from svc_infra.api.fastapi.dual.protected import user_router
 
     # Import svc-infra base function to mount base endpoints (with fallback)
@@ -128,7 +126,7 @@ def add_documents(
     @router.post("/{document_id}/ocr", response_model=OCRResult)
     async def extract_text_ocr(
         document_id: str,
-        provider: Optional[str] = None,
+        provider: str | None = None,
         force_refresh: bool = False,
     ) -> OCRResult:
         """

fin_infra/documents/analysis.py

@@ -24,7 +24,7 @@ from __future__ import annotations
 
 import re
 from datetime import datetime
-from typing import TYPE_CHECKING, Dict
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from svc_infra.storage.base import StorageBackend
@@ -32,14 +32,14 @@ if TYPE_CHECKING:
     from .models import DocumentAnalysis
 
 # In-memory analysis cache (production: use svc-infra cache)
-_analysis_cache: Dict[str, "DocumentAnalysis"] = {}
+_analysis_cache: dict[str, DocumentAnalysis] = {}
 
 
 async def analyze_document(
-    storage: "StorageBackend",
+    storage: StorageBackend,
     document_id: str,
     force_refresh: bool = False,
-) -> "DocumentAnalysis":
+) -> DocumentAnalysis:
     """
     Analyze a document using AI to extract insights and recommendations.
 
@@ -165,7 +165,7 @@ Important: This analysis is not a substitute for professional financial advice.
     return prompt
 
 
-def _validate_analysis(analysis: "DocumentAnalysis") -> bool:
+def _validate_analysis(analysis: DocumentAnalysis) -> bool:
     """
     Validate LLM analysis output.
 
@@ -201,7 +201,7 @@ def _validate_analysis(analysis: "DocumentAnalysis") -> bool:
     return True
 
 
-def _analyze_tax_document(ocr_text: str, metadata: dict, document_id: str) -> "DocumentAnalysis":
+def _analyze_tax_document(ocr_text: str, metadata: dict, document_id: str) -> DocumentAnalysis:
     """
     Specialized analysis for tax documents.
 
@@ -301,7 +301,7 @@ def _analyze_tax_document(ocr_text: str, metadata: dict, document_id: str) -> "D
     )
 
 
-def _analyze_bank_statement(ocr_text: str, metadata: dict, document_id: str) -> "DocumentAnalysis":
+def _analyze_bank_statement(ocr_text: str, metadata: dict, document_id: str) -> DocumentAnalysis:
     """
     Specialized analysis for bank statements.
 
@@ -352,7 +352,7 @@ def _analyze_bank_statement(ocr_text: str, metadata: dict, document_id: str) ->
     )
 
 
-def _analyze_receipt(ocr_text: str, metadata: dict, document_id: str) -> "DocumentAnalysis":
+def _analyze_receipt(ocr_text: str, metadata: dict, document_id: str) -> DocumentAnalysis:
     """
     Specialized analysis for receipts.
 
@@ -394,7 +394,7 @@ def _analyze_receipt(ocr_text: str, metadata: dict, document_id: str) -> "Docume
 
 def _analyze_generic_document(
     ocr_text: str, document_type: str, metadata: dict, document_id: str
-) -> "DocumentAnalysis":
+) -> DocumentAnalysis:
     """
     Generic analysis for other document types.
 

fin_infra/documents/ease.py

@@ -36,7 +36,7 @@ Quick Start:
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 try:
     from svc_infra.documents import DocumentManager as BaseDocumentManager
@@ -94,7 +94,7 @@ class FinancialDocumentManager(BaseDocumentManager):
 
     def __init__(
         self,
-        storage: "StorageBackend",
+        storage: StorageBackend,
         default_ocr_provider: str = "tesseract",
     ):
         """
@@ -111,12 +111,12 @@ class FinancialDocumentManager(BaseDocumentManager):
         self,
         user_id: str,
         file: bytes,
-        document_type: "DocumentType",
+        document_type: DocumentType,
         filename: str,
-        metadata: Optional[dict] = None,
-        tax_year: Optional[int] = None,
-        form_type: Optional[str] = None,
-    ) -> "FinancialDocument":
+        metadata: dict | None = None,
+        tax_year: int | None = None,
+        form_type: str | None = None,
+    ) -> FinancialDocument:
         """
         Upload a financial document with financial-specific fields.
 
@@ -159,11 +159,11 @@ class FinancialDocumentManager(BaseDocumentManager):
     def list_financial(
         self,
         user_id: str,
-        document_type: Optional["DocumentType"] = None,
-        tax_year: Optional[int] = None,
+        document_type: DocumentType | None = None,
+        tax_year: int | None = None,
         limit: int = 100,
         offset: int = 0,
-    ) -> list["FinancialDocument"]:
+    ) -> list[FinancialDocument]:
         """
         List user's financial documents with filters.
 
@@ -207,9 +207,9 @@ class FinancialDocumentManager(BaseDocumentManager):
     async def extract_text(
         self,
         document_id: str,
-        provider: Optional[str] = None,
+        provider: str | None = None,
         force_refresh: bool = False,
-    ) -> "OCRResult":
+    ) -> OCRResult:
         """
         Extract text from document using OCR (financial extension).
 
@@ -239,7 +239,7 @@ class FinancialDocumentManager(BaseDocumentManager):
         self,
         document_id: str,
         force_refresh: bool = False,
-    ) -> "DocumentAnalysis":
+    ) -> DocumentAnalysis:
         """
         Analyze document using AI (financial extension).
 
@@ -268,7 +268,7 @@ DocumentManager = FinancialDocumentManager
 
 
 def easy_documents(
-    storage: Optional["StorageBackend"] = None,
+    storage: StorageBackend | None = None,
     default_ocr_provider: str = "tesseract",
 ) -> FinancialDocumentManager:
     """

fin_infra/documents/models.py

@@ -31,7 +31,6 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Dict, List, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 from svc_infra.documents import Document as BaseDocument
@@ -111,8 +110,8 @@ class FinancialDocument(BaseDocument):
 
     # Financial-specific fields
     type: DocumentType = Field(..., description="Document type category (financial-specific)")
-    tax_year: Optional[int] = Field(None, description="Tax year for tax documents (e.g., 2024)")
-    form_type: Optional[str] = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
+    tax_year: int | None = Field(None, description="Tax year for tax documents (e.g., 2024)")
+    form_type: str | None = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
 
 
 # Backward compatibility: alias for existing code
@@ -145,7 +144,7 @@ class OCRResult(BaseModel):
     confidence: float = Field(
         ..., description="Overall OCR confidence score (0.0-1.0)", ge=0.0, le=1.0
     )
-    fields_extracted: Dict[str, str] = Field(
+    fields_extracted: dict[str, str] = Field(
         default_factory=dict,
         description="Structured fields extracted from document (names, amounts, dates)",
     )
@@ -181,10 +180,10 @@ class DocumentAnalysis(BaseModel):
 
     document_id: str = Field(..., description="Document that was analyzed")
     summary: str = Field(..., description="High-level document summary")
-    key_findings: List[str] = Field(
+    key_findings: list[str] = Field(
         default_factory=list, description="Important facts extracted from document"
     )
-    recommendations: List[str] = Field(
+    recommendations: list[str] = Field(
         default_factory=list, description="Action items or suggestions based on document content"
     )
     analysis_date: datetime = Field(