## 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.10 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.10 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": "",
"docs_url": null,
"requires_python": ">=3.10,<3.11",
"maintainer_email": "",
"keywords": "Debian,DevOps,Automation,converter,package",
"author": "Upciti",
"author_email": "support@upciti.com",
"download_url": "https://files.pythonhosted.org/packages/02/26/aa0bd6f1d3e75c765a57551f4b90637443b8516a525d149c2b9b4d342bba/wheel2deb-0.8.1.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.10 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.10 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.8.1",
"split_keywords": [
"debian",
"devops",
"automation",
"converter",
"package"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da9e6f269a75d743e82e8bc1e6e1ab560455bb58acd161c1729ec252d984c217",
"md5": "82c87b4d085911fdf15cd28160098128",
"sha256": "17aa3e85ec1239df9eb60bd903a4d64cc74efbe25d8b7435dc75ef9a584ab8dc"
},
"downloads": -1,
"filename": "wheel2deb-0.8.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "82c87b4d085911fdf15cd28160098128",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<3.11",
"size": 22664,
"upload_time": "2023-02-03T15:44:12",
"upload_time_iso_8601": "2023-02-03T15:44:12.962013Z",
"url": "https://files.pythonhosted.org/packages/da/9e/6f269a75d743e82e8bc1e6e1ab560455bb58acd161c1729ec252d984c217/wheel2deb-0.8.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0226aa0bd6f1d3e75c765a57551f4b90637443b8516a525d149c2b9b4d342bba",
"md5": "fde793bf23b013dfc1bc33bd46ab6115",
"sha256": "32d9a43cb1bb43ebfd8498704946d92375f302ba333e840997a312a0a761b878"
},
"downloads": -1,
"filename": "wheel2deb-0.8.1.tar.gz",
"has_sig": false,
"md5_digest": "fde793bf23b013dfc1bc33bd46ab6115",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<3.11",
"size": 21010,
"upload_time": "2023-02-03T15:44:14",
"upload_time_iso_8601": "2023-02-03T15:44:14.002415Z",
"url": "https://files.pythonhosted.org/packages/02/26/aa0bd6f1d3e75c765a57551f4b90637443b8516a525d149c2b9b4d342bba/wheel2deb-0.8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-03 15:44:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "upciti",
"github_project": "wheel2deb",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "wheel2deb"
}
JSON
