File: 76-setup-py-gui.txt

package info (click to toggle)
debmake-doc 1.17-7
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 24,612 kB
  • sloc: makefile: 768; sh: 690; ansic: 114; python: 99; sed: 16
file content (82 lines) | stat: -rw-r--r-- 2,432 bytes parent folder | download
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
[[setup-py-gui]]
=== setup.py (Python3, GUI)

Here is an example of creating a simple Debian package from a Python3 GUI program using the *setuptools* based *setup.py* as its build system.

This upstream is based on <<setup-py>> with enhanced GUI, desktop icon, and manpage support.

Let's assume this upstream tarball to be *debhello-1.3.tar.gz*.

Let's get the source and make the Debian package.

.Download *debhello-1.3.tar.gz*
----
include::../examples/debhello-1.3_build-1/step000.slog[]
----

Here, the content of this *debhello* source tree as follows.

.*setup.py* (v=1.3) -- a boilar plate *setup.py* for the backward compatibility
----
include::../examples/debhello-1.3_build-1/step101.slog[]
----

.*setup.cfg* (v=1.3) -- modern static metadata
----
include::../examples/debhello-1.3_build-1/step102.slog[]
----

.*pyproject.toml* (v=1.3) -- https://www.python.org/dev/peps/pep-0517/[PEP 517] configuration
----
include::../examples/debhello-1.3_build-1/step103.slog[]
----

.*MANIFEST.in* (v=1.3) -- for *distutils* to make *sdist*
----
include::../examples/debhello-1.3_build-1/step104.slog[]
----

.*src/debhello/\_\_init__.py* (v=1.3) -- program version definition
----
include::../examples/debhello-1.3_build-1/step105.slog[]
----

.*src/debhello/\_\_main__.py* (v=1.3) -- command entry point
----
include::../examples/debhello-1.3_build-1/step106.slog[]
----

Let's package this with the *debmake* command.  Here, the *-b\':py3'* option is used to specify that the generated binary package contains Python3 script and module files.

----
sys::[head -n3 ../examples/debhello-1.3_build-1/step200.slog]
 ...
sys::[grep -A12  '^I: sanity check of parameters' ../examples/debhello-1.3_build-1/step200.slog]
 ...
----

The result is practically the same as in <<setup-py>>.

Let's make this Debian package better as the maintainer.

.*debian/rules* (maintainer version, v=1.3):
----
include::../examples/debhello-1.3_build-1/step301.slog[]
----

.*debian/control* (maintainer version, v=1.3):
----
include::../examples/debhello-1.3_build-1/step302.slog[]
----

Please note the manually added *python3-gi* and *gir1.2-gtk-3.0* dependencies.

The rest of the packaging activities are practically the same as in <<setup-py>>.

Here is the generated dependency list of *debhello_1.3-1_all.deb*.

.The generated dependency list of *debhello_1.3-1_all.deb*:
----
include::../examples/debhello-1.3_build-1/step702.slog[]
----