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]

update:
After some reading, possibly what is really wanted here can be done with a simple glob recursive=True ?
See https://stackoverflow.com/a/57644936/2615050

Best I think would be to first get tests working for complicated cases, as is, then show that the simple glob solution works!

[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 (in include/target specs) -- see above
  • ideally, do the glob thing properly (e.g. support '**' -- but don't know of a 'standard' implementation for that)
• support proper globs in exclude patterns ?
• lack of global options config
  • possibly should exist in pyproject.toml
  • make it look like a real tool
  • this would seem especially useful for excludes

[pp-mo]

"numeric" here should probably say "integer".
Floats etc not needed for anything in these functions

[pp-mo]

Perhaps worth making the point here that we are 'interpreting' the input to avoid using "exec", on general principles (!)