@appthreat/atom 2.1.19 → 2.2.0

package/plugins/nikic/php-parser/README.md

@@ -1,225 +0,0 @@
-PHP Parser
-==========
-
-[![Coverage Status](https://coveralls.io/repos/github/nikic/PHP-Parser/badge.svg?branch=master)](https://coveralls.io/github/nikic/PHP-Parser?branch=master)
-
-This is a PHP 5.2 to PHP 8.2 parser written in PHP. Its purpose is to simplify static code analysis and
-manipulation.
-
-[**Documentation for version 4.x**][doc_4_x] (stable; for running on PHP >= 7.0; for parsing PHP 5.2 to PHP 8.2).
-
-[Documentation for version 3.x][doc_3_x] (unsupported; for running on PHP >= 5.5; for parsing PHP 5.2 to PHP 7.2).
-
-Features
---------
-
-The main features provided by this library are:
-
- * Parsing PHP 5, PHP 7, and PHP 8 code into an abstract syntax tree (AST).
-   * Invalid code can be parsed into a partial AST.
-   * The AST contains accurate location information.
- * Dumping the AST in human-readable form.
- * Converting an AST back to PHP code.
-   * Experimental: Formatting can be preserved for partially changed ASTs.
- * Infrastructure to traverse and modify ASTs.
- * Resolution of namespaced names.
- * Evaluation of constant expressions.
- * Builders to simplify AST construction for code generation.
- * Converting an AST into JSON and back.
-
-Quick Start
------------
-
-Install the library using [composer](https://getcomposer.org):
-
-    php composer.phar require nikic/php-parser
-
-Parse some PHP code into an AST and dump the result in human-readable form:
-
-```php
-<?php
-use PhpParser\Error;
-use PhpParser\NodeDumper;
-use PhpParser\ParserFactory;
-
-$code = <<<'CODE'
-<?php
-
-function test($foo)
-{
-    var_dump($foo);
-}
-CODE;
-
-$parser = (new ParserFactory)->create(ParserFactory::PREFER_PHP7);
-try {
-    $ast = $parser->parse($code);
-} catch (Error $error) {
-    echo "Parse error: {$error->getMessage()}\n";
-    return;
-}
-
-$dumper = new NodeDumper;
-echo $dumper->dump($ast) . "\n";
-```
-
-This dumps an AST looking something like this:
-
-```
-array(
-    0: Stmt_Function(
-        byRef: false
-        name: Identifier(
-            name: test
-        )
-        params: array(
-            0: Param(
-                type: null
-                byRef: false
-                variadic: false
-                var: Expr_Variable(
-                    name: foo
-                )
-                default: null
-            )
-        )
-        returnType: null
-        stmts: array(
-            0: Stmt_Expression(
-                expr: Expr_FuncCall(
-                    name: Name(
-                        parts: array(
-                            0: var_dump
-                        )
-                    )
-                    args: array(
-                        0: Arg(
-                            value: Expr_Variable(
-                                name: foo
-                            )
-                            byRef: false
-                            unpack: false
-                        )
-                    )
-                )
-            )
-        )
-    )
-)
-```
-
-Let's traverse the AST and perform some kind of modification. For example, drop all function bodies:
-
-```php
-use PhpParser\Node;
-use PhpParser\Node\Stmt\Function_;
-use PhpParser\NodeTraverser;
-use PhpParser\NodeVisitorAbstract;
-
-$traverser = new NodeTraverser();
-$traverser->addVisitor(new class extends NodeVisitorAbstract {
-    public function enterNode(Node $node) {
-        if ($node instanceof Function_) {
-            // Clean out the function body
-            $node->stmts = [];
-        }
-    }
-});
-
-$ast = $traverser->traverse($ast);
-echo $dumper->dump($ast) . "\n";
-```
-
-This gives us an AST where the `Function_::$stmts` are empty:
-
-```
-array(
-    0: Stmt_Function(
-        byRef: false
-        name: Identifier(
-            name: test
-        )
-        params: array(
-            0: Param(
-                type: null
-                byRef: false
-                variadic: false
-                var: Expr_Variable(
-                    name: foo
-                )
-                default: null
-            )
-        )
-        returnType: null
-        stmts: array(
-        )
-    )
-)
-```
-
-Finally, we can convert the new AST back to PHP code:
-
-```php
-use PhpParser\PrettyPrinter;
-
-$prettyPrinter = new PrettyPrinter\Standard;
-echo $prettyPrinter->prettyPrintFile($ast);
-```
-
-This gives us our original code, minus the `var_dump()` call inside the function:
-
-```php
-<?php
-
-function test($foo)
-{
-}
-```
-
-For a more comprehensive introduction, see the documentation.
-
-Documentation
--------------
-
- 1. [Introduction](doc/0_Introduction.markdown)
- 2. [Usage of basic components](doc/2_Usage_of_basic_components.markdown)
-
-Component documentation:
-
- * [Walking the AST](doc/component/Walking_the_AST.markdown)
-   * Node visitors
-   * Modifying the AST from a visitor
-   * Short-circuiting traversals
-   * Interleaved visitors
-   * Simple node finding API
-   * Parent and sibling references
- * [Name resolution](doc/component/Name_resolution.markdown)
-   * Name resolver options
-   * Name resolution context
- * [Pretty printing](doc/component/Pretty_printing.markdown)
-   * Converting AST back to PHP code
-   * Customizing formatting
-   * Formatting-preserving code transformations
- * [AST builders](doc/component/AST_builders.markdown)
-   * Fluent builders for AST nodes
- * [Lexer](doc/component/Lexer.markdown)
-   * Lexer options
-   * Token and file positions for nodes
-   * Custom attributes
- * [Error handling](doc/component/Error_handling.markdown)
-   * Column information for errors
-   * Error recovery (parsing of syntactically incorrect code)
- * [Constant expression evaluation](doc/component/Constant_expression_evaluation.markdown)
-   * Evaluating constant/property/etc initializers
-   * Handling errors and unsupported expressions
- * [JSON representation](doc/component/JSON_representation.markdown)
-   * JSON encoding and decoding of ASTs
- * [Performance](doc/component/Performance.markdown)
-   * Disabling Xdebug
-   * Reusing objects
-   * Garbage collection impact
- * [Frequently asked questions](doc/component/FAQ.markdown)
-   * Parent and sibling references
-
- [doc_3_x]: https://github.com/nikic/PHP-Parser/tree/3.x/doc
- [doc_4_x]: https://github.com/nikic/PHP-Parser/tree/4.x/doc

package/plugins/nikic/php-parser/bin/php-parse

@@ -1,205 +0,0 @@
-#!/usr/bin/env php
-<?php
-
-foreach ([__DIR__ . '/../../../autoload.php', __DIR__ . '/../vendor/autoload.php'] as $file) {
-    if (file_exists($file)) {
-        require $file;
-        break;
-    }
-}
-
-ini_set('xdebug.max_nesting_level', 3000);
-
-// Disable Xdebug var_dump() output truncation
-ini_set('xdebug.var_display_max_children', -1);
-ini_set('xdebug.var_display_max_data', -1);
-ini_set('xdebug.var_display_max_depth', -1);
-
-list($operations, $files, $attributes) = parseArgs($argv);
-
-/* Dump nodes by default */
-if (empty($operations)) {
-    $operations[] = 'dump';
-}
-
-if (empty($files)) {
-    showHelp("Must specify at least one file.");
-}
-
-$lexer = new PhpParser\Lexer\Emulative(['usedAttributes' => [
-    'startLine', 'endLine', 'startFilePos', 'endFilePos', 'comments'
-]]);
-$parser = (new PhpParser\ParserFactory)->create(
-    PhpParser\ParserFactory::PREFER_PHP7,
-    $lexer
-);
-$dumper = new PhpParser\NodeDumper([
-    'dumpComments' => true,
-    'dumpPositions' => $attributes['with-positions'],
-]);
-$prettyPrinter = new PhpParser\PrettyPrinter\Standard;
-
-$traverser = new PhpParser\NodeTraverser();
-$traverser->addVisitor(new PhpParser\NodeVisitor\NameResolver);
-
-foreach ($files as $file) {
-    if (strpos($file, '<?php') === 0) {
-        $code = $file;
-        fwrite(STDERR, "====> Code $code\n");
-    } else {
-        if (!file_exists($file)) {
-            fwrite(STDERR, "File $file does not exist.\n");
-            exit(1);
-        }
-
-        $code = file_get_contents($file);
-        fwrite(STDERR, "====> File $file:\n");
-    }
-
-    if ($attributes['with-recovery']) {
-        $errorHandler = new PhpParser\ErrorHandler\Collecting;
-        $stmts = $parser->parse($code, $errorHandler);
-        foreach ($errorHandler->getErrors() as $error) {
-            $message = formatErrorMessage($error, $code, $attributes['with-column-info']);
-            fwrite(STDERR, $message . "\n");
-        }
-        if (null === $stmts) {
-            continue;
-        }
-    } else {
-        try {
-            $stmts = $parser->parse($code);
-        } catch (PhpParser\Error $error) {
-            $message = formatErrorMessage($error, $code, $attributes['with-column-info']);
-            fwrite(STDERR, $message . "\n");
-            exit(1);
-        }
-    }
-
-    foreach ($operations as $operation) {
-        if ('dump' === $operation) {
-            fwrite(STDERR, "==> Node dump:\n");
-            echo $dumper->dump($stmts, $code), "\n";
-        } elseif ('pretty-print' === $operation) {
-            fwrite(STDERR, "==> Pretty print:\n");
-            echo $prettyPrinter->prettyPrintFile($stmts), "\n";
-        } elseif ('json-dump' === $operation) {
-            fwrite(STDERR, "==> JSON dump:\n");
-            echo json_encode($stmts, JSON_PRETTY_PRINT), "\n";
-        } elseif ('var-dump' === $operation) {
-            fwrite(STDERR, "==> var_dump():\n");
-            var_dump($stmts);
-        } elseif ('resolve-names' === $operation) {
-            fwrite(STDERR, "==> Resolved names.\n");
-            $stmts = $traverser->traverse($stmts);
-        }
-    }
-}
-
-function formatErrorMessage(PhpParser\Error $e, $code, $withColumnInfo) {
-    if ($withColumnInfo && $e->hasColumnInfo()) {
-        return $e->getMessageWithColumnInfo($code);
-    } else {
-        return $e->getMessage();
-    }
-}
-
-function showHelp($error = '') {
-    if ($error) {
-        fwrite(STDERR, $error . "\n\n");
-    }
-    fwrite($error ? STDERR : STDOUT, <<<OUTPUT
-Usage: php-parse [operations] file1.php [file2.php ...]
-   or: php-parse [operations] "<?php code"
-Turn PHP source code into an abstract syntax tree.
-
-Operations is a list of the following options (--dump by default):
-
-    -d, --dump              Dump nodes using NodeDumper
-    -p, --pretty-print      Pretty print file using PrettyPrinter\Standard
-    -j, --json-dump         Print json_encode() result
-        --var-dump          var_dump() nodes (for exact structure)
-    -N, --resolve-names     Resolve names using NodeVisitor\NameResolver
-    -c, --with-column-info  Show column-numbers for errors (if available)
-    -P, --with-positions    Show positions in node dumps
-    -r, --with-recovery     Use parsing with error recovery
-    -h, --help              Display this page
-
-Example:
-    php-parse -d -p -N -d file.php
-
-    Dumps nodes, pretty prints them, then resolves names and dumps them again.
-
-
-OUTPUT
-    );
-    exit($error ? 1 : 0);
-}
-
-function parseArgs($args) {
-    $operations = [];
-    $files = [];
-    $attributes = [
-        'with-column-info' => false,
-        'with-positions' => false,
-        'with-recovery' => false,
-    ];
-
-    array_shift($args);
-    $parseOptions = true;
-    foreach ($args as $arg) {
-        if (!$parseOptions) {
-            $files[] = $arg;
-            continue;
-        }
-
-        switch ($arg) {
-            case '--dump':
-            case '-d':
-                $operations[] = 'dump';
-                break;
-            case '--pretty-print':
-            case '-p':
-                $operations[] = 'pretty-print';
-                break;
-            case '--json-dump':
-            case '-j':
-                $operations[] = 'json-dump';
-                break;
-            case '--var-dump':
-                $operations[] = 'var-dump';
-                break;
-            case '--resolve-names':
-            case '-N';
-                $operations[] = 'resolve-names';
-                break;
-            case '--with-column-info':
-            case '-c';
-                $attributes['with-column-info'] = true;
-                break;
-            case '--with-positions':
-            case '-P':
-                $attributes['with-positions'] = true;
-                break;
-            case '--with-recovery':
-            case '-r':
-                $attributes['with-recovery'] = true;
-                break;
-            case '--help':
-            case '-h';
-                showHelp();
-                break;
-            case '--':
-                $parseOptions = false;
-                break;
-            default:
-                if ($arg[0] === '-') {
-                    showHelp("Invalid operation $arg.");
-                } else {
-                    $files[] = $arg;
-                }
-        }
-    }
-
-    return [$operations, $files, $attributes];
-}

package/plugins/nikic/php-parser/composer.json

@@ -1,41 +0,0 @@
-{
-    "name": "nikic/php-parser",
-    "type": "library",
-    "description": "A PHP parser written in PHP",
-    "keywords": [
-        "php",
-        "parser"
-    ],
-    "license": "BSD-3-Clause",
-    "authors": [
-        {
-            "name": "Nikita Popov"
-        }
-    ],
-    "require": {
-        "php": ">=7.0",
-        "ext-tokenizer": "*"
-    },
-    "require-dev": {
-        "phpunit/phpunit": "^6.5 || ^7.0 || ^8.0 || ^9.0",
-        "ircmaxell/php-yacc": "^0.0.7"
-    },
-    "extra": {
-        "branch-alias": {
-            "dev-master": "4.9-dev"
-        }
-    },
-    "autoload": {
-        "psr-4": {
-            "PhpParser\\": "lib/PhpParser"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "PhpParser\\": "test/PhpParser/"
-        }
-    },
-    "bin": [
-        "bin/php-parse"
-    ]
-}

package/plugins/nikic/php-parser/lib/PhpParser/Builder/ClassConst.php

@@ -1,148 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace PhpParser\Builder;
-
-use PhpParser;
-use PhpParser\BuilderHelpers;
-use PhpParser\Node;
-use PhpParser\Node\Const_;
-use PhpParser\Node\Identifier;
-use PhpParser\Node\Stmt;
-
-class ClassConst implements PhpParser\Builder
-{
-    protected $flags = 0;
-    protected $attributes = [];
-    protected $constants = [];
-
-    /** @var Node\AttributeGroup[] */
-    protected $attributeGroups = [];
-    /** @var Identifier|Node\Name|Node\ComplexType */
-    protected $type;
-
-    /**
-     * Creates a class constant builder
-     *
-     * @param string|Identifier                          $name  Name
-     * @param Node\Expr|bool|null|int|float|string|array $value Value
-     */
-    public function __construct($name, $value) {
-        $this->constants = [new Const_($name, BuilderHelpers::normalizeValue($value))];
-    }
-
-    /**
-     * Add another constant to const group
-     *
-     * @param string|Identifier                          $name  Name
-     * @param Node\Expr|bool|null|int|float|string|array $value Value
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function addConst($name, $value) {
-        $this->constants[] = new Const_($name, BuilderHelpers::normalizeValue($value));
-
-        return $this;
-    }
-
-    /**
-     * Makes the constant public.
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function makePublic() {
-        $this->flags = BuilderHelpers::addModifier($this->flags, Stmt\Class_::MODIFIER_PUBLIC);
-
-        return $this;
-    }
-
-    /**
-     * Makes the constant protected.
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function makeProtected() {
-        $this->flags = BuilderHelpers::addModifier($this->flags, Stmt\Class_::MODIFIER_PROTECTED);
-
-        return $this;
-    }
-
-    /**
-     * Makes the constant private.
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function makePrivate() {
-        $this->flags = BuilderHelpers::addModifier($this->flags, Stmt\Class_::MODIFIER_PRIVATE);
-
-        return $this;
-    }
-
-    /**
-     * Makes the constant final.
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function makeFinal() {
-        $this->flags = BuilderHelpers::addModifier($this->flags, Stmt\Class_::MODIFIER_FINAL);
-
-        return $this;
-    }
-
-    /**
-     * Sets doc comment for the constant.
-     *
-     * @param PhpParser\Comment\Doc|string $docComment Doc comment to set
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function setDocComment($docComment) {
-        $this->attributes = [
-            'comments' => [BuilderHelpers::normalizeDocComment($docComment)]
-        ];
-
-        return $this;
-    }
-
-    /**
-     * Adds an attribute group.
-     *
-     * @param Node\Attribute|Node\AttributeGroup $attribute
-     *
-     * @return $this The builder instance (for fluid interface)
-     */
-    public function addAttribute($attribute) {
-        $this->attributeGroups[] = BuilderHelpers::normalizeAttribute($attribute);
-
-        return $this;
-    }
-
-    /**
-     * Sets the constant type.
-     *
-     * @param string|Node\Name|Identifier|Node\ComplexType $type
-     *
-     * @return $this
-     */
-    public function setType($type) {
-        $this->type = BuilderHelpers::normalizeType($type);
-
-        return $this;
-    }
-
-    /**
-     * Returns the built class node.
-     *
-     * @return Stmt\ClassConst The built constant node
-     */
-    public function getNode(): PhpParser\Node {
-        return new Stmt\ClassConst(
-            $this->constants,
-            $this->flags,
-            $this->attributes,
-            $this->attributeGroups,
-            $this->type
-        );
-    }
-}