I totally agree with you. I use the python API in Blender to make some renderings of mechanical connections we are developing. As a python expert I am always a bit disoriented by how things should be handled. It would be really great if the python API could get some love in the future.