@averay/codeformat 0.2.7 → 0.2.9

package/vendor/react/dns/README.md

@@ -1,453 +0,0 @@
-# DNS
-
-[![CI status](https://github.com/reactphp/dns/actions/workflows/ci.yml/badge.svg)](https://github.com/reactphp/dns/actions)
-[![installs on Packagist](https://img.shields.io/packagist/dt/react/dns?color=blue&label=installs%20on%20Packagist)](https://packagist.org/packages/react/dns)
-
-Async DNS resolver for [ReactPHP](https://reactphp.org/).
-
-The main point of the DNS component is to provide async DNS resolution.
-However, it is really a toolkit for working with DNS messages, and could
-easily be used to create a DNS server.
-
-**Table of contents**
-
-* [Basic usage](#basic-usage)
-* [Caching](#caching)
-  * [Custom cache adapter](#custom-cache-adapter)
-* [ResolverInterface](#resolverinterface)
-  * [resolve()](#resolve)
-  * [resolveAll()](#resolveall)
-* [Advanced usage](#advanced-usage)
-  * [UdpTransportExecutor](#udptransportexecutor)
-  * [TcpTransportExecutor](#tcptransportexecutor)
-  * [SelectiveTransportExecutor](#selectivetransportexecutor)
-  * [HostsFileExecutor](#hostsfileexecutor)
-* [Install](#install)
-* [Tests](#tests)
-* [License](#license)
-* [References](#references)
-
-## Basic usage
-
-The most basic usage is to just create a resolver through the resolver
-factory. All you need to give it is a nameserver, then you can start resolving
-names, baby!
-
-```php
-$config = React\Dns\Config\Config::loadSystemConfigBlocking();
-if (!$config->nameservers) {
-    $config->nameservers[] = '8.8.8.8';
-}
-
-$factory = new React\Dns\Resolver\Factory();
-$dns = $factory->create($config);
-
-$dns->resolve('igor.io')->then(function ($ip) {
-    echo "Host: $ip\n";
-});
-```
-
-See also the [first example](examples).
-
-The `Config` class can be used to load the system default config. This is an
-operation that may access the filesystem and block. Ideally, this method should
-thus be executed only once before the loop starts and not repeatedly while it is
-running.
-Note that this class may return an *empty* configuration if the system config
-can not be loaded. As such, you'll likely want to apply a default nameserver
-as above if none can be found.
-
-> Note that the factory loads the hosts file from the filesystem once when
-  creating the resolver instance.
-  Ideally, this method should thus be executed only once before the loop starts
-  and not repeatedly while it is running.
-
-But there's more.
-
-## Caching
-
-You can cache results by configuring the resolver to use a `CachedExecutor`:
-
-```php
-$config = React\Dns\Config\Config::loadSystemConfigBlocking();
-if (!$config->nameservers) {
-    $config->nameservers[] = '8.8.8.8';
-}
-
-$factory = new React\Dns\Resolver\Factory();
-$dns = $factory->createCached($config);
-
-$dns->resolve('igor.io')->then(function ($ip) {
-    echo "Host: $ip\n";
-});
-
-...
-
-$dns->resolve('igor.io')->then(function ($ip) {
-    echo "Host: $ip\n";
-});
-```
-
-If the first call returns before the second, only one query will be executed.
-The second result will be served from an in memory cache.
-This is particularly useful for long running scripts where the same hostnames
-have to be looked up multiple times.
-
-See also the [third example](examples).
-
-### Custom cache adapter
-
-By default, the above will use an in memory cache.
-
-You can also specify a custom cache implementing [`CacheInterface`](https://github.com/reactphp/cache) to handle the record cache instead:
-
-```php
-$cache = new React\Cache\ArrayCache();
-$factory = new React\Dns\Resolver\Factory();
-$dns = $factory->createCached('8.8.8.8', null, $cache);
-```
-
-See also the wiki for possible [cache implementations](https://github.com/reactphp/react/wiki/Users#cache-implementations).
-
-## ResolverInterface
-
-<a id="resolver"><!-- legacy reference --></a>
-
-### resolve()
-
-The `resolve(string $domain): PromiseInterface<string>` method can be used to
-resolve the given $domain name to a single IPv4 address (type `A` query).
-
-```php
-$resolver->resolve('reactphp.org')->then(function ($ip) {
-    echo 'IP for reactphp.org is ' . $ip . PHP_EOL;
-});
-```
-
-This is one of the main methods in this package. It sends a DNS query
-for the given $domain name to your DNS server and returns a single IP
-address on success.
-
-If the DNS server sends a DNS response message that contains more than
-one IP address for this query, it will randomly pick one of the IP
-addresses from the response. If you want the full list of IP addresses
-or want to send a different type of query, you should use the
-[`resolveAll()`](#resolveall) method instead.
-
-If the DNS server sends a DNS response message that indicates an error
-code, this method will reject with a `RecordNotFoundException`. Its
-message and code can be used to check for the response code.
-
-If the DNS communication fails and the server does not respond with a
-valid response message, this message will reject with an `Exception`.
-
-Pending DNS queries can be cancelled by cancelling its pending promise like so:
-
-```php
-$promise = $resolver->resolve('reactphp.org');
-
-$promise->cancel();
-```
-
-### resolveAll()
-
-The `resolveAll(string $host, int $type): PromiseInterface<array>` method can be used to
-resolve all record values for the given $domain name and query $type.
-
-```php
-$resolver->resolveAll('reactphp.org', Message::TYPE_A)->then(function ($ips) {
-    echo 'IPv4 addresses for reactphp.org ' . implode(', ', $ips) . PHP_EOL;
-});
-
-$resolver->resolveAll('reactphp.org', Message::TYPE_AAAA)->then(function ($ips) {
-    echo 'IPv6 addresses for reactphp.org ' . implode(', ', $ips) . PHP_EOL;
-});
-```
-
-This is one of the main methods in this package. It sends a DNS query
-for the given $domain name to your DNS server and returns a list with all
-record values on success.
-
-If the DNS server sends a DNS response message that contains one or more
-records for this query, it will return a list with all record values
-from the response. You can use the `Message::TYPE_*` constants to control
-which type of query will be sent. Note that this method always returns a
-list of record values, but each record value type depends on the query
-type. For example, it returns the IPv4 addresses for type `A` queries,
-the IPv6 addresses for type `AAAA` queries, the hostname for type `NS`,
-`CNAME` and `PTR` queries and structured data for other queries. See also
-the `Record` documentation for more details.
-
-If the DNS server sends a DNS response message that indicates an error
-code, this method will reject with a `RecordNotFoundException`. Its
-message and code can be used to check for the response code.
-
-If the DNS communication fails and the server does not respond with a
-valid response message, this message will reject with an `Exception`.
-
-Pending DNS queries can be cancelled by cancelling its pending promise like so:
-
-```php
-$promise = $resolver->resolveAll('reactphp.org', Message::TYPE_AAAA);
-
-$promise->cancel();
-```
-
-## Advanced Usage
-
-### UdpTransportExecutor
-
-The `UdpTransportExecutor` can be used to
-send DNS queries over a UDP transport.
-
-This is the main class that sends a DNS query to your DNS server and is used
-internally by the `Resolver` for the actual message transport.
-
-For more advanced usages one can utilize this class directly.
-The following example looks up the `IPv6` address for `igor.io`.
-
-```php
-$executor = new UdpTransportExecutor('8.8.8.8:53');
-
-$executor->query(
-    new Query($name, Message::TYPE_AAAA, Message::CLASS_IN)
-)->then(function (Message $message) {
-    foreach ($message->answers as $answer) {
-        echo 'IPv6: ' . $answer->data . PHP_EOL;
-    }
-}, 'printf');
-```
-
-See also the [fourth example](examples).
-
-Note that this executor does not implement a timeout, so you will very likely
-want to use this in combination with a `TimeoutExecutor` like this:
-
-```php
-$executor = new TimeoutExecutor(
-    new UdpTransportExecutor($nameserver),
-    3.0
-);
-```
-
-Also note that this executor uses an unreliable UDP transport and that it
-does not implement any retry logic, so you will likely want to use this in
-combination with a `RetryExecutor` like this:
-
-```php
-$executor = new RetryExecutor(
-    new TimeoutExecutor(
-        new UdpTransportExecutor($nameserver),
-        3.0
-    )
-);
-```
-
-Note that this executor is entirely async and as such allows you to execute
-any number of queries concurrently. You should probably limit the number of
-concurrent queries in your application or you're very likely going to face
-rate limitations and bans on the resolver end. For many common applications,
-you may want to avoid sending the same query multiple times when the first
-one is still pending, so you will likely want to use this in combination with
-a `CoopExecutor` like this:
-
-```php
-$executor = new CoopExecutor(
-    new RetryExecutor(
-        new TimeoutExecutor(
-            new UdpTransportExecutor($nameserver),
-            3.0
-        )
-    )
-);
-```
-
-> Internally, this class uses PHP's UDP sockets and does not take advantage
-  of [react/datagram](https://github.com/reactphp/datagram) purely for
-  organizational reasons to avoid a cyclic dependency between the two
-  packages. Higher-level components should take advantage of the Datagram
-  component instead of reimplementing this socket logic from scratch.
-
-### TcpTransportExecutor
-
-The `TcpTransportExecutor` class can be used to
-send DNS queries over a TCP/IP stream transport.
-
-This is one of the main classes that send a DNS query to your DNS server.
-
-For more advanced usages one can utilize this class directly.
-The following example looks up the `IPv6` address for `reactphp.org`.
-
-```php
-$executor = new TcpTransportExecutor('8.8.8.8:53');
-
-$executor->query(
-    new Query($name, Message::TYPE_AAAA, Message::CLASS_IN)
-)->then(function (Message $message) {
-    foreach ($message->answers as $answer) {
-        echo 'IPv6: ' . $answer->data . PHP_EOL;
-    }
-}, 'printf');
-```
-
-See also [example #92](examples).
-
-Note that this executor does not implement a timeout, so you will very likely
-want to use this in combination with a `TimeoutExecutor` like this:
-
-```php
-$executor = new TimeoutExecutor(
-    new TcpTransportExecutor($nameserver),
-    3.0
-);
-```
-
-Unlike the `UdpTransportExecutor`, this class uses a reliable TCP/IP
-transport, so you do not necessarily have to implement any retry logic.
-
-Note that this executor is entirely async and as such allows you to execute
-queries concurrently. The first query will establish a TCP/IP socket
-connection to the DNS server which will be kept open for a short period.
-Additional queries will automatically reuse this existing socket connection
-to the DNS server, will pipeline multiple requests over this single
-connection and will keep an idle connection open for a short period. The
-initial TCP/IP connection overhead may incur a slight delay if you only send
-occasional queries – when sending a larger number of concurrent queries over
-an existing connection, it becomes increasingly more efficient and avoids
-creating many concurrent sockets like the UDP-based executor. You may still
-want to limit the number of (concurrent) queries in your application or you
-may be facing rate limitations and bans on the resolver end. For many common
-applications, you may want to avoid sending the same query multiple times
-when the first one is still pending, so you will likely want to use this in
-combination with a `CoopExecutor` like this:
-
-```php
-$executor = new CoopExecutor(
-    new TimeoutExecutor(
-        new TcpTransportExecutor($nameserver),
-        3.0
-    )
-);
-```
-
-> Internally, this class uses PHP's TCP/IP sockets and does not take advantage
-  of [react/socket](https://github.com/reactphp/socket) purely for
-  organizational reasons to avoid a cyclic dependency between the two
-  packages. Higher-level components should take advantage of the Socket
-  component instead of reimplementing this socket logic from scratch.
-
-### SelectiveTransportExecutor
-
-The `SelectiveTransportExecutor` class can be used to
-Send DNS queries over a UDP or TCP/IP stream transport.
-
-This class will automatically choose the correct transport protocol to send
-a DNS query to your DNS server. It will always try to send it over the more
-efficient UDP transport first. If this query yields a size related issue
-(truncated messages), it will retry over a streaming TCP/IP transport.
-
-For more advanced usages one can utilize this class directly.
-The following example looks up the `IPv6` address for `reactphp.org`.
-
-```php
-$executor = new SelectiveTransportExecutor($udpExecutor, $tcpExecutor);
-
-$executor->query(
-    new Query($name, Message::TYPE_AAAA, Message::CLASS_IN)
-)->then(function (Message $message) {
-    foreach ($message->answers as $answer) {
-        echo 'IPv6: ' . $answer->data . PHP_EOL;
-    }
-}, 'printf');
-```
-
-Note that this executor only implements the logic to select the correct
-transport for the given DNS query. Implementing the correct transport logic,
-implementing timeouts and any retry logic is left up to the given executors,
-see also [`UdpTransportExecutor`](#udptransportexecutor) and
-[`TcpTransportExecutor`](#tcptransportexecutor) for more details.
-
-Note that this executor is entirely async and as such allows you to execute
-any number of queries concurrently. You should probably limit the number of
-concurrent queries in your application or you're very likely going to face
-rate limitations and bans on the resolver end. For many common applications,
-you may want to avoid sending the same query multiple times when the first
-one is still pending, so you will likely want to use this in combination with
-a `CoopExecutor` like this:
-
-```php
-$executor = new CoopExecutor(
-    new SelectiveTransportExecutor(
-        $datagramExecutor,
-        $streamExecutor
-    )
-);
-```
-
-### HostsFileExecutor
-
-Note that the above `UdpTransportExecutor` class always performs an actual DNS query.
-If you also want to take entries from your hosts file into account, you may
-use this code:
-
-```php
-$hosts = \React\Dns\Config\HostsFile::loadFromPathBlocking();
-
-$executor = new UdpTransportExecutor('8.8.8.8:53');
-$executor = new HostsFileExecutor($hosts, $executor);
-
-$executor->query(
-    new Query('localhost', Message::TYPE_A, Message::CLASS_IN)
-);
-```
-
-## Install
-
-The recommended way to install this library is [through Composer](https://getcomposer.org/).
-[New to Composer?](https://getcomposer.org/doc/00-intro.md)
-
-This project follows [SemVer](https://semver.org/).
-This will install the latest supported version:
-
-```bash
-composer require react/dns:^1.13
-```
-
-See also the [CHANGELOG](CHANGELOG.md) for details about version upgrades.
-
-This project aims to run on any platform and thus does not require any PHP
-extensions and supports running on legacy PHP 5.3 through current PHP 8+ and
-HHVM.
-It's *highly recommended to use the latest supported PHP version* for this project.
-
-## Tests
-
-To run the test suite, you first need to clone this repo and then install all
-dependencies [through Composer](https://getcomposer.org/):
-
-```bash
-composer install
-```
-
-To run the test suite, go to the project root and run:
-
-```bash
-vendor/bin/phpunit
-```
-
-The test suite also contains a number of functional integration tests that rely
-on a stable internet connection.
-If you do not want to run these, they can simply be skipped like this:
-
-```bash
-vendor/bin/phpunit --exclude-group internet
-```
-
-## License
-
-MIT, see [LICENSE file](LICENSE).
-
-## References
-
-* [RFC 1034](https://tools.ietf.org/html/rfc1034) Domain Names - Concepts and Facilities
-* [RFC 1035](https://tools.ietf.org/html/rfc1035) Domain Names - Implementation and Specification

package/vendor/react/dns/composer.json

@@ -1,49 +0,0 @@
-{
-    "name": "react/dns",
-    "description": "Async DNS resolver for ReactPHP",
-    "keywords": ["dns", "dns-resolver", "ReactPHP", "async"],
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Christian Lück",
-            "homepage": "https://clue.engineering/",
-            "email": "christian@clue.engineering"
-        },
-        {
-            "name": "Cees-Jan Kiewiet",
-            "homepage": "https://wyrihaximus.net/",
-            "email": "reactphp@ceesjankiewiet.nl"
-        },
-        {
-            "name": "Jan Sorgalla",
-            "homepage": "https://sorgalla.com/",
-            "email": "jsorgalla@gmail.com"
-        },
-        {
-            "name": "Chris Boden",
-            "homepage": "https://cboden.dev/",
-            "email": "cboden@gmail.com"
-        }
-    ],
-    "require": {
-        "php": ">=5.3.0",
-        "react/cache": "^1.0 || ^0.6 || ^0.5",
-        "react/event-loop": "^1.2",
-        "react/promise": "^3.2 || ^2.7 || ^1.2.1"
-    },
-    "require-dev": {
-        "phpunit/phpunit": "^9.6 || ^5.7 || ^4.8.36",
-        "react/async": "^4.3 || ^3 || ^2",
-        "react/promise-timer": "^1.11"
-    },
-    "autoload": {
-        "psr-4": {
-            "React\\Dns\\": "src/"
-        }
-    },
-    "autoload-dev": {
-        "psr-4": {
-            "React\\Tests\\Dns\\": "tests/"
-        }
-    }
-}

package/vendor/react/dns/src/BadServerException.php

@@ -1,7 +0,0 @@
-<?php
-
-namespace React\Dns;
-
-final class BadServerException extends \Exception
-{
-}

package/vendor/react/dns/src/Config/Config.php

@@ -1,137 +0,0 @@
-<?php
-
-namespace React\Dns\Config;
-
-use RuntimeException;
-
-final class Config
-{
-    /**
-     * Loads the system DNS configuration
-     *
-     * Note that this method may block while loading its internal files and/or
-     * commands and should thus be used with care! While this should be
-     * relatively fast for most systems, it remains unknown if this may block
-     * under certain circumstances. In particular, this method should only be
-     * executed before the loop starts, not while it is running.
-     *
-     * Note that this method will try to access its files and/or commands and
-     * try to parse its output. Currently, this will only parse valid nameserver
-     * entries from its output and will ignore all other output without
-     * complaining.
-     *
-     * Note that the previous section implies that this may return an empty
-     * `Config` object if no valid nameserver entries can be found.
-     *
-     * @return self
-     * @codeCoverageIgnore
-     */
-    public static function loadSystemConfigBlocking()
-    {
-        // Use WMIC output on Windows
-        if (DIRECTORY_SEPARATOR === '\\') {
-            return self::loadWmicBlocking();
-        }
-
-        // otherwise (try to) load from resolv.conf
-        try {
-            return self::loadResolvConfBlocking();
-        } catch (RuntimeException $ignored) {
-            // return empty config if parsing fails (file not found)
-            return new self();
-        }
-    }
-
-    /**
-     * Loads a resolv.conf file (from the given path or default location)
-     *
-     * Note that this method blocks while loading the given path and should
-     * thus be used with care! While this should be relatively fast for normal
-     * resolv.conf files, this may be an issue if this file is located on a slow
-     * device or contains an excessive number of entries. In particular, this
-     * method should only be executed before the loop starts, not while it is
-     * running.
-     *
-     * Note that this method will throw if the given file can not be loaded,
-     * such as if it is not readable or does not exist. In particular, this file
-     * is not available on Windows.
-     *
-     * Currently, this will only parse valid "nameserver X" lines from the
-     * given file contents. Lines can be commented out with "#" and ";" and
-     * invalid lines will be ignored without complaining. See also
-     * `man resolv.conf` for more details.
-     *
-     * Note that the previous section implies that this may return an empty
-     * `Config` object if no valid "nameserver X" lines can be found. See also
-     * `man resolv.conf` which suggests that the DNS server on the localhost
-     * should be used in this case. This is left up to higher level consumers
-     * of this API.
-     *
-     * @param ?string $path (optional) path to resolv.conf file or null=load default location
-     * @return self
-     * @throws RuntimeException if the path can not be loaded (does not exist)
-     */
-    public static function loadResolvConfBlocking($path = null)
-    {
-        if ($path === null) {
-            $path = '/etc/resolv.conf';
-        }
-
-        $contents = @file_get_contents($path);
-        if ($contents === false) {
-            throw new RuntimeException('Unable to load resolv.conf file "' . $path . '"');
-        }
-
-        $matches = array();
-        preg_match_all('/^nameserver\s+(\S+)\s*$/m', $contents, $matches);
-
-        $config = new self();
-        foreach ($matches[1] as $ip) {
-            // remove IPv6 zone ID (`fe80::1%lo0` => `fe80:1`)
-            if (strpos($ip, ':') !== false && ($pos = strpos($ip, '%')) !== false) {
-                $ip = substr($ip, 0, $pos);
-            }
-
-            if (@inet_pton($ip) !== false) {
-                $config->nameservers[] = $ip;
-            }
-        }
-
-        return $config;
-    }
-
-    /**
-     * Loads the DNS configurations from Windows's WMIC (from the given command or default command)
-     *
-     * Note that this method blocks while loading the given command and should
-     * thus be used with care! While this should be relatively fast for normal
-     * WMIC commands, it remains unknown if this may block under certain
-     * circumstances. In particular, this method should only be executed before
-     * the loop starts, not while it is running.
-     *
-     * Note that this method will only try to execute the given command try to
-     * parse its output, irrespective of whether this command exists. In
-     * particular, this command is only available on Windows. Currently, this
-     * will only parse valid nameserver entries from the command output and will
-     * ignore all other output without complaining.
-     *
-     * Note that the previous section implies that this may return an empty
-     * `Config` object if no valid nameserver entries can be found.
-     *
-     * @param ?string $command (advanced) should not be given (NULL) unless you know what you're doing
-     * @return self
-     * @link https://ss64.com/nt/wmic.html
-     */
-    public static function loadWmicBlocking($command = null)
-    {
-        $contents = shell_exec($command === null ? 'wmic NICCONFIG get "DNSServerSearchOrder" /format:CSV' : $command);
-        preg_match_all('/(?<=[{;,"])([\da-f.:]{4,})(?=[};,"])/i', $contents, $matches);
-
-        $config = new self();
-        $config->nameservers = $matches[1];
-
-        return $config;
-    }
-
-    public $nameservers = array();
-}