Added macro for K8s

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,14 @@
 
 namespace RenokiCo\PhpK8s;
 
+use Illuminate\Support\Traits\Macroable;
+
 class K8s
 {
+    use Macroable {
+        __call as macroCall;
+    }
+
     /**
      * Create a new Node kind.
      *
@@ -395,4 +401,20 @@ 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);
+    }
 }

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/MacroTest.php

@@ -37,4 +37,14 @@ 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 K8sPod($cluster, $attributes);
+        });
+
+        $this->assertInstanceOf(K8sPod::class, K8s::newResource());
+        $this->assertInstanceOf(K8sPod::class, $this->cluster->newResource());
+    }
 }