refactor: Define enums

compatibility-suite/tests/Context/V3/Message/ConsumerContext.php

@@ -5,7 +5,7 @@
 use Behat\Behat\Context\Context;
 use Behat\Gherkin\Node\TableNode;
 use Exception;
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\MessageBuilder;
 use PhpPact\Standalone\PactMessage\PactMessageConfig;
 use PhpPactTest\CompatibilitySuite\Constant\Path;
@@ -41,7 +41,7 @@ public function __construct(
             ->setProvider(PactPath::PROVIDER)
             ->setPactDir(Path::PACTS_PATH)
             ->setPactSpecificationVersion($specificationVersion)
-            ->setPactFileWriteMode(PactConfigInterface::MODE_OVERWRITE);
+            ->setPactFileWriteMode(WriteMode::OVERWRITE);
         $this->builder = new MessageBuilder($config);
     }
 

compatibility-suite/tests/Context/V4/CombinedContext.php

@@ -3,7 +3,7 @@
 namespace PhpPactTest\CompatibilitySuite\Context\V4;
 
 use Behat\Behat\Context\Context;
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Model\Message;
 use PhpPactTest\CompatibilitySuite\Model\PactPath;
 use PhpPactTest\CompatibilitySuite\Service\InteractionBuilderInterface;
@@ -51,10 +51,10 @@ public function aMessageInteractionIsBeingDefinedForAConsumerTest(): void
      */
     public function thePactFileForTheTestIsGenerated(): void
     {
-        $this->pactWriter->write($this->id, $this->pactPath, PactConfigInterface::MODE_MERGE);
+        $this->pactWriter->write($this->id, $this->pactPath, WriteMode::MERGE);
         $message = new Message();
         $message->setDescription('message interaction');
-        $this->messagePactWriter->write($message, $this->pactPath, PactConfigInterface::MODE_MERGE);
+        $this->messagePactWriter->write($message, $this->pactPath, WriteMode::MERGE);
     }
 
     /**

compatibility-suite/tests/Service/MessagePactWriter.php

@@ -2,7 +2,7 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Factory\MessageDriverFactory;
 use PhpPact\Consumer\Model\Message;
 use PhpPact\Standalone\MockService\MockServerConfig;
@@ -17,7 +17,7 @@ public function __construct(
     ) {
     }
 
-    public function write(Message $message, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void
+    public function write(Message $message, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void
     {
         $config = new MockServerConfig();
         $config

compatibility-suite/tests/Service/MessagePactWriterInterface.php

@@ -2,11 +2,11 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Model\Message;
 use PhpPactTest\CompatibilitySuite\Model\PactPath;
 
 interface MessagePactWriterInterface
 {
-    public function write(Message $message, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void;
+    public function write(Message $message, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void;
 }

compatibility-suite/tests/Service/PactWriter.php

@@ -2,7 +2,7 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Factory\InteractionDriverFactory;
 use PhpPact\Standalone\MockService\MockServerConfig;
 use PhpPactTest\CompatibilitySuite\Constant\Path;
@@ -16,7 +16,7 @@ public function __construct(
     ) {
     }
 
-    public function write(int $id, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void
+    public function write(int $id, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void
     {
         $config = new MockServerConfig();
         $config

compatibility-suite/tests/Service/PactWriterInterface.php

@@ -2,10 +2,10 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPactTest\CompatibilitySuite\Model\PactPath;
 
 interface PactWriterInterface
 {
-    public function write(int $id, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void;
+    public function write(int $id, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void;
 }

compatibility-suite/tests/Service/Server.php

@@ -2,7 +2,7 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Driver\Interaction\InteractionDriverInterface;
 use PhpPact\Consumer\Factory\InteractionDriverFactory;
 use PhpPact\Standalone\MockService\MockServerConfig;
@@ -30,7 +30,7 @@ public function __construct(
             ->setProvider(PactPath::PROVIDER)
             ->setPactDir(Path::PACTS_PATH)
             ->setPactSpecificationVersion($specificationVersion)
-            ->setPactFileWriteMode(PactConfigInterface::MODE_OVERWRITE);
+            ->setPactFileWriteMode(WriteMode::OVERWRITE);
 
         if ($level = \getenv('PACT_LOGLEVEL')) {
             $this->config->setLogLevel($level);

compatibility-suite/tests/Service/SyncMessagePactWriter.php

@@ -2,7 +2,7 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Model\Message;
 use PhpPact\Standalone\MockService\MockServerConfig;
 use PhpPact\SyncMessage\Factory\SyncMessageDriverFactory;
@@ -16,7 +16,7 @@ public function __construct(
     ) {
     }
 
-    public function write(Message $message, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void
+    public function write(Message $message, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void
     {
         $config = new MockServerConfig();
         $config

compatibility-suite/tests/Service/SyncMessagePactWriterInterface.php

@@ -2,11 +2,11 @@
 
 namespace PhpPactTest\CompatibilitySuite\Service;
 
-use PhpPact\Config\PactConfigInterface;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Consumer\Model\Message;
 use PhpPactTest\CompatibilitySuite\Model\PactPath;
 
 interface SyncMessagePactWriterInterface
 {
-    public function write(Message $message, PactPath $pactPath, string $mode = PactConfigInterface::MODE_OVERWRITE): void;
+    public function write(Message $message, PactPath $pactPath, WriteMode $mode = WriteMode::OVERWRITE): void;
 }

src/PhpPact/Config/Enum/WriteMode.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace PhpPact\Config\Enum;
+
+enum WriteMode: string
+{
+    /**
+     * The entire file is overwritten
+     */
+    case OVERWRITE = 'overwrite';
+    /**
+     * Interactions are added
+     */
+    case MERGE = 'merge';
+}

