test: add tests and examples for Marche Temporali module

Author: lpaderiAltravia

readme.md

@@ -76,11 +76,44 @@ $impresa = $openapi->imprese->getByPartitaIva('12485671007');
 $track = $this->openapi->ufficiopostale->track('123456789'); 
 ```
 
-## Modulo ufficio postale
-### Creare raccomandata
+<!-- ## Modulo ufficio postale
+### Creare raccomandata -->
 
+## Modulo comuni
+Consente di prendere informazioni su comuni e provincie.
 
-## Modulo visure
+* `getCitiesByCap`
+* `getComuneByCatasto`
+* `getRegioni`
+* `getProvince`
+* `getComuni`
+
+### Esempi
+
+```php
+$provincia = 'RM';
+$comuni = $this->openapi->comuni->getComuni($provincia);
+
+var_dump($comuni['comuni']); 
+/*
+
+["nome_provincia"]=>
+  string(4) "Roma"
+  ["sigla_provincia"]=>
+  string(2) "RM"
+  ["regione"]=>
+  string(5) "Lazio"
+  ["comuni"]=>
+  array(121) {
+    [0]=>
+    string(6) "Affile"
+    ...
+*/
+
+
+```
+
+<!-- ## Modulo visure
 ### Utilizzo
 Il modulo espone i seguenti metodi: 
 * `sendRequest`
@@ -89,7 +122,7 @@ Il modulo espone i seguenti metodi:
 * `getDocument`
 * `setRicerca`
 
-### `sendRequest($VisRequest)`
+### `sendRequest($VisRequest)` -->
 
 
 ## Modulo imprese
@@ -103,4 +136,48 @@ Il modulo imprese espone i seguenti metodi:
 
 Per `getBySearch` e `getByPartitaIva` è richiesto accesso allo scope `/advance`
 
-## Modulo SMS
+### Esempi
+Utilizziamo `getBySearch` per cercare un'azienda il cui nome inizia con  `Altrav` a Roma
+
+```php
+$autocomplete = $this->openapi->imprese->getBySearch('Altrav*', 'RM');
+
+/*
+ [0]=>
+  object(stdClass)#41 (10) {
+    ["piva"]=>
+    string(11) "12485671007"
+    ["cf"]=>
+    string(11) "12485671007"
+    ["denominazione"]=>
+    string(20) "ALTRAVIA SERVIZI SRL"
+ [1]=>
+  object(stdClass)#42 (10) {
+    ["id"]=>
+    string(24) "4242424242"
+    ["denominazione"]=>
+    string(18) "xxx Altravia Esempio 2"
+    ...
+ */
+```
+
+## Modulo Marche Temporali
+* `availability`
+* `checkLotto`
+* `purcahse`
+
+### Esempi
+
+```php
+// Controlliamo la disponibilitá di una marca di inforcert o aruba
+$disponibilita = $this->openapi->marcheTemporali->availability('infocert', 1);
+
+// Se le marche sono disponibili, acquistiamone una
+if ($disponibilita->availability > 0) {
+    try {
+        $marca = $this->openapi->marcheTemporali->purcahse('infocert', 1);
+    } catch (\OpenApi\classes\exception\OpenApiMarcheTemporaliException $e) {
+        error_log(var_dump($e));
+    }
+}
+```

tests/ClientTest.php

@@ -47,6 +47,12 @@ public function __construct() {
             "PUT:ws.messaggisms.com/messages",
             "GET:ws.firmadigitale.com/richiesta",
             "POST:ws.firmadigitale.com/richiesta",
+            "GET:ws.marchetemporali.com/availability",
+            "GET:ws.marchetemporali.com/marche",
+            "POST:ws.marchetemporali.com/check_lotto",
+            "POST:ws.marchetemporali.com/marca",
+            "POST:ws.marchetemporali.com/verifica",
+            "POST:ws.marchetemporali.com/analisi",
         ];
 
         $this->openapi = new OpenApi($this->scopes, $this->username, $this->api_key, 'test');
@@ -74,18 +80,26 @@ public function testClientInstance() {
     //     var_dump($comuni[0]->nome);
     // }
 
-    public function testImprese() {
-        $impresa = $this->openapi->imprese->getByPartitaIva('00966950230');
-        $autocomplete = $this->openapi->imprese->getBySearch('*multiservizi*', 'RM');
-        $closed = $this->openapi->imprese->getClosed('00966950230');
-        $vat = $this->openapi->imprese->getVatGroup('00966950230');
-        $Pec = $this->openapi->imprese->getPec('00966950230');
-
-        $this->assertEquals($impresa->provincia, 'RM');
-        $this->assertIsArray($autocomplete);
-        $this->assertIsBool($closed->cessata);
-        $this->assertIsObject($vat);
-        $this->assertIsObject($Pec);
+    // public function testImprese() {
+    //     $impresa = $this->openapi->imprese->getByPartitaIva('00966950230');
+    //     $autocomplete = $this->openapi->imprese->getBySearch('Altrav*', 'RM');
+    //     $closed = $this->openapi->imprese->getClosed('00966950230');
+    //     $vat = $this->openapi->imprese->getVatGroup('00966950230');
+    //     $Pec = $this->openapi->imprese->getPec('00966950230');
+
+    //     $this->assertEquals($impresa->provincia, 'RM');
+    //     $this->assertIsArray($autocomplete);
+    //     var_dump($autocomplete);
+    //     $this->assertIsBool($closed->cessata);
+    //     $this->assertIsObject($vat);
+    //     $this->assertIsObject($Pec);
+    // }
+
+    public function testMarche() {
+        $marca = $this->openapi->marcheTemporali->availability('infocert', 1);
+        $comprata = $this->openapi->marcheTemporali->purcahse('infocert', 1);
+
+        $this->assertIsInt($marca->availability);
     }
 
     // public function testGeocoding() {