Spaces:
Running
Running
File size: 4,873 Bytes
3bb804c |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 |
Metadata-Version: 2.1
Name: llvmlite
Version: 0.46.0
Summary: lightweight wrapper around basic LLVM functionality
Home-page: http://llvmlite.readthedocs.io
Project-URL: Source, https://github.com/numba/llvmlite
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Compilers
Requires-Python: >=3.10
License-File: LICENSE
License-File: LICENSE.thirdparty
========
llvmlite
========
.. image:: https://dev.azure.com/numba/numba/_apis/build/status/numba.llvmlite?branchName=main
:target: https://dev.azure.com/numba/numba/_build/latest?definitionId=2&branchName=main
:alt: Azure Pipelines
.. image:: https://coveralls.io/repos/github/numba/llvmlite/badge.svg
:target: https://coveralls.io/github/numba/llvmlite
:alt: Coveralls.io
.. image:: https://readthedocs.org/projects/llvmlite/badge/
:target: https://llvmlite.readthedocs.io
:alt: Readthedocs.io
A Lightweight LLVM Python Binding for Writing JIT Compilers
-----------------------------------------------------------
.. _llvmpy: https://github.com/llvmpy/llvmpy
llvmlite is a project originally tailored for Numba_'s needs, using the
following approach:
* A small C wrapper around the parts of the LLVM C++ API we need that are
not already exposed by the LLVM C API.
* A ctypes Python wrapper around the C API.
* A pure Python implementation of the subset of the LLVM IR builder that we
need for Numba.
Why llvmlite
============
The old llvmpy_ binding exposes a lot of LLVM APIs but the mapping of
C++-style memory management to Python is error prone. Numba_ and many JIT
compilers do not need a full LLVM API. Only the IR builder, optimizer,
and JIT compiler APIs are necessary.
Key Benefits
============
* The IR builder is pure Python code and decoupled from LLVM's
frequently-changing C++ APIs.
* Materializing a LLVM module calls LLVM's IR parser which provides
better error messages than step-by-step IR building through the C++
API (no more segfaults or process aborts).
* Most of llvmlite uses the LLVM C API which is small but very stable
(low maintenance when changing LLVM version).
* The binding is not a Python C-extension, but a plain DLL accessed using
ctypes (no need to wrestle with Python's compiler requirements and C++ 11
compatibility).
* The Python binding layer has sane memory management.
* llvmlite is faster than llvmpy thanks to a much simpler architecture
(the Numba_ test suite is twice faster than it was).
Compatibility
=============
llvmlite has been tested with Python 3.10 -- 3.13 and is likely to work with
greater versions.
As of version 0.45.0, llvmlite requires LLVM 20.x.x on all architectures
Historical compatibility table:
================= ========================
llvmlite versions compatible LLVM versions
================= ========================
0.45.0 - ...... 20.x.x
0.44.0 15.x.x and 16.x.x
0.41.0 - 0.43.0 14.x.x
0.40.0 - 0.40.1 11.x.x and 14.x.x (12.x.x and 13.x.x untested but may work)
0.37.0 - 0.39.1 11.x.x
0.34.0 - 0.36.0 10.0.x (9.0.x for ``aarch64`` only)
0.33.0 9.0.x
0.29.0 - 0.32.0 7.0.x, 7.1.x, 8.0.x
0.27.0 - 0.28.0 7.0.x
0.23.0 - 0.26.0 6.0.x
0.21.0 - 0.22.0 5.0.x
0.17.0 - 0.20.0 4.0.x
0.16.0 - 0.17.0 3.9.x
0.13.0 - 0.15.0 3.8.x
0.9.0 - 0.12.1 3.7.x
0.6.0 - 0.8.0 3.6.x
0.1.0 - 0.5.1 3.5.x
================= ========================
Documentation
=============
You'll find the documentation at http://llvmlite.pydata.org
Pre-built binaries
==================
We recommend you use the binaries provided by the Numba_ team for
the Conda_ package manager. You can find them in Numba's `anaconda.org
channel <https://anaconda.org/numba>`_. For example::
$ conda install --channel=numba llvmlite
(or, simply, the official llvmlite package provided in the Anaconda_
distribution)
.. _Numba: http://numba.pydata.org/
.. _Conda: http://conda.pydata.org/
.. _Anaconda: http://docs.continuum.io/anaconda/index.html
Other build methods
===================
If you don't want to use our pre-built packages, you can compile
and install llvmlite yourself. The documentation will teach you how:
http://llvmlite.pydata.org/en/latest/install/index.html
|