Cython: Difference between revisions

Revision as of 20:26, 7 October 2023

Latest revision as of 03:20, 2 August 2025

(37 intermediate revisions by 25 users not shown)

Line 5:

| name = Cython

| logo = Cython logo.svg

| developer = Robert Bradshaw, Stefan Behnel, Joeet Kohleral.

| released = {{Start date and age|df=yes|2007|07|28}}<ref>{{cite web |url=httphttps://www.behnel.de/cythonEP2008/cython-ep2008.html |type=28 July 2007: official Cython launch |title=The Cython Compiler for C-Extensions in Python |last=Behnel |first=Stefan |work=EuroPython |date=2008 |publisher=Vilnius/Lietuva}}</ref>

| license = [[Apache License 2.0]]

| programming language = [[Python (programming language)|Python]]

| influenced_by = [[C (programming language)|C]], [[Python (programming language)|Python]]

| operating_system = [[Windows]], [[macOS]], [[Linux]]

| file_ext = .pyx, .pxd, .pxi <ref>{{Cite web |title=Language Basics — Cython 3.0.0a9 documentation |url=https://cython.readthedocs.io/en/latest/src/userguide/language_basics.html#cython-file-types |access-date=9 September 2021 |website=cython.readthedocs.io}}</ref>

| website = {{official URL}}

}}

'''Cython''' ({{IPAc-en|ˈ|s|aɪ|θ|ɒ|n}}) is a [[subsetsuperset]] of the programming language [[Python (programming language)|Python]], which allows developers to write Python code (with optional, C-inspired syntax extensions) that yields performance comparable to that of [[C (programming language)|C]].<ref>{{cite web |url=httphttps://docs.cython.org/src/quickstart/overview.html |title=Cython - an overview — Cython 0.19.1 documentation |publisher=Docs.cython.org |access-date=21 July 2013}}</ref><ref>{{cite book |last1=Smith |first1=Kurt |title=Cython: A Guide for Python Programmers |date=2015 |publisher=[[O'Reilly Media]] |isbn=978-1-4919-0155-7 |url=httphttps://shop.oreilly.com/product/0636920033431.do}}</ref>

Cython is a [[compiled language]] that is typically used to generate [[CPython]] extension modules. Annotated Python-like code is compiled to C (also usable from e.g. [[C++]]) and then automatically [[wrapper library|wrapped in interface code]], producing extension modules that can be loaded and used by regular Python code using the import statement, but with significantly less computational overhead at [[Run time (program lifecycle phase)|run time]]. Cython also facilitates wrapping independent C or C++ code into pythonPython-importable modules.

Cython is written in Python and C and works on [[Microsoft Windows|Windows]], [[macOS]], and [[Linux]], producing C source files compatible with CPython 2.6, 2.7, and 3.3 and later versions. The Cython source code that Cython compiles (to C) can use both Python 2 and Python 3 syntax, defaulting to Python 2 syntax in Cython 0.x (and Python 3 syntax in Cython 3.x, which is currently alpha software). The default can be overridden (e.g. in source code comment) to Python 3 (or 2) syntax. Since Python 3 syntax has changed in recent versions, Cython may not be up to date with the latest additionadditions. Cython has "native support for most of the C++ language" and "compiles almost all existing Python code".<ref>{{Cite web |title=FAQ · cython/cython Wiki |url=https://github.com/cython/cython |access-date=11 January 2023 |website=GitHub |language=en}}</ref>

Cython 3.0.0 was released on 17 July 2023.<ref>{{Cite web |title=Cython Changelog |url=https://cython.readthedocs.io/en/latest/src/changes.html |access-date=21 July 2023 |website=cython.org |language=en}}</ref>

Line 30:

Cython has a [[foreign function interface]] for invoking [[C (programming language)|C]]/[[C++]] [[subroutine|routines]] and the ability to declare the [[static type]] of subroutine parameters and results, local variables, and class attributes.

A Cython program that implements the same algorithm as a corresponding Python program may consume fewer computing resources such as core memory and processing cycles due to differences between the CPython and Cython execution models. A basic Python program is loaded and executed by the CPython [[virtual machine]], so both the runtime and the program itself consume computing resources. A Cython program is compiled to C code, which is further compiled to machine code, so the virtual machine is used only briefly when the program is loaded.<ref>{{cite web |last=Oliphant |first=Travis |date=20 June 2011 |url=httphttps://technicaldiscovery.blogspot.com/2011/06/speeding-up-python-numpy-cython-and.html |title=Technical Discovery: Speeding up Python (NumPy, Cython, and Weave) |publisher=Technicaldiscovery.blogspot.com |access-date=21 July 2013}}</ref><ref>{{cite journal |last1=Behnel |first1=Stefan |last2=Bradshaw |first2=Robert |last3=Citro |first3=Craig |last4=Dalcin |first4=Lisandro |last5=Seljebotn |first5=Dag Sverre |last6=Smith |first6=Kurt |year=2011 |title=Cython: The Best of Both Worlds |journal=Computing in Science and Engineering |volume=13 |issue=2 |pages=31–39 |doi=10.1109/MCSE.2010.118 |bibcode=2011CSE....13b..31B |s2cid=14292107 |url=httphttps://research.google.com/pubs/pub36727.html|hdl=11336/13103 |hdl-access=free }}

</ref><ref name="scipy09">{{cite journalbook |last=Seljebot |first=Dag Sverre |year=2009 |title=Fast numerical computations with Cython |journal=Proceedings of the 8th Python in Science Conference (SciPy|chapter=Fast numerical computations with Cython |year=2009) |pages=15–22 |doi=10.25080/GTCA8577 |chapter-url=http://conference.scipy.org/proceedings/SciPy2009/paper_2|doi-access=free }}</ref><ref>{{cite journal |last1=Wilbers |first1=I. |last2=Langtangen |first2=H. P. |last3=Ødegård |first3=Å. |year=2009 |title=Using Cython to Speed up Numerical Python Programs |journal=Proceedings of MekIT'09 | pages=495–512 |url=http://simula.no/research/sc/publications/Simula.SC.578/simula_pdf_file |access-date=14 June 2011 |format=PDF |editor1-first=B. |editor1-last=Skallerud |editor2-first=H. I. |editor2-last=Andersson |archive-date=4 January 2017 |archive-url=https://web.archive.org/web/20170104170007/http://simula.no/research/sc/publications/Simula.SC.578/simula_pdf_file |url-status=dead }}</ref>

Cython employs:

Line 37:

* [[Type inference]] (optional)

* Low overhead in control structures

* Low function call overhead<ref>{{cite web |url=http://telecom.inescporto.pt/~gjc/pybindgen-benchmarks/ |title=wrapper benchmarks for several Python wrapper generators (except Cython) |access-date=28 May 2010 |archive-url=https://web.archive.org/web/20150404154630/http://telecom.inescporto.pt/~gjc/pybindgen-benchmarks/ |archive-date=4 April 2015 |url-status=dead}}</ref><ref>{{cite web |url=httphttps://behnel.de/cycppbench/ |title=wrapper benchmarks for Cython, Boost.Python and PyBindGen |access-date=28 May 2010 |archive-url=https://web.archive.org/web/20160303224104/http://www.behnel.de/cycppbench/ |archive-date=3 March 2016 |url-status=dead}}</ref>

Performance depends both on what C code is generated by Cython and how that code is compiled by the C compiler.<ref>{{cite web |title=Cython: C-Extensions for Python |url=http://cython.org/index.html |accessdate=22 November 2015}}</ref>

== History ==

Cython is a derivative of the [[Pyrex (programming language)|Pyrex language]], andbut it supports more features and optimizations than Pyrex.<ref>{{cite web |url=https://github.com/cython/cython/wiki/DifferencesFromPyrex |title=Differences between Cython and Pyrex|website=[[GitHub]] }}</ref><ref>{{cite web |last=Ewing |first=Greg |url=httphttps://mail.python.org/pipermail/python-dev/2011-March/109642.html |title=Re: VM and Language summit info for those not at Pycon (and those that are!)|type=Message to the electronic mailing-list <code>python-dev</code> |date=21 March 2011 |access-date=5 May 2011}}</ref> Cython was [[Fork (software development)|forked]] from Pyrex in 2007 by developers of the [[SageMath|Sage]] computer algebra package, because they were unhappy with Pyrex's limitations and could not get patches accepted by Pyrex's maintainer Greg Ewing, who envisioned a much smaller scope for his tool than the Sage developers had in mind. They then forked Pyrex as SageX. When they found people were downloading Sage just to get SageX, and developers of other packages (including Stefan Behnel, who maintains the [[XML]] library {{proper name|LXML}}) were also maintaining forks of Pyrex, SageX was split off the Sage project and merged with <code>{{proper name|cython-lxml}}</code> to become Cython.<ref>{{cite web |author=Says Sage and Cython developer Robert Bradshaw at the Sage Days 29 conference |url=https://www.youtube.com/watch?v=osjSS2Rrvm0 |archive-url=https://ghostarchive.org/varchive/youtube/20211221/osjSS2Rrvm0 |archive-date=21 December 2021 |url-status=live |title=Cython: Past, Present and Future |via=[[YouTube]] |date=22 March 2011 |access-date=5 May 2011}}{{cbignore}}</ref>

Cython files have a <code>.pyx</code> extension. At its most basic, Cython code looks exactly like Python code. However, whereas standard Python is [[dynamic typing|dynamically typed]], in Cython, types can optionally be provided, allowing for improved performance, allowing loops to be converted into C loops where possible. For example:

Line 83:

[[File:Cython CPython Ext Module Workflow.png|thumb|Hello World in Cython]]

A sample [["Hello, World!" program|hello world]] program for Cython is more complex than in most languages because it interfaces with the Python C API and <code>setuptools</code> or other [[PEP517]]-compliant extension building facilities.{{technical inline|date=May 2024}} At least three files are required for a basic project:

* A <code>setup.py</code> file to invoke the <code>setuptools</code> build process that generates the extension module

Line 154:

== Uses ==

Cython is particularly popular among scientific users of Python,<ref name="scipy09" /><ref>{{cite web |title=inSCIght: The Scientific Computing Podcast |url=http://inscight.org/2011/03/31/episode_/ |type=Episode 6 |access-date=29 May 2011 |archive-url=https://web.archive.org/web/20141010032300/http://inscight.org/2011/03/31/episode_/ |archive-date=10 October 2014 |url-status=dead}}</ref><ref>{{cite journal |last1=Millman |first1=Jarrod |last2=Aivazis |first2=Michael |year=2011 |title=Python for Scientists and Engineers |journal=[[Computing in Science and Engineering]] |volume=13 |issue=2 |pages=9–12 |doi=10.1109/MCSE.2011.36 |bibcode=2011CSE....13b...9M |url=https://escholarship.org/uc/item/93s2v2s7}}</ref> where it has "the perfect audience" according to Python creator [[Guido van Rossum]].<ref>{{cite web |author=Guido Van Rossum |url=httphttps://mail.python.org/pipermail/python-dev/2011-March/109634.html |title=Re: VM and Language summit info for those not at Pycon (and those that are!) |type=Message to the electronic mailing-list <code>python-dev</code>|date=21 March 2011 |access-date=5 May 2011}}</ref> Of particular note:

* The [[free software]] [[SageMath]] computer algebra system depends on Cython, both for performance and to interface with other libraries.<ref>{{cite book |last1=Erocal |first1=Burcin |last2=Stein |first2=William |title=Mathematical Software – ICMS 2010 |chapter=The Sage Project: Unifying Free Mathematical Software to Create a Viable Alternative to Magma, Maple, Mathematica and MATLAB |year=2010 |journal=Mathematical Software' ICMS 2010 |volume=6327 |pages=12–27 |publisher=Springer Berlin / Heidelberg |doi=10.1007/978-3-642-15582-6_4 |url=http://wstein.org/papers/icms/icms_2010.pdf |series=Lecture Notes in Computer Science |isbn=978-3-642-15581-9 |citeseerx=10.1.1.172.624}}</ref>

* Significant parts of the scientific computing libraries [[SciPy]], [[Pandas (software)|pandas]] and [[scikit-learn]] are written in Cython.<ref>{{cite web |url=http://docs.scipy.org/doc/scipy/reference/release.0.7.2.html |title=SciPy 0.7.2 release notes |access-date=29 May 2011 |archive-date=4 March 2016 |archive-url=https://web.archive.org/web/20160304052117/http://docs.scipy.org/doc/scipy/reference/release.0.7.2.html |url-status=dead}}</ref><ref name="jmlr">{{cite journal |last1=Pedregosa |first1=Fabian |last2=Varoquaux |first2=Gaël |last3=Gramfort |first3=Alexandre |last4=Michel |first4=Vincent |last5=Thirion |first5=Bertrand |last6=Grisel |first6=Olivier |last7=Blondel |first7=Mathieu |last8=Prettenhofer |first8=Peter |last9=Weiss |first9=Ron |last10=Dubourg |first10=Vincent |last11=Vanderplas |first11=Jake |last12=Passos |first12=Alexandre |last13=Cournapeau |first13=David |title=Scikit-learn: Machine Learning in Python |journal=[[Journal of Machine Learning Research]] |year=2011 |volume=12 |pages=2825–2830 |arxiv=1201.0490|bibcode=2011JMLR...12.2825P }}</ref>

* Some high-traffic websites such as [[Quora]] use Cython.{{better source needed|date=October 2018}}<ref>{{cite web |url=https://www.quora.com/Is-Quora-still-running-on-PyPy/answer/Alex-Yakunin |title=Is Quora still running on PyPy?}}</ref>

Cython's ___domain is not limited to just numerical computing. For example, the {{proper name|lxml}} XML toolkit is written mostly in Cython, and like its predecessor Pyrex, Cython is used to provide Python bindings for many C and C++ libraries such as the messaging library [[ZeroMQ]].<ref>{{cite web |url=httphttps://www.zeromq.org/bindings:python |title=ØMQ: Python binding}}</ref> Cython can also be used to develop [[parallel program]]s for [[multi-core processor]] machines; this feature makes use of the [[OpenMP]] library.

== See also ==

* [[PyPy]]

* [[Numba]]

* [[pybind]]

== References ==