Comment by dnu

Well, regarding yout API example, Python 3 introduces function annotations which let you specify the types of the parameters and of the return value. These types are not checked by the interpreter, leaving this job to the programmer (or framework).

http://www.python.org/dev/peps/pep-3107/