debugpy 1.8.15__tar.gz → 1.8.16__tar.gz

{debugpy-1.8.15/src/debugpy.egg-info → debugpy-1.8.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugpy
-Version: 1.8.15
+Version: 1.8.16
 Summary: An implementation of the Debug Adapter Protocol for Python
 Home-page: https://aka.ms/debugpy
 Author: Microsoft Corporation

{debugpy-1.8.15 → debugpy-1.8.16}/src/debugpy/__init__.py

@@ -15,6 +15,7 @@ __all__ = [  # noqa
     "configure",
     "connect",
     "debug_this_thread",
+    "get_cli_options",
     "is_client_connected",
     "listen",
     "log_to",

{debugpy-1.8.15 → debugpy-1.8.16}/src/debugpy/_vendored/pydevd/pydevd_tracing.py

@@ -250,7 +250,9 @@ def get_python_helper_lib_filename():
         else:
             suffix = suffix_32
 
-        if IS_WINDOWS or IS_MAC:  # just the extension changes
+        if IS_WINDOWS:  # just the extension changes
+            prefix = "attach_"
+        elif IS_MAC:
             prefix = "attach"
             suffix = ""
         elif IS_LINUX:  #

{debugpy-1.8.15 → debugpy-1.8.16}/src/debugpy/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-07-08T10:47:47-0700",
+ "date": "2025-08-05T11:08:32-0700",
  "dirty": false,
  "error": null,
- "full-revisionid": "ea1dd9a838749a58bcc2d026693cc5a3c3cdbad1",
- "version": "1.8.15"
+ "full-revisionid": "b00a8129977494bd127dd0bfed22082597762a08",
+ "version": "1.8.16"
 }
 '''  # END VERSION_JSON
 

{debugpy-1.8.15 → debugpy-1.8.16}/src/debugpy/public_api.py

@@ -4,6 +4,7 @@
 
 from __future__ import annotations
 
+import dataclasses
 import functools
 import typing
 
@@ -21,6 +22,21 @@ from debugpy import _version
 Endpoint = typing.Tuple[str, int]
 
 
+@dataclasses.dataclass(frozen=True)
+class CliOptions:
+    """Options that were passed to the debugpy CLI entry point."""
+    mode: typing.Literal["connect", "listen"]
+    target_kind: typing.Literal["file", "module", "code", "pid"]
+    address: Endpoint
+    log_to: str | None = None
+    log_to_stderr: bool = False
+    target: str | None = None
+    wait_for_client: bool = False
+    adapter_access_token: str | None = None
+    config: dict[str, object] = dataclasses.field(default_factory=dict)
+    parent_session_pid: int | None = None
+
+
 def _api(cancelable=False):
     def apply(f):
         @functools.wraps(f)
@@ -196,4 +212,37 @@ def trace_this_thread(__should_trace: bool):
     """
 
 
+def get_cli_options() -> CliOptions | None:
+    """Returns the CLI options that were processed by debugpy.
+    
+    These options are all the options after the CLI args and
+    environment variables that were processed on startup.
+    
+    If the debugpy CLI entry point was not called in this process, the
+    returned value is None.
+    """
+    from debugpy.server import cli
+
+    options = cli.options
+    if options.mode is None or options.target_kind is None or options.address is None:
+        # The CLI entrypoint was not called so there are no options present.
+        return None
+
+    # We don't return the actual options object because we don't want callers
+    # to be able to mutate it. Instead we use a frozen dataclass as a snapshot
+    # with richer type annotations.
+    return CliOptions(
+        mode=options.mode,
+        target_kind=options.target_kind,
+        address=options.address,
+        log_to=options.log_to,
+        log_to_stderr=options.log_to_stderr,
+        target=options.target,
+        wait_for_client=options.wait_for_client,
+        adapter_access_token=options.adapter_access_token,
+        config=options.config,
+        parent_session_pid=options.parent_session_pid,
+    )
+
+
 __version__: str = _version.get_versions()["version"]

{debugpy-1.8.15 → debugpy-1.8.16}/src/debugpy/server/cli.py

@@ -7,7 +7,7 @@ import os
 import re
 import sys
 from importlib.util import find_spec
-from typing import Any, Union, Tuple, Dict
+from typing import Any, Union, Tuple, Dict, Literal
 
 # debugpy.__main__ should have preloaded pydevd properly before importing this module.
 # Otherwise, some stdlib modules above might have had imported threading before pydevd
@@ -23,6 +23,7 @@ import debugpy.server
 from debugpy.common import log, sockets
 from debugpy.server import api
 
+TargetKind = Literal["file", "module", "code", "pid"]
 
 TARGET = "<filename> | -m <module> | -c <code> | --pid <pid>"
 
@@ -35,6 +36,7 @@ Usage: debugpy --listen | --connect
                [--configure-<name> <value>]...
                [--log-to <path>] [--log-to-stderr]
                [--parent-session-pid <pid>]]
+               [--adapter-access-token <token>]
                {1}
                [<arg>]...
 """.format(
@@ -42,13 +44,14 @@ Usage: debugpy --listen | --connect
 )
 
 
+# Changes here should be aligned with the public API CliOptions.
 class Options(object):
-    mode = None
+    mode: Union[Literal["connect", "listen"], None] = None
     address: Union[Tuple[str, int], None] = None
     log_to = None
     log_to_stderr = False
     target: Union[str, None] = None
-    target_kind: Union[str, None] = None
+    target_kind: Union[TargetKind, None] = None
     wait_for_client = False
     adapter_access_token = None
     config: Dict[str, Any] = {}
@@ -145,7 +148,7 @@ def set_config(arg, it):
     options.config[name] = value
 
 
-def set_target(kind: str, parser=(lambda x: x), positional=False):
+def set_target(kind: TargetKind, parser=(lambda x: x), positional=False):
     def do(arg, it):
         options.target_kind = kind
         target = parser(arg if positional else next(it))
@@ -182,8 +185,6 @@ switches = [
     ("--wait-for-client",       None,               set_const("wait_for_client", True)),
     ("--configure-.+",          "<value>",          set_config),
     ("--parent-session-pid",    "<pid>",            set_arg("parent_session_pid", lambda x: int(x) if x else None)),
-
-    # Switches that are used internally by the client or debugpy itself.
     ("--adapter-access-token",   "<token>",         set_arg("adapter_access_token")),
 
     # Targets. The "" entry corresponds to positional command line arguments,

{debugpy-1.8.15 → debugpy-1.8.16/src/debugpy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugpy
-Version: 1.8.15
+Version: 1.8.16
 Summary: An implementation of the Debug Adapter Protocol for Python
 Home-page: https://aka.ms/debugpy
 Author: Microsoft Corporation