Add script for add code/api snippets into docs.

[richard-to]

This script will go through the markdown documentation and inserts code examples and api docstrings into the docs.

This code needs to import mesop, so your terminal needs to have mesop imported via pip.
It does not seem to work when .cli.venv is loaded.

python transform_markdown.py
python transform_markdown.py --cache_files_list
python transform_markdown.py --use_cached_files_list

You can use the cached_files list to create a block list to ignore specific files that are not relevant.

This script is not integrated with the existing workflow yet.

---

It fails to find:

• mesop.components.select.select.SelectOpenedChangeEvent
• mesop.components.progress_bar.progress_bar.ProgressBarAnimationEndEvent

These two classes do not seem to be imported in the init.py file in Mesop, so I can look the inspect the classes. Not sure if that's intentional or not.

[wwwillchen]

This script will go through the markdown documentation and inserts code examples and api docstrings into the docs.

This code needs to import mesop, so your terminal needs to have mesop imported via pip. It does not seem to work when .cli.venv is loaded.

python transform_markdown.py
python transform_markdown.py --cache_files_list
python transform_markdown.py --use_cached_files_list

You can use the cached_files list to create a block list to ignore specific files that are not relevant.

This script is not integrated with the existing workflow yet.

It fails to find:

• mesop.components.select.select.SelectOpenedChangeEvent
• mesop.components.progress_bar.progress_bar.ProgressBarAnimationEndEvent

These two classes do not seem to be imported in the init.py file in Mesop, so I can look the inspect the classes. Not sure if that's intentional or not.

We should export those two classes since they're part of our public API. I think it was just an oversight

[wwwillchen]

Overall I like this approach much better than my HTML approach - it's a lot cleaner and easier to extend. nice work!

[richard-to]

Ok.

• Exported the progressbar end event and the select opened change event to the mesop init object.
• Also added a check for enabling both flags at the same time (I had left it as is since I think it would be a noop in that situation. Would just end up overwriting the existing file with the same cached elements, but I think easy enough to add a check)