[xdsky]

Adds a debugging guide to the documentation. It covers: breaking a chain into smaller steps; inspecting the current selection (size, vals, all, val); selectors that match nothing; the "Cannot find a solid" error raised by findSolid; checking a shape with isValid, Volume and BoundingBox; and exporting intermediate results. All examples use non-executed code-block directives.

Closes #612

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.81%. Comparing base (5f5bc62) to head (bc809ef).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2113   +/-   ##
=======================================
  Coverage   95.81%   95.81%           
=======================================
  Files          30       30           
  Lines        9599     9605    +6     
  Branches     1441     1443    +2     
=======================================
+ Hits         9197     9203    +6     
  Misses        247      247           
  Partials      155      155           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[adam-urbanczyk]

Thanks @xdsky! To what extent was this LLM generated?

[xdsky]

Thanks! Honestly, it was AI-assisted for the initial draft, but I went through it myself and checked the workflow actually works - the debug()/inspect() parts are from my own use. If anything reads off or doesn't match the project's style, just point it out and I'll fix it.

[adam-urbanczyk]

I see three issues:

(1) CQ is not limited to the fluent/Workplane API
(2) You can invoke stuff with invoke without breaking the chain
(3) You mention vis capabilities and exporting+using external viewers. That is a contradiction, there is no need to use external viewers. Additionally, one can visualize things likes locations or vectors.

[xdsky]

Thanks for the detailed review - all three are fair. Reworked the tutorial:

• it's no longer framed around chains only; now covers the fluent, free function and OCCT levels
• added invoke() so you can print or hit a breakpoint mid-chain
• dropped the export + external viewer suggestion, cadquery.vis.show does the job, including locations and vectors

Just pushed an update.