azure-discovery 0.1.0__tar.gz → 0.1.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: azure-discovery
-Version: 0.1.0
+Version: 0.1.2
 Summary: Lightweight Azure tenant discovery and visualization via Resource Graph. Enumerates subscriptions and resources, normalizes results, and renders interactive dependency graphs. Supports public and sovereign clouds (Gov, China, Germany, Azure Stack).
 Author: David Frazer <david.frazer336@gmail.com>
 License-Expression: MIT

{azure_discovery-0.1.0 → azure_discovery-0.1.2}/azure_discovery/__init__.py

@@ -1,33 +1,33 @@
-"""Azure Discovery: Azure tenant discovery and visualization via Resource Graph.
-
-This package can be installed from PyPI as ``azure-discovery`` and used as:
-
-  pip install azure-discovery
-  azure-discovery discover --tenant-id <id> --subscription <sub-id>
-
-Programmatic usage:
-
-  from azure_discovery import run_discovery
-  from azure_discovery.adt_types import AzureDiscoveryRequest, AzureDiscoveryResponse
-"""
-
-from .orchestrator import run_discovery
-from .adt_types import (
-    AzureDiscoveryRequest,
-    AzureDiscoveryResponse,
-    AzureEnvironment,
-    DiscoveryFilter,
-    ResourceNode,
-    ResourceRelationship,
-)
-
-__all__ = [
-    "run_discovery",
-    "AzureDiscoveryRequest",
-    "AzureDiscoveryResponse",
-    "AzureEnvironment",
-    "DiscoveryFilter",
-    "ResourceNode",
-    "ResourceRelationship",
-]
-__version__ = "0.1.0"
+"""Azure Discovery: Azure tenant discovery and visualization via Resource Graph.
+
+This package can be installed from PyPI as ``azure-discovery`` and used as:
+
+  pip install azure-discovery
+  azure-discovery discover --tenant-id <id> --subscription <sub-id>
+
+Programmatic usage:
+
+  from azure_discovery import run_discovery
+  from azure_discovery.adt_types import AzureDiscoveryRequest, AzureDiscoveryResponse
+"""
+
+from .orchestrator import run_discovery
+from .adt_types import (
+    AzureDiscoveryRequest,
+    AzureDiscoveryResponse,
+    AzureEnvironment,
+    DiscoveryFilter,
+    ResourceNode,
+    ResourceRelationship,
+)
+
+__all__ = [
+    "run_discovery",
+    "AzureDiscoveryRequest",
+    "AzureDiscoveryResponse",
+    "AzureEnvironment",
+    "DiscoveryFilter",
+    "ResourceNode",
+    "ResourceRelationship",
+]
+__version__ = "0.1.2"

{azure_discovery-0.1.0 → azure_discovery-0.1.2}/azure_discovery/cli.py

@@ -17,7 +17,7 @@ from .adt_types import (
     DiscoveryFilter,
     VisualizationOptions,
 )
-from .utils.logging import get_logger
+from .utils.logging import enable_cli_logging
 
 cli = typer.Typer(help="Azure tenant discovery and visualization CLI")
 
