-
Notifications
You must be signed in to change notification settings - Fork 5
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
ENH: initial attempts at code summary layer, sphinx domain #12
Conversation
apischema serialization/deserialization will require more work; leaving as a TODO for now
Despite the above, I'm going to redo this entirely working with |
While documentation seems to indicate otherwise, but in the end the goal is "parse what Beckhoff parses"
There's still a lot left to do here, but the structure is OK enough as-is to merge for now. There will be follow-ups down the line at some point. One day entire PLC projects' API will be easily documentable in sphinx, but today is not that day... |
Changes in no particular order
Meta
instances are transferred over fromlark
toblark
; add explicit dataclass attributes for themblark parse
CLIblark.transform
(never 100% happy of course)Documentation?
So far, just function blocks + methods:
Generated by way of pointing to the project in Sphinx
conf.py
:sphinx
ordocutils
a required runtime dependency to blarkThings which I don't have a clue how to approach just yet: