Pytestless doctests

[pp-mo]

Pursuing an idea that we might create a better test-runner than pytest, for ourselves

[pp-mo]

I think the "private" concept does not apply to documentation files : Explain this?

[pp-mo]

TODO: document the intention.

In order to resolve a globbed path like dir/subdir/**/*AB_test.extension, we need to split the root path of the search from the wildcarded parts, to do Path("dir/subdir").glob("**/*AB_test.extension")
So here we are finding which path segments contain glob characters, and splitting at the first of those.
This probably is still a bit crude

• e.g. can't handle escaped glob chars
• e.g. maybe doesn't work (needs testing) if the globbed part or unglobbed parts are empty

[pp-mo]

What is still missing?

Apart from the above, this is still only "trial code".
Intention is (for now) to not put this in a distributable package, but into a SciTools template

What's really driving that is a desire to use this for Iris too.

Probably, it would still be good to have a distinct repo, for central control + to host testing,
- but that would also follow the template
(or perhaps, ~equivalently, the template follows the primary repo)

What's I can already see is still missing with the function itself ..

• now complicated enough that it needs some tests
• possible problems with less usual glob forms -- see above
• lack of global options config -- possibly should exist in pyproject.toml
  • this would seem especially useful for excludes