Merge pull request #2 from eclipxe13/master

Version 2.0.0

Author: eclipxe13

.php_cs.dist

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 return PhpCsFixer\Config::create()
     ->setRiskyAllowed(true)
-    ->setCacheFile(__DIR__.'/build/.php_cs.cache')
+    ->setCacheFile(__DIR__ . '/build/.php_cs.cache')
     ->setRules([
         '@PSR2' => true,
         '@PHP70Migration' => true,

.scrutinizer.yml

@@ -8,7 +8,7 @@ build:
     analysis:
       environment:
         php:
-          version: 7.3
+          version: "7.3"
       project_setup:
         override: true
       tests:

.travis.yml

@@ -6,8 +6,8 @@ sudo: false
 
 # php compatibility
 php:
-  - 7.2
-  - 7.3
+  - "7.2"
+  - "7.3"
 
 cache:
   - directories:

README.md

@@ -53,10 +53,10 @@ composer require phpcfdi/cfdi-expresiones
 
 ```php
 <?php
-use PhpCfdi\CfdiExpresiones\ExpressionExtractor;
+use PhpCfdi\CfdiExpresiones\DiscoverExtractor;
 
 // creamos el extractor
-$extractor = new ExpressionExtractor();
+$extractor = new DiscoverExtractor();
 
 // abrimos el documento en un DOMDocument
 $document = new DOMDocument();

docs/CHANGELOG.md

@@ -1,17 +1,15 @@
 # CHANGELOG
 
-## About SemVer
-
-In summary, [SemVer](https://semver.org/) can be viewed as ` Breaking . Feature . Fix `, where:
-
-- Breaking version = includes incompatible changes to the API
-- Feature version = adds new feature(s) in a backwards-compatible manner
-- Fix version = includes backwards-compatible bug fixes
-
-**Non breaking changes (doesn't apply any of the SemVer rules)**
-
-- Version `0.x.x`
-- Library elements with annotation `@internal` doesn't apply any of the SemVer rules
+## Version 2.0.0 2019-03-28
+
+- Allows to create an expression with format fixes from specific types
+- Change `ExpressionExtractorInterface` to add `public function format(array $values): string`
+- Give a unique name for extractors, so when discovering by type can obtain an item
+- Change `ExpressionExtractorInterface` to add `public function uniqueName(): string`
+    - `Comprobante33` uses `CFDI33`
+    - `Comprobante32` uses `CFDI32`
+    - `Retenciones10` uses `RET10`
+- Rename `ExpressionExtractor` to `DiscoverExtractor`, it makes more sense
 
 
 ## Version 1.0.0 2019-03-27

docs/SEMVER.md

@@ -0,0 +1,42 @@
+# SEMVER
+
+Respetamos el estándar [Versionado Semántico 2.0.0](https://semver.org/lang/es/).
+
+En resumen, [SemVer](https://semver.org/) es un sistema de versiones de tres componentes `X.Y.Z`
+que nombraremos así: ` Breaking . Feature . Fix `, donde:
+
+- `Breaking`: Rompe la compatibilidad de código con versiones anteriores.
+- `Feature`: Agrega una nueva característica que es compatible con lo anterior.
+- `Fix`: Incluye algún cambio (generalmente correcciones) que no agregan nueva funcionalidad.
+
+## Composer
+
+[Composer](https://getcomposer.org/) es un gestor de dependencias en proyectos para PHP.
+Este gestor usa las [reglas](https://getcomposer.org/doc/articles/versions.md)
+de versionado semántico para instalar y actualizar paquetes.
+
+Te recomendamos instalar dependencias de librerías (no frameworks) con *Caret Version Range*.
+Por ejemplo: `"vendor/package": "^2.5"`.
+
+Esto significa que:
+
+- no debe actualizar a versiones `3.x.x`
+- no debe utilizar ninguna versión menor a `2.5.0`
+
+## Versiones 0.x.y no rompe compatibilidad
+
+Las versiones que inician con cero, por ejemplo `0.y.z`, no se ajustan a las reglas de versionado.
+Se considera que estas versiones son previas a la madurez del proyecto y por lo tanto
+introducen cambios sin previo aviso.
+
+## `@internal` no rompe compatibilidad
+
+Si la librería contiene elementos marcados como `@internal` significa que no deben ser utilizados
+por tu código. Son partes de código internos de la librería.
+Por lo tanto, no se consideran breaking changes.
+
+Cuando un elemento es `@internal`, dicho elemento:
+
+- no debe ser una entrada (parámetro)
+- no debe ser una salida (retorno)
+- no debe exponer exponer funcionalidades en los objetos públicos (rasgos)

src/ExpressionExtractor.php renamed to src/DiscoverExtractor.php

@@ -10,7 +10,7 @@
 use PhpCfdi\CfdiExpresiones\Extractors\Comprobante33;
 use PhpCfdi\CfdiExpresiones\Extractors\Retenciones10;
 
-class ExpressionExtractor implements ExpressionExtractorInterface
+class DiscoverExtractor implements ExpressionExtractorInterface
 {
     /** @var ExpressionExtractorInterface[] */
     private $expressions;
@@ -35,11 +35,22 @@ public function defaultExtractors(): array
         ];
     }
 
+    /** @return ExpressionExtractorInterface[] */
     public function currentExpressionExtractors(): array
     {
         return $this->expressions;
     }
 
+    protected function findByUniqueName(string $uniqueName): ?ExpressionExtractorInterface
+    {
+        foreach ($this->expressions as $expression) {
+            if ($uniqueName === $expression->uniqueName()) {
+                return $expression;
+            }
+        }
+        return null;
+    }
+
     protected function findMatch(DOMDocument $document): ?ExpressionExtractorInterface
     {
         foreach ($this->expressions as $expression) {
@@ -54,7 +65,7 @@ protected function getFirstMatch(DOMDocument $document): ExpressionExtractorInte
     {
         $discovered = $this->findMatch($document);
         if (null === $discovered) {
-            throw new UnmatchedDocumentException('Cannot discover any ExpressionExtractor that matches with document');
+            throw new UnmatchedDocumentException('Cannot discover any DiscoverExtractor that matches with document');
         }
         return $discovered;
     }
@@ -64,9 +75,24 @@ public function matches(DOMDocument $document): bool
         return (null !== $this->findMatch($document));
     }
 
+    public function uniqueName(): string
+    {
+        return 'discover';
+    }
+
     public function extract(DOMDocument $document): string
     {
         $discovered = $this->getFirstMatch($document);
         return $discovered->extract($document);
     }
+
+    public function format(array $values, $type = ''): string
+    {
+        $extractor = $this->findByUniqueName($type);
+        if (null === $extractor) {
+            throw new UnmatchedDocumentException('DiscoverExtractor requires type key with an extractor identifier');
+        }
+        unset($values['type']);
+        return $extractor->format($values);
+    }
 }

src/ExpressionExtractorInterface.php

@@ -8,7 +8,17 @@
 
 interface ExpressionExtractorInterface
 {
+    public function uniqueName(): string;
+
     public function matches(DOMDocument $document): bool;
 
     public function extract(DOMDocument $document): string;
+
+    /**
+     * Format an expression based on given values
+     *
+     * @param array<string, string> $values
+     * @return string
+     */
+    public function format(array $values): string;
 }

src/Extractors/Comprobante32.php

@@ -20,6 +20,11 @@ public function __construct()
         $this->matchDetector = new MatchDetector('http://www.sat.gob.mx/cfd/3', 'cfdi:Comprobante', 'version', '3.2');
     }
 
+    public function uniqueName(): string
+    {
+        return 'CFDI32';
+    }
+
     public function matches(DOMDocument $document): bool
     {
         return $this->matchDetector->matches($document);
@@ -35,16 +40,27 @@ public function extract(DOMDocument $document): string
         $uuid = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Complemento', 'tfd:TimbreFiscalDigital', 'UUID');
         $rfcEmisor = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Emisor', 'rfc');
         $rfcReceptor = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Receptor', 'rfc');
-        $totalComprobante = $helper->getAttribute('cfdi:Comprobante', 'total');
+        $total = $helper->getAttribute('cfdi:Comprobante', 'total');
 
-        return '?' . implode('&', [
-            're=' . $rfcEmisor,
-            'rr=' . $rfcReceptor,
-            'tt=' . $this->formatTotal($totalComprobante),
-            'id=' . $uuid,
+        return $this->format([
+            're' => $rfcEmisor,
+            'rr' => $rfcReceptor,
+            'tt' => $total,
+            'id' => $uuid,
         ]);
     }
 
+    public function format(array $values): string
+    {
+        return '?'
+            . implode('&', [
+                're=' . ($values['re'] ?? ''),
+                'rr=' . ($values['rr'] ?? ''),
+                'tt=' . $this->formatTotal($values['tt'] ?? ''),
+                'id=' . ($values['id'] ?? ''),
+            ]);
+    }
+
     public function formatTotal(string $input): string
     {
         return str_pad(number_format(floatval($input), 6, '.', ''), 17, '0', STR_PAD_LEFT);

src/Extractors/Comprobante33.php

@@ -20,6 +20,11 @@ public function __construct()
         $this->matchDetector = new MatchDetector('http://www.sat.gob.mx/cfd/3', 'cfdi:Comprobante', 'Version', '3.3');
     }
 
+    public function uniqueName(): string
+    {
+        return 'CFDI33';
+    }
+
     public function matches(DOMDocument $document): bool
     {
         return $this->matchDetector->matches($document);
@@ -35,20 +40,30 @@ public function extract(DOMDocument $document): string
         $uuid = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Complemento', 'tfd:TimbreFiscalDigital', 'UUID');
         $rfcEmisor = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Emisor', 'Rfc');
         $rfcReceptor = $helper->getAttribute('cfdi:Comprobante', 'cfdi:Receptor', 'Rfc');
-        $totalComprobante = $helper->getAttribute('cfdi:Comprobante', 'Total');
+        $total = $helper->getAttribute('cfdi:Comprobante', 'Total');
         $sello = substr($helper->getAttribute('cfdi:Comprobante', 'Sello'), -8);
 
-        $total = $this->formatTotal($totalComprobante);
-
-        return 'https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?' . implode('&', [
-            'id=' . $uuid,
-            're=' . $rfcEmisor,
-            'rr=' . $rfcReceptor,
-            'tt=' . $total,
-            'fe=' . substr($sello, -8),
+        return $this->format([
+            'id' => $uuid,
+            're' => $rfcEmisor,
+            'rr' => $rfcReceptor,
+            'tt' => $total,
+            'fe' => substr($sello, -8),
         ]);
     }
 
+    public function format(array $values): string
+    {
+        return 'https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?'
+            . implode('&', [
+                'id=' . ($values['id'] ?? ''),
+                're=' . ($values['re'] ?? ''),
+                'rr=' . ($values['rr'] ?? ''),
+                'tt=' . $this->formatTotal($values['tt'] ?? ''),
+                'fe=' . ($values['fe'] ?? ''),
+            ]);
+    }
+
     public function formatTotal(string $input): string
     {
         $total = rtrim(number_format(floatval($input), 6, '.', ''), '0');