lldb-python
===========
An unofficial self contained distribution of the
[LLDB Python Bindings](https://lldb.llvm.org/python_api.html) to ease integration of the
LLDB debugger into external Python projects.
The Python API is normally distributed as part of the main LLDB package, but this
typically uses the System Python which can make it difficult to integrate into
standalone Python projects that typically will use a virtual environment
A small patch is made to the LLDB build to disable linking to the Python library,
and to enable linking to static libraries provided by [conan](https://github.com/conan-io/conan).
This makes it easier to distribute the LLDB Python bindings as a relocatable binary distribution.
Installation
------------
Download the appropriate wheel file for your platform and architecture and install
using PIP.
Example Usage
-------------
There are extensive examples in the [LLDB Documentation](https://lldb.llvm.org/use/python.html)
and the [LLVM Repository](https://github.com/llvm/llvm-project/tree/main/lldb/examples/python)
There is also a basic test suite in the `test` folder of this repository
Build
-----
Wheels are built using [scikit-build-core](https://github.com/scikit-build/scikit-build-core)
and [cibuildwheel](https://github.com/pypa/cibuildwheel). Some post-build customization
of the built wheel is done that could not be accomplished using these tools alone.
```
./download-llvm.sh
pipx run build -v --wheel
./python edit-wheel.py preprocess dist/<wheel_file>
```
Then to test the wheel
```
pip install -r requirements.txt
python -m venv .venv
source .venv/bin/activate
pip install dist/<wheel_file>
pytest -v test
```
Raw data
{
"_id": null,
"home_page": null,
"name": "lldb-python",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "lldb, debugger, llvm",
"author": null,
"author_email": "Andrew Marshall <planetmarshalluk@gmail.com>",
"download_url": null,
"platform": null,
"description": "lldb-python\n===========\n\n\n\nAn unofficial self contained distribution of the \n[LLDB Python Bindings](https://lldb.llvm.org/python_api.html) to ease integration of the\nLLDB debugger into external Python projects.\n\nThe Python API is normally distributed as part of the main LLDB package, but this\ntypically uses the System Python which can make it difficult to integrate into\nstandalone Python projects that typically will use a virtual environment\n\nA small patch is made to the LLDB build to disable linking to the Python library,\nand to enable linking to static libraries provided by [conan](https://github.com/conan-io/conan).\n\nThis makes it easier to distribute the LLDB Python bindings as a relocatable binary distribution.\n\nInstallation\n------------\n\nDownload the appropriate wheel file for your platform and architecture and install\nusing PIP.\n\n\nExample Usage\n-------------\n\nThere are extensive examples in the [LLDB Documentation](https://lldb.llvm.org/use/python.html)\nand the [LLVM Repository](https://github.com/llvm/llvm-project/tree/main/lldb/examples/python)\n\nThere is also a basic test suite in the `test` folder of this repository\n\n\nBuild\n-----\n\nWheels are built using [scikit-build-core](https://github.com/scikit-build/scikit-build-core)\nand [cibuildwheel](https://github.com/pypa/cibuildwheel). Some post-build customization\nof the built wheel is done that could not be accomplished using these tools alone.\n\n```\n./download-llvm.sh\npipx run build -v --wheel\n./python edit-wheel.py preprocess dist/<wheel_file>\n```\n\nThen to test the wheel\n```\npip install -r requirements.txt\npython -m venv .venv\nsource .venv/bin/activate\npip install dist/<wheel_file>\npytest -v test\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Unofficial self contained distribution of the LLDB Python Bindings",
"version": "19.0.0.dev1",
"project_urls": {
"Documentation": "https://lldb.llvm.org/python_api.html",
"Repository": "https://github.com/planetmarshall/lldb-python"
},
"split_keywords": [
"lldb",
" debugger",
" llvm"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "57f09010bd7485aec733032016f6bfbac86adce19d2c617518567879a3ee5c04",
"md5": "d91b230a1d86de7a92e8ef25db1154bf",
"sha256": "8fa0f0e0a14b331eae4b9a2ce6ef9bb3e9fd2efaabb8b5f6e69af5cbba344613"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp310-cp310-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "d91b230a1d86de7a92e8ef25db1154bf",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": null,
"size": 38530854,
"upload_time": "2024-04-24T10:35:30",
"upload_time_iso_8601": "2024-04-24T10:35:30.370497Z",
"url": "https://files.pythonhosted.org/packages/57/f0/9010bd7485aec733032016f6bfbac86adce19d2c617518567879a3ee5c04/lldb_python-19.0.0.dev1-cp310-cp310-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "85ee78d5af32f50bfb6535006eca3d4100dbfca1f6a204f9f1a3ea87057b588a",
"md5": "b12f4a2b39db8adb30a760861c48c846",
"sha256": "a37e031d9dcd34feb17e8278775ac30bffb3df4c805345253713c436b34239bd"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp310-cp310-manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "b12f4a2b39db8adb30a760861c48c846",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": null,
"size": 52215590,
"upload_time": "2024-04-24T10:35:33",
"upload_time_iso_8601": "2024-04-24T10:35:33.908087Z",
"url": "https://files.pythonhosted.org/packages/85/ee/78d5af32f50bfb6535006eca3d4100dbfca1f6a204f9f1a3ea87057b588a/lldb_python-19.0.0.dev1-cp310-cp310-manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a7d127a695afe875816e4447bd1a1e75deb78bf4231cc5ee82226222e57ee4cd",
"md5": "65aaa600da4a1a9cff850ecbae086444",
"sha256": "8a877c4c8f3da210ec322215302b7287c3cd8c677372215401861a91fbe80294"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp311-cp311-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "65aaa600da4a1a9cff850ecbae086444",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 38530855,
"upload_time": "2024-04-24T10:35:39",
"upload_time_iso_8601": "2024-04-24T10:35:39.837259Z",
"url": "https://files.pythonhosted.org/packages/a7/d1/27a695afe875816e4447bd1a1e75deb78bf4231cc5ee82226222e57ee4cd/lldb_python-19.0.0.dev1-cp311-cp311-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "47377547f167766ea1472448b3c7293e6585dc426c259ef7ab12131c97308484",
"md5": "430190dd45c989bb6fbedb3b2aeff025",
"sha256": "b70d08765309f379e438a24f23ebd2c29a06bfbc1c49d8dfdfb136a68a7d076b"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp311-cp311-manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "430190dd45c989bb6fbedb3b2aeff025",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": null,
"size": 52215515,
"upload_time": "2024-04-24T10:35:43",
"upload_time_iso_8601": "2024-04-24T10:35:43.351043Z",
"url": "https://files.pythonhosted.org/packages/47/37/7547f167766ea1472448b3c7293e6585dc426c259ef7ab12131c97308484/lldb_python-19.0.0.dev1-cp311-cp311-manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5cc2072fb4010fe1007b12759170469a1511aa5eeb0e8748531d7c7e6bb56e20",
"md5": "18a87710e5cb98612a603a579ad715f0",
"sha256": "d52209a57d4fed341fac63ca137a0c52fead1d5a48fd88e412643ea616b94b9b"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp312-cp312-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "18a87710e5cb98612a603a579ad715f0",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": null,
"size": 38533603,
"upload_time": "2024-04-24T10:35:47",
"upload_time_iso_8601": "2024-04-24T10:35:47.259486Z",
"url": "https://files.pythonhosted.org/packages/5c/c2/072fb4010fe1007b12759170469a1511aa5eeb0e8748531d7c7e6bb56e20/lldb_python-19.0.0.dev1-cp312-cp312-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "67c73b273318f362a850e0aaefa03996901307e0f520196874dba6164b7df65f",
"md5": "d6d7c6f623d0d414a6e0d80acf08c0d9",
"sha256": "5ee902f27544cd67eb12c135e65b9a11b4c1d59a0ce156fb1480e90a2f621ac4"
},
"downloads": -1,
"filename": "lldb_python-19.0.0.dev1-cp312-cp312-manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "d6d7c6f623d0d414a6e0d80acf08c0d9",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": null,
"size": 52213200,
"upload_time": "2024-04-24T10:35:51",
"upload_time_iso_8601": "2024-04-24T10:35:51.163899Z",
"url": "https://files.pythonhosted.org/packages/67/c7/3b273318f362a850e0aaefa03996901307e0f520196874dba6164b7df65f/lldb_python-19.0.0.dev1-cp312-cp312-manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 10:35:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "planetmarshall",
"github_project": "lldb-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pytest",
"specs": []
},
{
"name": "wheel",
"specs": []
},
{
"name": "delocate",
"specs": []
}
],
"lcname": "lldb-python"
}
JSON
