Talk:Python Guidelines

Transparency
In how far should the Python interface reflect the internal structure of the core?

Possibilities:
 * Not at all
 * The interface and the core use completely different interfaces
 * + Python interface could be made truly pythonic.
 * + C interface could be made truly C-ish.
 * + Simplifies refactoring of the core code.


 * Fully
 * The interface and the code use an interface that is as similar as possible.
 * + Simplifies transition from Python-code to C-code.
 * + Simplifies debugging.


 * Python interface reflects how we want the C-code to be in the future
 * The Python interface should look like we would want the C-code interface to look like.
 * If it is conceivable that something is used more than once, put it into a class, even if the core does not model it like this (yet)

Conclusion
At the moment, we keep the Python interface completely separate from the C interface.