Use CppHeaderParser when parsing header files
Registered by
Johan Hake
We use our own homebrewed C++ parser implemented in Python to extract signatures and documentations. Instead we should look into existing C++ header parsers, like CppHeaderParser. It is not complete, as it has problems with templates and especially shared_ptr<Foo> types. But it is open source and everything is contained in one file. So it should be possible to patch and/or fix our particular need.
Blueprint information
- Status:
- Started
- Approver:
- None
- Priority:
- Medium
- Drafter:
- None
- Direction:
- Approved
- Assignee:
- Johan Hake
- Definition:
- Approved
- Series goal:
- None
- Implementation:
- Good progress
- Milestone target:
- trunk
- Started by
- Johan Hake
- Completed by
Related branches
Related bugs
Sprints
Whiteboard
We now use CppHeaderParser for generating SWIG interface files, and it is used to parse JIT compiled code to only include the necessary dolfin headers.
We should use the information gained from CppHeaderParser to improve the documentation collection from the dolfin header files, instead of using our own home brewed parser.
(?)