[Python] Improve python API

[satur9nine]

• Make the Python API similar to Rust and Swift for improved usability

[jtdavis777]

@satur9nine I've got this on my list! Will look it over sometime in the next few days 🤞

[jtdavis777]

@fliiiix this seems like a good improvement but as always I enjoy an extra opinion :D

[fliiiix]

I had a quick look can you also split up this change in multiple commits but on MR is fine? (You can just force push them on this MR)
I really like the usage ✨ One thing im either not seeing or is missing is the generation of these new functions in the pyi files.

[satur9nine]

I had a quick look can you also split up this change in multiple commits but on MR is fine? (You can just force push them on this MR) I really like the usage ✨ One thing im either not seeing or is missing is the generation of these new functions in the pyi files.

OK I split it up into multiple commits. Do you know how to confirm the .pyi files are correct? I usually run mypy for files that have inline type information. Maybe it is similar for pyi files.

[fliiiix]

I'm away for the next few days and i didn't manage to review this in detail but it seems ok enough to get merged and if there are problems we can deal with them later 🤷

Do you know how to confirm the .pyi files are correct?

Visual inspection of the pyi file and then there is a way if they are in the correct location mypy will also pick them up. I realized when i looked again at this change that the types are now in the py file and the pyi file if im not mistaken the types should end up only in the pyi files. (I would not remove them in this MR from the py file, and i need to look up the discussion again about that topic, but i think that should be a new MR)