From 3e75931eea14b9bdce968bf33d446317fd994f61 Mon Sep 17 00:00:00 2001
From: "tien.xuan.vo" <tien.xuan.vo@gmail.com>
Date: Fri, 8 Dec 2023 21:18:34 +0700
Subject: [PATCH] refactor: Add generator classes

---
 .../Exception/InvalidUuidFormatException.php  |  9 ++++
 .../Matcher/Generators/AbstractDateTime.php   | 32 ++++++++++++
 .../Consumer/Matcher/Generators/Date.php      | 23 +++++++++
 .../Consumer/Matcher/Generators/DateTime.php  | 23 +++++++++
 .../Matcher/Generators/MockServerURL.php      | 30 +++++++++++
 .../Matcher/Generators/ProviderState.php      | 28 +++++++++++
 .../Matcher/Generators/RandomBoolean.php      | 21 ++++++++
 .../Matcher/Generators/RandomDecimal.php      | 26 ++++++++++
 .../Matcher/Generators/RandomHexadecimal.php  | 26 ++++++++++
 .../Consumer/Matcher/Generators/RandomInt.php | 27 ++++++++++
 .../Matcher/Generators/RandomString.php       | 26 ++++++++++
 .../Consumer/Matcher/Generators/Regex.php     | 26 ++++++++++
 .../Consumer/Matcher/Generators/Time.php      | 23 +++++++++
 .../Consumer/Matcher/Generators/Uuid.php      | 50 +++++++++++++++++++
 .../Matcher/Model/GeneratorInterface.php      |  9 ++++
 .../Consumer/Matcher/Generators/DateTest.php  | 21 ++++++++
 .../Matcher/Generators/DateTimeTest.php       | 21 ++++++++
 .../Matcher/Generators/MockServerURLTest.php  | 18 +++++++
 .../Matcher/Generators/ProviderStateTest.php  | 18 +++++++
 .../Matcher/Generators/RandomBooleanTest.php  | 18 +++++++
 .../Matcher/Generators/RandomDecimalTest.php  | 18 +++++++
 .../Generators/RandomHexadecimalTest.php      | 18 +++++++
 .../Matcher/Generators/RandomIntTest.php      | 18 +++++++
 .../Matcher/Generators/RandomStringTest.php   | 18 +++++++
 .../Consumer/Matcher/Generators/RegexTest.php | 18 +++++++
 .../Consumer/Matcher/Generators/TimeTest.php  | 21 ++++++++
 .../Consumer/Matcher/Generators/UuidTest.php  | 28 +++++++++++
 27 files changed, 614 insertions(+)
 create mode 100644 src/PhpPact/Consumer/Matcher/Exception/InvalidUuidFormatException.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/AbstractDateTime.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/Date.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/DateTime.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/MockServerURL.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/ProviderState.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/RandomBoolean.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/RandomDecimal.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/RandomHexadecimal.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/RandomInt.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/RandomString.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/Regex.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/Time.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Generators/Uuid.php
 create mode 100644 src/PhpPact/Consumer/Matcher/Model/GeneratorInterface.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/DateTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/DateTimeTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/MockServerURLTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/ProviderStateTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RandomBooleanTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RandomDecimalTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RandomHexadecimalTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RandomIntTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RandomStringTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/RegexTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/TimeTest.php
 create mode 100644 tests/PhpPact/Consumer/Matcher/Generators/UuidTest.php

