Add README and a helper script for running tests

Author: amezin

README.md

@@ -0,0 +1,31 @@
+<!--
+SPDX-FileCopyrightText: 2026 Aleksandr Mezin <mezin.alexander@gmail.com>
+
+SPDX-License-Identifier: MIT
+-->
+
+# gjs-typelib-installer
+
+[ddterm] depends on multiple GObject libraries (`gi://` imports),
+some of them are often not installed by default.
+
+Instead of silently failing, a notification is shown:
+
+![Notification](pictures/notification.png)
+
+On supported distributions, it has an "Install" button, which installs
+the requested packages.
+
+gjs-typelib-installer is the backend for it. It implements:
+
+1. [`require()`] function that tries to import libraries, and throws
+[`MissingDependencies`] exception if import fails. The exception contains
+a list of packages that need to be installed to fix the issue.
+
+2. [`findTerminalInstallCommand()`] function that finds a working package
+installation method for the current OS.
+
+[ddterm]: https://github.com/ddterm/gnome-shell-extension-ddterm
+[`require()`]: https://ddterm.github.io/gjs-typelib-installer/functions/require.html
+[`MissingDependencies`]: https://ddterm.github.io/gjs-typelib-installer/classes/MissingDependencies.html
+[`findTerminalInstallCommand()`]: https://ddterm.github.io/gjs-typelib-installer/functions/findTerminalInstallCommand.html

pictures/notification.png

@@ -0,0 +1,3 @@
+SPDX-FileCopyrightText: NONE
+
+SPDX-License-Identifier: CC0-1.0

pictures/notification.png.license

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+# SPDX-FileCopyrightText: 2026 Aleksandr Mezin <mezin.alexander@gmail.com>
+#
+# SPDX-License-Identifier: MIT
+
+set -e
+
+service="$1"
+shift
+
+trap 'podman compose down -v "$service"' EXIT
+
+podman compose up --build --wait --force-recreate "$service"
+podman compose exec -u testuser "$service" tests/e2e-tests.sh "$@"