## wheel2deb
[](https://codecov.io/gh/upciti/wheel2deb)
[](https://lbesson.mit-license.org/)
[](https://github.com/ambv/black)
[](https://pypi.python.org/pypi/wheel2deb/)
[](https://pepy.tech/project/wheel2deb)
[](https://docs.wakemeops.com/packages/wheel2deb)
`wheel2deb` is a python wheel to debian package converter. It takes a list of wheels as input and produces a list of debian binary CPython packages (those prefixed with python- or python3-).
[](https://asciinema.org/a/249779)
## Quick Example
The following shows how to convert numpy and pytest, along with their dependencies into a list of debian packages:
```sh
# Download (and build if needed) pytest, numpy and their requirements
pip3 wheel pytest numpy
# Convert all wheels to debian source packages, build them with dpkg-buildpackage
wheel2deb
ls -l output/*.deb
# Install generated packages
dpkg -i output/*.deb
# Run pytest on numpy
python3 -c "import numpy; numpy.test()"
```
## Project scope
- Python 2.7 and 3
- CPython only for now
- support for non pure python wheels
- support debian architectures all, armhf, amd64, i686
- tested on jessie, stretch, buster so far, ubuntu should also work
## Requirements
`wheel2deb` uses `apt-cache` to search for debian packages, `dpkg-shlibdeps` to calculate shared library dependencies and `apt-file` to search packages providing shared library dependencies. `wheel2deb build` requires the usual tools to build a debian package:
```sh
apt update
apt install apt-file dpkg-dev fakeroot build-essential devscripts debhelper
apt-file update
```
If you want to cross build packages for ARM, you will also need to install `binutils-arm-linux-gnueabihf`.
Converting pure python wheels, don't actually requires apt-file and dpkg-dev.
Keep in mind that you should only convert wheels that have been built for your distribution and architecture. wheel2deb will not warn you about ABI compatibility issues.
## Installation
### From the release page
`wheel2deb` is packaged as a single binary application that you can download from the release page. Using those releases will spare you the hassle of building Python 3.11 on old Debian based distributions.
### With [wakemeops](https://docs.wakemeops.com)
```shell
sudo apt-get install wheel2deb
```
### With docker
We currently do not build docker images with `wheel2deb` pre-installed. You can use wakemeops docker images to quickly play with `wheel2deb` on a different distribution than your host.
```shell
docker run -ti wakemeops/debian:buster
```
And in the container run:
```
install_packages wheel2deb
```
### With [pipx](https://github.com/pipxproject/pipx)
`wheel2deb` is available from [pypi](https://pypi.org/project/wheel2deb/):
```shell
pipx install wheel2deb
```
## Features
- guess debian package names from wheel names and search for them in the cache
- search packages providing shared library dependencies for wheels with native code
- handle entrypoints and scripts (those will be installed in /usr/bin with a proper shebang)
- try to locate licence files and to generate a debian/copyright file
## Usage
Use `wheel2deb convert --help` and `wheel2deb build --help` to check all supported options.
## Development
You will need [poetry](https://python-poetry.org/), and probably [pyenv](https://github.com/pyenv/pyenv) if you don't have python 3.11 on your host.
```shell
poetry install
```
To run wheel2deb test suite run:
```shell
poetry run task check
```
To build a python wheel:
```shell
poetry run poetry build
```
## Bugs/Requests
Please use the [GitHub issue tracker](https://github.com/upciti/wheel2deb/issues) to submit bugs or request features.
## License
Copyright Parkoview SA 2019-2023.
Distributed under the terms of the [MIT](https://github.com/upciti/wheel2deb/blob/master/LICENSE) license, wheel2deb is free and open source software.
Raw data
{
"_id": null,
"home_page": "https://github.com/upciti/wheel2deb",
"name": "wheel2deb",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "Debian, DevOps, Automation, converter, package",
"author": "Upciti",
"author_email": "support@upciti.com",
"download_url": "https://files.pythonhosted.org/packages/d5/f6/33bfe971287650b34961c9f4bb7bb6826761d159fe47bac5b50ebbf2fd39/wheel2deb-0.9.5.tar.gz",
"platform": null,
"description": "## wheel2deb\n\n\n[](https://codecov.io/gh/upciti/wheel2deb)\n[](https://lbesson.mit-license.org/)\n[](https://github.com/ambv/black)\n[](https://pypi.python.org/pypi/wheel2deb/)\n[](https://pepy.tech/project/wheel2deb)\n[](https://docs.wakemeops.com/packages/wheel2deb)\n\n`wheel2deb` is a python wheel to debian package converter. It takes a list of wheels as input and produces a list of debian binary CPython packages (those prefixed with python- or python3-).\n\n[](https://asciinema.org/a/249779)\n\n## Quick Example\n\nThe following shows how to convert numpy and pytest, along with their dependencies into a list of debian packages:\n\n```sh\n# Download (and build if needed) pytest, numpy and their requirements\npip3 wheel pytest numpy\n# Convert all wheels to debian source packages, build them with dpkg-buildpackage\nwheel2deb\nls -l output/*.deb\n# Install generated packages\ndpkg -i output/*.deb\n# Run pytest on numpy\npython3 -c \"import numpy; numpy.test()\"\n```\n\n## Project scope\n\n- Python 2.7 and 3\n- CPython only for now\n- support for non pure python wheels\n- support debian architectures all, armhf, amd64, i686\n- tested on jessie, stretch, buster so far, ubuntu should also work\n\n## Requirements\n\n`wheel2deb` uses `apt-cache` to search for debian packages, `dpkg-shlibdeps` to calculate shared library dependencies and `apt-file` to search packages providing shared library dependencies. `wheel2deb build` requires the usual tools to build a debian package:\n\n```sh\napt update\napt install apt-file dpkg-dev fakeroot build-essential devscripts debhelper\napt-file update\n```\n\nIf you want to cross build packages for ARM, you will also need to install `binutils-arm-linux-gnueabihf`.\n\nConverting pure python wheels, don't actually requires apt-file and dpkg-dev.\n\nKeep in mind that you should only convert wheels that have been built for your distribution and architecture. wheel2deb will not warn you about ABI compatibility issues.\n\n## Installation\n\n### From the release page\n\n`wheel2deb` is packaged as a single binary application that you can download from the release page. Using those releases will spare you the hassle of building Python 3.11 on old Debian based distributions.\n\n### With [wakemeops](https://docs.wakemeops.com)\n\n```shell\nsudo apt-get install wheel2deb\n```\n\n### With docker\n\nWe currently do not build docker images with `wheel2deb` pre-installed. You can use wakemeops docker images to quickly play with `wheel2deb` on a different distribution than your host.\n\n```shell\ndocker run -ti wakemeops/debian:buster\n```\n\nAnd in the container run:\n\n```\ninstall_packages wheel2deb\n```\n\n### With [pipx](https://github.com/pipxproject/pipx)\n\n`wheel2deb` is available from [pypi](https://pypi.org/project/wheel2deb/):\n\n```shell\npipx install wheel2deb\n```\n\n## Features\n\n- guess debian package names from wheel names and search for them in the cache\n- search packages providing shared library dependencies for wheels with native code\n- handle entrypoints and scripts (those will be installed in /usr/bin with a proper shebang)\n- try to locate licence files and to generate a debian/copyright file\n\n## Usage\n\nUse `wheel2deb convert --help` and `wheel2deb build --help` to check all supported options.\n\n## Development\n\nYou will need [poetry](https://python-poetry.org/), and probably [pyenv](https://github.com/pyenv/pyenv) if you don't have python 3.11 on your host.\n\n```shell\npoetry install\n```\n\nTo run wheel2deb test suite run:\n\n```shell\npoetry run task check\n```\n\nTo build a python wheel:\n\n```shell\npoetry run poetry build\n```\n\n## Bugs/Requests\n\nPlease use the [GitHub issue tracker](https://github.com/upciti/wheel2deb/issues) to submit bugs or request features.\n\n## License\n\nCopyright Parkoview SA 2019-2023.\n\nDistributed under the terms of the [MIT](https://github.com/upciti/wheel2deb/blob/master/LICENSE) license, wheel2deb is free and open source software.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python wheel to debian package converter",
"version": "0.9.5",
"project_urls": {
"Homepage": "https://github.com/upciti/wheel2deb",
"Repository": "https://github.com/upciti/wheel2deb"
},
"split_keywords": [
"debian",
" devops",
" automation",
" converter",
" package"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b2cf1f3a053f530d5f87e98a327c753b6d5ddae78c746330ff3a314cd4365e2e",
"md5": "df86108d72314b81d537299f5b267738",
"sha256": "3fa1280b3f13a6b85a0645caba5a0b52d34e1807dccd3a801ec68200876ce582"
},
"downloads": -1,
"filename": "wheel2deb-0.9.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "df86108d72314b81d537299f5b267738",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 22822,
"upload_time": "2024-07-19T15:48:48",
"upload_time_iso_8601": "2024-07-19T15:48:48.403639Z",
"url": "https://files.pythonhosted.org/packages/b2/cf/1f3a053f530d5f87e98a327c753b6d5ddae78c746330ff3a314cd4365e2e/wheel2deb-0.9.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d5f633bfe971287650b34961c9f4bb7bb6826761d159fe47bac5b50ebbf2fd39",
"md5": "2241a665a279dc9e2371f1ff16c3b511",
"sha256": "1cf4670263c90789eb41a8f77f23ebfb45129d080b0472547245d54570aa7470"
},
"downloads": -1,
"filename": "wheel2deb-0.9.5.tar.gz",
"has_sig": false,
"md5_digest": "2241a665a279dc9e2371f1ff16c3b511",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 20861,
"upload_time": "2024-07-19T15:48:49",
"upload_time_iso_8601": "2024-07-19T15:48:49.615116Z",
"url": "https://files.pythonhosted.org/packages/d5/f6/33bfe971287650b34961c9f4bb7bb6826761d159fe47bac5b50ebbf2fd39/wheel2deb-0.9.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-19 15:48:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "upciti",
"github_project": "wheel2deb",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "wheel2deb"
}
JSON
