abbadon1334 / phpdoc-to-rst

src/Builder/MainIndexBuilder.php

Spacing +3 added lines, -3 removed lines

@@ -44,13 +44,13 @@
         $this->indent();
         $this->addLine(':maxdepth: 1')->addLine();
         foreach ($this->namespaces as $namespace) {
-            $namespaceString = (string) $namespace->getFqsen();
+            $namespaceString = (string)$namespace->getFqsen();
             $subPath = $namespaceString;
-            $path = substr(str_replace('\\', '/', $subPath), 1).'/index';
+            $path = substr(str_replace('\\', '/', $subPath), 1) . '/index';
             if ($namespaceString === '\\') {
                 $path = 'index';
             }
-            $this->addLine($namespace->getFqsen().' <'.$path.'>');
+            $this->addLine($namespace->getFqsen() . ' <' . $path . '>');
         }
         $this->addLine();
         $this->addLine();

src/Builder/NamespaceIndexBuilder.php

Spacing +15 added lines, -15 removed lines

@@ -70,19 +70,19 @@ 
      */
     private function findChildNamespaces()
     {
-        $currentNamespaceFqsen = (string) $this->currentNamespace->getFqsen();
+        $currentNamespaceFqsen = (string)$this->currentNamespace->getFqsen();
         /** @var Namespace_ $namespace */
         foreach ($this->namespaces as $namespace) {
             // check if not root and doesn't start with current namespace
-            if ($currentNamespaceFqsen !== '\\' && strpos((string) $namespace->getFqsen(),
-                    $currentNamespaceFqsen.'\\') !== 0) {
+            if ($currentNamespaceFqsen !== '\\' && strpos((string)$namespace->getFqsen(),
+                    $currentNamespaceFqsen . '\\') !== 0) {
                 continue;
             }
-            if ((string) $namespace->getFqsen() !== $currentNamespaceFqsen && strpos((string) $namespace->getFqsen(),
+            if ((string)$namespace->getFqsen() !== $currentNamespaceFqsen && strpos((string)$namespace->getFqsen(),
                     $currentNamespaceFqsen) === 0) {
                 // only keep first level children
-                $childrenPath = substr((string) $namespace->getFqsen(),
-                    strlen((string) $this->currentNamespace->getFqsen()) + 1);
+                $childrenPath = substr((string)$namespace->getFqsen(),
+                    strlen((string)$this->currentNamespace->getFqsen()) + 1);
                 if (strpos($childrenPath, '\\') === false) {
                     $this->childNamespaces[] = $namespace;
                 }
@@ -92,15 +92,15 @@ 
 
     public function render()
     {
-        $currentNamespaceFqsen = (string) $this->currentNamespace->getFqsen();
+        $currentNamespaceFqsen = (string)$this->currentNamespace->getFqsen();
         if ($currentNamespaceFqsen !== '\\') {
             $label = str_replace('\\', '-', $currentNamespaceFqsen);
-            $this->addLine('.. _namespace'.$label.':')->addLine();
+            $this->addLine('.. _namespace' . $label . ':')->addLine();
             $this->addH1(RstBuilder::escape($this->currentNamespace->getName()));
             $this->addLine(self::escape($currentNamespaceFqsen))->addLine();
         } else {
             $label = 'root-namespace';
-            $this->addLine('.. _namespace-'.$label.':')->addLine();
+            $this->addLine('.. _namespace-' . $label . ':')->addLine();
             $this->addH1(RstBuilder::escape('\\'));
         }
         $this->addLine();
@@ -129,7 +129,7 @@ 
                     continue;
                 }
                 if ($type === self::RENDER_INDEX_NAMESPACE) {
-                    $this->addLine($entry->getName().' <'.$entry->getName().'/index>');
+                    $this->addLine($entry->getName() . ' <' . $entry->getName() . '/index>');
                 } else {
                     $this->addElementTocEntry($entry);
                 }
@@ -200,14 +200,14 @@ 
 
     private function addElementTocEntry(Fqsen $entry)
     {
-        $currentNamespaceFqsen = (string) $this->currentNamespace->getFqsen();
+        $currentNamespaceFqsen = (string)$this->currentNamespace->getFqsen();
         $subPath = $entry;
         if ($currentNamespaceFqsen !== '\\' && substr($entry, 0,
                 strlen($currentNamespaceFqsen)) === $currentNamespaceFqsen) {
             $subPath = substr($entry, strlen($currentNamespaceFqsen));
         }
         $path = substr(str_replace('\\', '/', $subPath), 1);
-        $this->addLine($entry->getName().' <'.$path.'>');
+        $this->addLine($entry->getName() . ' <' . $path . '>');
     }
 
     private function addFunctions()
@@ -233,10 +233,10 @@ 
             /** @var Argument $argument */
             foreach ($function->getArguments() as $argument) {
                 // TODO: defaults, types
-                $args .= '$'.$argument->getName().', ';
+                $args .= '$' . $argument->getName() . ', ';
             }
             $args = substr($args, 0, -2);
-            $this->beginPhpDomain('function', $function->getName().'('.$args.')');
+            $this->beginPhpDomain('function', $function->getName() . '(' . $args . ')');
             $this->addDocBlockDescription($function);
             if (!empty($params)) {
                 foreach ($function->getArguments() as $argument) {
@@ -244,7 +244,7 @@ 
                         /** @var Param $param */
                         $param = $params[$argument->getName()];
                         if ($param !== null) {
-                            $this->addMultiline(':param '.self::escape($param->getType()).' $'.$argument->getName().': '.$param->getDescription(),
+                            $this->addMultiline(':param ' . self::escape($param->getType()) . ' $' . $argument->getName() . ': ' . $param->getDescription(),
                                 true);
                         }
                     }

src/Builder/ClassFileBuilder.php

Spacing +1 added lines, -1 removed lines

@@ -58,7 +58,7 @@
     {
         $implementedInterfaces = '';
         foreach ($element->getInterfaces() as $int) {
-            $implementedInterfaces .= $this->getLink('interface', $int).' ';
+            $implementedInterfaces .= $this->getLink('interface', $int) . ' ';
         }
         if ($implementedInterfaces !== '') {
             $this->addFieldList('Implements', $implementedInterfaces);

src/Builder/PhpDomainBuilder.php

Spacing +34 added lines, -34 removed lines

@@ -43,10 +43,10 @@ 
  */
 class PhpDomainBuilder extends RstBuilder
 {
-    const SECTION_BEFORE_DESCRIPTION = self::class.'::SECTION_BEFORE_DESCRIPTION';
-    const SECTION_AFTER_DESCRIPTION = self::class.'::SECTION_AFTER_DESCRIPTION';
-    const SECTION_AFTER_TITLE = self::class.'::SECTION_AFTER_TITLE';
-    const SECTION_AFTER_INTRODUCTION = self::class.'::SECTION_AFTER_INTRODUCTION';
+    const SECTION_BEFORE_DESCRIPTION = self::class . '::SECTION_BEFORE_DESCRIPTION';
+    const SECTION_AFTER_DESCRIPTION = self::class . '::SECTION_AFTER_DESCRIPTION';
+    const SECTION_AFTER_TITLE = self::class . '::SECTION_AFTER_TITLE';
+    const SECTION_AFTER_INTRODUCTION = self::class . '::SECTION_AFTER_INTRODUCTION';
 
     use ExtensionBuilder {
         ExtensionBuilder::__construct as private __extensionConstructor;
@@ -55,7 +55,7 @@ 
     public function __construct($extensions)
     {
         $this->__extensionConstructor($extensions);
-        $this->addMultiline('.. role:: php(code)'.PHP_EOL.':language: php', true);
+        $this->addMultiline('.. role:: php(code)' . PHP_EOL . ':language: php', true);
         $this->addLine();
     }
 
@@ -74,7 +74,7 @@ 
             $modifiers = $element->isAbstract() ? ' abstract' : '';
             $modifiers = $element->isFinal() ? ' final' : $modifiers;
             if ($modifiers !== '') {
-                $this->addLine('.. rst-class:: '.$modifiers)->addLine();
+                $this->addLine('.. rst-class:: ' . $modifiers)->addLine();
             }
         }
 
@@ -93,7 +93,7 @@ 
      */
     public static function getNamespace(Element $element)
     {
-        return substr($element->getFqsen(), 0, strlen($element->getFqsen()) - strlen('\\'.$element->getName()));
+        return substr($element->getFqsen(), 0, strlen($element->getFqsen()) - strlen('\\' . $element->getName()));
         //return str_replace('\\' . $element->getName(), '', $element->getFqsen());
     }
 
@@ -105,7 +105,7 @@ 
     public function beginPhpDomain($type, $name, $indent = true)
     {
         // FIXME: Add checks if it is properly ended
-        $this->addLine('.. php:'.$type.':: '.$name)->addLine();
+        $this->addLine('.. php:' . $type . ':: ' . $name)->addLine();
         if ($indent === true) {
             $this->indent();
         }
@@ -168,7 +168,7 @@ 
      */
     private function addConstant(Constant $constant)
     {
-        $this->beginPhpDomain('const', $constant->getName().' = '.self::escape($constant->getValue()));
+        $this->beginPhpDomain('const', $constant->getName() . ' = ' . self::escape($constant->getValue()));
         $docBlock = $constant->getDocBlock();
         $this->addDocBlockDescription($constant);
         if ($docBlock) {
@@ -195,7 +195,7 @@ 
             $this->addLine('.. rst-class:: phpdoc-description')->addLine();
             $this->indent();
             $this->addMultilineWithoutRendering(RstBuilder::escape($docBlock->getSummary()))->addLine();
-            if ((string) $docBlock->getDescription() !== '') {
+            if ((string)$docBlock->getDescription() !== '') {
                 $this->addMultilineWithoutRendering(RstBuilder::escape($docBlock->getDescription()))->addLine();
             }
             $this->unindent();
@@ -235,44 +235,44 @@ 
             case 'return':
                 /** @var Return_ $return */
                 $return = $tags[0];
-                $this->addMultiline(':Returns: '.self::typesToRst($return->getType()).' '.RstBuilder::escape($return->getDescription()),
+                $this->addMultiline(':Returns: ' . self::typesToRst($return->getType()) . ' ' . RstBuilder::escape($return->getDescription()),
                     true);
                 break;
             case 'var':
                 /** @var DocBlock\Tags\Var_ $return */
                 $return = $tags[0];
-                $this->addMultiline(':Type: '.self::typesToRst($return->getType()).' '.RstBuilder::escape($return->getDescription()),
+                $this->addMultiline(':Type: ' . self::typesToRst($return->getType()) . ' ' . RstBuilder::escape($return->getDescription()),
                     true);
                 break;
             case 'throws':
                 /** @var Throws $tag */
                 foreach ($tags as $tag) {
-                    $this->addMultiline(':Throws: '.self::typesToRst($tag->getType()).' '.RstBuilder::escape($tag->getDescription()),
+                    $this->addMultiline(':Throws: ' . self::typesToRst($tag->getType()) . ' ' . RstBuilder::escape($tag->getDescription()),
                         true);
                 }
                 break;
             case 'since':
                 /** @var Since $return */
                 $return = $tags[0];
-                $this->addMultiline(':Since: '.$return->getVersion().' '.RstBuilder::escape($return->getDescription()),
+                $this->addMultiline(':Since: ' . $return->getVersion() . ' ' . RstBuilder::escape($return->getDescription()),
                     true);
                 break;
             case 'deprecated':
                 /** @var Deprecated $return */
                 $return = $tags[0];
-                $this->addMultiline(':Deprecated: '.$return->getVersion().' '.RstBuilder::escape($return->getDescription()),
+                $this->addMultiline(':Deprecated: ' . $return->getVersion() . ' ' . RstBuilder::escape($return->getDescription()),
                     true);
                 break;
             case 'see':
                 /** @var See $return */
                 $return = $tags[0];
-                $this->addMultiline(':See: '.self::typesToRst($return->getReference()).' '.RstBuilder::escape($return->getDescription()),
+                $this->addMultiline(':See: ' . self::typesToRst($return->getReference()) . ' ' . RstBuilder::escape($return->getDescription()),
                     true);
                 break;
             case 'license':
                 /** @var DocBlock\Tags\BaseTag $return */
                 $return = $tags[0];
-                $this->addMultiline(':License: '.RstBuilder::escape($return->getDescription()), true);
+                $this->addMultiline(':License: ' . RstBuilder::escape($return->getDescription()), true);
                 break;
         }
     }
@@ -311,13 +311,13 @@ 
         foreach ($types as $typeFull) {
             $type = str_replace('[]', '', $typeFull);
             if (in_array($type, $whitelist, true)) {
-                $result .= $typeFull.' | ';
+                $result .= $typeFull . ' | ';
                 continue;
             }
             if (0 === strpos($type, '\\')) {
                 $type = substr($type, 1);
             }
-            $result .= ':any:`'.RstBuilder::escape($typeFull).' <'.RstBuilder::escape($type).'>` | ';
+            $result .= ':any:`' . RstBuilder::escape($typeFull) . ' <' . RstBuilder::escape($type) . '>` | ';
         }
 
         return substr($result, 0, -3);
@@ -355,7 +355,7 @@ 
     private function addProperty(Property $property)
     {
         $modifiers = $property->isStatic() ? '' : ' static';
-        $this->beginPhpDomain('attr', $property->getVisibility().$modifiers.' '.$property->getName());
+        $this->beginPhpDomain('attr', $property->getVisibility() . $modifiers . ' ' . $property->getName());
         $docBlock = $property->getDocBlock();
         $this->addDocBlockDescription($property);
         if ($docBlock) {
@@ -394,11 +394,11 @@ 
     public static function getLink($type, $fqsen, $description = '')
     {
         if ($description !== '') {
-            return ':php:'.$type.':`'.RstBuilder::escape($description).'<'.RstBuilder::escape(substr($fqsen,
-                    1)).'>`';
+            return ':php:' . $type . ':`' . RstBuilder::escape($description) . '<' . RstBuilder::escape(substr($fqsen,
+                    1)) . '>`';
         }
 
-        return ':php:'.$type.':`'.RstBuilder::escape(substr($fqsen, 1)).'`';
+        return ':php:' . $type . ':`' . RstBuilder::escape(substr($fqsen, 1)) . '`';
     }
 
     /**
@@ -408,7 +408,7 @@ 
     {
         $usedTraits = '';
         foreach ($element->getUsedTraits() as $trait) {
-            $usedTraits .= $this->getLink('trait', $trait).' ';
+            $usedTraits .= $this->getLink('trait', $trait) . ' ';
         }
         if ($usedTraits !== '') {
             $this->addFieldList('Used traits', $usedTraits);
@@ -449,11 +449,11 @@ 
         $modifiers .= $method->isFinal() ? ' final' : '';
         $modifiers .= $method->isStatic() ? ' static' : '';
         $deprecated = count($deprecated) > 0 ? ' deprecated' : '';
-        $this->addLine('.. rst-class:: '.$modifiers.$deprecated)->addLine();
+        $this->addLine('.. rst-class:: ' . $modifiers . $deprecated)->addLine();
         $this->indent();
 
         $args = $this->processMethodArgumentTypes($method);
-        $this->beginPhpDomain('method', $modifiers.' '.$method->getName().'('.$args.')');
+        $this->beginPhpDomain('method', $modifiers . ' ' . $method->getName() . '(' . $args . ')');
         $this->addDocBlockDescription($method);
         $this->addLine();
         if (!empty($params)) {
@@ -495,12 +495,12 @@ 
                 if ($argument->isVariadic()) {
                     $paramItem .= '...';
                 }
-                $paramItem .= '$'.$argument->getName().'** ';
+                $paramItem .= '$' . $argument->getName() . '** ';
                 if ($typString !== null) {
-                    $paramItem .= '('.self::typesToRst($typString).') ';
+                    $paramItem .= '(' . self::typesToRst($typString) . ') ';
                 }
-                $paramItem .= ' '.$param->getDescription();
-                $parameterDetails .= $paramItem.PHP_EOL;
+                $paramItem .= ' ' . $param->getDescription();
+                $parameterDetails .= $paramItem . PHP_EOL;
             }
         }
 
@@ -533,20 +533,20 @@ 
     private function processMethodArgumentType(Argument $argument, string $args): string
     {
         foreach ($argument->getType() as $type) {
-            $args .= self::escape($type).'|';
+            $args .= self::escape($type) . '|';
         }
-        $args = substr($args, 0, -1).' ';
+        $args = substr($args, 0, -1) . ' ';
         if ($argument->isVariadic()) {
             $args .= '...';
         }
         if ($argument->isByReference()) {
             $args .= '&';
         }
-        $args .= '$'.$argument->getName();
+        $args .= '$' . $argument->getName();
         $default = $argument->getDefault();
         if ($default !== null) {
             $default = $default === '' ? '""' : $default;
-            $args .= '='.self::escape($default);
+            $args .= '=' . self::escape($default);
         }
         $args .= ', ';