src/PhpPact/Config/Exception/ConfigException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace PhpPact\Config\Exception;
+
+use PhpPact\Exception\BaseException;
+
+class ConfigException extends BaseException
+{
+}

src/PhpPact/Config/Exception/InvalidWriteModeException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace PhpPact\Config\Exception;
+
+class InvalidWriteModeException extends ConfigException
+{
+}

src/PhpPact/Config/PactConfig.php

@@ -3,6 +3,8 @@
 namespace PhpPact\Config;
 
 use Composer\Semver\VersionParser;
+use PhpPact\Config\Enum\WriteMode;
+use PhpPact\Config\Exception\InvalidWriteModeException;
 
 class PactConfig implements PactConfigInterface
 {
@@ -40,7 +42,7 @@ class PactConfig implements PactConfigInterface
      * pact file is deleted before running tests when using this option so that
      * interactions deleted from the code are not maintained in the file.
      */
-    private string $pactFileWriteMode = self::MODE_MERGE;
+    private WriteMode $pactFileWriteMode = WriteMode::MERGE;
 
     /**
      * {@inheritdoc}
@@ -155,24 +157,27 @@ public function setLog(string $log): self
     /**
      * {@inheritdoc}
      */
-    public function getPactFileWriteMode(): string
+    public function getPactFileWriteMode(): WriteMode
     {
         return $this->pactFileWriteMode;
     }
 
     /**
      * {@inheritdoc}
      */
-    public function setPactFileWriteMode(string $pactFileWriteMode): self
+    public function setPactFileWriteMode(string|WriteMode $pactFileWriteMode): self
     {
-        $options = [self::MODE_OVERWRITE, self::MODE_MERGE];
-
-        if (!\in_array($pactFileWriteMode, $options)) {
-            $implodedOptions = \implode(', ', $options);
-
-            throw new \InvalidArgumentException("Invalid PhpPact File Write Mode, value must be one of the following: {$implodedOptions}.");
+        if (is_string($pactFileWriteMode)) {
+            try {
+                $pactFileWriteMode = WriteMode::from($pactFileWriteMode);
+            } catch (\Throwable $th) {
+                $all = implode(', ', array_map(
+                    fn (WriteMode $mode) => $mode->value,
+                    WriteMode::cases()
+                ));
+                throw new InvalidWriteModeException(sprintf("Mode '%s' is not supported. Supported modes are: %s", $pactFileWriteMode, $all));
+            }
         }
-
         $this->pactFileWriteMode = $pactFileWriteMode;
 
         return $this;

src/PhpPact/Config/PactConfigInterface.php

@@ -2,7 +2,8 @@
 
 namespace PhpPact\Config;
 
-use InvalidArgumentException;
+use PhpPact\Config\Exception\InvalidWriteModeException;
+use PhpPact\Config\Enum\WriteMode;
 use UnexpectedValueException;
 
 /**
@@ -12,9 +13,16 @@ interface PactConfigInterface
 {
     public const DEFAULT_SPECIFICATION_VERSION = '3.0.0';
 
+    /**
+     * @deprecated Use WriteMode::OVERWRITE instead
+     */
     public const MODE_OVERWRITE = 'overwrite';
+    /**
+     * @deprecated Use WriteMode::MERGE instead
+     */
     public const MODE_MERGE = 'merge';
 
+
     public function getConsumer(): string;
 
     /**
@@ -65,15 +73,10 @@ public function getLogLevel(): ?string;
 
     public function setLogLevel(string $logLevel): self;
 
-    /**
-     * @return string 'merge' or 'overwrite' merge means that interactions are added and overwrite means that the entire file is overwritten
-     */
-    public function getPactFileWriteMode(): string;
+    public function getPactFileWriteMode(): WriteMode;
 
     /**
-     * @param string $pactFileWriteMode 'merge' or 'overwrite' merge means that interactions are added and overwrite means that the entire file is overwritten
-     *
-     * @throws InvalidArgumentException If mode is incorrect.
+     * @throws InvalidWriteModeException If mode is incorrect.
      */
-    public function setPactFileWriteMode(string $pactFileWriteMode): self;
+    public function setPactFileWriteMode(string|WriteMode $pactFileWriteMode): self;
 }

src/PhpPact/Consumer/Driver/Pact/PactDriver.php

@@ -3,6 +3,7 @@
 namespace PhpPact\Consumer\Driver\Pact;
 
 use Composer\Semver\Comparator;
+use PhpPact\Config\Enum\WriteMode;
 use PhpPact\Config\PactConfigInterface;
 use PhpPact\Consumer\Driver\Exception\MissingPactException;
 use PhpPact\Consumer\Driver\Exception\PactFileNotWrittenException;
@@ -34,7 +35,7 @@ public function writePact(): void
         $error = $this->client->pactHandleWriteFile(
             $this->getPact()->handle,
             $this->config->getPactDir(),
-            $this->config->getPactFileWriteMode() === PactConfigInterface::MODE_OVERWRITE
+            $this->config->getPactFileWriteMode() === WriteMode::OVERWRITE
         );
         if ($error) {
             throw new PactFileNotWrittenException($error);

src/PhpPact/Consumer/Matcher/Enum/HttpStatus.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Enum;
+
+use PhpPact\Consumer\Matcher\Model\Range;
+
+enum HttpStatus: string
+{
+    case INFORMATION = 'info';
+    case SUCCESS = 'success';
+    case REDIRECT = 'redirect';
+    case CLIENT_ERROR = 'clientError';
+    case SERVER_ERROR = 'serverError';
+    case NON_ERROR = 'nonError';
+    case ERROR = 'error';
+
+    public function range(): Range
+    {
+        return match($this) {
+            self::INFORMATION => new Range(100, 199),
+            self::SUCCESS => new Range(200, 299),
+            self::REDIRECT => new Range(300, 399),
+            self::CLIENT_ERROR => new Range(400, 499),
+            self::SERVER_ERROR => new Range(500, 599),
+            self::NON_ERROR => new Range(100, 399),
+            self::ERROR => new Range(400, 599),
+        };
+    }
+}

src/PhpPact/Consumer/Matcher/Enum/UuidFormat.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace PhpPact\Consumer\Matcher\Enum;
+
+enum UuidFormat: string
+{
+    case SIMPLE = 'simple';
+    case LOWER_CASE_HYPHENATED = 'lower-case-hyphenated';
+    case UPPER_CASE_HYPHENATED = 'upper-case-hyphenated';
+    case URN = 'URN';
+}