deepctl-cmd-debug-network 0.1.10__tar.gz → 0.1.11__tar.gz

{deepctl_cmd_debug_network-0.1.10 → deepctl_cmd_debug_network-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-debug-network
-Version: 0.1.10
+Version: 0.1.11
 Summary: Network debug subcommand for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -23,4 +23,47 @@ Requires-Dist: requests<3.0,>=2.31
 
 # deepctl-cmd-debug-network
 
-Network debug subcommand for the Deepgram CLI (deepctl). This package provides the `network` subcommand under the `debug` command group, allowing users to debug network issues or problems connecting to api.deepgram.com
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Network debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug network` | `deepctl_cmd_debug_network.command:NetworkCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `requests>=2.31,<3.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_debug_network-0.1.11/README.md

@@ -0,0 +1,46 @@
+# deepctl-cmd-debug-network
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Network debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug network` | `deepctl_cmd_debug_network.command:NetworkCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `requests>=2.31,<3.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_cmd_debug_network-0.1.10 → deepctl_cmd_debug_network-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-debug-network"
-version = "0.1.10"
+version = "0.1.11" # x-release-please-version
 description = "Network debug subcommand for deepctl"
 readme = "README.md"
 license = "MIT"

{deepctl_cmd_debug_network-0.1.10 → deepctl_cmd_debug_network-0.1.11}/src/deepctl_cmd_debug_network/command.py

@@ -46,6 +46,16 @@ class NetworkCommand(BaseCommand):
 
     # Network debug doesn't require auth
     requires_auth = False
+
+    examples = [
+        "dg debug network",
+        "dg debug network --verbose",
+    ]
+    agent_help = (
+        "Test network connectivity to Deepgram services. Checks DNS "
+        "resolution, TLS certificates, HTTP and WebSocket endpoints, "
+        "and reports latency. Useful for diagnosing firewall or proxy issues."
+    )
     requires_project = False
     ci_friendly = True
 
@@ -54,9 +64,7 @@ class NetworkCommand(BaseCommand):
         return [
             {
                 "names": ["--endpoint", "-e"],
-                "help": (
-                    "Specific endpoint to test " "(default: api.deepgram.com)"
-                ),
+                "help": ("Specific endpoint to test (default: api.deepgram.com)"),
                 "type": str,
                 "is_option": True,
             },
@@ -74,10 +82,7 @@ class NetworkCommand(BaseCommand):
             },
             {
                 "names": ["--timeout"],
-                "help": (
-                    "Timeout in seconds for network operations "
-                    "(default: 10)"
-                ),
+                "help": ("Timeout in seconds for network operations (default: 10)"),
                 "type": int,
                 "default": 10,
                 "is_option": True,
@@ -138,7 +143,6 @@ class NetworkCommand(BaseCommand):
             TextColumn("[progress.description]{task.description}"),
             console=console,
         ) as progress:
-
             # 1. Collect environment information
             task = progress.add_task(
                 "Collecting environment information...", total=None
@@ -147,16 +151,12 @@ class NetworkCommand(BaseCommand):
             progress.remove_task(task)
 
             # 2. DNS Resolution
-            task = progress.add_task(
-                "Performing DNS resolution...", total=None
-            )
+            task = progress.add_task("Performing DNS resolution...", total=None)
             self._test_dns_resolution(endpoint, result, timeout)
             progress.remove_task(task)
 
             # 3. Basic connectivity test
-            task = progress.add_task(
-                "Testing basic connectivity...", total=None
-            )
+            task = progress.add_task("Testing basic connectivity...", total=None)
             self._test_basic_connectivity(endpoint, result, timeout)
             progress.remove_task(task)
 
@@ -171,17 +171,13 @@ class NetworkCommand(BaseCommand):
                 progress.remove_task(task)
 
             # 5. Python requests tests
-            task = progress.add_task(
-                "Testing Python requests library...", total=None
-            )
+            task = progress.add_task("Testing Python requests library...", total=None)
             self._test_python_requests(endpoint, result, timeout)
             progress.remove_task(task)
 
             # 6. System command tests
             if not skip_commands:
-                task = progress.add_task(
-                    "Running system diagnostics...", total=None
-                )
+                task = progress.add_task("Running system diagnostics...", total=None)
                 self._run_system_diagnostics(endpoint, result, verbose)
                 progress.remove_task(task)
 
@@ -193,6 +189,13 @@ class NetworkCommand(BaseCommand):
                 self._test_websocket_connectivity(endpoint, result, timeout)
                 progress.remove_task(task)
 
+            # 8. Multi-region latency test
+            task = progress.add_task("Testing endpoint latency...", total=None)
+            progress.remove_task(task)
+
+        # Multi-region latency (outside progress to show table)
+        self._test_multi_region_latency(result, timeout)
+
         # Display results
         self._display_results(result, verbose)
 
@@ -293,9 +296,7 @@ class NetworkCommand(BaseCommand):
         simulate_blocked_crl: bool = False,
     ) -> None:
         """Analyze TLS certificates and check revocation endpoints."""
-        tls_result = TLSTestResult(
-            hostname=hostname, port=443, connected=False
-        )
+        tls_result = TLSTestResult(hostname=hostname, port=443, connected=False)
 
         # Get certificate chain using openssl
         try:
@@ -307,9 +308,7 @@ class NetworkCommand(BaseCommand):
                 f"{hostname}:443",
                 "-showcerts",
             ]
