diff --git a/TESTING.md b/TESTING.md index 3f0e58810..0dd82144c 100644 --- a/TESTING.md +++ b/TESTING.md @@ -9,7 +9,39 @@ Before starting, follow the [instructions](README.md#installation) for installin Before attempting to run the test suite copy the example environment file for tests and update the values to match your environment: `cp .env.testing.example .env.testing` -> Since the data in the database is flushed after each test it is recommended you create a separate mysql database for specifically for tests + +The following should work for running tests in memory with sqlite: +``` +# -------------------------------------------- +# REQUIRED: BASIC APP SETTINGS +# -------------------------------------------- +APP_ENV=testing +APP_DEBUG=true +APP_KEY=base64:glJpcM7BYwWiBggp3SQ/+NlRkqsBQMaGEOjemXqJzOU= +APP_URL=http://localhost:8000 +APP_TIMEZONE='UTC' +APP_LOCALE=en + +# -------------------------------------------- +# REQUIRED: DATABASE SETTINGS +# -------------------------------------------- +DB_CONNECTION=sqlite_testing +#DB_HOST=127.0.0.1 +#DB_PORT=3306 +#DB_DATABASE=null +#DB_USERNAME=null +#DB_PASSWORD=null +``` + +To use MySQL you should update the `DB_` variables to match your local test database: +``` +DB_CONNECTION=mysql +DB_HOST=127.0.0.1 +DB_PORT=3306 +DB_DATABASE={} +DB_USERNAME={} +DB_PASSWORD={} +``` Now you are ready to run the entire test suite from your terminal: @@ -19,6 +51,10 @@ To run individual test files, you can pass the path to the test that you want to `php artisan test tests/Unit/AccessoryTest.php` +You can also run the tests in parallel with: + +`php artisan test --parallel` + ## Browser Tests Browser tests are run via [Laravel Dusk](https://laravel.com/docs/8.x/dusk) and require Google Chrome to be installed.