8ba573712c
This extends the existing XML-based template generator to allow an
additional kind of Python-based input.
The Python code is read as source code to an AST to a typed model
equivalent to the existing XML model, and processed by the existing
code templates into compatible code.
This provides a few benefits, namely readability is much increased,
but more importantly, it allows associating the APIs with Python's new
typing information, which will allow to provide accurate type hinting
without additional downstream processing in the future.
Right now this is just a proof-of-concept but if the approach is
well received, then a more complete implementation can be done with
further conversion of existing binding files.
Here is an example of how it looks, though I still think the metadata
is too verbose and can be made to look nicer with some further work.
```python
from ..Base.Metadata import metadata
from ..Base.Persistence import PersistencePy
from typing import Any, Optional, List
@metadata(
Father="PersistencePy",
Name="DocumentPy",
Twin="Document",
TwinPointer="Document",
Include="Gui/Document.h",
Namespace="Gui",
FatherInclude="Base/PersistencePy.h",
FatherNamespace="Base"
)
class DocumentPy(PersistencePy):
"""
This is a Document class.
Author: Werner Mayer (wmayer@users.sourceforge.net)
Licence: LGPL
"""
def __init__(self, *args: Any, **kwargs: Any) -> None:
"""
Constructor for DocumentPy.
"""
super(DocumentPy, self).__init__(*args, **kwargs)
pass
def show(self, objName: str) -> None:
"""
show(objName) -> None
Show an object.
Parameters:
objName (str): Name of the `Gui.ViewProvider` to show.
"""
pass
```
30 lines
582 B
Python
30 lines
582 B
Python
"""
|
|
This file keeps auxiliary metadata to be used by the Python API stubs.
|
|
"""
|
|
|
|
def export(**kwargs):
|
|
"""
|
|
A decorator to attach metadata to a class.
|
|
"""
|
|
...
|
|
|
|
def constmethod(): ...
|
|
def no_args(): ...
|
|
def forward_declarations(source_code):
|
|
"""
|
|
A decorator to attach forward declarations to a class.
|
|
"""
|
|
...
|
|
|
|
def class_declarations(source_code):
|
|
"""
|
|
A decorator to attach forward declarations to a class.
|
|
"""
|
|
...
|
|
|
|
def sequence_protocol(**kwargs):
|
|
"""
|
|
A decorator to attach sequence protocol metadata to a class.
|
|
"""
|
|
...
|