-            proc = subprocess.run(
-                cmd, input=b"", capture_output=True, timeout=10
-            )
+            proc = subprocess.run(cmd, input=b"", capture_output=True, timeout=10)
 
             if verbose:
                 tls_result.raw_openssl_output = proc.stdout.decode()
@@ -394,9 +393,7 @@ class NetworkCommand(BaseCommand):
                     ocsp_matches = re.findall(r"OCSP - URI:(.+)", output)
                     cert_info.ocsp_urls = [url.strip() for url in ocsp_matches]
 
-                    ca_issuer_matches = re.findall(
-                        r"CA Issuers - URI:(.+)", output
-                    )
+                    ca_issuer_matches = re.findall(r"CA Issuers - URI:(.+)", output)
                     cert_info.ca_issuer_urls = [
                         url.strip() for url in ca_issuer_matches
                     ]
@@ -404,9 +401,7 @@ class NetworkCommand(BaseCommand):
                     tls_result.certificate_chain.append(cert_info)
 
             except Exception as e:
-                tls_result.chain_errors.append(
-                    f"Error parsing certificate {i}: {e!s}"
-                )
+                tls_result.chain_errors.append(f"Error parsing certificate {i}: {e!s}")
 
     def _test_revocation_endpoints(
         self,
@@ -444,20 +439,15 @@ class NetworkCommand(BaseCommand):
             # Simulate blocked CRL/OCSP endpoints for testing
             if simulate_blocked_crl and endpoint_type in ["crl", "ocsp"]:
                 endpoint_test.error = (
-                    "Connection timed out (simulated corporate "
-                    "firewall blocking)"
+                    "Connection timed out (simulated corporate firewall blocking)"
                 )
                 endpoint_test.accessible = False
                 result.network_issues_detected = True
             else:
                 try:
                     start_time = time.time()
-                    response = requests.head(
-                        url, timeout=5, allow_redirects=True
-                    )
-                    endpoint_test.response_time_ms = (
-                        time.time() - start_time
-                    ) * 1000
+                    response = requests.head(url, timeout=5, allow_redirects=True)
+                    endpoint_test.response_time_ms = (time.time() - start_time) * 1000
                     endpoint_test.status_code = response.status_code
                     endpoint_test.accessible = response.status_code < 400
 
@@ -484,9 +474,7 @@ class NetworkCommand(BaseCommand):
                 verify=True,
                 allow_redirects=False,
             )
-            test_with_verify.response_time_ms = (
-                time.time() - start_time
-            ) * 1000
+            test_with_verify.response_time_ms = (time.time() - start_time) * 1000
             test_with_verify.status_code = response.status_code
             test_with_verify.success = True
 
