fin-infra 0.1.86__tar.gz → 0.1.88__tar.gz

{fin_infra-0.1.86 → fin_infra-0.1.88}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: fin-infra
-Version: 0.1.86
+Version: 0.1.88
 Summary: Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations
 License: MIT
 Keywords: finance,banking,plaid,brokerage,markets,credit,tax,cashflow,fintech,infra
@@ -49,9 +49,14 @@ Description-Content-Type: text/markdown
 
 # fin-infra
 
-### Financial data infrastructure for fintech apps
+[![CI](https://github.com/nfraxlab/fin-infra/actions/workflows/ci.yml/badge.svg)](https://github.com/nfraxlab/fin-infra/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![Python](https://img.shields.io/pypi/pyversions/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Downloads](https://img.shields.io/pypi/dm/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![codecov](https://codecov.io/gh/nfraxlab/fin-infra/branch/main/graph/badge.svg)](https://codecov.io/gh/nfraxlab/fin-infra)
 
-[![PyPI](https://img.shields.io/pypi/v/fin-infra.svg)](https://pypi.org/project/fin-infra/) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Downloads](https://static.pepy.tech/badge/fin-infra/month)](https://pepy.tech/project/fin-infra)
+### Financial data infrastructure for fintech apps
 
 **Banking, investments, market data, credit scores, and financial calculations in one toolkit.**
 

{fin_infra-0.1.86 → fin_infra-0.1.88}/README.md

@@ -2,9 +2,14 @@
 
 # fin-infra
 
-### Financial data infrastructure for fintech apps
+[![CI](https://github.com/nfraxlab/fin-infra/actions/workflows/ci.yml/badge.svg)](https://github.com/nfraxlab/fin-infra/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![Python](https://img.shields.io/pypi/pyversions/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Downloads](https://img.shields.io/pypi/dm/fin-infra.svg)](https://pypi.org/project/fin-infra/)
+[![codecov](https://codecov.io/gh/nfraxlab/fin-infra/branch/main/graph/badge.svg)](https://codecov.io/gh/nfraxlab/fin-infra)
 
-[![PyPI](https://img.shields.io/pypi/v/fin-infra.svg)](https://pypi.org/project/fin-infra/) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Downloads](https://static.pepy.tech/badge/fin-infra/month)](https://pepy.tech/project/fin-infra)
+### Financial data infrastructure for fintech apps
 
 **Banking, investments, market data, credit scores, and financial calculations in one toolkit.**
 

{fin_infra-0.1.86 → fin_infra-0.1.88}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fin-infra"
-version = "0.1.86"
+version = "0.1.88"
 description = "Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations"
 authors = ["Ali Khatami <aliikhatami94@gmail.com>"]
 license = "MIT"
@@ -78,6 +78,7 @@ black = ">=24.0.0"
 isort = ">=5.13.0"
 flake8 = ">=7.0.0"
 pre-commit = ">=3.0.0"
+bandit = ">=1.7.0"
 types-requests = ">=2.31.0"
 pytest-cov = ">=4.0.0"
 aiosqlite = ">=0.20.0"
@@ -150,6 +151,24 @@ known-first-party = ["fin_infra"]
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
+[tool.bandit]
+exclude_dirs = ["tests", ".venv", "venv"]
+skips = [
+    "B101",  # assert used (intentional in tests and contracts)
+    "B311",  # random for non-crypto (intentional)
+    "B324",  # MD5 hash - used for cache keys only, not security
+]
+
+[tool.coverage.run]
+source = ["src/fin_infra"]
+branch = true
+omit = ["*/tests/*", "*/__pycache__/*"]
+
+[tool.coverage.report]
+exclude_lines = ["pragma: no cover", "if TYPE_CHECKING:", "raise NotImplementedError"]
+fail_under = 70
+show_missing = true
+
 [tool.mypy]
 python_version = "3.13"
 ignore_missing_imports = true

{fin_infra-0.1.86 → fin_infra-0.1.88}/src/fin_infra/utils/__init__.py

@@ -10,8 +10,22 @@ and should be imported from there:
 
 For async retry with exponential backoff:
     from fin_infra.utils.retry import retry_async, RetryError
+
+For deprecation utilities:
+    from fin_infra.utils.deprecation import deprecated, deprecated_parameter
 """
 
+from fin_infra.utils.deprecation import (
+    DeprecatedWarning,
+    deprecated,
+    deprecated_parameter,
+)
 from fin_infra.utils.retry import RetryError, retry_async
 
-__all__ = ["RetryError", "retry_async"]
+__all__ = [
+    "RetryError",
+    "retry_async",
+    "deprecated",
+    "deprecated_parameter",
+    "DeprecatedWarning",
+]

fin_infra-0.1.88/src/fin_infra/utils/deprecation.py

@@ -0,0 +1,161 @@
+"""Deprecation utilities for fin-infra.
+
+This module provides decorators and functions for marking features as deprecated,
+following the deprecation policy defined in DEPRECATION.md.
+
+Example:
+    >>> from fin_infra.utils.deprecation import deprecated
+    >>>
+    >>> @deprecated(
+    ...     version="1.2.0",
+    ...     reason="Use new_function() instead",
+    ...     removal_version="1.4.0"
+    ... )
+    ... def old_function():
+    ...     pass
+"""
+
+from __future__ import annotations
+
+import functools
+import warnings
+from collections.abc import Callable
+from typing import Any, TypeVar
+
+__all__ = [
+    "deprecated",
+    "deprecated_parameter",
+    "DeprecatedWarning",
+]
+
+F = TypeVar("F", bound=Callable[..., Any])
+
+
+class DeprecatedWarning(DeprecationWarning):
+    """Custom deprecation warning for fin-infra.
+
+    This warning is used to distinguish fin-infra deprecations from
+    Python's built-in DeprecationWarning.
+    """
+
+    pass
+
+
+def deprecated(
+    version: str,
+    reason: str,
+    removal_version: str | None = None,
+    *,
+    stacklevel: int = 2,
+) -> Callable[[F], F]:
+    """Decorator to mark a function or class as deprecated.
+
+    The decorated function/class will emit a DeprecationWarning when called/instantiated.
+
+    Args:
+        version: The version in which the feature was deprecated (e.g., "1.2.0").
+        reason: The reason for deprecation and recommended alternative.
+        removal_version: The version in which the feature will be removed (e.g., "1.4.0").
+        stacklevel: Stack level for the warning (default 2 for immediate caller).
+
+    Returns:
+        A decorator that wraps the function/class with deprecation warning.
+
+    Example:
+        >>> @deprecated(
+        ...     version="1.2.0",
+        ...     reason="Use new_function() instead",
+        ...     removal_version="1.4.0"
+        ... )
+        ... def old_function():
+        ...     return "result"
+        >>>
+        >>> old_function()  # Emits DeprecationWarning
+        'result'
+    """
+
+    def decorator(func: F) -> F:
+        # Build the warning message
+        name = getattr(func, "__qualname__", getattr(func, "__name__", str(func)))
+        message = f"{name} is deprecated since version {version}."
+
+        if removal_version:
+            message += f" It will be removed in version {removal_version}."
+
+        message += f" {reason}"
+
+        if isinstance(func, type):
+            # Handle class deprecation
+            original_init = func.__init__  # type: ignore[misc]
+
+            @functools.wraps(original_init)
+            def new_init(self: Any, *args: Any, **kwargs: Any) -> None:
+                warnings.warn(message, DeprecatedWarning, stacklevel=stacklevel)
+                original_init(self, *args, **kwargs)
+
+            func.__init__ = new_init  # type: ignore[misc]
+
+            # Add deprecation info to docstring
+            if func.__doc__:
+                func.__doc__ = f".. deprecated:: {version}\n   {reason}\n\n{func.__doc__}"
+            else:
+                func.__doc__ = f".. deprecated:: {version}\n   {reason}"
+
+            return func  # type: ignore[return-value]
+        else:
+            # Handle function deprecation
+            @functools.wraps(func)
+            def wrapper(*args: Any, **kwargs: Any) -> Any:
+                warnings.warn(message, DeprecatedWarning, stacklevel=stacklevel)
+                return func(*args, **kwargs)
+
+            # Add deprecation info to docstring
+            if wrapper.__doc__:
+                wrapper.__doc__ = f".. deprecated:: {version}\n   {reason}\n\n{wrapper.__doc__}"
+            else:
+                wrapper.__doc__ = f".. deprecated:: {version}\n   {reason}"
+
+            return wrapper  # type: ignore[return-value]
+
+    return decorator
+
+
+def deprecated_parameter(
+    name: str,
+    version: str,
+    reason: str,
+    removal_version: str | None = None,
+    *,
+    stacklevel: int = 2,
+) -> None:
+    """Emit a deprecation warning for a deprecated parameter.
+
+    Call this function when a deprecated parameter is used. This should be
+    called at the beginning of a function that has deprecated parameters.
+
+    Args:
+        name: The name of the deprecated parameter.
+        version: The version in which the parameter was deprecated.
+        reason: The reason for deprecation and recommended alternative.
+        removal_version: The version in which the parameter will be removed.
+        stacklevel: Stack level for the warning (default 2 for immediate caller).
+
+    Example:
+        >>> def my_function(new_param: str, old_param: str | None = None):
+        ...     if old_param is not None:
+        ...         deprecated_parameter(
+        ...             name="old_param",
+        ...             version="1.2.0",
+        ...             reason="Use new_param instead"
+        ...         )
+        ...         new_param = old_param
+        ...     return new_param
+    """
+    message = f"Parameter '{name}' is deprecated since version {version}."
+
+    if removal_version:
+        message += f" It will be removed in version {removal_version}."
+
+    message += f" {reason}"
+
+    warnings.warn(message, DeprecatedWarning, stacklevel=stacklevel + 1)