diff options
Diffstat (limited to 'docs/src/userguide/source_files_and_compilation.rst')
| -rw-r--r-- | docs/src/userguide/source_files_and_compilation.rst | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/docs/src/userguide/source_files_and_compilation.rst b/docs/src/userguide/source_files_and_compilation.rst index edf51213e..d1c8f696c 100644 --- a/docs/src/userguide/source_files_and_compilation.rst +++ b/docs/src/userguide/source_files_and_compilation.rst @@ -12,17 +12,21 @@ file named :file:`primes.pyx`. Cython code, unlike Python, must be compiled. This happens in two stages: - * A ``.pyx`` file is compiled by Cython to a ``.c`` file. + * A ``.pyx`` (or ``.py``) file is compiled by Cython to a ``.c`` file. * The ``.c`` file is compiled by a C compiler to a ``.so`` file (or a ``.pyd`` file on Windows) -Once you have written your ``.pyx`` file, there are a couple of ways of turning it -into an extension module. +Once you have written your ``.pyx``/``.py`` file, there are a couple of ways +how to turn it into an extension module. The following sub-sections describe several ways to build your extension modules, and how to pass directives to the Cython compiler. +There are also a number of tools that process ``.pyx`` files apart from Cython, e.g. + +- Linting: https://pypi.org/project/cython-lint/ + .. _compiling_command_line: @@ -946,7 +950,8 @@ Cython code. Here is the list of currently supported directives: Uses function argument annotations to determine the type of variables. Default is True, but can be disabled. Since Python does not enforce types given in annotations, setting to False gives greater compatibility with Python code. - Must be set globally. + From Cython 3.0, ``annotation_typing`` can be set on a per-function or + per-class basis. ``emit_code_comments`` (True / False) Copy the original source code line by line into C code comments in the generated |