Limitations

Unsupported Python Features

One of our goals is to make Cython as compatible as possible with standard Python. This page lists the things that work in Python but not in Cython.

Nested def statements

Function definitions (whether using def or cdef) cannot be nested within other function definitions.

def make_func():
    def f(x):
        return x*x
    return f

(work in progress) This relies on functional closures

Generators

Using the yield keywords. (work in progress) This relies on functional closures

Other Current Limitations

• The globals() and locals() functions cannot be used.
• Class and function definitions cannot be placed inside control structures.

Semantic differences between Python and Cython

Behaviour of class scopes

In Python, referring to a method of a class inside the class definition, i.e. while the class is being defined, yields a plain function object, but in Cython it yields an unbound method [1]. A consequence of this is that the usual idiom for using the classmethod() and staticmethod() functions, e.g.:

class Spam:

    def method(cls):
        ...

    method = classmethod(method)

will not work in Cython. This can be worked around by defining the function outside the class, and then assigning the result of classmethod or staticmethod inside the class, i.e.:

def Spam_method(cls):
    ...

class Spam:

    method = classmethod(Spam_method)

Footnotes

[1]

The reason for the different behaviour of class scopes is that Cython-defined Python functions are PyCFunction objects, not PyFunction objects, and are not recognised by the machinery that creates a bound or unbound method when a function is extracted from a class. To get around this, Cython wraps each method in an unbound method object itself before storing it in the class’s dictionary.