README

faker-php-number-helpers

Adds a helper trait that makes it easier to generate random numbers using FakerPHP.

Index

• Installation
• Usage
• Available methods
  • Integer generation
  • Float generation
• Next float number
• API Documentation

Installation

Use it as a production dependency

composer require marcoconsiglio/faker-php-number-helpers

or a development dependency

composer require --dev marcoconsiglio/faker-php-number-helpers

Usage

Add the trait to a TestCase class if you use this library in your tests project written in PHPUnit, otherwise add it wherever you need it.

<?php
namespace MyCompany\Project\Tests\Unit;

use MarcoConsiglio\FakerPhpNumberHelpers\WithFakerHelpers;
use PHPUnit\Framework\TestCase;

class MyUnitTestCase extends TestCase
{
    use WithFakerHelpers;

    protected function setUp(): void
    {
        parent::setUp();
        // Set up faker before using the methods in the trait
        // with your needed locale.
        $this->setUpFaker("en_GB");
    }

    public function test_example(): void
    {
        // Arrange
        $int = $this->randomInteger(); // 45465
        $float = $this->randomFloat(); // 89354.454687684
    }
}

In some tests, you'll need a PHPUnit data provider, which is a static function. In this case you can call statically setUpFaker() method in order to set up a static Faker\Generator when PHPUnit call the data provider method, which is done prior to call the setUp() method.

<?php
namespace MyCompany\Project\Tests\Unit;

use MarcoConsiglio\FakerPhpNumberHelpers\WithFakerHelpers;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;

class MyUnitTestCase extends TestCase
{
    use WithFakerHelpers;

    /**
     * This won't work as this method is called after
     * myDataProvider().
     */
    protected function setUp(): void
    {
        parent::setUp();
        $this->setUpFaker(); // Too late!
    }

    public static function myDataProvider(): array
    {
        self::setUpFaker(); // Early call!
        return [
            [self::randomInteger()]
        ];
    }
    
    #[DataProvider("myDataProvider")]
    public function test_something(int $number): void
    {
        // Act & Assert
        $this->assertIsInt($number);
    }
}

Constants

Several constants provide the limit for random generation.

Integers

Floats

Available methods

Integer generation

Float generation

Next float number

Some times you need to have the previous/next representable float adjacent to a specific number.

To solve this problem you can use the NextFloat class, which is a convenient wrapper of the nsfisis/php-next-after library.

<?php
namespace MyCompany\Project;

use MarcoConsiglio\FakerPhpNumberHelpers\NextFloat;

class MyClass
{
    /**
     *  Return the next representable `float` near 3.5.
     */
    public function nextFloat(): float
    {
        return NextFloat::after(3.5);
    }
}

API Documentation

See more in the API Documentation at ./docs/html/index.html.