functions.php

<?php
/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */
/**
 * Italix Rules - Helper Functions
 *
 * @package Italix\Rules
 * @license MPL-2.0
 */

declare(strict_types=1);

namespace Italix\Rules;

/**
 * Create a new Checker.
 *
 * For applications with a container, prefer registering Checker as a service
 * and injecting it — this helper is for scripts, tests and templates, where
 * wiring a container would be more ceremony than the job deserves.
 *
 * @param string                      $country_c          Default country, e.g. 'IT'
 * @param bool                        $check_email_dns    Allow MX/A lookups on e-mail domains
 * @param MunicipalityCodeSource|null $municipality_codes Reference data for tax codes, if available
 * @return Checker
 */
function checker(
    string $country_c = 'IT',
    bool $check_email_dns = false,
    ?MunicipalityCodeSource $municipality_codes = null
): Checker {
    return new Checker($country_c, $check_email_dns, $municipality_codes);
}