add scope field to ApiDoc

retailcrm · Oct 1, 2024 · d761d89 · d761d89
1 parent 5513664
commit d761d89
Show file tree

Hide file tree

Showing 5 changed files with 81 additions and 1 deletion.
diff --git a/Annotation/ApiDoc.php b/Annotation/ApiDoc.php
@@ -175,6 +175,8 @@ class ApiDoc
      */
     private $tags = [];
 
+    private ?string $scope = null;
+
     public function __construct(array $data)
     {
         $this->resource = !empty($data['resource']) ? $data['resource'] : false;
@@ -664,6 +666,16 @@ public function getMethod()
         return $this->method;
     }
 
+    public function setScope(string $scope): void
+    {
+        $this->scope = $scope;
+    }
+
+    public function getScope(): ?string
+    {
+        return $this->scope;
+    }
+
     /**
      * @return array
      */
@@ -742,6 +754,7 @@ public function toArray()
         $data['authentication'] = $this->authentication;
         $data['authenticationRoles'] = $this->authenticationRoles;
         $data['deprecated'] = $this->deprecated;
+        $data['scope'] = $this->scope;
 
         return $data;
     }

diff --git a/Extractor/ApiDocExtractor.php b/Extractor/ApiDocExtractor.php
@@ -506,10 +506,13 @@ protected function setParentClasses($array)
                 if (isset($v['children'])) {
                     if (isset($v['class'])) {
                         foreach ($v['children'] as $key => $item) {
-                            $array[$k]['children'][$key]['parentClass'] = $v['class'];
+                            if (empty($item['parentClass'] ?? null)) {
+                                $array[$k]['children'][$key]['parentClass'] = $v['class'];
+                            }
                             $array[$k]['children'][$key]['field'] = $key;
                         }
                     }
+
                     $array[$k]['children'] = $this->setParentClasses($array[$k]['children']);
                 }
             }

diff --git a/Tests/Formatter/SimpleFormatterTest.php b/Tests/Formatter/SimpleFormatterTest.php
@@ -62,6 +62,7 @@ public function testFormatOne(): void
             'authentication' => false,
             'authenticationRoles' => [],
             'deprecated' => false,
+            'scope' => null,
         ];
 
         $this->assertEquals($expected, $result);

diff --git a/Tests/Formatter/testFormat-result.php b/Tests/Formatter/testFormat-result.php
@@ -1114,6 +1114,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'views' => [
                 'default',
                 'test',
@@ -1128,6 +1129,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         2 => [
             'method' => 'ANY',
@@ -1145,6 +1147,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         3 => [
             'method' => 'ANY',
@@ -1156,6 +1159,7 @@
                 1 => 'ROLE_FOOBAR',
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         4 => [
             'method' => 'POST',
@@ -1422,6 +1426,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         5 => [
             'method' => 'GET',
@@ -1456,6 +1461,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         6 => [
             'method' => 'ANY',
@@ -1490,6 +1496,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         7 => [
             'method' => 'GET',
@@ -1509,6 +1516,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'resourceDescription' => 'Popo',
             'section' => 'Popo',
         ],
@@ -1538,6 +1546,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'resourceDescription' => 'Popo',
             'section' => 'Popo',
         ],
@@ -1558,6 +1567,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'resourceDescription' => 'Popo',
             'section' => 'Popo',
         ],
@@ -1586,6 +1596,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'resourceDescription' => 'Popo',
             'section' => 'Popo',
         ],
@@ -1622,6 +1633,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
             'resourceDescription' => 'Popo',
             'section' => 'Popo',
         ],
@@ -1889,6 +1901,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         13 => [
             'method' => 'GET',
@@ -1915,6 +1928,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         14 => [
             'method' => 'ANY',
@@ -1924,6 +1938,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         15 => [
             'method' => 'ANY',
@@ -1940,6 +1955,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         16 => [
             'method' => 'GET',
@@ -1949,6 +1965,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => true,
+            'scope' => null,
         ],
         17 => [
             'method' => 'POST',
@@ -1968,6 +1985,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         18 => [
             'method' => 'GET',
@@ -1984,6 +2002,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         19 => [
             'method' => 'GET',
@@ -1999,6 +2018,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         20 => [
             'method' => 'GET',
@@ -2034,6 +2054,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         22 => [
             'method' => 'ANY',
@@ -2135,6 +2156,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         23 => [
             'method' => 'ANY',
@@ -2182,6 +2204,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         24 => [
             'method' => 'ANY',
@@ -2283,6 +2306,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         25 => [
             'method' => 'POST',
@@ -2292,6 +2316,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         26 => [
             'method' => 'POST',
@@ -2301,6 +2326,7 @@
             'authenticationRoles' => [
             ],
             'deprecated' => false,
+            'scope' => null,
         ],
         27 => [
             'authentication' => false,
@@ -2309,6 +2335,7 @@
             'https' => false,
             'authenticationRoles' => [],
             'deprecated' => false,
+            'scope' => null,
             'requirements' => [
                 '_format' => [
                     'requirement' => '',