feat: add arch test function

Adds a new `arch` function that is a synonym for `test()->group('arch')`. This allows users to easily isolate arch tests for inclusion/exclusion when running their test suite.

src/Autoload.php

@@ -3,6 +3,23 @@
 declare(strict_types=1);
 
 use Pest\Arch\Concerns\Architectable;
+use Pest\Concerns\Expectable;
+use Pest\PendingCalls\TestCall;
 use Pest\Plugin;
+use PHPUnit\Framework\TestCase;
 
 Plugin::uses(Architectable::class);
+
+if (! function_exists('arch')) {
+    /**
+     * Adds the given closure as an architecture test. The first
+     * argument is the test description; the second argument
+     * is a closure that contains the test expectations.
+     *
+     * @return Expectable|TestCall|TestCase|mixed
+     */
+    function arch(string $description, Closure $closure = null): TestCall
+    {
+        return test($description, $closure)->group('arch');
+    }
+}

tests/Arch.php

@@ -11,7 +11,7 @@
 use Pest\Expectation;
 use Whoops\Exception\Frame;
 
-test('base')
+arch('base')
     ->expect('Pest\Arch')
     ->classes->toBeFinal()
     ->classes->not->toBeAbstract()
@@ -34,24 +34,24 @@
         'Whoops\Exception\Frame',
     ])->ignoring(['PHPUnit\Framework', 'Composer']);
 
-test('contracts')
+arch('contracts')
     ->expect('Pest\Arch')
     ->not->toBeInterface()
     ->ignoring('Pest\Arch\Contracts');
 
-test('collections')
+arch('collections')
     ->expect('Pest\Arch\Collections')
     ->toOnlyUse('Pest\Arch\ValueObjects');
 
-test('exceptions')
+arch('exceptions')
     ->expect('Pest\Arch\Exceptions')
     ->toImplement(Throwable::class)
     ->toOnlyUse([
         Frame::class,
         Violation::class,
     ])->ignoring('PHPUnit\Framework');
 
-test('expectations')
+arch('expectations')
     ->expect('Pest\Arch\Expectations')
     ->toOnlyUse([
         'expect',
@@ -60,7 +60,7 @@
         'PHPUnit\Architecture\Elements\ObjectDescription',
     ])->ignoring('PHPUnit\Framework');
 
-test('repositories')->expect('Pest\Arch\Repositories')->toOnlyUse([
+arch('repositories')->expect('Pest\Arch\Repositories')->toOnlyUse([
     'Pest\TestSuite',
     'Pest\Arch\Factories',
     'Pest\Arch\Objects',
@@ -70,7 +70,7 @@
     'Symfony\Component\Finder\Finder',
 ]);
 
-test('value objects')
+arch('value objects')
     ->expect('Pest\Arch\ValueObjects')
     ->toUseNothing()
     ->ignoring([Targets::class, Dependency::class, 'PHPUnit\Framework', Expectation::class])

tests/ArchFunction.php

@@ -0,0 +1,5 @@
+<?php
+
+arch('this should have been added to an arch group', function () {
+    expect(test()->groups()[0])->toBe('arch');
+});