Skip to content

docs: add documentation on how to debug embedded app in linux using vscode#1574

Open
dipinknair wants to merge 7 commits intomainfrom
doc/add-debug-mech-env
Open

docs: add documentation on how to debug embedded app in linux using vscode#1574
dipinknair wants to merge 7 commits intomainfrom
doc/add-debug-mech-env

Conversation

@dipinknair
Copy link
Copy Markdown
Collaborator

Closes #1190

@dipinknair dipinknair requested a review from a team as a code owner March 28, 2026 21:21
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 28, 2026
@codecov
Copy link
Copy Markdown

codecov bot commented Mar 28, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.30%. Comparing base (6607e79) to head (9bcdd28).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1574      +/-   ##
==========================================
+ Coverage   80.28%   80.30%   +0.01%     
==========================================
  Files          42       42              
  Lines        3191     3193       +2     
==========================================
+ Hits         2562     2564       +2     
  Misses        629      629              
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@dipinknair dipinknair requested review from MaxJPRey and PipKat April 3, 2026 20:38
@codacy-production
Copy link
Copy Markdown

codacy-production bot commented Apr 6, 2026

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Coverage ∅ diff coverage · +0.01% coverage variation

Metric Results
Coverage variation +0.01% coverage variation (-1.00%)
Diff coverage diff coverage

View coverage diff in Codacy

Coverage variation details
Coverable lines Covered lines Coverage
Common ancestor commit (6607e79) 3191 2562 80.29%
Head commit (9bcdd28) 3193 (+2) 2564 (+2) 80.30% (+0.01%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details
Coverable lines Covered lines Diff coverage
Pull request (#1574) 0 0 ∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

TIP This summary will be updated as you push new changes. Give us feedback

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

Pull request documentation preview limit (10) reached: skipping documentation deployment for this pull request.

@dipinknair dipinknair requested a review from sbradrick April 6, 2026 15:14
]
}

#. Start **Run and Debug**, choose **Python Debugger: Current File**, and run your script.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bold is used only to indicate UI options--is that the case here?

Debugging with Visual Studio Code
---------------------------------

To debug embedded PyMechanical scripts in VS Code on Linux, export the environment that
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To debug embedded PyMechanical scripts in VS Code on Linux, export the environment that
To debug embedded PyMechanical scripts in Visual Studio Code on Linux, export the environment that

---------------------------------

To debug embedded PyMechanical scripts in VS Code on Linux, export the environment that
``mechanical-env`` would set and attach the debugger to it. See
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
``mechanical-env`` would set and attach the debugger to it. See
``mechanical-env`` variable would set and attach the debugger to it. See

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe "mechanical-env script" instead

Copy link
Copy Markdown
Member

@PipKat PipKat Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@klmcadams I was just trying to put a noun after to indicate what type of entity it was. Script is fine with me. I do think I made the same "variable" change elsewhere though so I'd recommend a search. (I can make to see that you found that edit of mine and also recommended script there. Way to go!)

Co-authored-by: Kathy Pippert <84872299+PipKat@users.noreply.github.com>
Debug with Visual Studio Code on Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

On Linux, the Python debugger must see the same environment that ``mechanical-env`` sets when
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
On Linux, the Python debugger must see the same environment that ``mechanical-env`` sets when

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

On Linux, the Python debugger must see the same environment that ``mechanical-env`` sets when
On Linux, the Python debugger must see the same environment that the ``mechanical-env`` variable sets when
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
On Linux, the Python debugger must see the same environment that the ``mechanical-env`` variable sets when
On Linux, the Python debugger must see the same environment that the ``mechanical-env`` script sets when

---------------------------------

To debug embedded PyMechanical scripts in VS Code on Linux, export the environment that
``mechanical-env`` would set and attach the debugger to it. See
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe "mechanical-env script" instead

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing documentation

4 participants