Sample\Application::showBasicUsage()

Complexity

Conditions	5
Paths	16

Size

Total Lines	66
Code Lines	34

Duplication

Lines	10
Ratio	15.15 %

Importance

Changes

0

<?php namespace Sample;
    private function showSingleValueValidation(): void
    {
        $this->console('Basic usage sample.' . PHP_EOL);
        $this->console('===================' . PHP_EOL);

        // Let's build a rule that validates an input to be either `null` or a string from 5 to 10 characters.
        $validator = v::validator(
            r::nullable(r::isString(r::stringLengthBetween(5, 10)))
        );

        // let's try validation with valid input
        $input = null;
        if ($validator->validate($input) === true) {

This code seems to be duplicated across your project.

            $this->console("Validation OK for `null`." . PHP_EOL);
        } else {
            assert(false, 'We should not be here.');
        }
        // another one
        $input = 'Hello';
        if ($validator->validate($input) === true) {

This code seems to be duplicated across your project.

            $this->console("Validation OK for `$input`." . PHP_EOL);
        } else {
            assert(false, 'We should not be here.');
        }
        // this one should not pass the validation
        $input = 'This string is too long.';
        if ($validator->validate($input) === false) {
            $this->console("Input `$input` has not passed validation." . PHP_EOL);
            $this->printErrors($validator->getErrors());
        } else {
            assert(false, 'We should not be here.');
        }

        // next example demonstrates
        // - parsing strings as dates
        // - validation for dates
        // - data capture so you don't need to parse the input second time after validation
        $fromDate  = new DateTime('2001-02-03');
        $toDate    = new DateTime('2001-04-05');
        $validator = v::validator(
            r::isString(r::stringToDateTime(DATE_ATOM, r::between($fromDate, $toDate)))
                ->setName('my_date')->enableCapture()
        );
        $input     = '2001-03-04T05:06:07+08:00';
        if ($validator->validate($input) === true) {
            $this->console("Validation OK for `$input`." . PHP_EOL);
            $myDate = $validator->getCaptures()->get()['my_date'];
            // note that captured date is already DateTime
            assert($myDate instanceof DateTimeInterface);
        } else {
            assert(false, 'We should not be here.');
        }

        $this->console(PHP_EOL . PHP_EOL . PHP_EOL);

        // The output would be
        // -------------------------------------------------------------------------------------------------------
        // Basic usage sample.
        // ===================
        // Validation OK for `null`.
        // Validation OK for `Hello`.
        // Input `This string is too long to pass validation.` has not passed validation.
        // Validation failed for `This string is too long.` with: The value should be between 5 and 10 characters.
        // Validation OK for `2001-03-04T05:06:07+08:00`.
        // -------------------------------------------------------------------------------------------------------
    }