Skip to content

Conversation

peterbjohnson
Copy link
Contributor

This is a demo of auto generating docs from tests.

It's 'opt-it', where each test requires self.docs_from_test(locals()) at the end to export the test.

After running tests as follows:
python3 -m unittest evaluation_function.evaluation_test > test_to_docs.json

A json is created with the test data. That can easily be converted to a markdown table by the eval docs loader.

I don't know the best place to put the json - it's just a demo.

If you think this approach works, we can suggest it to Andreas to generalise in the boiler plate, and push to the other existing repos.

@peterbjohnson peterbjohnson requested a review from m-hurlow July 19, 2024 16:23
@m-hurlow m-hurlow force-pushed the auto-docs-for-tests branch from c3c9824 to 7c33929 Compare July 25, 2024 12:01
@m-hurlow m-hurlow force-pushed the auto-docs-for-tests branch from 7c33929 to 169c51c Compare July 25, 2024 12:06
@m-hurlow m-hurlow merged commit 7d2b7b5 into main Jul 25, 2024
8 checks passed
@m-hurlow m-hurlow deleted the auto-docs-for-tests branch July 25, 2024 12:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants