Add a possibility of customizing with the standard paper format (#28)

docs/customization.rst

@@ -58,7 +58,62 @@ The path provided can be relative as well as absolute.
 Paper size
 ----------
 
-You can override the default paper size with width and height (in inches):
+You can override the default paper size with standard paper size using the
+`PaperSize` enum :
+
+.. code-block:: php
+
+    use Sensiolabs\GotenbergBundle\Pdf\Gotenberg;
+
+    $twigPdfBuilder = $gotenberg->twig();
+    $twigPdfBuilder
+        ->content('path/to/template.html.twig')
+        ->paperStandardSize(PaperSize::A3);
+
+Or if you want you can create your own logic, you just need to implements `PaperSizeInterface`
+
+.. code-block:: php
+
+    use Sensiolabs\GotenbergBundle\Enum\PaperSizeInterface;
+
+    enum PdfSize implements PaperSizeInterface
+    {
+        case Letter;
+        case Legal;
+        case Tabloid;
+        case Ledger;
+
+        public function width(): float
+        {
+            return match ($this) {
+                PdfSize::Letter, PdfSize::Legal => 8.5,
+                PdfSize::Tabloid => 11,
+                PdfSize::Ledger => 17,
+            };
+        }
+
+        public function height(): float
+        {
+            return match ($this) {
+                PdfSize::Letter, PdfSize::Ledger => 11,
+                PdfSize::Legal => 14,
+                PdfSize::Tabloid => 17,
+            };
+        }
+    }
+
+And then use it with paperStandardSize.
+
+.. code-block:: php
+
+    use Sensiolabs\GotenbergBundle\Pdf\Gotenberg;
+
+    $twigPdfBuilder = $gotenberg->twig();
+    $twigPdfBuilder
+        ->content('path/to/template.html.twig')
+        ->paperStandardSize(PdfSize::Tabloid);
+
+Or, you can even override with your proper width and height (in inches):
 
 .. code-block:: php
 
@@ -69,17 +124,19 @@ You can override the default paper size with width and height (in inches):
         ->content('path/to/template.html.twig')
         ->paperSize(8.5, 11);
 
-* Letter - 8.5 x 11 (default)
-* Legal - 8.5 x 14
-* Tabloid - 11 x 17
-* Ledger - 17 x 11
-* A0 - 33.1 x 46.8
-* A1 - 23.4 x 33.1
-* A2 - 16.54 x 23.4
-* A3 - 11.7 x 16.54
-* A4 - 8.27 x 11.7
-* A5 - 5.83 x 8.27
-* A6 - 4.13 x 5.83
+.. tip::
+
+    * Letter - 8.5 x 11 (default)
+    * Legal - 8.5 x 14
+    * Tabloid - 11 x 17
+    * Ledger - 17 x 11
+    * A0 - 33.1 x 46.8
+    * A1 - 23.4 x 33.1
+    * A2 - 16.54 x 23.4
+    * A3 - 11.7 x 16.54
+    * A4 - 8.27 x 11.7
+    * A5 - 5.83 x 8.27
+    * A6 - 4.13 x 5.83
 
 Prefer CSS page size
 --------------------

src/Builder/AbstractChromiumPdfBuilder.php

@@ -3,6 +3,7 @@
 namespace Sensiolabs\GotenbergBundle\Builder;
 
 use Sensiolabs\GotenbergBundle\Client\GotenbergClientInterface;
+use Sensiolabs\GotenbergBundle\Enum\PaperSizeInterface;
 use Sensiolabs\GotenbergBundle\Enum\PdfPart;
 use Sensiolabs\GotenbergBundle\Exception\InvalidBuilderConfiguration;
 use Sensiolabs\GotenbergBundle\Exception\PdfPartRenderingException;
@@ -62,6 +63,14 @@ public function paperSize(float $width, float $height): static
         return $this;
     }
 
