PHP download

Download the PHP package aldavigdis/wp-tests-strapon without Composer

On this page you can find all versions of the php package aldavigdis/wp-tests-strapon. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download aldavigdis/wp-tests-strapon
More information about aldavigdis/wp-tests-strapon
Files in aldavigdis/wp-tests-strapon

Vendor aldavigdis
Package wp-tests-strapon
Short Description Strap the WordPress PHPUnit tests library onto your plugin or theme with this handy Composer package.
License AGPL-3.0-or-later
Homepage https://github.com/aldavigdis/wp-tests-strapon

Keywords testing phpunit wordpress dev

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Informations about the package wp-tests-strapon

WP-Tests-Strapon

Strap the WordPress PHPUnit tests library onto your WordPress plugin or theme with this handy Composer package.

This PHP Composer package facilitates the configuration and installation of a WordPress test environment so that WordPress' functionality can be used in your PHPUnit test suite.

In essence, it has the same purpose as the install-wp-tests.sh shell script installed by the WP-CLI scaffolder, but takes a more streamlined approach:

It comes as a PHP Composer package, simplifying updates and maintainance, with no extra files in your own codebase
Is 100% programmed in PHP, so it does not require skills beyond that to contribute to the project
Has the same dependencies as one can expect from any WordPress development environment (the cURL and ZipArchive PHP modules)
Does not depend on ancient technology that nobody should use anymore, such as Subversion
The test environments are downloaded and configured automatically using information from your PHPUnit configuration file and environment variables
No need to re-run a script to install a development environment with the same parameters after every time you restart your computer or development environment

A screenshot of WP-Tests-Strapon, showing the test suite being prepared and run.

Usage

WP-Tests-Strapon integrates with PHPUnit and acts as a bootstrap layer between it and your WordPress plugin's test suite. Simply run ./vendor/bin/phpunit as you would generally do after following the installation instructions below.

For more information on PHPUnit itself and how to write tests, you should read their documentation.

Installation

Make sure you have version 9 or 10 of PHPUnit installed as a development dependency for your project.
Install the Composer package using composer require --dev aldavigdis/wp-tests-strapon.

Finally, Open up your PHPUnit configuration file (phpunit.xml or phpunit.xml.dist) and set the bootstrap attribute of the root <phpunit> element to vendor/aldavigdis/wp-tests-strapon/bootstrap.php.

Alternatively, you can include or require vendor/aldavigdis/wp-tests-strapon/bootstrap.php in your own PHPUnit bootstrap file.

Example PHPUnit configuration file

Environment variables and constants

You can set those in your phpunit.xml file, in your terminal session or in your test and production environments.

PHPUnit Bootstrap

WP_TESTS_CONFIG_FILE_PATH (constant): The location of your test environment's config file. Defaults to /tmp/wp-tests-strapon/config.php on Linux/Unix/macOS.
WP_VERSION (environment variable): The PHP version to test against. Defaults to master.

Config File Constants

The following constants will be set in your WordPress test configuration file:

WP_DEFAULT_THEME
WP_TESTS_MULTISITE
WP_DEBUG
TABLE_PREFIX
DB_NAME
DB_USER
DB_PASSWORD
DB_HOST
WP_TESTS_DOMAIN
WP_TESTS_EMAIL
WP_TESTS_TITLE
WP_PHP_BINARY
WPLANG

The default values can be overridden when the file is generated by setting environment variables of the same name. You can do it using your PHPUnit configuration file, the PHPUnit runtime parameters, globally in your terminal or in your CI environment.

The Todo List

Test the database connection when the config file is initialised
Create the database if it does not exsist
Improve documentation
Add more tests
Add more glitter
Test on a Mac
Get Windows support sorted out (both CMD and PowerShell)

FAQ

Q: Why did you choose the AGPL license as opposed to a less restrictive one?

A: The AGPL makes sure that those who are using my software without paying contribute back if they modify it. If you would like a different licensing agreement for a fee, then that can be arranged.

Q: What's with the emoji everywhere?

A: What's with you being so boring and dull?

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

For questions regarding the license or requests for alternative license arrangements, please contact the author at [email protected].

All versions of wp-tests-strapon with dependencies

PHP Build Version

Package Version

Version 0.1.7 Release 25. Jan 2025
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of wp-tests-strapon from vendor aldavigdis

Requires composer-plugin-api Version ^2.6
yoast/phpunit-polyfills Version ^3.1
simoneast/simple-ansi-colors Version ^1.0
phpunit/phpunit Version ^10 || ^11

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package aldavigdis/wp-tests-strapon contains the following files

Loading the files please wait ....