Add option to export binary STL

[lorenzncode]

• exporters.export add "ascii" (or "ASCII") options dict
• Shape.exportStl add "ascii" bool param
• fix corrupt docstrings/typos in shapes.py

[codecov]

Codecov Report

Merging #1106 (24d09b2) into master (f3b0b09) will decrease coverage by 2.42%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master    #1106      +/-   ##
==========================================
- Coverage   96.32%   93.90%   -2.43%     
==========================================
  Files          40       25      -15     
  Lines        9672     5328    -4344     
  Branches     1280      979     -301     
==========================================
- Hits         9317     5003    -4314     
+ Misses        210      193      -17     
+ Partials      145      132      -13     

Impacted Files	Coverage Δ
cadquery/occ_impl/exporters/__init__.py	91.81% <100.00%> (+0.22%)	⬆️
cadquery/occ_impl/shapes.py	92.55% <100.00%> (+0.01%)	⬆️
tests/test_exporters.py
tests/test_cadquery.py
tests/test_cqgi.py
tests/test_sketch.py
tests/naca.py
tests/test_importers.py
tests/test_workplanes.py
tests/test_utils.py
... and 7 more

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[lorenzncode]

Initially I thought I would clean up some of the docstrings since I was already touching shapes.py. I've removed the unrelated docstring cleanup changes to simplify this PR.

[adam-urbanczyk]

One minor suggestion to improve readability.

NB: I excluded tests from overage calculation to prevent false positive on the relative coverage delta.

[adam-urbanczyk]

@lorenzncode which default value did you have in mind?

[lorenzncode]

@adam-urbanczyk I had left the default as ascii mostly to maintain the current behavior and defer the decision. If you agree, let's change to binary in master. If a problem is raised prior to the next release, it can be reverted back to ascii.

[adam-urbanczyk]

I'm OK with changing to binary, let's see what others will say.

[jmwright]

Thanks @lorenzncode

[jmwright]

Feel free to merge after the change to binary as the default is made.

[lorenzncode]

The behavior of deprecated exportShape is unchanged. Binary STL format support is not added to exportShape. It continues to export ASCII format.

[jmwright]

@lorenzncode Is this ready to merge?

[lorenzncode]

@jmwright Yes, in summary:

Provide binary STL export format option
Binary is now the default for STL export

[lorenzncode]

also tests excluded from coverage calculation

[jmwright]

@lorenzncode Thanks!