Include girepository-2.0 as a system depdendency for Toga on Debian (#2187)

Defaults to libgirepository-2.0 on Debian-based releases, to avoid incompatibility with PyGObject 3.52.1. This change will break new apps on Debian 11, Debian 12, or Ubuntu 22.04; but there's no way to support both simultaneously.

Co-authored-by: Russell Martin <russell@rjm.li>

Author: freakboy3742

changes/2187.bugfix.rst

@@ -0,0 +1 @@
+New Toga projects on Debian-derived distributions now include ``libgirepository-2.0-0`` and ``libgirepository-2.0-dev`` as a system requirement. This is needed for support for PyGObject 3.52.1 and later.

src/briefcase/bootstraps/toga.py

@@ -60,6 +60,10 @@ def pyproject_table_linux(self):
         return """\
 requires = [
     "toga-gtk~=0.4.7",
+    # PyGObject 3.52.1 enforces a requirement on libgirepository-2.0-dev. This library
+    # isn't available on Debian 12/Ubuntu 22.04. If you need to support those (or older)
+    # releases, uncomment this version pin. See beeware/toga#3143.
+    # "pygobject < 3.52.1",
 ]
 """
 
@@ -68,18 +72,27 @@ def pyproject_table_linux_system_debian(self):
 system_requires = [
     # Needed to compile pycairo wheel
     "libcairo2-dev",
-    # Needed to compile PyGObject wheel
-    "libgirepository1.0-dev",
+    # One of the following two packages are needed to compile PyGObject wheel.
+    # Debian 12/Ubuntu 22.04 only has the older 1.0 version of the library.
+    # If you use the older version, you'll also need to apply the pygobject pin
+    # (see the linux requires table). See beeware/toga#3143.
+    "libgirepository-2.0-dev",
+    # "libgirepository1.0-dev",
 ]
 
 system_runtime_requires = [
     # Needed to provide GTK and its GI bindings
     "gir1.2-gtk-3.0",
-    "libgirepository-1.0-1",
+    # One of the following two packages are needed to use PyGObject at runtime.
+    # Debian 12/Ubuntu 22.04 only has the older 1.0 version of the library.
+    # If you use the older version, you'll also need to apply the pygobject pin
+    # (see the linux requires table). See beeware/toga#3143.
+    "libgirepository-2.0-0",
+    # "libgirepository-1.0-1",
     # Dependencies that GTK looks for at runtime
     "libcanberra-gtk3-module",
     # Needed to provide WebKit2 at runtime
-    # Note: Debian 11 and Ubuntu 20.04 require gir1.2-webkit2-4.0 instead
+    # Note: Debian 11 requires gir1.2-webkit2-4.0 instead
     # "gir1.2-webkit2-4.1",
 ]
 """

tests/commands/new/test_build_gui_context.py

@@ -86,24 +86,37 @@ def main():
         pyproject_table_linux="""\
 requires = [
     "toga-gtk~=0.4.7",
+    # PyGObject 3.52.1 enforces a requirement on libgirepository-2.0-dev. This library
+    # isn't available on Debian 12/Ubuntu 22.04. If you need to support those (or older)
+    # releases, uncomment this version pin. See beeware/toga#3143.
+    # "pygobject < 3.52.1",
 ]
 """,
         pyproject_table_linux_system_debian="""\
 system_requires = [
     # Needed to compile pycairo wheel
     "libcairo2-dev",
-    # Needed to compile PyGObject wheel
-    "libgirepository1.0-dev",
+    # One of the following two packages are needed to compile PyGObject wheel.
+    # Debian 12/Ubuntu 22.04 only has the older 1.0 version of the library.
+    # If you use the older version, you'll also need to apply the pygobject pin
+    # (see the linux requires table). See beeware/toga#3143.
+    "libgirepository-2.0-dev",
+    # "libgirepository1.0-dev",
 ]
 
 system_runtime_requires = [
     # Needed to provide GTK and its GI bindings
     "gir1.2-gtk-3.0",
-    "libgirepository-1.0-1",
+    # One of the following two packages are needed to use PyGObject at runtime.
+    # Debian 12/Ubuntu 22.04 only has the older 1.0 version of the library.
+    # If you use the older version, you'll also need to apply the pygobject pin
+    # (see the linux requires table). See beeware/toga#3143.
+    "libgirepository-2.0-0",
+    # "libgirepository-1.0-1",
     # Dependencies that GTK looks for at runtime
     "libcanberra-gtk3-module",
     # Needed to provide WebKit2 at runtime
-    # Note: Debian 11 and Ubuntu 20.04 require gir1.2-webkit2-4.0 instead
+    # Note: Debian 11 requires gir1.2-webkit2-4.0 instead
     # "gir1.2-webkit2-4.1",
 ]
 """,