nur-sery/nur_src/m/cli/UpdateMigrationsApp.php

165 lines
5.8 KiB
PHP
Raw Normal View History

2023-12-03 22:10:18 +04:00
<?php
namespace nur\m\cli;
use nur\A;
use nur\b\ValueException;
use nur\cli\Application;
use nur\data\types\Metadata;
abstract class UpdateMigrationsApp extends Application {
function trace(string $line): void {
echo "$line\n";
}
/**
* @var string répertoire de base pour la génération des fichiers (i.e chemin
* du projet)
*/
const BASEDIR = null;
/** @var Metadata */
private static $database_md;
private static function database_md(): Metadata {
if (self::$database_md === null) {
self::$database_md = new Metadata([
"class" => ["?string", null, "classe de migration qui contient les définitions"],
"sql_dir" => ["?string", null, "chemin relatif dans lequel générer les migrations SQL e.g. 'config/sqlmig/DATABASE'"],
"sql_prefix" => ["bool", null, ""],
"doc_dir" => ["?string", null, "chemin relatif dans lequel générer la doc e.g. 'doc'"],
"class_dir" => ["?string", null, "chemin relatif dans lequel générer les classes de DAO e.g. 'src/m'"],
"class_package" => ["?string", null, "package des classes DAO, exprimé relativement au package de la classe qui contient les définitions"],
"class_baserow" => ["?string", null, "classe de base pour les classes DAO"],
]);
}
return self::$database_md;
}
/** @var array base de données dont il faut faire la migration */
const DATABASE = null;
/**
* @var array liste des bases de données supplémentaires dont il faut faire la
* migration
*/
const DATABASES = null;
2024-06-14 11:25:34 +04:00
/** @var bool valeur par défaut de $doSql si aucun argument n'est spécifié */
const DO_SQL = true;
/** @var bool valeur par défaut de $doClass si aucun argument n'est spécifié */
const DO_CLASS = true;
/** @var bool valeur par défaut de $doDoc si aucun argument n'est spécifié */
const DO_DOC = true;
2023-12-03 22:10:18 +04:00
const MIGRATE_PARAMS_SCHEMA = [
"basedir" => ["?string", null, "chemin absolu du projet"],
"overwrite" => ["?bool", null, "faut-il regénérer les fichier?"],
"verbose" => ["bool", null, "faut-il activer l'affichage verbeux"],
"class" => ["?string", null, "cf database_schema"],
"do_sql" => ["bool", null, "faut-il générer les fichiers SQL"],
"sql_dir" => ["?string", null, "cf database_schema"],
"sql_prefix" => ["bool", null, "cf database_schema"],
"class_dir" => ["?string", null, "cf database_schema"],
"class_package" => ["?string", null, "cf database_schema"],
"class_baserow" => ["?string", null, "cf database_schema"],
2024-06-14 11:25:34 +04:00
"do_doc" => ["bool", null, "faut-il générer la documentation"],
"doc_dir" => ["?string", null, "cf database_schema"],
"do_class" => ["bool", null, "faut-il générer les classes DAO"],
2023-12-03 22:10:18 +04:00
];
protected abstract function migrate(array $params);
const ARGS = [
["group",
["-o", "--overwrite", "name" => "overwrite", "value" => true,
"help" => "forcer (resp. interdire) l'écrasement des fichier générés",
],
["-k", "--keep", "name" => "overwrite", "value" => false],
],
["-v", "--verbose", "name" => "verbose", "value" => true,
"help" => "mode verbeux",
],
["-b", "--basedir", "arg" => "dir",
"help" => "répertoire de base pour la génération des fichiers",
],
["-s", "--sql-only", "name" => "do_sql", "value" => true,
"help" => "ne faire que la génération des fichiers SQL",
],
["-c", "--class-only", "name" => "do_class", "value" => true,
"help" => "ne faire que la génération des fichiers DAO",
],
2024-06-14 11:25:34 +04:00
["-d", "--doc-only", "name" => "do_doc", "value" => true,
"help" => "ne faire que la génération de la documentation",
],
2023-12-03 22:10:18 +04:00
["group",
["-l", "--select", "arg" => "value", "name" => "select",
"help" => "sélectionner une base de données en particulier"
],
["-1", "--first", "name" => "select", "value" => 1],
["-2", "--second", "name" => "select", "value" => 2],
],
];
/** @var ?string */
protected $overwrite = null;
protected $verbose = false;
protected $basedir;
2024-06-14 11:25:34 +04:00
protected $doSql = null;
protected $doClass = null;
protected $doDoc = null;
2023-12-03 22:10:18 +04:00
protected $select;
function main() {
$overwrite = $this->overwrite;
$verbose = $this->verbose;
$basedir = $this->basedir;
if ($basedir === null) $basedir = static::BASEDIR;
if ($basedir === null) throw new ValueException("Vous devez spécifier --basedir");
$doSql = $this->doSql;
$doClass = $this->doClass;
2024-06-14 11:25:34 +04:00
$doDoc = $this->doDoc;
if ($doSql === null && $doDoc === null && $doClass === null) {
$doSql = static::DO_SQL;
$doClass = static::DO_CLASS;
$doDoc = static::DO_DOC;
2023-12-03 22:10:18 +04:00
}
$databases = [];
A::append_nn($databases, static::DATABASE);
A::merge_nn($databases, static::DATABASES);
$select = $this->select;
if ($select !== null) {
if (is_numeric($select)) {
$index = $select - 1;
$database = A::nth($databases, $index);
if ($database === null) throw new ValueException("$select: index invalide");
} else {
$database = A::get($databases, $select);
if ($database === null) throw new ValueException("$select: base de donnée invalide");
}
$databases = [$database];
}
self::database_md()->eachEnsureSchema($databases);
foreach ($databases as $database) {
$this->migrate([
"class" => $database["class"],
"overwrite" => $overwrite,
"verbose" => $verbose,
"basedir" => $basedir,
"do_sql" => $doSql,
"sql_dir" => $database["sql_dir"],
"sql_prefix" => $database["sql_prefix"],
"do_class" => $doClass,
"class_dir" => $database["class_dir"],
"class_package" => $database["class_package"],
"class_baserow" => $database["class_baserow"],
2024-06-14 11:25:34 +04:00
"do_doc" => $doDoc,
"doc_dir" => $database["doc_dir"],
2023-12-03 22:10:18 +04:00
]);
}
}
}