add

2026-01-28 23:48:20 +08:00
commit b8cd0c9418
1293 changed files with 184011 additions and 0 deletions
@@ -0,0 +1,106 @@
+<?php
+
+/**
+ * This file is part of the Nette Framework (https://nette.org)
+ * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
+ */
+
+declare(strict_types=1);
+
+namespace Nette\PhpGenerator;
+
+use Nette;
+
+
+/**
+ * @internal
+ */
+final class Helpers
+{
+	use Nette\StaticClass;
+
+	public const PHP_IDENT = '[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*';
+
+
+	/** @deprecated  use Nette\PhpGenerator\Dumper::dump() */
+	public static function dump($var): string
+	{
+		return (new Dumper)->dump($var);
+	}
+
+
+	/** @deprecated  use Nette\PhpGenerator\Dumper::format() */
+	public static function format(string $statement, ...$args): string
+	{
+		return (new Dumper)->format($statement, ...$args);
+	}
+
+
+	/** @deprecated  use Nette\PhpGenerator\Dumper::format() */
+	public static function formatArgs(string $statement, array $args): string
+	{
+		return (new Dumper)->format($statement, ...$args);
+	}
+
+
+	public static function formatDocComment(string $content): string
+	{
+		if (($s = trim($content)) === '') {
+			return '';
+		} elseif (strpos($content, "\n") === false) {
+			return "/** $s */\n";
+		} else {
+			return str_replace("\n", "\n * ", "/**\n$s") . "\n */\n";
+		}
+	}
+
+
+	public static function unformatDocComment(string $comment): string
+	{
+		return preg_replace('#^\s*\* ?#m', '', trim(trim(trim($comment), '/*')));
+	}
+
+
+	public static function unindent(string $s, int $level = 1): string
+	{
+		return preg_replace('#^(\t|\ \ \ \ ){1,' . $level . '}#m', '', $s);
+	}
+
+
+	public static function isIdentifier($value): bool
+	{
+		return is_string($value) && preg_match('#^' . self::PHP_IDENT . '$#D', $value);
+	}
+
+
+	public static function isNamespaceIdentifier($value, bool $allowLeadingSlash = false): bool
+	{
+		$re = '#^' . ($allowLeadingSlash ? '\\\\?' : '') . self::PHP_IDENT . '(\\\\' . self::PHP_IDENT . ')*$#D';
+		return is_string($value) && preg_match($re, $value);
+	}
+
+
+	public static function extractNamespace(string $name): string
+	{
+		return ($pos = strrpos($name, '\\')) ? substr($name, 0, $pos) : '';
+	}
+
+
+	public static function extractShortName(string $name): string
+	{
+		return ($pos = strrpos($name, '\\')) === false ? $name : substr($name, $pos + 1);
+	}
+
+
+	public static function tabsToSpaces(string $s, int $count = 4): string
+	{
+		return str_replace("\t", str_repeat(' ', $count), $s);
+	}
+
+
+	/** @internal */
+	public static function createObject(string $class, array $props)
+	{
+		return Dumper::createObject($class, $props);
+	}
+}