minor: Class_$parent_class_name and $child_class_names

Author: osmianski

runtime/Compilation/Class_.php

@@ -23,7 +23,9 @@
  * Computed:
  *
  * @property \ReflectionClass $reflection
+ * @property ?string $parent_class_name
  * @property Class_ $parent_class
+ * @property string[] $child_class_names
  * @property Class_[] $static_traits
  * @property Class_[] $actual_dynamic_traits
  * @property Class_[] $dynamic_traits
@@ -71,6 +73,24 @@ protected function get_parent_class(): ?Class_ {
         return $osm_app->app->classes[$class->getName()] ?? null;
     }
 
+    protected function get_parent_class_name(): ?string {
+        return $this->parent_class?->name;
+    }
+
+    protected function get_child_class_names(): array {
+        global $osm_app; /* @var Compiler $osm_app */
+
+        $childClassNames = [];
+
+        foreach ($osm_app->app->classes as $class) {
+            if ($class->parent_class_name == $this->name) {
+                $childClassNames[] = $class->name;
+            }
+        }
+
+        return $childClassNames;
+    }
+
     /** @noinspection PhpUnused */
     protected function get_static_traits(): array {
         global $osm_app; /* @var Compiler $osm_app */

src/Class_.php

@@ -13,6 +13,7 @@
  * @property string $name #[Serialized]
  * @property ?string $parent_class_name #[Serialized]
  * @property ?Class_ $parent_class
+ * @property string[] $child_class_names #[Serialized]
  * @property Property[] $properties #[Serialized]
  * @property Method[] $methods #[Serialized]
  * @property array|object[] $attributes #[Serialized]

tests/test_02_class_loading.php

@@ -41,6 +41,40 @@ public function test_that_module_classes_are_loaded() {
         });
     }
 
+    public function test_that_parent_classes_are_known() {
+        // GIVEN a compiler configured to compile a sample app
+        $compiler = Compiler::new(['app_class_name' => App::class]);
+
+        Apps::run($compiler, function(Compiler $compiler) {
+            // WHEN you check reflections of module classes
+            // THEN only classes of loaded modules are there
+            $this->assertArrayHasKey(\Osm\Core\Samples\Some\Some::class,
+                $compiler->app->classes);
+
+            // AND each class has a module class name assigned
+            $this->assertTrue($compiler->app->classes
+                [\Osm\Core\Samples\Some\Some::class]->parent_class_name ==
+                    \Osm\Core\Object_::class);
+        });
+    }
+
+    public function test_that_child_classes_are_known() {
+        // GIVEN a compiler configured to compile a sample app
+        $compiler = Compiler::new(['app_class_name' => App::class]);
+
+        Apps::run($compiler, function(Compiler $compiler) {
+            // WHEN you check reflections of module classes
+            // THEN only classes of loaded modules are there
+            $this->assertArrayHasKey(\Osm\Core\Samples\Some\Some::class,
+                $compiler->app->classes);
+
+            // AND each class has a module class name assigned
+            $this->assertTrue(in_array(\Osm\Core\Samples\Some\Other::class,
+                $compiler->app->classes[\Osm\Core\Samples\Some\Some::class]
+                    ->child_class_names));
+        });
+    }
+
     public function test_that_external_classes_are_loaded() {
         // GIVEN a compiler configured to compile a sample app
         $compiler = Compiler::new(['app_class_name' => App::class]);