More free functions

[adam-urbanczyk]

This PR should reach (rough) feature parity with Shape.* Closes #1812

• prism
• hollow
• offset2D
• fillet2D
• draft
• set ops for combining selectors

This enables e.g.
selection = f.outerWire() & f.edges('|X')

• history

Big experimental change. Added a History and Op class. History instance can be passed now to many ops via history= kwarg. Name for the operation can be specified via name=. It can be later queried like so:

h = History()

f = plane(1,1)
res = extrude(f, (0,0,1), history=h, name='ex')

top = h['ex'].last()
side = h[-1].generated(f.edges())

• tests
• docs

[codecov]

Codecov Report

❌ Patch coverage is 97.46835% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.66%. Comparing base (8c17892) to head (d724fc6).

Files with missing lines	Patch %	Lines
cadquery/occ_impl/shapes.py	97.43%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2038      +/-   ##
==========================================
+ Coverage   95.64%   95.66%   +0.01%     
==========================================
  Files          30       30              
  Lines        8962     9040      +78     
  Branches     1328     1344      +16     
==========================================
+ Hits         8572     8648      +76     
- Misses        240      241       +1     
- Partials      150      151       +1     

☔ View full report in Codecov by Sentry.
📢 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.

[codecov]

Codecov Report

❌ Patch coverage is 98.23009% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.75%. Comparing base (8c17892) to head (8f54845).
⚠️ Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
cadquery/occ_impl/shapes.py	98.21%	2 Missing and 6 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2038      +/-   ##
==========================================
+ Coverage   95.64%   95.75%   +0.10%     
==========================================
  Files          30       30              
  Lines        8962     9356     +394     
  Branches     1328     1391      +63     
==========================================
+ Hits         8572     8959     +387     
- Misses        240      242       +2     
- Partials      150      155       +5     

☔ 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]

@jmwright @lorenzncode could you do a second pass and take a look at the docs? Summary of changes:

• Added history and set operators + example
• Slight rephrasing regarding free function API/removal of "Direct API"
• Added quickstart example rewritten using free func
• Mentioned fig.show

[lorenzncode]

This looks good. I've added only a few doc items.

[lorenzncode]

This renders only as show in the sphinx output so it isn't obvious that it's different than the previous section on vis.show. Suggest to mention Figure.

[jmwright]

@adam-urbanczyk Are the 2D operations ever going to get the history feature?