mirrors/PocketMine-MP
1
0
Fork 0
mirror of https://github.com/pmmp/PocketMine-MP.git synced 2025-09-08 10:53:05 +00:00
Code Issues Projects Releases Wiki Activity

Move code & docblock generation methods out of RegistryTrait

Browse Source 
this allows generating a docblock / code for a registry without the class needing to exist or be populated yet, which makes code generation significantly less cumbersome.
This commit is contained in:
Dylan K. Taylor
2020-08-07 21:43:19 +01:00
parent ff2a3baa8e
commit 192e31a397
2 changed files with 80 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
src/utils/RegistryTrait.php
View File

@ -112,55 +112,4 @@ trait RegistryTrait{
return self::preprocessMember($o);
}, self::$members);
}
/**
* Generates code for static methods for all known registry members.
*/
public static function _generateGetters() : string{
$lines = [];
static $fnTmpl = '
public static function %1$s() : %2$s{
return self::fromString("%1$s");
}';
foreach(self::_registryGetAll() as $name => $member){
$lines[] = sprintf($fnTmpl, $name, '\\' . get_class($member));
}
return "//region auto-generated code\n" . implode("\n", $lines) . "\n\n//endregion\n";
}
/**
* Generates a block of @ method annotations for accessors for this registry's known members.
*/
public static function _generateMethodAnnotations() : string{
$traitName = (new \ReflectionClass(__TRAIT__))->getShortName();
$fnName = (new \ReflectionMethod(__METHOD__))->getShortName();
$lines = ["/**"];
$lines[] = " * This doc-block is generated automatically, do not modify it manually.";
$lines[] = " * This must be regenerated whenever registry members are added, removed or changed.";
$lines[] = " * @see $traitName::$fnName()";
$lines[] = " *";
static $lineTmpl = " * @method static %2\$s %s()";
$thisNamespace = (new \ReflectionClass(__CLASS__))->getNamespaceName();
foreach(self::_registryGetAll() as $name => $member){
$reflect = new \ReflectionClass($member);
while($reflect !== false and $reflect->isAnonymous()){
$reflect = $reflect->getParentClass();
}
if($reflect === false){
$typehint = "object";
}elseif($reflect->getName() === __CLASS__){
$typehint = "self";
}elseif(strpos($reflect->getName(), $thisNamespace) === 0){
$typehint = substr($reflect->getName(), strlen($thisNamespace . '\\'));
}else{
$typehint = '\\' . $reflect->getName();
}
$lines[] = sprintf($lineTmpl, $name, $typehint);
}
$lines[] = " */\n";
return implode("\n", $lines);
}
}