+    public function paperStandardSize(PaperSizeInterface $paperSize): static
+    {
+        $this->paperWidth($paperSize->width());
+        $this->paperHeight($paperSize->height());
+
+        return $this;
+    }
+
     public function paperWidth(float $width): static
     {
         $this->formFields['paperWidth'] = $width;

src/Enum/PaperSize.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Sensiolabs\GotenbergBundle\Enum;
+
+enum PaperSize implements PaperSizeInterface
+{
+    case A0;
+    case A1;
+    case A2;
+    case A3;
+    case A4;
+    case A5;
+    case A6;
+
+    public function width(): float
+    {
+        return match ($this) {
+            PaperSize::A0 => 33.1,
+            PaperSize::A1 => 23.4,
+            PaperSize::A2 => 16.54,
+            PaperSize::A3 => 11.7,
+            PaperSize::A4 => 8.27,
+            PaperSize::A5 => 5.83,
+            PaperSize::A6 => 4.13,
+        };
+    }
+
+    public function height(): float
+    {
+        return match ($this) {
+            PaperSize::A0 => 46.8,
+            PaperSize::A1 => 33.1,
+            PaperSize::A2 => 23.4,
+            PaperSize::A3 => 16.54,
+            PaperSize::A4 => 11.7,
+            PaperSize::A5 => 8.27,
+            PaperSize::A6 => 5.83,
+        };
+    }
+}

src/Enum/PaperSizeInterface.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Sensiolabs\GotenbergBundle\Enum;
+
+interface PaperSizeInterface
+{
+    public function width(): float;
+
+    public function height(): float;
+}

tests/Builder/HtmlPdfBuilderTest.php

@@ -6,6 +6,7 @@
 use PHPUnit\Framework\Attributes\UsesClass;
 use Sensiolabs\GotenbergBundle\Builder\HtmlPdfBuilder;
 use Sensiolabs\GotenbergBundle\Client\GotenbergClientInterface;
+use Sensiolabs\GotenbergBundle\Enum\PaperSize;
 use Sensiolabs\GotenbergBundle\Exception\ExtraHttpHeadersJsonEncodingException;
 use Sensiolabs\GotenbergBundle\Exception\PdfPartRenderingException;
 use Sensiolabs\GotenbergBundle\Formatter\AssetBaseDirFormatter;
@@ -96,6 +97,26 @@ public function testWithAssets(): void
         self::assertSame('image/png', $multipartFormData[1]['files']->getContentType());
     }
 
+    public function testWithPaperStandardSize(): void
+    {
+        $client = $this->createMock(GotenbergClientInterface::class);
+        $assetBaseDirFormatter = new AssetBaseDirFormatter(new Filesystem(), self::FIXTURE_DIR, self::FIXTURE_DIR);
+
+        $builder = new HtmlPdfBuilder($client, $assetBaseDirFormatter);
+        $builder->contentFile('content.html');
+        $builder->paperStandardSize(PaperSize::A3);
+
+        $multipartFormData = $builder->getMultipartFormData();
+
+        self::assertCount(3, $multipartFormData);
+
+        self::assertArrayHasKey('paperWidth', $multipartFormData[1]);
+        self::assertArrayHasKey('paperHeight', $multipartFormData[2]);
+
+        self::assertSame((string) PaperSize::A3->width(), $multipartFormData[1]['paperWidth']);
+        self::assertSame((string) PaperSize::A3->height(), $multipartFormData[2]['paperHeight']);
+    }
+
     public function testWithHeader(): void
     {
         $client = $this->createMock(GotenbergClientInterface::class);

tests/Enum/PaperSizeTest.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Sensiolabs\GotenbergBundle\Tests\Enum;
+
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+use Sensiolabs\GotenbergBundle\Enum\PaperSize;
+
+#[CoversClass(PaperSize::class)]
+final class PaperSizeTest extends TestCase
+{
+    public function testWidth(): void
+    {
+        foreach (PaperSize::cases() as $size) {
+            $size->width();
+            self::addToAssertionCount(1);
+        }
+    }
+
+    public function testHeight(): void
+    {
+        foreach (PaperSize::cases() as $size) {
+            $size->height();
+            self::addToAssertionCount(1);
+        }
+    }
+}