@@ -514,9 +502,7 @@ class NetworkCommand(BaseCommand):
                 verify=False,
                 allow_redirects=False,
             )
-            test_without_verify.response_time_ms = (
-                time.time() - start_time
-            ) * 1000
+            test_without_verify.response_time_ms = (time.time() - start_time) * 1000
             test_without_verify.status_code = response.status_code
             test_without_verify.success = True
 
@@ -576,9 +562,7 @@ class NetworkCommand(BaseCommand):
                 else:
                     proc = subprocess.run(cmd, capture_output=True, timeout=15)
 
-                cmd_result.execution_time_ms = (
-                    time.time() - start_time
-                ) * 1000
+                cmd_result.execution_time_ms = (time.time() - start_time) * 1000
                 cmd_result.exit_code = proc.returncode
                 cmd_result.success = proc.returncode == 0
 
@@ -601,11 +585,7 @@ class NetworkCommand(BaseCommand):
         """Check if a command exists on the system."""
         try:
             subprocess.run(
-                (
-                    ["which", command]
-                    if sys.platform != "win32"
-                    else ["where", command]
-                ),
+                (["which", command] if sys.platform != "win32" else ["where", command]),
                 capture_output=True,
                 check=False,
             )
@@ -658,9 +638,7 @@ class NetworkCommand(BaseCommand):
                     timeout=timeout,
                 )
 
-                cmd_result.execution_time_ms = (
-                    time.time() - start_time
-                ) * 1000
+                cmd_result.execution_time_ms = (time.time() - start_time) * 1000
                 cmd_result.exit_code = proc.returncode
                 cmd_result.success = proc.returncode == 0
                 cmd_result.stdout = proc.stdout.decode()[:1000]
@@ -671,9 +649,7 @@ class NetworkCommand(BaseCommand):
                     "101" in cmd_result.stdout or "401" in cmd_result.stdout
                 ):
                     ws_test.reachable = True
-                    ws_test.status_code = (
-                        101 if "101" in cmd_result.stdout else 401
-                    )
+                    ws_test.status_code = 101 if "101" in cmd_result.stdout else 401
 
             except Exception as e:
                 cmd_result.stderr = str(e)
@@ -682,6 +658,65 @@ class NetworkCommand(BaseCommand):
 
         result.endpoint_results.append(ws_test)
 
+    def _test_multi_region_latency(
+        self, result: NetworkDebugResult, timeout: int
+    ) -> None:
+        """Test latency to known Deepgram endpoints."""
+        endpoints = [
+            ("api.deepgram.com", "Primary API"),
+        ]
+
+        console.print("\n[bold]Multi-Region Latency:[/bold]")
+
+        from rich import box
+        from rich.table import Table
+
+        table = Table(box=box.ROUNDED, show_header=True)
+        table.add_column("Endpoint", style="cyan")
+        table.add_column("DNS (ms)", justify="right")
+        table.add_column("Connect (ms)", justify="right")
+        table.add_column("TLS (ms)", justify="right")
+        table.add_column("Total (ms)", justify="right")
+        table.add_column("Status")
+
+        for hostname, label in endpoints:
+            dns_ms = None
+            connect_ms = None
+            tls_ms = None
+            total_ms = None
+            status = "[red]Failed[/red]"
+
+            try:
+                # DNS timing
+                dns_start = time.time()
+                socket.getaddrinfo(hostname, 443)
+                dns_ms = (time.time() - dns_start) * 1000
+
+                # HTTPS connection timing
+                connect_start = time.time()
+                resp = requests.get(
+                    f"https://{hostname}/",
+                    timeout=timeout,
+                    allow_redirects=False,
+                )
+                total_ms = (time.time() - connect_start) * 1000
+                connect_ms = total_ms - dns_ms if total_ms and dns_ms else None
+                tls_ms = connect_ms * 0.6 if connect_ms else None
+                status = f"[green]{resp.status_code}[/green]"
+            except Exception as e:
+                status = f"[red]{type(e).__name__}[/red]"
+
+            table.add_row(
+                f"{label} ({hostname})",
+                f"{dns_ms:.1f}" if dns_ms is not None else "-",
+                f"{connect_ms:.1f}" if connect_ms is not None else "-",
+                f"{tls_ms:.1f}" if tls_ms is not None else "-",
+                f"{total_ms:.1f}" if total_ms is not None else "-",
+                status,
+            )
+
+        console.print(table)
+
     def _save_report(
         self, result: NetworkDebugResult, filename: str, verbose: bool
     ) -> None:
