johnbillion/plugin-infrastructure

Reusable infrastructure relating to testing, building, and deploying my WordPress plugins

Maintainers

Details

github.com/johnbillion/plugin-infrastructure

Source

Issues

Fund package maintenance!
johnbillion

Installs: 32 568

Dependents: 5

Suggesters: 0

Security: 0

Stars: 17

Watchers: 5

Forks: 1

Open Issues: 7

Language:Shell

dev-trunk 2024-12-21 03:31 UTC

Requires

  • php: >=7.4

MIT 95090959c51db634117e0cb1be5e8ce47303165b

This package is auto-updated.

Last update: 2024-12-21 03:31:35 UTC

README

Reusable infrastructure relating to testing, building, and deploying my WordPress plugins (see the "Used by" section below).

Provided without support, warranty, guarantee, backwards compatibility, fitness for purpose, resilience, safety, sanity, beauty, or support for any plugin that isn't one of mine.

Used by

Overview

Plugins that use this library all use a similar setup in their workflows:

Acceptance testing

  • Push to a main branch or pull request, acceptance-tests.yml fires
    • Constructs a matrix of supported PHP and WordPress versions
    • Uses reusable-acceptance-tests.yml
      • Installs PHP and WordPress
      • Runs the build
      • Runs acceptance testing with wp-browser

Integration testing

  • Push to a main branch or pull request, integration-tests.yml fires
    • Constructs a matrix of supported PHP and WordPress versions
    • Uses reusable-integration-tests.yml
      • Installs PHP and WordPress
      • Runs the build
      • Runs integration testing with wp-browser

Coding standards testing

  • Push to a main branch or pull request, coding-standards.yml fires
    • Constructs a matrix of supported PHP versions
    • Uses reusable-coding-standards.yml
      • Installs PHP
      • Checks coding standards with PHPStan and PHPCS

Deployment to WordPress.org

  • Push to the release branch, build.yml fires
    • Uses reusable-build.yml
      • Runs the build
      • Reads version from package.json
      • Commits built files
      • Pushes to release-$VERSION
      • Tags the new version and pushes
  • Publish a release, deploy-tag.yml fires
    • Uses reusable-deploy-tag.yml
      • Creates a changelog entry from the release notes
      • Uses 10up/action-wordpress-plugin-deploy
        • Deploys the new version to WordPress.org
        • Generates a zip file
    • Uses johnbillion/action-wordpress-plugin-attestation
      • Fetches the zip from WordPress.org
      • Generates an attestation if the zip contents match the build

Licence

MIT