feat: Add configuration for running tests

Thanks to the work done in roots/bedrock#366 .

README.md

@@ -30,3 +30,16 @@ docker compose -f docker-compose.yml --env-file=docker_configs/.env.compose.deve
 ```
 git --git-dir= apply application_php.patch
 ```
+
+If there are some update with autoload's run:
+
+```
+composer dump-autoload
+```
+
+Run tests
+
+```
+# ./vendor/bin/phpunit
+composer test
+```

composer.json

@@ -38,5 +38,10 @@
   "scripts": {
     "lint": "phpcs",
     "test": "phpunit"
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Tests\\": "tests/src"
+    }
   }
 }

phpunit.xml.dist

@@ -0,0 +1,20 @@
+<?xml version="1.0"?>
+<phpunit
+	bootstrap="tests/bootstrap.php"
+	backupGlobals="false"
+	colors="true"
+	convertErrorsToExceptions="true"
+	convertNoticesToExceptions="true"
+	convertWarningsToExceptions="true"
+	>
+	<testsuites>
+		<testsuite name="unit">
+			<directory suffix="Test.php">./tests/unit/</directory>
+			<exclude>./tests/test-sample.php</exclude>
+		</testsuite>
+	</testsuites>
+	<php>
+		<env name="WP_ENV" value="testing"/>
+		<env name="WP_PHPUNIT__TABLE_PREFIX" value="tests_"/>
+	</php>
+</phpunit>

tests/bootstrap.php

@@ -0,0 +1,19 @@
+<?php
+/**
+ * PHPUnit bootstrap file
+ *
+ * Composer autoloader must be loaded before WP_PHPUNIT__DIR will be available.
+ */
+
+require_once(dirname(__DIR__) . '/vendor/autoload.php');
+
+// Give access to tests_add_filter() function.
+require_once(getenv('WP_PHPUNIT__DIR') . '/includes/functions.php');
+
+tests_add_filter('muplugins_loaded', function () {
+    // test set up, plugin activation, etc.
+});
+
+// Start up the WP testing environment.
+putenv(sprintf('WP_PHPUNIT__TESTS_CONFIG=%s/wp-config.php', __DIR__));
+require(getenv('WP_PHPUNIT__DIR') . '/includes/bootstrap.php');

tests/src/TestCase.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Tests;
+
+class TestCase extends \WP_UnitTestCase
+{
+    /**
+     * Here you can define your own custom assertions or helper methods
+     * which will be available to all your tests that extend it.
+     */
+}

tests/unit/ExampleTest.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Tests;
+
+class ExampleTest extends TestCase
+{
+    /** @test */
+    function it_works()
+    {
+        $this->assertTrue(function_exists('add_action'));
+    }
+}

tests/wp-config.php

@@ -0,0 +1,7 @@
+<?php
+/**
+ * Do not edit this file. Edit the config files found in the config/ dir instead.
+ * Test-specific configuration is found in config/environments/testing.php.
+ */
+require_once(dirname(__DIR__) . '/vendor/autoload.php');
+require_once(dirname(__DIR__) . '/bedrock/config/application.php');