// vim:set filetype=asciidoc:
[[pyproject]]
=== pyproject.toml (Python3, CLI)

Here is an example of creating a simple Debian package from a Python3 CLI program using *pyproject.toml*.

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

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

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

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

.*MANIFEST.in* (v=1.1) -- for tar-ball.
----
include::../examples/debhello-1.1_build-1/step104.slog[]
----

.**src/debhello/\\__init__.py** (v=1.1)
----
include::../examples/debhello-1.1_build-1/step105.slog[]
----

.*src/debhello/main.py* (v=1.1) -- command entry point
----
include::../examples/debhello-1.1_build-1/step106.slog[]
----

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

----
include::../examples/debhello-1.1_build-1/step200.slog[lines=1..3]
 ...
include::../examples/debhello-1.1_build-1/step200.slog-sanity[]
 ...
----

Let's inspect the notable template files generated.

.*debian/rules* (template file, v=1.1):
----
include::../examples/debhello-1.1_build-1/step202.slog[]
----

This is essentially the standard *debian/rules* file with the *dh* command.

The use of the "`*--with python3*`" option invokes *dh_python3* to calculate Python dependencies, add maintainer scripts to byte compiled files, etc. See *dh_python3*(1).

The use of the "`*--buildsystem=pybuild*`" option invokes various build systems for requested Python versions in order to build modules and extensions.  See *pybuild*(1).

.*debian/control* (template file, v=1.1):
----
include::../examples/debhello-1.1_build-1/step203.slog[]
----

Since this is the Python3 package, the *debmake* command sets "`*Architecture: all*`" and "`*Multi-Arch: foreign*`".  Also, it sets required *substvar* parameters as "`*Depends: ${python3:Depends}, ${misc:Depends}*`".  These are explained in "`<<basics>>`".

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

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

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

There are several other template files under the *debian/* directory.  These also need to be updated.

This *debhello* command comes with the upstream-provided manpage and desktop file but the upstream *pyproject.toml* doesn't install them.  So you need to update *debian/install* and *debian/manpages* as follows:

.*debian/install* (maintainer version, v=1.1):
----
include::../examples/debhello-1.1_build-1/step303.slog[]
----

.*debian/manpages* (maintainer version, v=1.1):
----
include::../examples/debhello-1.1_build-1/step304.slog[]
----

The rest of the packaging activities are practically the same as the ones in "`<<makefile-sh>>`".

.Template files under *debian/*. (v=1.1):
----
include::../examples/debhello-1.1_build-1/step400.slog[]
----

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

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