Add factories with variable drivers

Author: tontonsb

CHANGELOG.md

@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Driver swapping via factories
 
 
 ## [0.2.0] - 2024-05-27

README.md

@@ -86,6 +86,18 @@ SpatiaLite\Sfc::makePoint(1, 3)->setSRID(3059);
 // Produces SetSRID(MakePoint(?, ?), ?) with bindings [1, 3, 3059]
 ```
 
+Use factories with drivers set on them:
+
+```php
+// simple feature classes
+$sf = new Sf('PostGIS');
+$sf->point('mycol'); // a PostGIS/Point wrapping the `mycol`
+
+// simple feature constructors
+$sfc = new Sfc('PostGIS');
+$sfc->makePoint(1, 3); // a PostGIS/Point with ST_MakePoint(?, ?) and [1, 3] bindings
+```
+
 ## Usage examples
 
 This section presents some plain examples in plain PDO.

src/Sf.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace GlaivePro\SF;
+
+use GlaivePro\SF\OGC\Sfc as OGCSfc;
+
+/**
+ * Creating simple feature classes of the selected driver.
+ */
+class Sf
+{
+	protected string $namespace;
+
+	public function __construct(string $driver = 'OGC')
+	{
+		$this->namespace = '\\GlaivePro\\SF\\'.$driver.'\\';
+	}
+
+	public function __call($method, $args)
+	{
+		$class = $this->namespace.ucfirst($method);
+
+		return new $class(...$args);
+	}
+}

src/Sfc.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace GlaivePro\SF;
+
+use GlaivePro\SF\OGC\Sfc as OGCSfc;
+
+/**
+ * Simple feature constructors for the selected driver.
+ */
+class Sfc
+{
+	protected OGCSfc $driver;
+
+	public function __construct(string $driver = 'OGC')
+	{
+		$driverClass = '\\GlaivePro\\SF\\'.$driver.'\\Sfc';
+
+		$this->driver = new $driverClass;
+	}
+
+	public function __call($method, $args)
+	{
+		return $this->driver->$method(...$args);
+	}
+}

tests/Feature/SfTest.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace GlaivePro\SF\Tests\Feature;
+
+use PHPUnit\Framework\TestCase;
+use GlaivePro\SF\OGC\Contracts;
+use GlaivePro\SF\OGC;
+use GlaivePro\SF\PostGIS;
+use GlaivePro\SF\Sf;
+
+class SfTest extends TestCase
+{
+	public function testDefaultDriver(): void
+	{
+		$sf = new Sf;
+
+		$point = $sf->point('somecol');
+
+		$this->assertEquals('somecol', (string) $point);
+		$this->assertInstanceOf(Contracts\Point::class, $point);
+		$this->assertInstanceOf(OGC\Point::class, $point);
+		$this->assertNotInstanceOf(PostGIS\Point::class, $point);
+	}
+
+	public function testPostgisDriver(): void
+	{
+		$sf = new Sf('PostGIS');
+
+		$point = $sf->point('somecol');
+
+		$this->assertEquals('somecol', (string) $point);
+		$this->assertInstanceOf(Contracts\Point::class, $point);
+		$this->assertInstanceOf(PostGIS\Point::class, $point);
+		$this->assertNotInstanceOf(OGC\Point::class, $point);
+	}
+}

tests/Feature/SfcTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace GlaivePro\SF\Tests\Feature;
+
+use PHPUnit\Framework\TestCase;
+use GlaivePro\SF\OGC\Contracts;
+use GlaivePro\SF\OGC;
+use GlaivePro\SF\PostGIS;
+use GlaivePro\SF\Sfc;
+
+class SfcTest extends TestCase
+{
+	public function testDefaultDriver(): void
+	{
+		$sfc = new Sfc;
+
+		$point = $sfc->pointFromWkb('binary');
+
+		$this->assertEquals(
+			'ST_PointFromWKB(?)',
+			(string) $point,
+		);
+		$this->assertEquals(['binary'], $point->bindings);
+		$this->assertInstanceOf(Contracts\Point::class, $point);
+		$this->assertInstanceOf(OGC\Point::class, $point);
+		$this->assertNotInstanceOf(PostGIS\Point::class, $point);
+	}
+
+	public function testPostgisDriver(): void
+	{
+		$sfc = new Sfc('PostGIS');
+
+		$point = $sfc->pointFromWkb('binary');
+
+		$this->assertEquals(
+			'ST_PointFromWKB(?)',
+			(string) $point,
+		);
+		$this->assertEquals(['binary'], $point->bindings);
+		$this->assertInstanceOf(Contracts\Point::class, $point);
+		$this->assertInstanceOf(PostGIS\Point::class, $point);
+		$this->assertNotInstanceOf(OGC\Point::class, $point);
+	}
+}