Adding a With_Faker trait

src/mantle/database/class-factory-service-provider.php

@@ -43,7 +43,7 @@ protected function register_mantle_factory() {
 		$this->app->singleton(
 			FakerGenerator::class,
 			function ( $app, $parameters ) {
-				$locale = 'en_US';
+				$locale = config( 'app.faker_locale', Factory::DEFAULT_LOCALE );
 
 				if ( ! isset( static::$fakers[ $locale ] ) ) {
 					static::$fakers[ $locale ] = Factory::create();

src/mantle/testing/concerns/trait-with-faker.php

@@ -0,0 +1,49 @@
+<?php
+/**
+ * This file contains the With_Faker trait
+ *
+ * @package Mantle
+ */
+
+namespace Mantle\Testing\Concerns;
+
+use Faker\Generator;
+use Faker\Factory;
+
+/**
+ * This trait sets up a faker instance for use in tests.
+ */
+trait With_Faker {
+	/**
+	 * Faker instance.
+	 *
+	 * @var Generator
+	 */
+	protected Generator $faker;
+
+	/**
+	 * Setup the Faker instance.
+	 */
+	public function with_faker_set_up() {
+		$this->faker = $this->make_faker();
+
+		$this->faker->unique( true );
+	}
+
+	/**
+	 * Create a faker instance.
+	 *
+	 * @return Generator
+	 */
+	protected function make_faker(): Generator {
+		$locale = isset( $this->app['config'] )
+			? $this->app['config']->get( 'app.faker_locale', Factory::DEFAULT_LOCALE )
+			: Factory::DEFAULT_LOCALE;
+
+		if ( isset( $this->app ) && $this->app->bound( Generator::class ) ) {
+			return $this->app->make( Generator::class, [ 'locale' => $locale ] );
+		}
+
+		return Factory::create( $locale );
+	}
+}

tests/testing/test-with-faker.php

@@ -0,0 +1,13 @@
+<?php
+namespace Mantle\Testing;
+
+use Faker\Generator;
+use Mantle\Testing\Concerns\With_Faker;
+
+class Test_With_Faker extends Framework_Test_Case {
+	use With_Faker;
+
+	public function test_creates_faker() {
+		$this->assertInstanceOf( Generator::class, $this->faker );
+	}
+}

tests/testkit/test-with-faker.php

@@ -0,0 +1,14 @@
+<?php
+namespace Mantle\Tests\Testkit;
+
+use Faker\Generator;
+use Mantle\Testing\Concerns\With_Faker;
+use Mantle\Testkit\Test_Case;
+
+class Test_With_Faker extends Test_Case {
+	use With_Faker;
+
+	public function test_creates_faker() {
+		$this->assertInstanceOf( Generator::class, $this->faker );
+	}
+}