From 82797c1ed409971fbed673d9b32074d8172fdcbc Mon Sep 17 00:00:00 2001 From: Paula Camargo Date: Thu, 12 Oct 2023 16:10:30 -0700 Subject: [PATCH 1/2] Update readme --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index c4555200..e4057d05 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,19 @@ Note: - The Python extension offers the python debugger extension as an optional installation, including it during the setup process. - This extension is supported for all [actively supported versions](https://devguide.python.org/#status-of-python-branches) of the Python language (i.e., Python >= 3.7). + +## Intent and Purpose + +The primary intent of this extension is to address the following crucial issues: + + +1. **Independence and Compatibility:** The primary aim of this extension is to offer autonomy to the bundled debugpy implementation, freeing it from dependency on the primary Python extension. This solution tackles a common problem where users encounter challenges debugging with older Python versions (e.g., Python 3.7) as the primary Python extension progresses. Users often face two choices: stick with an older Python extension version and miss out on new features, or upgrade their Python environment, which may not always be feasible. With this extension, you can selectively enable the debugger features, while keeping your main Python extension up-to-date. + +2. **Platform-Specific Builds:** Unlike the main Python extension, which bundles all debugpy builds for various platforms into a single extension package, this extension provides a more streamlined approach. It delivers platform-specific builds, ensuring you only receive the components relevant to your specific platform. This reduces unnecessary overhead. + +3. **Feature Parity and Ongoing Updates:** This extension replicates all the functionality available in the main Python extension. Any new features introduced in the Python extension will be added here. In the future, the main extension will transition to using this extension for these features. + + ## Usage Once installed in Visual Studio Code, python-debugger will be automatically activated when you open a Python file. From f8ec2f5d315ceb018bca57f98644e239a11bbd8f Mon Sep 17 00:00:00 2001 From: paulacamargo25 Date: Thu, 12 Oct 2023 16:41:23 -0700 Subject: [PATCH 2/2] Update README.md Co-authored-by: Luciana Abud <45497113+luabud@users.noreply.github.com> --- README.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e4057d05..4a67350f 100644 --- a/README.md +++ b/README.md @@ -7,16 +7,15 @@ Note: - This extension is supported for all [actively supported versions](https://devguide.python.org/#status-of-python-branches) of the Python language (i.e., Python >= 3.7). -## Intent and Purpose +## Purpose -The primary intent of this extension is to address the following crucial issues: +The main intent of this extension is to offer: +1. **Independence and Compatibility:** The Python Debugger extension aims to separate the debugging functionality from the main Python extension to prevent compatibility issues. This ensures that even as the Python extension drops support for older Python versions (e.g., Python 3.7), you can continue debugging projects with those versions without downgrading your Python extension. This allows you to access new features and bug fixes while keeping your debugging capabilities intact. -1. **Independence and Compatibility:** The primary aim of this extension is to offer autonomy to the bundled debugpy implementation, freeing it from dependency on the primary Python extension. This solution tackles a common problem where users encounter challenges debugging with older Python versions (e.g., Python 3.7) as the primary Python extension progresses. Users often face two choices: stick with an older Python extension version and miss out on new features, or upgrade their Python environment, which may not always be feasible. With this extension, you can selectively enable the debugger features, while keeping your main Python extension up-to-date. +2. **Platform-Specific Builds:** Unlike the main Python extension, which bundles all debugpy builds for various platforms into a single extension package, the Python Debugger extension provides a more streamlined approach: it delivers platform-specific builds, ensuring you only receive the components relevant to your specific operating system. This reduces download times and unnecessary overhead. -2. **Platform-Specific Builds:** Unlike the main Python extension, which bundles all debugpy builds for various platforms into a single extension package, this extension provides a more streamlined approach. It delivers platform-specific builds, ensuring you only receive the components relevant to your specific platform. This reduces unnecessary overhead. - -3. **Feature Parity and Ongoing Updates:** This extension replicates all the functionality available in the main Python extension. Any new features introduced in the Python extension will be added here. In the future, the main extension will transition to using this extension for these features. +3. **Feature Parity and Ongoing Updates:** This extension replicates all the functionality available in the main Python extension, and more. Going forward, any new debugger features will be added to this extension. In the future, the Python extension will no longer offer debugging support on its own, and we will transition all debugging support to this extension for all debugging functionality. ## Usage