Skip to content

Using debuild to pack python projecr into debian package The python project include pyproject.toml

install depend packages

1
2
3
sudo apt install dh-python
sudo apt install pybuild-plugin-pyproject
sudo apt install python3-all

Project basic

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
├── debian
│   ├── changelog
│   ├── control
│   ├── postinst
│   ├── postrm
│   └── rules
├── pyproject.toml
├── README.md
├── src
│   └── py2deb
│       ├── __init__.py
│       └── py.typed
└── uv.lock

control

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
Source: py2deb
Section: python
Priority: optional
Maintainer: Your Name <you@example.com>
Build-Depends:
 debhelper-compat (= 13),
 dh-python,
 python3-all,
 pybuild-plugin-pyproject
Standards-Version: 4.6.2

Package: python3-py2deb
Architecture: all
Depends: ${python3:Depends}, ${misc:Depends}
Description: py2deb Python library
 Python library installed system-wide using dh-python.

rules

1
2
3
4
5
6
7
#!/usr/bin/make -f

%:
    dh $@ --with python3 --buildsystem=pybuild

override_dh_builddeb:
    dh_builddeb --destdir=$(CURDIR)/debs

rule tab indentation

settings.json
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
    "[shellscript]": {
        "editor.insertSpaces": false,
        "editor.tabSize": 4,
        "editor.detectIndentation": false
    },
    "files.associations": {
        "rules": "shellscript"
    }
}

pyproject.toml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[project]
name = "py2deb"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
authors = [
    { name = "robobe", email = "robobe2020@gmail.com" }
]
requires-python = ">=3.12"
dependencies = []

[build-system]
requires = ["setuptools>=68", "wheel"]
build-backend = "setuptools.build_meta"

[dependency-groups]
dev = [
    "build>=1.3.0",
]

postinst

- #DEBHELPER#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
#!/bin/sh

# debhelper will inject its autogenerated code here
# (triggers, ldconfig, python cache, etc.)
# DO NOT REMOVE
#DEBHELPER#

set -e

case "$1" in
  configure)
    echo "Running custom post-install logic"
    # your command here
    ;;
esac

exit 0

postrm

  • DEBHELPER

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
#!/bin/sh

# debhelper will inject its autogenerated code here
# (triggers, ldconfig, python cache, etc.)
# DO NOT REMOVE
#DEBHELPER#

set -e



exit 0

usage

debs folder

debuild create the deb file and other artifacts in project parent folder using rules control where deb fille will locater but it mess dpkg-buildpackage app default behaver

rules
1
2
override_dh_builddeb:
    dh_builddeb --destdir=$(CURDIR)/debs

1
debuild -b -us -uc

TODO

  • hot to sync pyproject.toml version with changelog / debian package
  • explain more #DEBHELPER# what are the defaults commends that debuld embedded in postinst and postrm