Added macros

Author: rennokki

docs/RESOURCES.md

@@ -4,6 +4,7 @@
 
 - [Methods & Usage](Usage.md)
 - [Cluster & Authentication](Cluster.md)
+- [General Resources](kinds/Resource.md)
 
 ## Supported Instances
 

docs/kinds/Resource.md

@@ -182,3 +182,31 @@ $rule->addToAttribute('rules', 'some-rule')
 
 // rules: ['some-rule', 'another-rule']
 ```
+
+# Macros
+
+Beside the custom callers to call custom attributes, you can also define your own custom functions using [Macros](https://tighten.co/blog/the-magic-of-laravel-macros/). In case you are not familiar with Macros, you can see the following example on defining a custom function for the `K8sPod` instance.
+
+```php
+use RenokiCo\PhpK8s\Kinds\K8sPod;
+
+// changeDnsPolicy() does not exist in the code
+
+K8sPod::macro('changeDnsPolicy', function ($policy = 'None') {
+    return $this->setSpec('dnsPolicy', $policy);
+});
+
+K8s::pod()->changeDnsPolicy('ClusterFirst');
+```
+
+**`$this` keyword used within the closure is going to reference the current K8sPod object in this example. You might as well define how many macros you want. The closure can also contain parameters or no parameters at all, based on your needs.**
+
+Macros also work with custom callers:
+
+```php
+use RenokiCo\PhpK8s\Kinds\K8sPod;
+
+K8sPod::macro('changeMetadata', function (array $metadata) {
+    return $this->setMetadata($metadata);
+});
+```

src/Traits/HasAttributes.php

@@ -4,9 +4,14 @@
 
 use Illuminate\Support\Arr;
 use Illuminate\Support\Str;
+use Illuminate\Support\Traits\Macroable;
 
 trait HasAttributes
 {
+    use Macroable {
+        __call as macroCall;
+    }
+
     /**
      * The Kubernetes resource's attributes.
      *
@@ -80,6 +85,10 @@ public function getAttribute(string $name, $default = null)
      */
     public function __call(string $method, array $parameters)
     {
+        if (static::hasMacro($method)) {
+            return $this->macroCall($method, $parameters);
+        }
+
         // Intercept methods like ->setXXXX(...)
         if (Str::startsWith($method, 'set')) {
             $attribute = Str::camel(

tests/MacroTest.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace RenokiCo\PhpK8s\Test;
+
+use RenokiCo\PhpK8s\Instances\Container;
+use RenokiCo\PhpK8s\K8s;
+use RenokiCo\PhpK8s\Kinds\K8sPod;
+
+class MacroTest extends TestCase
+{
+    public function test_instances_macro()
+    {
+        Container::macro('macroTest', function ($var1, $var2) {
+            return $this->setMacroField([$var1, $var2]);
+        });
+
+        Container::macro('getMacroTest', function () {
+            return $this->getMacroField([]);
+        });
+
+        $container = K8s::container()->macroTest('val1', 'val2');
+
+        $this->assertEquals(['val1', 'val2'], $container->getMacroTest());
+    }
+
+    public function test_resource_macro()
+    {
+        K8sPod::macro('macroTest', function ($var1, $var2) {
+            return $this->setMacroField([$var1, $var2]);
+        });
+
+        K8sPod::macro('getMacroTest', function () {
+            return $this->getMacroField([]);
+        });
+
+        $pod = K8s::pod()->macroTest('val1', 'val2');
+
+        $this->assertEquals(['val1', 'val2'], $pod->getMacroTest());
+    }
+}