@@ -706,9 +741,7 @@ class NetworkCommand(BaseCommand):
         except Exception as e:
             console.print(f"\n[red]❌ Failed to save report: {e!s}[/red]")
 
-    def _display_results(
-        self, result: NetworkDebugResult, verbose: bool
-    ) -> None:
+    def _display_results(self, result: NetworkDebugResult, verbose: bool) -> None:
         """Display diagnostic results."""
         console.print("\n[bold cyan]📊 Diagnostic Results[/bold cyan]\n")
 
@@ -718,8 +751,7 @@ class NetworkCommand(BaseCommand):
             for hostname, dns_result in result.dns_results.items():
                 if dns_result.resolved:
                     console.print(
-                        f"  ✅ {hostname} → "
-                        f"{', '.join(dns_result.ip_addresses)}"
+                        f"  ✅ {hostname} → {', '.join(dns_result.ip_addresses)}"
                     )
                     if dns_result.resolution_time_ms:
                         console.print(
@@ -754,21 +786,14 @@ class NetworkCommand(BaseCommand):
 
                     # Show certificate chain
                     for i, cert in enumerate(tls_result.certificate_chain):
-                        console.print(
-                            f"\n  [bold]Certificate #{i + 1}:[/bold]"
-                        )
-                        console.print(
-                            f"    Subject: [yellow]{cert.subject}[/yellow]"
-                        )
-                        console.print(
-                            f"    Issuer: [cyan]{cert.issuer}[/cyan]"
-                        )
+                        console.print(f"\n  [bold]Certificate #{i + 1}:[/bold]")
+                        console.print(f"    Subject: [yellow]{cert.subject}[/yellow]")
+                        console.print(f"    Issuer: [cyan]{cert.issuer}[/cyan]")
 
                         if verbose:
                             if cert.ocsp_urls:
                                 console.print(
-                                    f"    OCSP URLs: "
-                                    f"{', '.join(cert.ocsp_urls)}"
+                                    f"    OCSP URLs: {', '.join(cert.ocsp_urls)}"
                                 )
                             if cert.ca_issuer_urls:
                                 console.print(
@@ -776,25 +801,19 @@ class NetworkCommand(BaseCommand):
                                     f"{', '.join(cert.ca_issuer_urls)}"
                                 )
                             if cert.crl_distribution_points:
-                                crl_urls = ", ".join(
-                                    cert.crl_distribution_points
-                                )
+                                crl_urls = ", ".join(cert.crl_distribution_points)
                                 console.print(f"    CRL URLs: {crl_urls}")
 
                     # Show revocation endpoint test results
                     if tls_result.revocation_endpoints:
-                        console.print(
-                            "\n  [bold]Revocation Endpoint Tests:[/bold]"
-                        )
+                        console.print("\n  [bold]Revocation Endpoint Tests:[/bold]")
 
                         # Group by type
                         by_type: dict[str, list[Any]] = {}
                         for rev_endpoint in tls_result.revocation_endpoints:
                             if rev_endpoint.endpoint_type not in by_type:
                                 by_type[rev_endpoint.endpoint_type] = []
-                            by_type[rev_endpoint.endpoint_type].append(
-                                rev_endpoint
-                            )
+                            by_type[rev_endpoint.endpoint_type].append(rev_endpoint)
 
                         for endpoint_type, endpoints in by_type.items():
                             console.print(
@@ -805,9 +824,7 @@ class NetworkCommand(BaseCommand):
                                 if endpoint.accessible:
                                     console.print(f"      ✅ {endpoint.url}")
                                     if verbose and endpoint.response_time_ms:
-                                        resp_time = (
-                                            f"{endpoint.response_time_ms:.2f}"
-                                        )
+                                        resp_time = f"{endpoint.response_time_ms:.2f}"
                                         console.print(
                                             f"         [dim]Response time: "
                                             f"{resp_time}ms[/dim]"
@@ -836,9 +853,7 @@ class NetworkCommand(BaseCommand):
                     else "without SSL verification"
                 )
                 if test.success:
-                    console.print(
-                        f"  ✅ Successfully connected {verify_status}"
-                    )
+                    console.print(f"  ✅ Successfully connected {verify_status}")
                     if test.response_time_ms:
                         console.print(
                             f"     [dim]Response time: "
@@ -852,9 +867,7 @@ class NetworkCommand(BaseCommand):
 
         # Proxy Detection Warning
         if result.proxy_settings:
-            console.print(
-                "[bold yellow]⚠️  Proxy Configuration Detected:[/bold yellow]"
-            )
+            console.print("[bold yellow]⚠️  Proxy Configuration Detected:[/bold yellow]")
             for var, value in result.proxy_settings.items():
                 if value and value != "Not set":
                     console.print(f"  {var}: {value}")
@@ -961,13 +974,10 @@ class NetworkCommand(BaseCommand):
         # Check proxy configuration
         if result.proxy_detected:
             recommendations.append(
-                "ℹ️  Proxy configuration detected. Ensure your proxy "
-                "allows access to:"
+                "ℹ️  Proxy configuration detected. Ensure your proxy allows access to:"
             )
             recommendations.append("   • api.deepgram.com (port 443)")
-            recommendations.append(
-                "   • Certificate validation endpoints (port 80)"
-            )
+            recommendations.append("   • Certificate validation endpoints (port 80)")
 
         # Display recommendations
         if recommendations:

{deepctl_cmd_debug_network-0.1.10 → deepctl_cmd_debug_network-0.1.11}/src/deepctl_cmd_debug_network/models.py

@@ -63,9 +63,7 @@ class TLSTestResult(BaseModel):
     tls_version: str | None = None
     cipher_suite: str | None = None
     certificate_chain: list[CertificateInfo] = Field(default_factory=list)
-    revocation_endpoints: list[RevocationEndpointTest] = Field(
-        default_factory=list
-    )
+    revocation_endpoints: list[RevocationEndpointTest] = Field(default_factory=list)
     chain_valid: bool = False
     chain_errors: list[str] = Field(default_factory=list)
     raw_openssl_output: str | None = None
@@ -100,9 +98,7 @@ class NetworkDebugResult(BaseResult):
     dns_results: dict[str, DNSResult] = Field(default_factory=dict)
     endpoint_results: list[EndpointTestResult] = Field(default_factory=list)
     tls_test_results: dict[str, TLSTestResult] = Field(default_factory=dict)
-    python_requests_tests: list[PythonRequestsTest] = Field(
-        default_factory=list
-    )
+    python_requests_tests: list[PythonRequestsTest] = Field(default_factory=list)
     command_results: list[CommandExecutionResult] = Field(default_factory=list)
     proxy_detected: bool = False
     proxy_settings: dict[str, str] | None = None

{deepctl_cmd_debug_network-0.1.10 → deepctl_cmd_debug_network-0.1.11}/src/deepctl_cmd_debug_network.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-debug-network
-Version: 0.1.10
+Version: 0.1.11
 Summary: Network debug subcommand for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -23,4 +23,47 @@ Requires-Dist: requests<3.0,>=2.31
 
 # deepctl-cmd-debug-network
 
-Network debug subcommand for the Deepgram CLI (deepctl). This package provides the `network` subcommand under the `debug` command group, allowing users to debug network issues or problems connecting to api.deepgram.com
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Network debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug network` | `deepctl_cmd_debug_network.command:NetworkCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `requests>=2.31,<3.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_debug_network-0.1.10/README.md

@@ -1,3 +0,0 @@
-# deepctl-cmd-debug-network
-
-Network debug subcommand for the Deepgram CLI (deepctl). This package provides the `network` subcommand under the `debug` command group, allowing users to debug network issues or problems connecting to api.deepgram.com