Upgrade framework

vendor/psy/psysh/src/Sudo.php

@@ -0,0 +1,192 @@
+<?php
+
+/*
+ * This file is part of Psy Shell.
+ *
+ * (c) 2012-2022 Justin Hileman
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Psy;
+
+/**
+ * Helpers for bypassing visibility restrictions, mostly used in code generated
+ * by the `sudo` command.
+ */
+class Sudo
+{
+    /**
+     * Fetch a property of an object, bypassing visibility restrictions.
+     *
+     * @param object $object
+     * @param string $property property name
+     *
+     * @return mixed Value of $object->property
+     */
+    public static function fetchProperty($object, string $property)
+    {
+        $prop = self::getProperty(new \ReflectionObject($object), $property);
+
+        return $prop->getValue($object);
+    }
+
+    /**
+     * Assign the value of a property of an object, bypassing visibility restrictions.
+     *
+     * @param object $object
+     * @param string $property property name
+     * @param mixed  $value
+     *
+     * @return mixed Value of $object->property
+     */
+    public static function assignProperty($object, string $property, $value)
+    {
+        $prop = self::getProperty(new \ReflectionObject($object), $property);
+        $prop->setValue($object, $value);
+
+        return $value;
+    }
+
+    /**
+     * Call a method on an object, bypassing visibility restrictions.
+     *
+     * @param object $object
+     * @param string $method  method name
+     * @param mixed  $args...
+     *
+     * @return mixed
+     */
+    public static function callMethod($object, string $method, ...$args)
+    {
+        $refl = new \ReflectionObject($object);
+        $reflMethod = $refl->getMethod($method);
+        $reflMethod->setAccessible(true);
+
+        return $reflMethod->invokeArgs($object, $args);
+    }
+
+    /**
+     * Fetch a property of a class, bypassing visibility restrictions.
+     *
+     * @param string|object $class    class name or instance
+     * @param string        $property property name
+     *
+     * @return mixed Value of $class::$property
+     */
+    public static function fetchStaticProperty($class, string $property)
+    {
+        $prop = self::getProperty(new \ReflectionClass($class), $property);
+        $prop->setAccessible(true);
+
+        return $prop->getValue();
+    }
+
+    /**
+     * Assign the value of a static property of a class, bypassing visibility restrictions.
+     *
+     * @param string|object $class    class name or instance
+     * @param string        $property property name
+     * @param mixed         $value
+     *
+     * @return mixed Value of $class::$property
+     */
+    public static function assignStaticProperty($class, string $property, $value)
+    {
+        $prop = self::getProperty(new \ReflectionClass($class), $property);
+        $prop->setValue($value);
+
+        return $value;
+    }
+
+    /**
+     * Call a static method on a class, bypassing visibility restrictions.
+     *
+     * @param string|object $class   class name or instance
+     * @param string        $method  method name
+     * @param mixed         $args...
+     *
+     * @return mixed
+     */
+    public static function callStatic($class, string $method, ...$args)
+    {
+        $refl = new \ReflectionClass($class);
+        $reflMethod = $refl->getMethod($method);
+        $reflMethod->setAccessible(true);
+
+        return $reflMethod->invokeArgs(null, $args);
+    }
+
+    /**
+     * Fetch a class constant, bypassing visibility restrictions.
+     *
+     * @param string|object $class class name or instance
+     * @param string        $const constant name
+     *
+     * @return mixed
+     */
+    public static function fetchClassConst($class, string $const)
+    {
+        $refl = new \ReflectionClass($class);
+
+        do {
+            if ($refl->hasConstant($const)) {
+                return $refl->getConstant($const);
+            }
+
+            $refl = $refl->getParentClass();
+        } while ($refl !== false);
+
+        return false;
+    }
+
+    /**
+     * Construct an instance of a class, bypassing private constructors.
+     *
+     * @param string $class   class name
+     * @param mixed  $args...
+     */
+    public static function newInstance(string $class, ...$args)
+    {
+        $refl = new \ReflectionClass($class);
+        $instance = $refl->newInstanceWithoutConstructor();
+
+        $constructor = $refl->getConstructor();
+        $constructor->setAccessible(true);
+        $constructor->invokeArgs($instance, $args);
+
+        return $instance;
+    }
+
+    /**
+     * Get a ReflectionProperty from an object (or its parent classes).
+     *
+     * @throws \ReflectionException if neither the object nor any of its parents has this property
+     *
+     * @param \ReflectionClass $refl
+     * @param string           $property property name
+     *
+     * @return \ReflectionProperty
+     */
+    private static function getProperty(\ReflectionClass $refl, string $property): \ReflectionProperty
+    {
+        $firstException = null;
+        do {
+            try {
+                $prop = $refl->getProperty($property);
+                $prop->setAccessible(true);
+
+                return $prop;
+            } catch (\ReflectionException $e) {
+                if ($firstException === null) {
+                    $firstException = $e;
+                }
+
+                $refl = $refl->getParentClass();
+            }
+        } while ($refl !== false);
+
+        throw $firstException;
+    }
+}