* * For the full copyright and license information, please view * the LICENSE file that was distributed with this source code. */ namespace Nexus\PHPUnit\Tachycardia\Metadata\Parser; use Nexus\PHPUnit\Tachycardia\Metadata\LimitCollection; use Nexus\PHPUnit\Tachycardia\Metadata\NoTimeLimitForClass; use Nexus\PHPUnit\Tachycardia\Metadata\NoTimeLimitForMethod; use Nexus\PHPUnit\Tachycardia\Metadata\TimeLimitForClass; use Nexus\PHPUnit\Tachycardia\Metadata\TimeLimitForMethod; /** * @internal */ final class AnnotationParser implements Parser { /** * @var array>> */ private array $classDocblocks = []; /** * @var array>>> */ private array $methodDocblocks = []; public function forClass(string $className): LimitCollection { $limits = []; foreach ($this->parseClassName($className) as $annotation => $values) { switch ($annotation) { case 'noTimeLimit': $limits[] = new NoTimeLimitForClass(); break; case 'timeLimit': $limits[] = new TimeLimitForClass((float) $values[0]); break; } } return LimitCollection::fromArray($limits); } public function forMethod(string $className, string $methodName): LimitCollection { $limits = []; foreach ($this->parseMethodName($className, $methodName) as $annotation => $values) { switch ($annotation) { case 'noTimeLimit': $limits[] = new NoTimeLimitForMethod(); break; case 'timeLimit': $limits[] = new TimeLimitForMethod((float) $values[0]); break; } } return LimitCollection::fromArray($limits); } public function forClassAndMethod(string $className, string $methodName): LimitCollection { return $this->forClass($className)->mergeWith($this->forMethod($className, $methodName)); } /** * @param class-string $class * * @return array> */ private function parseClassName(string $class): array { if (\array_key_exists($class, $this->classDocblocks)) { return $this->classDocblocks[$class]; } $reflection = new \ReflectionClass($class); $annotations = array_merge( self::parseDocComment((string) $reflection->getDocComment()), ...array_map( static fn(\ReflectionClass $trait): array => self::parseDocComment((string) $trait->getDocComment()), array_values($reflection->getTraits()), ), ); $this->classDocblocks[$class] = $annotations; return $annotations; } /** * @param class-string $class * @param non-empty-string $method * * @return array> */ private function parseMethodName(string $class, string $method): array { if (isset($this->methodDocblocks[$class][$method])) { return $this->methodDocblocks[$class][$method]; } $reflection = new \ReflectionMethod($class, $method); $annotations = self::parseDocComment((string) $reflection->getDocComment()); $this->methodDocblocks[$class][$method] = $annotations; return $annotations; } /** * @return array> */ private static function parseDocComment(string $docComment): array { $docComment = substr($docComment, 3, -2); $annotations = []; if (preg_match_all('/@(?P[A-Za-z_-]+)(?:[ \t]+(?P.*?))?[ \t]*\r?$/m', $docComment, $matches) > 0) { $numMatches = \count($matches[0]); for ($i = 0; $i < $numMatches; ++$i) { $annotations[$matches['name'][$i]][] = $matches['value'][$i]; } } return $annotations; } }