Introduce a versioning system.

[samcunliffe]

• Add a mechanism for CMake to read a git hash and construct a "version" (release).
• A tag of semver format on main (v1.2.3) is taken as an official version, otherwise it constructs a placeholder <branchname>_<tag or short format commit hash>.
  For example this commit has the "version" 201-versioning-in-cmake_b16cd31.
• (Useful for debugging) you can also overwrite this with CMake configuration...

  cmake .. -DTDMS_VERSION=Ive_just_introduced_a_bug
  make install
  tdms --version
  

With a bit of luck I've explained all of this in the developers documentation 😸

---

Resolves #201.

---

Cheers @giordano and @alessandrofelder for suggestions. @giordano : if you have time and any opinions, they'd be appreciated.

[samcunliffe]

It's a bit fiddly, but @willGraham01 : you can check out your local copy of main and merge this feature branch in (or cherry-pick the commit) to test.

Then git tag v100.99.98 (or whatever) and compile as normal, then check tdms --version.

[giordano]

Looks overall good, but I believe you should handle the case where there is no git repository, which if I understand correctly (but haven't tried) may result in some errors when running CMake

[willGraham01]

It's a bit fiddly, but @willGraham01 : you can check out your local copy of main and merge this feature branch in (or cherry-pick the commit) to test.

Then git tag v100.99.98 (or whatever) and compile as normal, then check tdms --version.

Seems all good: cmake happily picks up if I'm sat at a tag, and failing that provides the auto-generated version string you specified. -DTDMS_version overrides both as predicted, although I made a comment about how adamant it is about doing this between builds.

[codecov]

Codecov Report

Patch coverage: 17% and project coverage change: -24 ⚠️

Comparison is base (11e9e8b) 48% compared to head (0e8e798) 24%.

Additional details and impacted files

@@          Coverage Diff          @@
##           main   #203     +/-   ##
=====================================
- Coverage    48%    24%    -24%     
=====================================
  Files        63     62      -1     
  Lines      7808   3593   -4215     
=====================================
- Hits       3760    874   -2886     
+ Misses     4048   2719   -1329     

Impacted Files	Coverage Δ
tdms/src/argument_parser.cpp	69% <17%> (-5%)	⬇️

... and 54 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.