diff --git a/src/PhpPact/Consumer/Matcher/Exception/InvalidUuidFormatException.php b/src/PhpPact/Consumer/Matcher/Exception/InvalidUuidFormatException.php
new file mode 100644
index 00000000..04cd925d
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Exception/InvalidUuidFormatException.php
@@ -0,0 +1,9 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Exception;
+
+use Exception;
+
+class InvalidUuidFormatException extends Exception
+{
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/AbstractDateTime.php b/src/PhpPact/Consumer/Matcher/Generators/AbstractDateTime.php
new file mode 100644
index 00000000..e7d8ba1c
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/AbstractDateTime.php
@@ -0,0 +1,32 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+abstract class AbstractDateTime implements GeneratorInterface
+{
+    public function __construct(private ?string $format = null, private ?string $expression = null)
+    {
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        $data = ['pact:generator:type' => $this->getType()];
+
+        if ($this->format !== null) {
+            $data['format'] = $this->format;
+        }
+
+        if ($this->expression !== null) {
+            $data['expression'] = $this->expression;
+        }
+
+        return $data;
+    }
+
+    abstract protected function getType(): string;
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/Date.php b/src/PhpPact/Consumer/Matcher/Generators/Date.php
new file mode 100644
index 00000000..9caefa82
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/Date.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+/**
+ * Generates a date value for the provided format.
+ * If no format is provided, ISO date format is used.
+ * If an expression is given, it will be evaluated to generate the date, otherwise 'today' will be used
+ *
+ * Example format: yyyy-MM-dd
+ * Example expression: +1 day
+ *
+ * NOTE: Java's datetime format is used, not PHP's datetime format
+ * For Java one, see https://www.digitalocean.com/community/tutorials/java-simpledateformat-java-date-format#patterns
+ * For PHP one, see https://www.php.net/manual/en/datetime.format.php#refsect1-datetime.format-parameters
+ */
+class Date extends AbstractDateTime
+{
+    protected function getType(): string
+    {
+        return 'Date';
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/DateTime.php b/src/PhpPact/Consumer/Matcher/Generators/DateTime.php
new file mode 100644
index 00000000..8d682ed9
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/DateTime.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+/**
+ * Generates a datetime value for the provided format.
+ * If no format is provided, ISO format is used.
+ * If an expression is given, it will be evaluated to generate the datetime, otherwise 'now' will be used
+ *
+ * Example format: yyyy-MM-dd'T'HH:mm:ss
+ * Example expression: +1 day
+ *
+ * NOTE: Java's datetime format is used, not PHP's datetime format
+ * For Java one, see https://www.digitalocean.com/community/tutorials/java-simpledateformat-java-date-format#patterns
+ * For PHP one, see https://www.php.net/manual/en/datetime.format.php#refsect1-datetime.format-parameters
+ */
+class DateTime extends AbstractDateTime
+{
+    protected function getType(): string
+    {
+        return 'DateTime';
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/MockServerURL.php b/src/PhpPact/Consumer/Matcher/Generators/MockServerURL.php
new file mode 100644
index 00000000..e8a34577
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/MockServerURL.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a URL with the mock server as the base URL.
+ *
+ * Example regex: .*(/path)$
+ * Example example: http://localhost:1234/path
+ */
+class MockServerURL implements GeneratorInterface
+{
+    public function __construct(private string $regex, private string $example)
+    {
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'regex'               => $this->regex,
+            'example'             => $this->example,
+            'pact:generator:type' => 'MockServerURL',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/ProviderState.php b/src/PhpPact/Consumer/Matcher/Generators/ProviderState.php
new file mode 100644
index 00000000..88b2d675
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/ProviderState.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a value that is looked up from the provider state context using the given expression
+ *
+ * Example expression: /products/${id}
+ */
+class ProviderState implements GeneratorInterface
+{
+    public function __construct(private string $expression)
+    {
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'expression'          => $this->expression,
+            'pact:generator:type' => 'ProviderState',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/RandomBoolean.php b/src/PhpPact/Consumer/Matcher/Generators/RandomBoolean.php
new file mode 100644
index 00000000..872ab29f
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/RandomBoolean.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random boolean value
+ */
+class RandomBoolean implements GeneratorInterface
+{
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'pact:generator:type' => 'RandomBoolean',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/RandomDecimal.php b/src/PhpPact/Consumer/Matcher/Generators/RandomDecimal.php
new file mode 100644
index 00000000..62ed7a8a
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/RandomDecimal.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random big decimal value with the provided number of digits
+ */
+class RandomDecimal implements GeneratorInterface
+{
+    public function __construct(private int $digits = 10)
+    {
+    }
+
+    /**
+     * @return array<string, string|int>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'digits'              => $this->digits,
+            'pact:generator:type' => 'RandomDecimal',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/RandomHexadecimal.php b/src/PhpPact/Consumer/Matcher/Generators/RandomHexadecimal.php
new file mode 100644
index 00000000..48ec6ed3
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/RandomHexadecimal.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random hexadecimal value of the given number of digits
+ */
+class RandomHexadecimal implements GeneratorInterface
+{
+    public function __construct(private int $digits = 10)
+    {
+    }
+
+    /**
+     * @return array<string, string|int>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'digits'              => $this->digits,
+            'pact:generator:type' => 'RandomHexadecimal',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/RandomInt.php b/src/PhpPact/Consumer/Matcher/Generators/RandomInt.php
new file mode 100644
index 00000000..df774c87
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/RandomInt.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random integer between the min and max values (inclusive)
+ */
+class RandomInt implements GeneratorInterface
+{
+    public function __construct(private int $min = 0, private int $max = 10)
+    {
+    }
+
+    /**
+     * @return array<string, string|int>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'min'                 => $this->min,
+            'max'                 => $this->max,
+            'pact:generator:type' => 'RandomInt',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/RandomString.php b/src/PhpPact/Consumer/Matcher/Generators/RandomString.php
new file mode 100644
index 00000000..f8be32a5
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/RandomString.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random alphanumeric string of the provided length
+ */
+class RandomString implements GeneratorInterface
+{
+    public function __construct(private int $size = 10)
+    {
+    }
+
+    /**
+     * @return array<string, string|int>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'size'                => $this->size,
+            'pact:generator:type' => 'RandomString',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/Regex.php b/src/PhpPact/Consumer/Matcher/Generators/Regex.php
new file mode 100644
index 00000000..0625269a
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/Regex.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+
+/**
+ * Generates a random string from the provided regular expression
+ */
+class Regex implements GeneratorInterface
+{
+    public function __construct(private string $regex)
+    {
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        return [
+            'regex'               => $this->regex,
+            'pact:generator:type' => 'Regex',
+        ];
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/Time.php b/src/PhpPact/Consumer/Matcher/Generators/Time.php
new file mode 100644
index 00000000..a535ae0a
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/Time.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+/**
+ * Generates a time value for the provided format.
+ * If no format is provided, ISO time format is used.
+ * If an expression is given, it will be evaluated to generate the time, otherwise 'now' will be used
+ *
+ * Example format: HH:mm:ss
+ * Example expression: +1 hour
+ *
+ * NOTE: Java's datetime format is used, not PHP's datetime format
+ * For Java one, see https://www.digitalocean.com/community/tutorials/java-simpledateformat-java-date-format#patterns
+ * For PHP one, see https://www.php.net/manual/en/datetime.format.php#refsect1-datetime.format-parameters
+ */
+class Time extends AbstractDateTime
+{
+    protected function getType(): string
+    {
+        return 'Time';
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Generators/Uuid.php b/src/PhpPact/Consumer/Matcher/Generators/Uuid.php
new file mode 100644
index 00000000..ad5ceadb
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Generators/Uuid.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Model\GeneratorInterface;
+use PhpPact\Consumer\Matcher\Exception\InvalidUuidFormatException;
+
+/**
+ * Generates a random UUID.
+ * V4 supports specifying the format:
+ * - simple (e.g 936DA01f9abd4d9d80c702af85c822a8)
+ * - lower-case-hyphenated (e.g 936da01f-9abd-4d9d-80c7-02af85c822a8)
+ * - upper-case-hyphenated (e.g 936DA01F-9ABD-4D9D-80C7-02AF85C822A8)
+ * - URN (e.g. urn:uuid:936da01f-9abd-4d9d-80c7-02af85c822a8)
+ */
+class Uuid implements GeneratorInterface
+{
+    public const SIMPLE_FORMAT = 'simple';
+    public const LOWER_CASE_HYPHENATED_FORMAT = 'lower-case-hyphenated';
+    public const UPPER_CASE_HYPHENATED_FORMAT = 'upper-case-hyphenated';
+    public const URN_FORMAT = 'URN';
+
+    public const FORMATS = [
+        self::SIMPLE_FORMAT,
+        self::LOWER_CASE_HYPHENATED_FORMAT,
+        self::UPPER_CASE_HYPHENATED_FORMAT,
+        self::URN_FORMAT,
+    ];
+
+    public function __construct(private ?string $format = null)
+    {
+        if ($format && !in_array($format, self::FORMATS, true)) {
+            throw new InvalidUuidFormatException(sprintf('Format %s is not supported. Supported formats are: %s', $format, implode(', ', self::FORMATS)));
+        }
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function jsonSerialize(): array
+    {
+        $data = ['pact:generator:type' => 'Uuid'];
+
+        if ($this->format !== null) {
+            $data['format'] = $this->format;
+        }
+
+        return $data;
+    }
+}
diff --git a/src/PhpPact/Consumer/Matcher/Model/GeneratorInterface.php b/src/PhpPact/Consumer/Matcher/Model/GeneratorInterface.php
new file mode 100644
index 00000000..7701bdb5
--- /dev/null
+++ b/src/PhpPact/Consumer/Matcher/Model/GeneratorInterface.php
@@ -0,0 +1,9 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Model;
+
+use JsonSerializable;
+
+interface GeneratorInterface extends JsonSerializable
+{
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/DateTest.php b/tests/PhpPact/Consumer/Matcher/Generators/DateTest.php
new file mode 100644
index 00000000..4354a611
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/DateTest.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\Date;
+use PHPUnit\Framework\TestCase;
+
+class DateTest extends TestCase
+{
+    /**
+     * @testWith [null,         null,     "{\"pact:generator:type\":\"Date\"}"]
+     *           ["yyyy-MM-dd", null,     "{\"pact:generator:type\":\"Date\",\"format\":\"yyyy-MM-dd\"}"]
+     *           [null,         "+1 day", "{\"pact:generator:type\":\"Date\",\"expression\":\"+1 day\"}"]
+     *           ["yyyy-MM-dd", "+1 day", "{\"pact:generator:type\":\"Date\",\"format\":\"yyyy-MM-dd\",\"expression\":\"+1 day\"}"]
+     */
+    public function testSerialize(?string $format, ?string $expression, string $json): void
+    {
+        $date = new Date($format, $expression);
+        $this->assertSame($json, json_encode($date));
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/DateTimeTest.php b/tests/PhpPact/Consumer/Matcher/Generators/DateTimeTest.php
new file mode 100644
index 00000000..9ae7d95f
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/DateTimeTest.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\DateTime;
+use PHPUnit\Framework\TestCase;
+
+class DateTimeTest extends TestCase
+{
+    /**
+     * @testWith [null,                    null,     "{\"pact:generator:type\":\"DateTime\"}"]
+     *           ["yyyy-MM-dd'T'HH:mm:ss", null,     "{\"pact:generator:type\":\"DateTime\",\"format\":\"yyyy-MM-dd'T'HH:mm:ss\"}"]
+     *           [null,                    "+1 day", "{\"pact:generator:type\":\"DateTime\",\"expression\":\"+1 day\"}"]
+     *           ["yyyy-MM-dd'T'HH:mm:ss", "+1 day", "{\"pact:generator:type\":\"DateTime\",\"format\":\"yyyy-MM-dd'T'HH:mm:ss\",\"expression\":\"+1 day\"}"]
+     */
+    public function testSerialize(?string $format, ?string $expression, string $json): void
+    {
+        $dateTime = new DateTime($format, $expression);
+        $this->assertSame($json, json_encode($dateTime));
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/MockServerURLTest.php b/tests/PhpPact/Consumer/Matcher/Generators/MockServerURLTest.php
new file mode 100644
index 00000000..4a7bb3b2
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/MockServerURLTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\MockServerURL;
+use PHPUnit\Framework\TestCase;
+
+class MockServerURLTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $url = new MockServerURL('.*(/path)$', 'http://localhost:1234/path');
+        $this->assertSame(
+            '{"regex":".*(\/path)$","example":"http:\/\/localhost:1234\/path","pact:generator:type":"MockServerURL"}',
+            json_encode($url)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/ProviderStateTest.php b/tests/PhpPact/Consumer/Matcher/Generators/ProviderStateTest.php
new file mode 100644
index 00000000..a6a80566
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/ProviderStateTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\ProviderState;
+use PHPUnit\Framework\TestCase;
+
+class ProviderStateTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $url = new ProviderState('/products/${id}');
+        $this->assertSame(
+            '{"expression":"\/products\/${id}","pact:generator:type":"ProviderState"}',
+            json_encode($url)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RandomBooleanTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RandomBooleanTest.php
new file mode 100644
index 00000000..c302f3c0
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RandomBooleanTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\RandomBoolean;
+use PHPUnit\Framework\TestCase;
+
+class RandomBooleanTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $boolean = new RandomBoolean();
+        $this->assertSame(
+            '{"pact:generator:type":"RandomBoolean"}',
+            json_encode($boolean)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RandomDecimalTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RandomDecimalTest.php
new file mode 100644
index 00000000..22aac2a9
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RandomDecimalTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\RandomDecimal;
+use PHPUnit\Framework\TestCase;
+
+class RandomDecimalTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $decimal = new RandomDecimal(12);
+        $this->assertSame(
+            '{"digits":12,"pact:generator:type":"RandomDecimal"}',
+            json_encode($decimal)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RandomHexadecimalTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RandomHexadecimalTest.php
new file mode 100644
index 00000000..be13ab06
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RandomHexadecimalTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\RandomHexadecimal;
+use PHPUnit\Framework\TestCase;
+
+class RandomHexadecimalTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $hexaDecimal = new RandomHexadecimal(8);
+        $this->assertSame(
+            '{"digits":8,"pact:generator:type":"RandomHexadecimal"}',
+            json_encode($hexaDecimal)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RandomIntTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RandomIntTest.php
new file mode 100644
index 00000000..70d3ff9d
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RandomIntTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\RandomInt;
+use PHPUnit\Framework\TestCase;
+
+class RandomIntTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $int = new RandomInt(5, 15);
+        $this->assertSame(
+            '{"min":5,"max":15,"pact:generator:type":"RandomInt"}',
+            json_encode($int)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RandomStringTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RandomStringTest.php
new file mode 100644
index 00000000..2adf26bf
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RandomStringTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\RandomString;
+use PHPUnit\Framework\TestCase;
+
+class RandomStringTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $string = new RandomString(11);
+        $this->assertSame(
+            '{"size":11,"pact:generator:type":"RandomString"}',
+            json_encode($string)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/RegexTest.php b/tests/PhpPact/Consumer/Matcher/Generators/RegexTest.php
new file mode 100644
index 00000000..00332a02
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/RegexTest.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\Regex;
+use PHPUnit\Framework\TestCase;
+
+class RegexTest extends TestCase
+{
+    public function testSerialize(): void
+    {
+        $regex = new Regex('[\w\d]+');
+        $this->assertSame(
+            '{"regex":"[\\\\w\\\\d]+","pact:generator:type":"Regex"}',
+            json_encode($regex)
+        );
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/TimeTest.php b/tests/PhpPact/Consumer/Matcher/Generators/TimeTest.php
new file mode 100644
index 00000000..d42d4e74
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/TimeTest.php
@@ -0,0 +1,21 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Generators\Time;
+use PHPUnit\Framework\TestCase;
+
+class TimeTest extends TestCase
+{
+    /**
+     * @testWith [null,       null,      "{\"pact:generator:type\":\"Time\"}"]
+     *           ["HH:mm:ss", null,      "{\"pact:generator:type\":\"Time\",\"format\":\"HH:mm:ss\"}"]
+     *           [null,       "+1 hour", "{\"pact:generator:type\":\"Time\",\"expression\":\"+1 hour\"}"]
+     *           ["HH:mm:ss", "+1 hour", "{\"pact:generator:type\":\"Time\",\"format\":\"HH:mm:ss\",\"expression\":\"+1 hour\"}"]
+     */
+    public function testSerialize(?string $format, ?string $expression, string $json): void
+    {
+        $time = new Time($format, $expression);
+        $this->assertSame($json, json_encode($time));
+    }
+}
diff --git a/tests/PhpPact/Consumer/Matcher/Generators/UuidTest.php b/tests/PhpPact/Consumer/Matcher/Generators/UuidTest.php
new file mode 100644
index 00000000..c5e08adb
--- /dev/null
+++ b/tests/PhpPact/Consumer/Matcher/Generators/UuidTest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace PhpPactTest\Consumer\Matcher\Generators;
+
+use PhpPact\Consumer\Matcher\Exception\InvalidUuidFormatException;
+use PhpPact\Consumer\Matcher\Generators\Uuid;
+use PHPUnit\Framework\TestCase;
+
+class UuidTest extends TestCase
+{
+    /**
+     * @testWith [null,                    "{\"pact:generator:type\":\"Uuid\"}"]
+     *           ["simple",                "{\"pact:generator:type\":\"Uuid\",\"format\":\"simple\"}"]
+     *           ["lower-case-hyphenated", "{\"pact:generator:type\":\"Uuid\",\"format\":\"lower-case-hyphenated\"}"]
+     *           ["upper-case-hyphenated", "{\"pact:generator:type\":\"Uuid\",\"format\":\"upper-case-hyphenated\"}"]
+     *           ["URN",                   "{\"pact:generator:type\":\"Uuid\",\"format\":\"URN\"}"]
+     *           ["invalid",               null]
+     */
+    public function testSerialize(?string $format, ?string $json): void
+    {
+        if (!$json) {
+            $this->expectException(InvalidUuidFormatException::class);
+            $this->expectExceptionMessage('Format invalid is not supported. Supported formats are: simple, lower-case-hyphenated, upper-case-hyphenated, URN');
+        }
+        $uuid = new Uuid($format);
+        $this->assertSame($json, json_encode($uuid));
+    }
+}