summaryrefslogtreecommitdiff
path: root/vendor/sebastian/version
diff options
context:
space:
mode:
authorAndrew Dolgov <[email protected]>2022-03-22 12:24:31 +0300
committerAndrew Dolgov <[email protected]>2022-03-22 12:24:31 +0300
commit1c4f7ab3b838b23afb2ee4dab14acbf75956e952 (patch)
tree0a19274107d717efe92d2c0376cd3105fead5a11 /vendor/sebastian/version
parent711662948768492e8d05b778a7d80eacaec368d2 (diff)
* add phpunit as a dev dependency
* add some basic tests for UrlHelper::rewrite_relative() * fix UrlHelper::rewrite_relative() to work better on non-absolute relative URL paths
Diffstat (limited to 'vendor/sebastian/version')
-rw-r--r--vendor/sebastian/version/.gitattributes4
-rw-r--r--vendor/sebastian/version/.gitignore2
-rw-r--r--vendor/sebastian/version/ChangeLog.md25
-rw-r--r--vendor/sebastian/version/LICENSE33
-rw-r--r--vendor/sebastian/version/README.md43
-rw-r--r--vendor/sebastian/version/composer.json37
-rw-r--r--vendor/sebastian/version/src/Version.php97
7 files changed, 241 insertions, 0 deletions
diff --git a/vendor/sebastian/version/.gitattributes b/vendor/sebastian/version/.gitattributes
new file mode 100644
index 000000000..54b895305
--- /dev/null
+++ b/vendor/sebastian/version/.gitattributes
@@ -0,0 +1,4 @@
+/.github export-ignore
+/.php_cs.dist export-ignore
+
+*.php diff=php
diff --git a/vendor/sebastian/version/.gitignore b/vendor/sebastian/version/.gitignore
new file mode 100644
index 000000000..ff5ec9a0e
--- /dev/null
+++ b/vendor/sebastian/version/.gitignore
@@ -0,0 +1,2 @@
+/.php_cs.cache
+/.idea
diff --git a/vendor/sebastian/version/ChangeLog.md b/vendor/sebastian/version/ChangeLog.md
new file mode 100644
index 000000000..10fd9a1a5
--- /dev/null
+++ b/vendor/sebastian/version/ChangeLog.md
@@ -0,0 +1,25 @@
+# ChangeLog
+
+All notable changes are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
+
+## [3.0.2] - 2020-09-28
+
+### Changed
+
+* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
+
+## [3.0.1] - 2020-06-26
+
+### Added
+
+* This component is now supported on PHP 8
+
+## [3.0.0] - 2020-01-21
+
+### Removed
+
+* This component is no longer supported on PHP 7.1 and PHP 7.2
+
+[3.0.2]: https://github.com/sebastianbergmann/version/compare/3.0.1...3.0.2
+[3.0.1]: https://github.com/sebastianbergmann/version/compare/3.0.0...3.0.1
+[3.0.0]: https://github.com/sebastianbergmann/version/compare/2.0.1...3.0.0
diff --git a/vendor/sebastian/version/LICENSE b/vendor/sebastian/version/LICENSE
new file mode 100644
index 000000000..aa6bca299
--- /dev/null
+++ b/vendor/sebastian/version/LICENSE
@@ -0,0 +1,33 @@
+Version
+
+Copyright (c) 2013-2020, Sebastian Bergmann <[email protected]>.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+
+ * Neither the name of Sebastian Bergmann nor the names of his
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
diff --git a/vendor/sebastian/version/README.md b/vendor/sebastian/version/README.md
new file mode 100644
index 000000000..2864c8126
--- /dev/null
+++ b/vendor/sebastian/version/README.md
@@ -0,0 +1,43 @@
+# Version
+
+**Version** is a library that helps with managing the version number of Git-hosted PHP projects.
+
+## Installation
+
+You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
+
+ composer require sebastian/version
+
+If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
+
+ composer require --dev sebastian/version
+
+## Usage
+
+The constructor of the `SebastianBergmann\Version` class expects two parameters:
+
+* `$release` is the version number of the latest release (`X.Y.Z`, for instance) or the name of the release series (`X.Y`) when no release has been made from that branch / for that release series yet.
+* `$path` is the path to the directory (or a subdirectory thereof) where the sourcecode of the project can be found. Simply passing `__DIR__` here usually suffices.
+
+Apart from the constructor, the `SebastianBergmann\Version` class has a single public method: `getVersion()`.
+
+Here is a contrived example that shows the basic usage:
+
+ <?php
+ $version = new SebastianBergmann\Version(
+ '3.7.10', '/usr/local/src/phpunit'
+ );
+
+ var_dump($version->getVersion());
+ ?>
+
+ string(18) "3.7.10-17-g00f3408"
+
+When a new release is prepared, the string that is passed to the constructor as the first argument needs to be updated.
+
+### How SebastianBergmann\Version::getVersion() works
+
+* If `$path` is not (part of) a Git repository and `$release` is in `X.Y.Z` format then `$release` is returned as-is.
+* If `$path` is not (part of) a Git repository and `$release` is in `X.Y` format then `$release` is returned suffixed with `-dev`.
+* If `$path` is (part of) a Git repository and `$release` is in `X.Y.Z` format then the output of `git describe --tags` is returned as-is.
+* If `$path` is (part of) a Git repository and `$release` is in `X.Y` format then a string is returned that begins with `X.Y` and ends with information from `git describe --tags`.
diff --git a/vendor/sebastian/version/composer.json b/vendor/sebastian/version/composer.json
new file mode 100644
index 000000000..e76dbf412
--- /dev/null
+++ b/vendor/sebastian/version/composer.json
@@ -0,0 +1,37 @@
+{
+ "name": "sebastian/version",
+ "description": "Library that helps with managing the version number of Git-hosted PHP projects",
+ "homepage": "https://github.com/sebastianbergmann/version",
+ "license": "BSD-3-Clause",
+ "authors": [
+ {
+ "name": "Sebastian Bergmann",
+ "email": "[email protected]",
+ "role": "lead"
+ }
+ ],
+ "support": {
+ "issues": "https://github.com/sebastianbergmann/version/issues"
+ },
+ "config": {
+ "platform": {
+ "php": "7.3.0"
+ },
+ "optimize-autoloader": true,
+ "sort-packages": true
+ },
+ "prefer-stable": true,
+ "require": {
+ "php": ">=7.3"
+ },
+ "autoload": {
+ "classmap": [
+ "src/"
+ ]
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.0-dev"
+ }
+ }
+}
diff --git a/vendor/sebastian/version/src/Version.php b/vendor/sebastian/version/src/Version.php
new file mode 100644
index 000000000..53ae7894e
--- /dev/null
+++ b/vendor/sebastian/version/src/Version.php
@@ -0,0 +1,97 @@
+<?php
+/*
+ * This file is part of sebastian/version.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace SebastianBergmann;
+
+final class Version
+{
+ /**
+ * @var string
+ */
+ private $path;
+
+ /**
+ * @var string
+ */
+ private $release;
+
+ /**
+ * @var string
+ */
+ private $version;
+
+ public function __construct(string $release, string $path)
+ {
+ $this->release = $release;
+ $this->path = $path;
+ }
+
+ public function getVersion(): string
+ {
+ if ($this->version === null) {
+ if (\substr_count($this->release, '.') + 1 === 3) {
+ $this->version = $this->release;
+ } else {
+ $this->version = $this->release . '-dev';
+ }
+
+ $git = $this->getGitInformation($this->path);
+
+ if ($git) {
+ if (\substr_count($this->release, '.') + 1 === 3) {
+ $this->version = $git;
+ } else {
+ $git = \explode('-', $git);
+
+ $this->version = $this->release . '-' . \end($git);
+ }
+ }
+ }
+
+ return $this->version;
+ }
+
+ /**
+ * @return bool|string
+ */
+ private function getGitInformation(string $path)
+ {
+ if (!\is_dir($path . DIRECTORY_SEPARATOR . '.git')) {
+ return false;
+ }
+
+ $process = \proc_open(
+ 'git describe --tags',
+ [
+ 1 => ['pipe', 'w'],
+ 2 => ['pipe', 'w'],
+ ],
+ $pipes,
+ $path
+ );
+
+ if (!\is_resource($process)) {
+ return false;
+ }
+
+ $result = \trim(\stream_get_contents($pipes[1]));
+
+ \fclose($pipes[1]);
+ \fclose($pipes[2]);
+
+ $returnCode = \proc_close($process);
+
+ if ($returnCode !== 0) {
+ return false;
+ }
+
+ return $result;
+ }
+}