azure-discovery 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

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/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/utils/logging.py

@@ -1,4 +1,13 @@
-"""Structured logging helpers."""
+"""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
 
@@ -31,29 +40,47 @@ def _build_json_formatter() -> logging.Formatter:
 
 
 def get_logger(quiet: bool = False) -> logging.Logger:
-    """Return module-wide structured 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: If True, only log ERROR and above. Logs always go to stderr.
+        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:
-        # Update log level if quiet mode changed
         if quiet:
             logger.setLevel(logging.ERROR)
         return logger
 
-    # Always use stderr for logs, never stdout
+    # 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)
-
-    logger.propagate = False
-    return logger

{azure_discovery-0.1.0.dist-info → azure_discovery-0.1.2.dist-info}/METADATA

@@ -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.dist-info → azure_discovery-0.1.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-azure_discovery/__init__.py,sha256=tK8HAgGDPhdvsTOdWFHZK0pB5JUZBo6G23w7np2w8dE,835
+azure_discovery/__init__.py,sha256=XoegHZgjqgojOp8yggmypiG7J9sUVGq6JPBv0yC4wQo,868
 azure_discovery/api.py,sha256=J1iRt3SyVqbSbVpvQgfQcwDtzGK-PT7QlU5QQDTnv_k,1290
-azure_discovery/cli.py,sha256=Qqjifxu-zbsktkxpA0_8LI7PntgnmUOvs1NlcCu_Vj0,4233
+azure_discovery/cli.py,sha256=kSm1gVytcjxp9qfMdMmuLQX8PmgNWlZ8xqQ0lx7sV-8,4283
 azure_discovery/orchestrator.py,sha256=xD_W0qHw46ahia95Lbam2UUa13jw4jnStWc-DE7nQLU,839
 azure_discovery/adt_types/__init__.py,sha256=wKv5ggC77-hCve-96VWnkjsjAe-zbzbcHEi1jQCCjOw,433
 azure_discovery/adt_types/errors.py,sha256=_I_2CTzEowzoXEXZcJEcyknmOYovG30IvX-jXt7d0RE,340
@@ -13,10 +13,10 @@ azure_discovery/reporting/html.py,sha256=jH4BJjZFGFpoSvquxnosMx1AIyWfUf0immdDnqm
 azure_discovery/utils/__init__.py,sha256=oIrIQN9OPeaE3djBcB5sR1PhBpkdkw9lA8QEEv4agHY,292
 azure_discovery/utils/azure_clients.py,sha256=TG4tWivxE2IvKSBGRUtWF0eA25Wb0GrILor2nrfcwmY,5972
 azure_discovery/utils/graph_helpers.py,sha256=XQTqEg9SPU6V3r2qas2BII6-KquBizc5DclbCLAfLKg,1181
-azure_discovery/utils/logging.py,sha256=LvT9Fea__hqOq2UwScHpT8eElW4ArzwyZwVMBSMUgoc,1692
-azure_discovery-0.1.0.dist-info/licenses/LICENSE,sha256=H5Cd8vqg-_kMV2v3EQEc9JgLWLa-tZKrn8ekdbVRE_0,1085
-azure_discovery-0.1.0.dist-info/METADATA,sha256=ruZ-wVxReb5QSxtV2WEXSV6SWJ7s_ViUQ-DGu4MCbCI,15516
-azure_discovery-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-azure_discovery-0.1.0.dist-info/entry_points.txt,sha256=ZoF7ybEeKIn5Q2Rklb77swS2lZ-4L_NzXhUOo1pFttM,61
-azure_discovery-0.1.0.dist-info/top_level.txt,sha256=aui6halihvG0KwHYrQYpTpu5gO-dI-Xr3nQ1JRB1vIk,16
-azure_discovery-0.1.0.dist-info/RECORD,,
+azure_discovery/utils/logging.py,sha256=hTpScdRRxqOCTI5jpKQ9owA3XzTnHLErFo5eRpDXW6A,3048
+azure_discovery-0.1.2.dist-info/licenses/LICENSE,sha256=H5Cd8vqg-_kMV2v3EQEc9JgLWLa-tZKrn8ekdbVRE_0,1085
+azure_discovery-0.1.2.dist-info/METADATA,sha256=qru5Xlk77B_DpFrDLrWn8sIK5d8Vk46UwB6CB97xK00,15516
+azure_discovery-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+azure_discovery-0.1.2.dist-info/entry_points.txt,sha256=ZoF7ybEeKIn5Q2Rklb77swS2lZ-4L_NzXhUOo1pFttM,61
+azure_discovery-0.1.2.dist-info/top_level.txt,sha256=aui6halihvG0KwHYrQYpTpu5gO-dI-Xr3nQ1JRB1vIk,16
+azure_discovery-0.1.2.dist-info/RECORD,,