mokoplatform/validate/check_dolibarr_module.php

#!/usr/bin/env php
<?php

/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * This file is part of a Moko Consulting project.
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Scripts.Validate
 * INGROUP: MokoPlatform
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
 * PATH: /validate/check_dolibarr_module.php
 * BRIEF: Validates Dolibarr module directory structure
 */

declare(strict_types=1);

require_once __DIR__ . '/../vendor/autoload.php';

use MokoEnterprise\{CliFramework, SourceResolver};

/**
 * Validates the required directory structure of a Dolibarr module repository.
 */
class CheckDolibarrModule extends CliFramework
{
    /**
     * Configure available arguments.
     */
    protected function configure(): void
    {
        $this->setDescription('Validates Dolibarr module directory structure');
        $this->addArgument('--path', 'Repository path to check', '.');
    }

    /**
     * Run the Dolibarr module validation.
     *
     * @return int  Exit code: 0 on pass, 1 on failure.
     */
    protected function run(): int
    {
        $path   = $this->getArgument('--path');
        $passed = 0;
        $failed = 0;

        $this->section('Checking directory structure');
        $srcName = SourceResolver::resolve($path);
        SourceResolver::warnIfLegacy($path);

        $srcDir = SourceResolver::resolveAbsolute($path);
        if ($srcDir === null) {
            $this->status(false, 'source/ or src/ directory exists');
            $failed++;
        } else {
            $this->status(true, "{$srcName}/ directory exists");
            $passed++;
        }

        if (!is_dir($path . "/{$srcName}/core/modules")) {
            $this->status(false, "{$srcName}/core/modules/ directory exists");
            $failed++;
        } else {
            $this->status(true, "{$srcName}/core/modules/ directory exists");
            $passed++;
        }

        if (!is_dir($path . "/{$srcName}/langs")) {
            $this->warning("Missing suggested directory: {$srcName}/langs/");
        } else {
            $this->status(true, "{$srcName}/langs/ directory exists");
            $passed++;
        }

        $this->section('Checking module descriptor');

        $descriptors = glob($path . "/{$srcName}/core/modules/mod*.class.php") ?: [];
        if (empty($descriptors)) {
            $this->status(false, 'Module descriptor found (mod*.class.php)');
            $failed++;
        } else {
            $this->status(true, 'Module descriptor found', basename($descriptors[0]));
            $passed++;
        }

        $this->printSummary($passed, $failed, $this->elapsed());

        if ($failed > 0) {
            return 1;
        }

        return 0;
    }
}

$script = new CheckDolibarrModule('check_dolibarr_module', 'Validates Dolibarr module directory structure');
exit($script->execute());