WIP: developing a true C++ API...

[attipaci]

Brand new C++ API. Getting closer by the day, but much remains to be done still:

• (~98% complete) API design.
• (~95% complete) Document all the classes and methods properly.
• (~85% complete) Add regression testing (check against the C API).
• (~50% complete) Add error handling (constructors, builders, and optionals only)
• (~70% complete) Integrate the C++ API into the build (as an option).
• (~50% complete) Add C++ examples.
• Update CI to include C++ checks.
• Write a README for the C++ API specifically.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.93%. Comparing base (cb543fc) to head (2002f15).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #256   +/-   ##
=======================================
  Coverage   99.93%   99.93%           
=======================================
  Files          24       24           
  Lines        4743     4784   +41     
  Branches      927      937   +10     
=======================================
+ Hits         4740     4781   +41     
  Partials        3        3           

Flag	Coverage Δ
unittests	99.93% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/calendar.c	100.00% <100.00%> (ø)
src/cio.c	100.00% <ø> (ø)
src/earth.c	100.00% <100.00%> (ø)
src/ephemeris.c	100.00% <ø> (ø)
src/frames.c	100.00% <100.00%> (ø)
src/observer.c	100.00% <100.00%> (ø)
src/orbital.c	100.00% <100.00%> (ø)
src/parse.c	99.47% <100.00%> (ø)
src/place.c	100.00% <100.00%> (ø)
src/refract.c	100.00% <100.00%> (ø)
... and 5 more

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update cb543fc...2002f15. Read the comment docs.

🚀 New features to boost your workflow:

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