The goal of this project is to facilitate the running of tests and code analysis against a Moodle plugin in Travis CI. All of these tests and tools are run everytime a change is pushed to a GitHub branch or pull request.

Why would you want to do this? It saves you from having to remember to setup and run PHPUnit, Behat, code checker, etc every single time you make a change. If you have enough test coverage, it also makes accepting pull requests painless because you can be more confident that the change wont break anything. There are many more advantages to using a service like Travis CI, like being able to test your code against multiple databases, multiple PHP versions, etc.

This project supports the following testing frameworks and code analysis tools:

Requirements

The requirements for Version 2 are PHP 5.6 or later and Moodle 3.2 or later.

In addition, the plugin being tested must have a version.php file and $plugin->component must be defined within it.

If you need to run your plugin in earlier versions of Moodle, then please use Version 1 of this tool. Documentation and more information about Version 1 can be found in the v1 branch. Please know that Version 1 is no longer getting new features and may not receive additional updates.

Getting started

Follow these steps to get your Moodle plugin building in Travis CI.

Step 1

Sign into Travis CI with your GitHub account. Once you’re signed in, and Travis CI will have synchronized your repositories from GitHub. Go to your profile page and enable Travis CI for the plugin you want to build. Now whenever your plugin receives an update or gets a new pull request, Travis CI will run a build to make sure nothing broke.

Step 2

Copy the .travis.dist.yml file into the root of your plugin and rename it to .travis.yml. Now might be a good time to review the .travis.yml contents and remove anything that is not needed. See this help document for an explanation about the contents of the this file. Once you have added the .travis.yml file, commit and push up to GitHub, to trigger a Travis CI build. Navigate back to Travis CI to see if your build passes or fails.

Step 3

Congratulations, you are building on Travis CI! Next steps on your continuous build journey include:

  • Reviewing the help documentation to further improve and customize your build.
  • Resolve any build errors you may currently have. Get to that ever rewarding Green Build status.
  • Show off your build status by adding the badge to your plugin’s README file.
  • Write new tests to increase your code coverage.
  • Enjoy your favorite beverage because you no longer have to waste time manually testing your plugin!

Upgrading

Guides to updating your plugin’s .travis.yml file to use the latest versions of this tool.

Documentation

Visit the help page for a complete list of documents, guides and links.

Usage / Versioning

This project uses Semantic Versioning for its public API. The public API for this project is defined as the CLI interface of the moodle-plugin-ci script. Everything outside of this script is considered to be private API and is not guaranteed to follow Semantic Versioning.

The commands ran via the moodle-plugin-ci script by default take no arguments. It is recommended, if at all possible, to avoid using arguments to prevent problems with future versions. Rest assured though that if any arguments are modified, it will be in the change log and the version will be bumped appropriately according to Semantic Versioning.

License

This project is licensed under the GNU GPL v3 or later. See the LICENSE file for details.