phpbb-release-tools

Build phpBB package ZIPs, publish GitHub Releases, wait for PR checks, and test extensions and styles on a local board. Written and tested on Linux.

Tools

Tool	Purpose
git-extensions.sh	Package and release extensions
git-release-style.sh	Package and release styles
git-release-langpack.sh	Validate, package, and release language packs
pr-wait.py	Wait for a pull request's checks
phpbb-test-board/	Set up a local board, run checks, and take screenshots

Quick start

Clone the whole repository so the scripts can find their shared lib/ helpers:

git clone https://github.com/phpbbmodders/phpbb-release-tools.git
cd phpbb-release-tools
export PATH="$PWD:$PWD/phpbb-test-board:$PATH"

The PATH change applies to the current shell. See Installation for prerequisites and permanent setup.

Run a release script inside the package's Git repository:

git-extensions.sh --create                      # ZIP from local HEAD
git-extensions.sh --release --remote --dry-run  # ZIP and publication preview
git-extensions.sh --release --remote            # publish from GitHub's default branch

Use git-release-style.sh or git-release-langpack.sh for those package types. All three use local HEAD by default; --remote selects GitHub's default branch. Uncommitted changes are excluded. Run a tool with --help for its options.

Documentation

The Wiki contains the full guides:

• Release workflows, including package examples and common options.
• Default-branch releases, including migration from git-release-api.sh.
• GitHub releases and recovery, including rolling releases and --force replacement.
• Waiting for PR checks.
• Test-board setup and maintainer checks.
• Forum update posts and screenshot galleries.

Contributing

Contributions are welcome!

• Bug reports: Open an issue.
• Everything else (questions, feature requests, ideas, general discussion): Use Discussions.
• Pull requests are welcome for bug fixes or discussed features.

Acknowledgments

• Code review, bug fixes, and documentation assisted by Claude.
• Release-script consolidation, regression tests, and documentation assisted by Codex.

License

This project is licensed under the GNU General Public License v2.0.

See LICENSE for more information.