Merge pull request #59 from renoki-co/feature/k8s-macro

[feature] K8s Macro

Author: rennokki

docs/kinds/Resource.md

@@ -228,3 +228,15 @@ K8sPod::macro('changeMetadata', function (array $metadata) {
     return $this->setMetadata($metadata);
 });
 ```
+
+Usually, it's initialize the resources from `K8s` class, so that they automatically gets redirected to cluster calls that actually make the API requests, so if you have new resources to initialize, you can use the macro on it, for example, like an [Agones Fleet](https://agones.dev/site/docs/reference/fleet):
+
+```php
+K8s::macro('agonesFleet', function ($cluster = null, $attributes = []) {
+    return new Kinds\MyAgonesFleet($cluster, $attributes);
+});
+
+foreach (K8s::agonesFleet()->all() as $fleet) {
+    //
+}
+```

src/K8s.php

@@ -2,8 +2,15 @@
 
 namespace RenokiCo\PhpK8s;
 
+use Illuminate\Support\Traits\Macroable;
+
 class K8s
 {
+    use Macroable {
+        __call as macroCall;
+        __callStatic as macroCallStatic;
+    }
+
     /**
      * Create a new Node kind.
      *
@@ -395,4 +402,36 @@ public static function fromYamlFile($cluster, string $path)
     {
         return static::fromYaml($cluster, file_get_contents($path));
     }
+
+    /**
+     * Proxy the K8s call to cluster object.
+     *
+     * @param  string  $method
+     * @param  array  $parameters
+     * @return mixed
+     */
+    public function __call($method, $parameters)
+    {
+        if (static::hasMacro($method)) {
+            return $this->macroCall($method, $parameters);
+        }
+
+        return $this->cluster->{$method}(...$parameters);
+    }
+
+    /**
+     * Proxy the K8s static call to cluster object.
+     *
+     * @param  string  $method
+     * @param  array  $parameters
+     * @return mixed
+     */
+    public static function __callStatic($method, $parameters)
+    {
+        if (static::hasMacro($method)) {
+            return static::macroCallStatic($method, $parameters);
+        }
+
+        return new static;
+    }
 }

src/Traits/HasAttributes.php

@@ -81,7 +81,7 @@ public function getAttribute(string $name, $default = null)
      *
      * @param  string  $method
      * @param  array  $parameters
-     * @return $this
+     * @return mixed
      */
     public function __call(string $method, array $parameters)
     {

tests/Kinds/NewResource.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace RenokiCo\PhpK8s\Test\Kinds;
+
+use RenokiCo\PhpK8s\Kinds\K8sPod;
+
+class NewResource extends K8sPod
+{
+    //
+}

tests/MacroTest.php

@@ -37,4 +37,15 @@ public function test_resource_macro()
 
         $this->assertEquals(['val1', 'val2'], $pod->getMacroTest());
     }
+
+    public function test_k8s_macro()
+    {
+        K8s::macro('newResource', function ($cluster = null, $attributes = []) {
+            return new Kinds\NewResource($cluster, $attributes);
+        });
+
+        $this->assertInstanceOf(Kinds\NewResource::class, K8s::newResource());
+        $this->assertInstanceOf(Kinds\NewResource::class, (new K8s)->newResource());
+        $this->assertInstanceOf(Kinds\NewResource::class, $this->cluster->newResource());
+    }
 }