@@ -83,8 +83,8 @@ def discover_command(
     Use --quiet to suppress all logs except errors.
     """
 
-    # Initialize logger with quiet mode
-    get_logger(quiet=quiet)
+    # Emit logs to stderr only when run as CLI; library use stays silent.
+    enable_cli_logging(quiet=quiet)
 
     tag_filters = _parse_tags(required_tag)
     discovery_filter = DiscoveryFilter(

azure_discovery-0.1.2/azure_discovery/utils/logging.py

@@ -0,0 +1,86 @@
+"""Structured logging helpers.
+
+When used as a library (e.g. imported by auto_iac), no handlers are attached
+by default so the package does not write to stderr and does not interfere
+with the calling application's UI (e.g. Rich live panels). Callers can attach
+their own handler to the \"azure_discovery\" logger if they want to see logs.
+
+When run as the CLI, the entrypoint calls enable_cli_logging() so logs are
+emitted to stderr in JSON form.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import sys
+from typing import Any, Dict
+
+_LOGGER_NAME = "azure_discovery"
+
+
+def _build_json_formatter() -> logging.Formatter:
+    class JsonFormatter(logging.Formatter):
+        def format(self, record: logging.LogRecord) -> str:
+            payload: Dict[str, Any] = {
+                "logger": record.name,
+                "level": record.levelname,
+                "message": record.getMessage(),
+                "module": record.module,
+                "function": record.funcName,
+            }
+            if record.exc_info:
+                payload["exc_info"] = self.formatException(record.exc_info)
+            if record.__dict__.get("context"):
+                payload["context"] = record.__dict__["context"]
+            return json.dumps(payload)
+
+    return JsonFormatter()
+
+
+def get_logger(quiet: bool = False) -> logging.Logger:
+    """Return module-wide logger. Does not attach any handler when used as a library.
+
+    Library use: no output unless the calling app attaches a handler to
+    \"azure_discovery\". CLI use: call enable_cli_logging() first so logs go to stderr.
+
+    Args:
+        quiet: Ignored when no CLI handler is attached. When enable_cli_logging(quiet=True)
+            is used, only ERROR and above are emitted.
+    """
+    logger = logging.getLogger(_LOGGER_NAME)
+    if logger.handlers:
+        if quiet:
+            logger.setLevel(logging.ERROR)
+        return logger
+
+    # Library default: no stderr output; avoid interfering with calling scripts.
+    logger.addHandler(logging.NullHandler())
+    logger.propagate = False
+    if quiet:
+        logger.setLevel(logging.ERROR)
+    else:
+        env_level = os.getenv("AZURE_DISCOVERY_LOG_LEVEL", "INFO").upper()
+        logger.setLevel(env_level)
+    return logger
+
+
+def enable_cli_logging(quiet: bool = False) -> None:
+    """Attach stderr + JSON handler so logs are emitted when run as the CLI.
+
+    Call this from the CLI entrypoint only. When used as a library, do not call
+    this so the package does not write to stderr.
+    """
+    logger = logging.getLogger(_LOGGER_NAME)
+    # Replace any existing handlers (e.g. NullHandler from get_logger) with our CLI handler.
+    logger.handlers.clear()
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(_build_json_formatter())
+    logger.addHandler(handler)
+    logger.propagate = False
+    if quiet:
+        logger.setLevel(logging.ERROR)
+    else:
+        env_level = os.getenv("AZURE_DISCOVERY_LOG_LEVEL", "INFO").upper()
+        logger.setLevel(env_level)

{azure_discovery-0.1.0 → azure_discovery-0.1.2}/azure_discovery.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: azure-discovery
-Version: 0.1.0
+Version: 0.1.2
 Summary: Lightweight Azure tenant discovery and visualization via Resource Graph. Enumerates subscriptions and resources, normalizes results, and renders interactive dependency graphs. Supports public and sovereign clouds (Gov, China, Germany, Azure Stack).
 Author: David Frazer <david.frazer336@gmail.com>
 License-Expression: MIT

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

@@ -1,116 +1,116 @@
-[build-system]
-requires = ["setuptools>=66", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "azure-discovery"
-version = "0.1.0"
-description = "Lightweight Azure tenant discovery and visualization via Resource Graph. Enumerates subscriptions and resources, normalizes results, and renders interactive dependency graphs. Supports public and sovereign clouds (Gov, China, Germany, Azure Stack)."
-readme = "README.md"
-license = "MIT"
-requires-python = ">=3.11"
-authors = [
-    { name = "David Frazer <david.frazer336@gmail.com>" }
-]
-keywords = [
-    "azure",
-    "resource-graph",
-    "discovery",
-    "inventory",
-    "sovereign-cloud",
-    "visualization",
-]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: System :: Systems Administration",
-]
-dependencies = [
-    "pydantic>=2.7",
-    "fastapi>=0.110",
-    "uvicorn>=0.30",
-    "typer>=0.12",
-    "pyvis>=0.3.2",
-    "azure-identity>=1.17",
-    "azure-mgmt-resourcegraph>=8.0",
-    "azure-mgmt-subscription>=3.1",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.2",
-    "pytest-asyncio>=0.23",
-    "pytest-cov>=5.0",
-    "ruff>=0.4.0",
-    "mypy>=1.10",
-]
-
-[project.scripts]
-azure-discovery = "azure_discovery.cli:main"
-
-[project.urls]
-Documentation = "https://github.com/maravedi/AzureDiscovery#readme"
-Repository = "https://github.com/maravedi/AzureDiscovery"
-"Bug Tracker" = "https://github.com/maravedi/AzureDiscovery/issues"
-
-[tool.setuptools.packages.find]
-where = ["."]
-include = ["azure_discovery*"]
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-testpaths = ["tests"]
-python_files = "test_*.py"
-python_functions = "test_*"
-addopts = "--cov=azure_discovery --cov-report=term-missing --cov-report=html"
-
-[tool.ruff]
-line-length = 100
-target-version = "py311"
-
-[tool.ruff.lint]
-select = [
-    "E",   # pycodestyle errors
-    "W",   # pycodestyle warnings
-    "F",   # pyflakes
-    "I",   # isort
-    "B",   # flake8-bugbear
-    "C4",  # flake8-comprehensions
-    "UP",  # pyupgrade
-]
-ignore = [
-    "E501",  # line too long (handled by formatter)
-]
-
-[tool.mypy]
-python_version = "3.11"
-strict = true
-warn_return_any = true
-warn_unused_configs = true
-disallow_untyped_defs = true
-disallow_any_generics = false
-disallow_subclassing_any = false
-warn_redundant_casts = true
-warn_unused_ignores = true
-no_implicit_optional = true
-check_untyped_defs = true
-
-[tool.coverage.run]
-omit = [
-    "tests/*",
-    "*/__init__.py",
-]
-
-[tool.coverage.report]
-exclude_lines = [
-    "pragma: no cover",
-    "def __repr__",
-    "raise AssertionError",
-    "raise NotImplementedError",
-    "if __name__ == .__main__.:",
-    "if TYPE_CHECKING:",
-]
+[build-system]
+requires = ["setuptools>=66", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "azure-discovery"
+version = "0.1.2"
+description = "Lightweight Azure tenant discovery and visualization via Resource Graph. Enumerates subscriptions and resources, normalizes results, and renders interactive dependency graphs. Supports public and sovereign clouds (Gov, China, Germany, Azure Stack)."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "David Frazer <david.frazer336@gmail.com>" }
+]
+keywords = [
+    "azure",
+    "resource-graph",
+    "discovery",
+    "inventory",
+    "sovereign-cloud",
+    "visualization",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "pydantic>=2.7",
+    "fastapi>=0.110",
+    "uvicorn>=0.30",
+    "typer>=0.12",
+    "pyvis>=0.3.2",
+    "azure-identity>=1.17",
+    "azure-mgmt-resourcegraph>=8.0",
+    "azure-mgmt-subscription>=3.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.2",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10",
+]
+
+[project.scripts]
+azure-discovery = "azure_discovery.cli:main"
+
+[project.urls]
+Documentation = "https://github.com/maravedi/AzureDiscovery#readme"
+Repository = "https://github.com/maravedi/AzureDiscovery"
+"Bug Tracker" = "https://github.com/maravedi/AzureDiscovery/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["azure_discovery*"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_functions = "test_*"
+addopts = "--cov=azure_discovery --cov-report=term-missing --cov-report=html"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_generics = false
+disallow_subclassing_any = false
+warn_redundant_casts = true
+warn_unused_ignores = true
+no_implicit_optional = true
+check_untyped_defs = true
+
+[tool.coverage.run]
+omit = [
+    "tests/*",
+    "*/__init__.py",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]

