marked new deprecated stuff

Author: dg

composer.json

@@ -25,7 +25,7 @@
 		"phpstan/phpstan": "^1.0"
 	},
 	"suggest": {
-		"nikic/php-parser": "to use ClassType::withBodiesFrom() & GlobalFunction::withBodyFrom()"
+		"nikic/php-parser": "to use ClassType::from(withBodies: true) & ClassType::fromCode()"
 	},
 	"autoload": {
 		"classmap": ["src/"]

readme.md

@@ -721,9 +721,9 @@ Function and method bodies are empty by default. If you want to load them as wel
 (it requires `nikic/php-parser` to be installed):
 
 ```php
-$class = Nette\PhpGenerator\ClassType::withBodiesFrom(MyClass::class);
+$class = Nette\PhpGenerator\ClassType::from(PDO::class, withBodies: true);
 
-$function = Nette\PhpGenerator\GlobalFunction::withBodyFrom('dump');
+$function = Nette\PhpGenerator\GlobalFunction::from('dump', withBody: true);
 ```
 
 Load class from file

src/PhpGenerator/ClassType.php

@@ -99,8 +99,10 @@ public static function from(string|object $class, bool $withBodies = false, bool
 	}
 
 
+	/** @deprecated  use ClassType::from(..., withBodies: true) */
 	public static function withBodiesFrom(string|object $class): self
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use ClassType::from(..., withBodies: true)', E_USER_DEPRECATED);
 		return (new Factory)
 			->fromClassReflection(new \ReflectionClass($class), withBodies: true);
 	}
@@ -150,9 +152,10 @@ public function getName(): ?string
 	}
 
 
-	/** @deprecated */
+	/** @deprecated  use setType('class') or create using ClassType::class() */
 	public function setClass(): static
 	{
+		trigger_error(__METHOD__ . "() is deprecated, use setType('class').", E_USER_DEPRECATED);
 		$this->type = self::TYPE_CLASS;
 		return $this;
 	}
@@ -164,8 +167,10 @@ public function isClass(): bool
 	}
 
 
+	/** @deprecated  use setType('interface') or create using ClassType::interface() */
 	public function setInterface(): static
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use $class->setType($class::TYPE_INTERFACE) or create object using ClassType::interface()', E_USER_DEPRECATED);
 		$this->type = self::TYPE_INTERFACE;
 		return $this;
 	}
@@ -177,8 +182,10 @@ public function isInterface(): bool
 	}
 
 
+	/** @deprecated  use setType('trait') or create using ClassType::trait() */
 	public function setTrait(): static
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use $class->setType($class::TYPE_TRAIT) or create object using ClassType::trait()', E_USER_DEPRECATED);
 		$this->type = self::TYPE_TRAIT;
 		return $this;
 	}

src/PhpGenerator/GlobalFunction.php

@@ -31,8 +31,10 @@ public static function from(string $function, bool $withBody = false): self
 	}
 
 
+	/** @deprecated  use GlobalFunction::from(..., withBody: true) */
 	public static function withBodyFrom(string $function): self
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use GlobalFunction::from(..., withBody: true)', E_USER_DEPRECATED);
 		return (new Factory)->fromFunctionReflection(new \ReflectionFunction($function), withBody: true);
 	}
 

src/PhpGenerator/Helpers.php

@@ -51,20 +51,23 @@ final class Helpers
 	/** @deprecated  use (new Nette\PhpGenerator\Dumper)->dump() */
 	public static function dump($var): string
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->dump().', E_USER_DEPRECATED);
 		return (new Dumper)->dump($var);
 	}
 
 
 	/** @deprecated  use (new Nette\PhpGenerator\Dumper)->format() */
 	public static function format(string $statement, ...$args): string
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->format().', E_USER_DEPRECATED);
 		return (new Dumper)->format($statement, ...$args);
 	}
 
 
 	/** @deprecated  use (new Nette\PhpGenerator\Dumper)->format() */
 	public static function formatArgs(string $statement, array $args): string
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->format().', E_USER_DEPRECATED);
 		return (new Dumper)->format($statement, ...$args);
 	}
 

src/PhpGenerator/Parameter.php

@@ -62,13 +62,15 @@ public function getType(bool $asObject = false): Type|string|null
 	/** @deprecated  use setType() */
 	public function setTypeHint(?string $type): static
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use setType().', E_USER_DEPRECATED);
 		return $this->setType($type);
 	}
 
 
 	/** @deprecated  use getType() */
 	public function getTypeHint(): ?string
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use getType().', E_USER_DEPRECATED);
 		return $this->getType();
 	}
 

src/PhpGenerator/PhpFile.php

@@ -153,6 +153,7 @@ public function hasStrictTypes(): bool
 	/** @deprecated  use hasStrictTypes() */
 	public function getStrictTypes(): bool
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use hasStrictTypes().', E_USER_DEPRECATED);
 		return $this->strictTypes;
 	}
 

src/PhpGenerator/PhpLiteral.php

@@ -10,6 +10,7 @@
 namespace Nette\PhpGenerator;
 
 
+/** @deprecated  use Nette\PhpGenerator\Literal */
 class PhpLiteral extends Literal
 {
 }

src/PhpGenerator/PhpNamespace.php

@@ -83,6 +83,7 @@ public function hasBracketedSyntax(): bool
 	/** @deprecated  use hasBracketedSyntax() */
 	public function getBracketedSyntax(): bool
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use hasBracketedSyntax().', E_USER_DEPRECATED);
 		return $this->bracketedSyntax;
 	}
 
@@ -157,6 +158,7 @@ public function getUses(string $of = self::NAME_NORMAL): array
 	/** @deprecated  use simplifyName() */
 	public function unresolveName(string $name): string
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use simplifyName()', E_USER_DEPRECATED);
 		return $this->simplifyName($name);
 	}
 

src/PhpGenerator/Traits/FunctionLike.php

@@ -155,6 +155,7 @@ public function isReturnNullable(): bool
 	/** @deprecated  use isReturnNullable() */
 	public function getReturnNullable(): bool
 	{
+		trigger_error(__METHOD__ . '() is deprecated, use isReturnNullable().', E_USER_DEPRECATED);
 		return $this->returnNullable;
 	}
 }