History

Paul Hollinsky 8e7d235513 tools/toolbox: Explicitly use /bin/bash The script uses bash-specific language extensions which cause syntax errors when run with /bin/sh -> /bin/dash. Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3186>		2024-02-11 14:41:31 -08:00
..
create-toolbox.sh	tools/toolbox: Explicitly use /bin/bash	2024-02-11 14:41:31 -08:00
meson-build.sh	tools/toolbox: Expose --wipe meson flag	2024-01-15 17:18:09 +00:00
meson-test.sh	tools/toolbox: Add `meson test` convenience wrapper	2024-01-15 17:27:46 +00:00
README.md	docs: Use consistent spacing	2024-01-27 22:22:11 +01:00
run-gnome-shell.sh	tools/toolbox: Add run convenience script	2023-12-01 15:58:21 +00:00

README.md

Toolbox tools

Toolbox is a container tool for Linux, which allows the use of interactive command line environments for development, without having to install software on the host.

It is suitable for gnome-shell development, and we maintain a number of scripts to make its use easier and more convenient.

create-toolbox.sh

Create a new toolbox for gnome-shell development.

The new toolbox uses a custom container image that includes all dependencies except mutter. Mutter is developed in lock-step with gnome-shell, and therefore needs to be updated more regularly than the image. The toolbox includes the update-mutter command that takes care of this, which is usually run by the script when creating the toolbox.

When called with the --builder option, the script also sets up build configuration for the GNOME Builder IDE, which allows building and running gnome-shell from within the app.

For other options, run the script with --help.

meson-build.sh

Build and install a meson project in a toolbox.

gnome-shell uses the meson build system, and doesn't require any build steps other than the standard meson commands. It is still convenient to have a single command to enter a toolbox and setup, compile and install the project.

Run the script with --help to see available options.

meson-test.sh

Run a meson project's test suite in a toolbox.

The script wraps meson's test command to make invoking it inside a toolbox more convenient.

Run the script with --help to see available options.

run-gnome-shell.sh

Run gnome-shell from a toolbox.

The script can be used both from within a graphical session and from a TTY. It takes care of isolating the nested shell from the host session, and setting up the environment to allow apps to launch inside the nested instance.

It also provides useful options for development, like running from gdb, or simulating multiple monitors or a greeter session.

Run the script with --help to see all available options.