azure_discovery-0.1.0/azure_discovery/utils/logging.py

@@ -1,59 +0,0 @@
-"""Structured logging helpers."""
-
-from __future__ import annotations
-
-import json
-import logging
-import os
-import sys
-from typing import Any, Dict
-
-_LOGGER_NAME = "azure_discovery"
-
-
-def _build_json_formatter() -> logging.Formatter:
-    class JsonFormatter(logging.Formatter):
-        def format(self, record: logging.LogRecord) -> str:
-            payload: Dict[str, Any] = {
-                "logger": record.name,
-                "level": record.levelname,
-                "message": record.getMessage(),
-                "module": record.module,
-                "function": record.funcName,
-            }
-            if record.exc_info:
-                payload["exc_info"] = self.formatException(record.exc_info)
-            if record.__dict__.get("context"):
-                payload["context"] = record.__dict__["context"]
-            return json.dumps(payload)
-
-    return JsonFormatter()
-
-
-def get_logger(quiet: bool = False) -> logging.Logger:
-    """Return module-wide structured logger.
-
-    Args:
-        quiet: If True, only log ERROR and above. Logs always go to stderr.
-    """
-
-    logger = logging.getLogger(_LOGGER_NAME)
-    if logger.handlers:
-        # Update log level if quiet mode changed
-        if quiet:
-            logger.setLevel(logging.ERROR)
-        return logger
-
-    # Always use stderr for logs, never stdout
-    handler = logging.StreamHandler(sys.stderr)
-    handler.setFormatter(_build_json_formatter())
-    logger.addHandler(handler)
-
-    if quiet:
-        logger.setLevel(logging.ERROR)
-    else:
-        env_level = os.getenv("AZURE_DISCOVERY_LOG_LEVEL", "INFO").upper()
-        logger.setLevel(env_level)
-
-    logger.propagate = False
-    return logger