edimetia3d / pybind11_weaver Goto Github PK

When a function uses T* (or T & ) as a parameter, this function will usually want to modify the object it pointed to, e.g.

ErrorCode GetValue(int * v);
ErrorCode GetValue(std::vector<int> * vec);

However:

1. Python itself does not support mutable int
2. pybind11 will create a copy when T is a std container type, any modification to the copied object will not return to python runtime.

These cases should be handled automatically, or at least a warning should be printed.

Hi,

This project is still under development, the PyPI package and GitHub repo are both just placeholders.

I do have a full plan to re-implement it in an open-source way, but it may take some time.

whatever, the idea in the readme should be enough, it should be able to help you create your own generator that fits your needs.

Doxygen style C++ document could be injected as docstring for exported entities.

• docstring for enum item
• docstring for function
• docstring for class
• docstring for method
• docstring for public data member

The user now could only guess usage from examples, some documents should be added

Pybind11 intrinsically supports the binding of overloaded functions.

Nonetheless, several predicaments may arise:

1. Pybind11 internally scrutinizes overloaded functions sequentially, employing the first viable function. Please refer to this Documentation for further details.
2. Certain discrepancies exist between Python and C++ types, such as Python's bool being a subclass of int.

Consequently, when generating an overload solely reliant on the builtin type, potential complications could emerge. For instance:

Should you bind void Foo(int, float) prior to void Foo(bool, float), the Python call mod.foo(False, 8) would align with void Foo(int, float), a situation incongruous with the C++ overloading mechanism.

In the face of such circumstances, it would be prudent to issue appropriate warnings when generating binding code.

There should be some quality assurance:

• Static code check, and fix errors, tools like MYPY and PyLint should be used
• CI should be enabled, to enable auto testing/building/releasing
• More tests should be added.