added With class; added branch-alias to composer.json

Author: nix

README.md

@@ -187,6 +187,32 @@ echo (new Pipe('NOW')) // wrap initial value
 // prints: 2026
 ```
 
+### With
+
+A `With` object wraps an object and can be used to call any method on it with chaining support (handled by the wrapper).
+Note that any value returned by the method calls is discarded!
+
+```php
+With::new(mysqli::class, 'localhost', 'db_user', 'db_password')
+->set_charset('utf8mb4')
+->select_db('log')
+->autocommit(false)
+->begin_transaction()
+->execute_query('INSERT INTO ping')
+->execute_query('INSERT INTO pong')
+->commit()
+->close();
+```
+
+Or just use it for initialization calls and unwrap it then:
+```php
+$mysql = With::new(mysqli::class, 'localhost', 'db_user', 'db_password')
+->set_charset('utf8mb4')
+->select_db('log')
+->autocommit(false)
+->object; // unwrap
+```
+
 ## License
 Copyright © 2025 nix <https://keybase.io/nixn>
 

composer.json

@@ -15,5 +15,10 @@
         "psr-4": {
             "nixn\\php\\": "src/"
         }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-main": "1.1.x-dev"
+        }
     }
 }

src/With.php

@@ -0,0 +1,34 @@
+<?php
+namespace nixn\php;
+
+/** @since 1.1 */
+final class With
+{
+	/**
+	 * @template T
+	 * @param class-string<T> $class
+	 * @param mixed ...$args
+	 * @return T
+	 * @since 1.1
+	 */
+	public static function new(string $class, mixed ...$args): object
+	{
+		return new $class(...$args);
+	}
+
+	public function __construct(
+		public object $object,
+	)
+	{}
+
+	public function __call(string $method, array $args)
+	{
+		$this->object->{$method}(...$args);
+		return $this;
+	}
+
+	public function __toString(): string
+	{
+		return "$this->object";
+	}
+}