updated-packages

vendor/phpdocumentor/reflection-common/src/Element.php

@@ -1,11 +1,13 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * phpDocumentor
  *
- * PHP Version 5.5
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel / Naenius (http://www.naenius.com)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
 
@@ -18,15 +20,11 @@ interface Element
 {
     /**
      * Returns the Fqsen of the element.
-     *
-     * @return Fqsen
      */
-    public function getFqsen();
+    public function getFqsen() : Fqsen;
 
     /**
      * Returns the name of the element.
-     *
-     * @return string
      */
-    public function getName();
-}
+    public function getName() : string;
+}

vendor/phpdocumentor/reflection-common/src/File.php

@@ -1,12 +1,13 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * This file is part of phpDocumentor.
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel<mike@phpdoc.org>
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
 
@@ -19,22 +20,16 @@ interface File
 {
     /**
      * Returns the content of the file as a string.
-     *
-     * @return string
      */
-    public function getContents();
+    public function getContents() : string;
 
     /**
      * Returns md5 hash of the file.
-     *
-     * @return string
      */
-    public function md5();
+    public function md5() : string;
 
     /**
      * Returns an relative path to the file.
-     *
-     * @return string
      */
-    public function path();
+    public function path() : string;
 }

vendor/phpdocumentor/reflection-common/src/Fqsen.php

@@ -1,51 +1,60 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * phpDocumentor
  *
- * PHP Version 5.5
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel / Naenius (http://www.naenius.com)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
 
 namespace phpDocumentor\Reflection;
 
+use InvalidArgumentException;
+use function assert;
+use function end;
+use function explode;
+use function is_string;
+use function preg_match;
+use function sprintf;
+use function trim;
+
 /**
  * Value Object for Fqsen.
  *
  * @link https://github.com/phpDocumentor/fig-standards/blob/master/proposed/phpdoc-meta.md
+ *
+ * @psalm-immutable
  */
 final class Fqsen
 {
-    /**
-     * @var string full quallified class name
-     */
+    /** @var string full quallified class name */
     private $fqsen;
 
-    /**
-     * @var string name of the element without path.
-     */
+    /** @var string name of the element without path. */
     private $name;
 
     /**
      * Initializes the object.
      *
-     * @param string $fqsen
-     *
-     * @throws \InvalidArgumentException when $fqsen is not matching the format.
+     * @throws InvalidArgumentException when $fqsen is not matching the format.
      */
-    public function __construct($fqsen)
+    public function __construct(string $fqsen)
     {
-        $matches = array();
+        $matches = [];
+
         $result = preg_match(
+            //phpcs:ignore Generic.Files.LineLength.TooLong
             '/^\\\\([a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff\\\\]*)?(?:[:]{2}\\$?([a-zA-Z_\\x7f-\\xff][a-zA-Z0-9_\\x7f-\\xff]*))?(?:\\(\\))?$/',
-                $fqsen,
-                $matches
+            $fqsen,
+            $matches
         );
 
         if ($result === 0) {
-            throw new \InvalidArgumentException(
+            throw new InvalidArgumentException(
                 sprintf('"%s" is not a valid Fqsen.', $fqsen)
             );
         }
@@ -56,26 +65,24 @@ final class Fqsen
             $this->name = $matches[2];
         } else {
             $matches = explode('\\', $fqsen);
-            $this->name = trim(end($matches), '()');
+            $name = end($matches);
+            assert(is_string($name));
+            $this->name = trim($name, '()');
         }
     }
 
     /**
      * converts this class to string.
-     *
-     * @return string
      */
-    public function __toString()
+    public function __toString() : string
     {
         return $this->fqsen;
     }
 
     /**
      * Returns the name of the element without path.
-     *
-     * @return string
      */
-    public function getName()
+    public function getName() : string
     {
         return $this->name;
     }

vendor/phpdocumentor/reflection-common/src/Location.php

@@ -1,12 +1,13 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * This file is part of phpDocumentor.
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel<mike@phpdoc.org>
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
 
@@ -14,10 +15,12 @@ namespace phpDocumentor\Reflection;
 
 /**
  * The location where an element occurs within a file.
+ *
+ * @psalm-immutable
  */
 final class Location
 {
-    /** @var int  */
+    /** @var int */
     private $lineNumber = 0;
 
     /** @var int */
@@ -25,32 +28,25 @@ final class Location
 
     /**
      * Initializes the location for an element using its line number in the file and optionally the column number.
-     *
-     * @param int $lineNumber
-     * @param int $columnNumber
      */
-    public function __construct($lineNumber, $columnNumber = 0)
+    public function __construct(int $lineNumber, int $columnNumber = 0)
     {
-        $this->lineNumber   = $lineNumber;
+        $this->lineNumber = $lineNumber;
         $this->columnNumber = $columnNumber;
     }
 
     /**
      * Returns the line number that is covered by this location.
-     *
-     * @return integer
      */
-    public function getLineNumber()
+    public function getLineNumber() : int
     {
         return $this->lineNumber;
     }
 
     /**
      * Returns the column number (character position on a line) for this location object.
-     *
-     * @return integer
      */
-    public function getColumnNumber()
+    public function getColumnNumber() : int
     {
         return $this->columnNumber;
     }

vendor/phpdocumentor/reflection-common/src/Project.php

@@ -1,11 +1,13 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * phpDocumentor
  *
- * PHP Version 5.5
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel / Naenius (http://www.naenius.com)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
 
@@ -18,8 +20,6 @@ interface Project
 {
     /**
      * Returns the name of the project.
-     *
-     * @return string
      */
-    public function getName();
+    public function getName() : string;
 }

vendor/phpdocumentor/reflection-common/src/ProjectFactory.php

@@ -1,13 +1,16 @@
 <?php
+
+declare(strict_types=1);
+
 /**
  * phpDocumentor
  *
- * PHP Version 5.5
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
  *
- * @copyright 2010-2015 Mike van Riel / Naenius (http://www.naenius.com)
- * @license   http://www.opensource.org/licenses/mit-license.php MIT
  * @link      http://phpdoc.org
  */
+
 namespace phpDocumentor\Reflection;
 
 /**
@@ -19,9 +22,7 @@ interface ProjectFactory
     /**
      * Creates a project from the set of files.
      *
-     * @param string $name
      * @param File[] $files
-     * @return Project
      */
-    public function create($name, array $files);
+    public function create(string $name, array $files) : Project;
 }