Version 1
[yaffs-website] / vendor / psy / psysh / src / Psy / ParserFactory.php
diff --git a/vendor/psy/psysh/src/Psy/ParserFactory.php b/vendor/psy/psysh/src/Psy/ParserFactory.php
new file mode 100644 (file)
index 0000000..83f1539
--- /dev/null
@@ -0,0 +1,91 @@
+<?php
+
+/*
+ * This file is part of Psy Shell.
+ *
+ * (c) 2012-2017 Justin Hileman
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Psy;
+
+use PhpParser\Lexer;
+use PhpParser\Parser;
+use PhpParser\ParserFactory as OriginalParserFactory;
+
+/**
+ * Parser factory to abstract over PHP parser library versions.
+ */
+class ParserFactory
+{
+    const ONLY_PHP5   = 'ONLY_PHP5';
+    const ONLY_PHP7   = 'ONLY_PHP7';
+    const PREFER_PHP5 = 'PREFER_PHP5';
+    const PREFER_PHP7 = 'PREFER_PHP7';
+
+    /**
+     * Possible kinds of parsers for the factory, from PHP parser library.
+     *
+     * @return array
+     */
+    public static function getPossibleKinds()
+    {
+        return array('ONLY_PHP5', 'ONLY_PHP7', 'PREFER_PHP5', 'PREFER_PHP7');
+    }
+
+    /**
+     * Is this parser factory supports kinds?
+     *
+     * PHP parser < 2.0 doesn't support kinds, >= 2.0 — does.
+     *
+     * @return bool
+     */
+    public function hasKindsSupport()
+    {
+        return class_exists('PhpParser\ParserFactory');
+    }
+
+    /**
+     * Default kind (if supported, based on current interpreter's version).
+     *
+     * @return string|null
+     */
+    public function getDefaultKind()
+    {
+        if ($this->hasKindsSupport()) {
+            return version_compare(PHP_VERSION, '7.0', '>=') ? static::ONLY_PHP7 : static::ONLY_PHP5;
+        }
+    }
+
+    /**
+     * New parser instance with given kind.
+     *
+     * @param string|null $kind One of class constants (only for PHP parser 2.0 and above)
+     *
+     * @return Parser
+     */
+    public function createParser($kind = null)
+    {
+        if ($this->hasKindsSupport()) {
+            $originalFactory = new OriginalParserFactory();
+
+            $kind = $kind ?: $this->getDefaultKind();
+
+            if (!in_array($kind, static::getPossibleKinds())) {
+                throw new \InvalidArgumentException('Unknown parser kind');
+            }
+
+            $parser = $originalFactory->create(constant('PhpParser\ParserFactory::' . $kind));
+        } else {
+            if ($kind !== null) {
+                throw new \InvalidArgumentException('Install PHP Parser v2.x to specify parser kind');
+            }
+
+            $parser = new Parser(new Lexer());
+        }
+
+        return $parser;
+    }
+}