iris-rb 0.1.17 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f530ed97880d96359159d5cb55abee605f9aa59d1f23e536b4c1885288da71c
-  data.tar.gz: bbf25b5000ec1e074e6420edff1a9d13c3a23053444ca38366a9d91cc96c5ec0
+  metadata.gz: 342f7b6e458a03751e4cc02ea3ea1d1136facb8ba2f1c9b3e6ed2618356009b6
+  data.tar.gz: 23dd8f9356408ff363e1d9c248a37510ea2b91eb91068abcb4347c452c7410bc
 SHA512:
-  metadata.gz: 60da79d63bd677064142b3db4a7fe870b7c5832da12d47c14532a0ad8795812d6f7b7d2820602c9211869bf362f878c70444b0d9048b0901ec52ce54c34868dc
-  data.tar.gz: b8aa932680104bf1aeaf67c93e3b84336ac08e2dee651137f9d3e1d56a8b40950c04f72887e695615e4157036d328704cd558fe2fb35d7945bb60dbfe1096b3a
+  metadata.gz: a06570fcdf74938281327bbded5e1742bdbcf81a5454907454b55aed8359e939158578f68bf856331c432b52a0112ddbfb51251afd59946d65f741d046eec956
+  data.tar.gz: 9a92fa07eebcbc5130d9cdb174b67a8ff3ec38c5675894b864a918f4e6348886e8e2c3d66ffbded6dc41890557a26aba8d1b19fee5a6008667616bef9ca56819

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    iris-rb (0.1.10)
+    iris-rb (0.1.17)
       italian-ruby (~> 0.1)
       rack (~> 2.2)
 
@@ -9,7 +9,7 @@ GEM
   remote: https://rubygems.org/
   specs:
     diff-lcs (1.3)
-    italian-ruby (0.1.13)
+    italian-ruby (0.1.17)
       ruby2ruby (~> 2.4)
     rack (2.2.2)
     rake (12.3.3)

data/lib/iris/applicazione.ir

@@ -1,7 +1,7 @@
 ##
 # Descrive un'applicazione di Iris.
 # Un'applicazione Iris è compatibile con Rack, quindi è un
-# oggetto che risponde al metodo `call` (alias `chiama` per Italian Ruby)
+# oggetto che risponde al metodo `call` (alias `avvia` per Italian Ruby)
 # e ritorna una risposta in forma di array con stato, intestazioni e corpo.
 #
 # Un'esempio di applicazione Iris può essere il seguente:
@@ -43,10 +43,10 @@ modulo Iris
 
     ##
     # Questo metodo rende Iris::Applicazione compatibile con Rack.
-    definisci chiama(env)
+    definisci avvia(env)
       @app.call env
     fine
-    alias     :call         :chiama
+    alias     :call         :avvia
 
   fine
 fine

data/lib/iris/azione/parametri.ir

@@ -16,7 +16,7 @@ modulo Iris
     #       fine
     #     fine
     #
-    #     definisci chiama
+    #     definisci avvia
     #     fine
     #
     #   fine
@@ -98,7 +98,7 @@ modulo Iris
         ritorna se @validi == no
 
         regola_rispettata = si
-        regola_rispettata = blocco.chiama se blocco.esiste?
+        regola_rispettata = blocco.avvia se blocco.esiste?
         se regola_rispettata == no
           @validi = no
           @errori.deposita :regole, [] se @errori.non_ha_chiave? :regole
@@ -135,7 +135,7 @@ modulo Iris
           lancia :controllo_terminato se valore_parametro.nullo?
 
           parametri_annidati = Parametri.nuovo valore_parametro
-          blocco.chiama parametri_annidati
+          blocco.avvia parametri_annidati
           @validi = (@validi e parametri_annidati.validi?)
           @parametri_processati.deposita parametro, parametri_annidati.ottieni se @validi == si
           @errori.deposita parametro, parametri_annidati.errori se parametri_annidati.errati?

data/lib/iris/azione/registratore.ir

@@ -13,10 +13,10 @@ modulo Iris
           applicazione      =  "IRIS"
         fine
 
-        metodo_richiesta    = @env["REQUEST_METHOD"]
-        percorso_richiesta  = @env["REQUEST_PATH"]
-        parametri           = @env["iris.parametri"]
-        inizio_richiesta    = @env["timer.start"]
+        metodo_richiesta    = @richiesta["REQUEST_METHOD"]
+        percorso_richiesta  = @richiesta["REQUEST_PATH"]
+        parametri           = @richiesta["iris.parametri"]
+        inizio_richiesta    = @richiesta["timer.start"]
         se inizio_richiesta.specificato?
           tempo_richiesta   = "#{((Tempo.adesso - inizio_richiesta) * 1000).arrotonda}ms"
         altrimenti

data/lib/iris/azione.ir

@@ -1,3 +1,4 @@
+require           "json"
 richiedi_relativo "azione/intestazioni"
 richiedi_relativo "azione/parametri"
 richiedi_relativo "azione/registratore"
@@ -26,7 +27,7 @@ richiedi_relativo "azione/registratore"
 #       classe ListaLibri
 #         includi Iris::Azione
 #
-#         definisci chiama
+#         definisci avvia
 #           [ 200, {}, [ "Libri" ] ]
 #         fine
 #
@@ -34,7 +35,7 @@ richiedi_relativo "azione/registratore"
 #     fine
 #   fine
 #
-# L'azione `ListaLibri` deve implementare il metodo chiama, che permette
+# L'azione `ListaLibri` deve implementare il metodo avvia, che permette
 # di eseguire la procedura desiderata, e fornire la risposta utilizzando
 # le variabili d'istanza `@stato`, `@intestazioni` e `@corpo`.
 modulo Iris
@@ -56,8 +57,8 @@ modulo Iris
 
     ##
     # Metodo principale eseguito per risolvere l'azione.
-    definisci call(env)
-      _imposta_variabili_istanza env
+    definisci _avvia(richiesta)
+      _imposta_variabili_istanza richiesta
       _converti_parametri_interrogazione
       _converti_corpo_in_json
       _inizializza_parametri
@@ -66,13 +67,14 @@ modulo Iris
         inizia
           prima
           valida_parametri
-          chiama
+          rilascia se blocco_dato?
         recupera StandardError => errore
-          @errore = errore
+          alza errore a_meno_che Iris.configurazione.cattura_errori
+
           se Iris.configurazione.blocco_recupero_errori.esiste?
-            esegui_in_istanza &Iris.configurazione.blocco_recupero_errori
+            esegui_in_istanza errore, &Iris.configurazione.blocco_recupero_errori
           altrimenti
-            arresta 500, errore: @errore
+            arresta 500, errore: errore
           fine
         fine
       fine
@@ -84,16 +86,7 @@ modulo Iris
 
       [ @stato, @intestazioni, [ @corpo ] ]
     fine
-    alias     :avvia      :call
-
-    ##
-    # Metodo per risolvere l'azione in modo personalizzato.
-    # In questo metodo è possibile impostare lo stato, le intestazioni
-    # o il corpo della risposta. È inoltre possibile utilizzare
-    # i metodi `arresta` e `stato` per interrompere il flusso dell'azione
-    # e ritornare immediatamente i valori passati.
-    definisci chiama
-    fine
+    alias     :call      :_avvia
 
     ##
     # Aggiunge un aggancio per eseguire codice prima
@@ -101,7 +94,6 @@ modulo Iris
     # controlli sull'utente o altre cose distribuite su azioni
     # multiple.
     definisci prima
-      rilascia se blocco_dato?
     fine
 
     ##
@@ -109,7 +101,6 @@ modulo Iris
     # dell'azione effettiva. A questo punto sono già definiti
     # stato, intestazioni e corpo della risposta.
     definisci dopo
-      rilascia se blocco_dato?
     fine
 
     ##
@@ -134,48 +125,77 @@ modulo Iris
     fine
     alias     :stato      :arresta
 
+    ##
+    # Codice da eseguire all'inclusione del modulo.
+    definisci se_stesso.included(azione)
+      azione.class_eval esegui
+        preponi Iris::Azione::InterfacciaAvvio
+      fine
+    fine
+
     privati
 
       ##
       # Imposta le variabili d'istanza iniziali.
-      definisci _imposta_variabili_istanza(env)
-        @env                      = env
-        @stato                    = 200
-        @intestazioni             = INTESTAZIONI_PREDEFINITE
-        @corpo                    = nullo
-        @env["iris.parametri"]  ||= Mappa.nuova
+      definisci _imposta_variabili_istanza(richiesta)
+        @richiesta                      = richiesta
+        @stato                          = 200
+        @intestazioni                   = INTESTAZIONI_PREDEFINITE
+        @corpo                          = nullo
+        @richiesta["iris.parametri"]  ||= Mappa.nuova
       fine
 
       ##
       # Inizializza i parametri.
       definisci _inizializza_parametri
-        @parametri = Parametri.nuovo @env["iris.parametri"]
+        @parametri = Parametri.nuovo @richiesta["iris.parametri"]
       fine
 
       ##
       # Converte il corpo della richiesta in JSON.
       definisci _converti_corpo_in_json
-        ritorna se @env["rack.input"].nullo?
-        corpo = @env["rack.input"].read
+        ritorna se @richiesta["rack.input"].nullo?
+        corpo = @richiesta["rack.input"].read
         ritorna se corpo.non_specificato?
 
         inizia
           corpo_convertito = (JSON.processa corpo).simbolizza
-          @env["iris.parametri"].fondi! corpo_convertito se corpo_convertito.è_una? Mappa
-          @env["iris.corpo"] = corpo_convertito
+          @richiesta["iris.parametri"].fondi! corpo_convertito se corpo_convertito.è_una? Mappa
+          @richiesta["iris.corpo"] = corpo_convertito
         recupera JSON::ParserError => errore
           arresta 400, errore: "Il corpo fornito non è un JSON valido."
         fine
-        @env["rack.input"].rewind
+        @richiesta["rack.input"].rewind
       fine
 
       ##
       # Converte i parametri della richiesta.
       definisci _converti_parametri_interrogazione
-        ritorna a_meno_che @env["REQUEST_URI"].specificato? e @env["REQUEST_URI"].include?("?")
-        parametri_stringa_interrogazione = @env["REQUEST_URI"].partiziona("?").ultimo
-        @env["iris.parametri"].fondi! Rack::Utils.parse_nested_query(parametri_stringa_interrogazione).simbolizza
+        ritorna a_meno_che @richiesta["REQUEST_URI"].specificato? e @richiesta["REQUEST_URI"].include?("?")
+        parametri_stringa_interrogazione = @richiesta["REQUEST_URI"].partiziona("?").ultimo
+        @richiesta["iris.parametri"].fondi! Rack::Utils.parse_nested_query(parametri_stringa_interrogazione).simbolizza
       fine
 
+    ##
+    # Questo modulo serve per eseguire il codice del metodo `_avvia`
+    # anche quando viene ridefinito nella classe includente.
+    modulo InterfacciaAvvio
+
+      ##
+      # Metodo per risolvere l'azione in modo personalizzato.
+      # In questo metodo è possibile impostare lo stato, le intestazioni
+      # o il corpo della risposta. È inoltre possibile utilizzare
+      # i metodi `arresta` e `stato` per interrompere il flusso dell'azione
+      # e ritornare immediatamente i valori passati.
+      definisci avvia(richiesta)
+        _avvia(richiesta) esegui
+          se definito? super
+            super
+          fine
+        fine
+      fine
+
+    fine
+
   fine
 fine

data/lib/iris/navigatore/rotta.ir

@@ -10,17 +10,22 @@ modulo Iris
         @parametri = Mappa.nuova
       fine
 
-      definisci raggiungi(env)
-        env["iris.parametri"] ||= Mappa.nuova
-        env["iris.parametri"].fondi! @parametri se @parametri.esiste?
-
-        se @azione.risponde_a? :chiama
-          @azione.chiama env
+      ##
+      # Avvia l'azione corrispondente alla rotta.
+      definisci avvia_azione(richiesta)
+        richiesta["iris.parametri"] ||= Mappa.nuova
+        richiesta["iris.parametri"].fondi! @parametri se @parametri.esiste?
+
+        se @azione.risponde_a? :avvia
+          @azione.avvia richiesta
         altrimenti
-          @azione.nuova.avvia env
+          @azione.nuova.avvia richiesta
         fine
       fine
 
+      ##
+      # Determina se la rotta è raggiungibile per il metodo
+      # e il percorso della richiesta.
       definisci raggiungibile_per?(metodo, percorso_richiesta)
         ritorna no se metodo != @metodo
         ritorna si se @passi_definiti.ultimo == "*"

data/lib/iris/navigatore.ir

@@ -9,8 +9,9 @@ modulo Iris
 
     definisci inizializzatore(azione: nulla, percorso_padre: nullo, &blocco)
       @rotte = []
+      @montaggi = []
       @percorso_padre = percorso_padre
-      @azione_rotta_non_raggiungibile = RottaNonRaggiungibile
+      @azione_rotta_non_raggiungibile = RottaNonRaggiungibile.nuova
 
       se azione.esiste?
         @azione = azione
@@ -19,15 +20,19 @@ modulo Iris
       fine
     fine
 
-    definisci risolvi(env)
+    definisci risolvi(richiesta)
       se @azione.esiste?
-        @azione.avvia env
+        @azione.avvia richiesta
       altrimenti
-        rotta_raggiungibile = cerca_rotta_raggiungibile_per env
-        se rotta_raggiungibile.esiste?
-          rotta_raggiungibile.raggiungi env
+        cerca_rotta_raggiungibile_per richiesta
+
+        ritorna @azione_rotta_non_raggiungibile.avvia(richiesta) se @rotta_raggiungibile.non_esiste?
+        ritorna @rotta_raggiungibile.avvia_azione(richiesta) se @rotta_raggiungibile.è_una? Iris::Navigatore::Rotta
+
+        se @rotta_raggiungibile.risponde_a? :avvia
+          @rotta_raggiungibile.avvia richiesta
         altrimenti
-          @azione_rotta_non_raggiungibile.nuova.avvia env
+          @rotta_raggiungibile.nuova.avvia richiesta
         fine
       fine
     fine
@@ -35,25 +40,47 @@ modulo Iris
 
     ##
     # Cerca la rotta raggiungibile per la richiesta.
-    definisci cerca_rotta_raggiungibile_per(env)
-      rotta_raggiungibile = nulla
-      metodo              = env["REQUEST_METHOD"]
-      percorso_richiesta  = env["REQUEST_PATH"] || env["PATH_INFO"]
+    definisci cerca_rotta_raggiungibile_per(richiesta)
+      @rotta_raggiungibile  = nulla
+      @metodo               = richiesta["REQUEST_METHOD"]
+      @percorso_richiesta   = richiesta["iris.percorso"] || richiesta["REQUEST_PATH"] || richiesta["PATH_INFO"]
 
       cattura :rotta_trovata esegui
-        @rotte.per_ognuna esegui |rotta_definita|
-          se rotta_definita.è_una? Iris::Navigatore::Rotta
-            se rotta_definita.raggiungibile_per? metodo, percorso_richiesta
-              rotta_raggiungibile = rotta_definita
-              lancia :rotta_trovata
-            fine
-          altrimenti_se rotta_definita.è_un? Iris::Navigatore
-            rotta_raggiungibile = rotta_definita.cerca_rotta_raggiungibile_per env
-            lancia :rotta_trovata se rotta_raggiungibile.esiste?
+        cerca_fra_i_montaggi  richiesta
+        cerca_fra_le_rotte    richiesta
+      fine
+
+      @rotta_raggiungibile
+    fine
+
+    ##
+    # Cerca se fra i montaggi c'è una rotta raggiungibile
+    # per la richiesta.
+    definisci cerca_fra_i_montaggi(richiesta)
+      @montaggi.per_ognuno esegui |montaggio|
+        se @percorso_richiesta.inizia_con? montaggio[:su]
+          @rotta_raggiungibile = montaggio[:applicazione]
+          richiesta["iris.percorso"] = @percorso_richiesta.rimpiazza montaggio[:su], ""
+          lancia :rotta_trovata
+        fine
+      fine
+    fine
+
+    ##
+    # Cerca se fra le rotte definite ce n'è una raggiungibile
+    # per la richiesta.
+    definisci cerca_fra_le_rotte(richiesta)
+      @rotte.per_ognuna esegui |rotta_definita|
+        se rotta_definita.è_una? Iris::Navigatore::Rotta
+          se rotta_definita.raggiungibile_per? @metodo, @percorso_richiesta
+            @rotta_raggiungibile = rotta_definita
+            lancia :rotta_trovata
           fine
+        altrimenti_se rotta_definita.è_un? Iris::Navigatore
+          @rotta_raggiungibile = rotta_definita.cerca_rotta_raggiungibile_per richiesta
+          lancia :rotta_trovata se @rotta_raggiungibile.esiste?
         fine
       fine
-      rotta_raggiungibile
     fine
 
     privati
@@ -77,20 +104,27 @@ modulo Iris
       alias     :options    :rotta
 
       ##
-      # Definisce una percorso annidata.
+      # Definisce una percorso annidato.
       definisci percorso(percorso_rotta, &blocco)
         alza "Definire un percorso valido, non può essere nullo né vuoto." se percorso_rotta.non_specificato?
         percorso_completo = [ @percorso_padre, percorso_rotta ].unisci
         @rotte << Iris::Navigatore.nuovo(azione: nulla, percorso_padre: percorso_completo, &blocco)
       fine
 
+      ##
+      # Monta un'altra applicazione.
+      definisci monta(applicazione, su: nullo)
+        alza "Definire un percorso valido, non può essere nullo né vuoto." se su.non_specificato?
+        @montaggi << Mappa[applicazione: applicazione, su: su]
+      fine
+
     ##
     # L'azione predefinita con cui rispondere se non vengono
     # trovate rotte raggiungibili per il metodo e il percorso richiesto.
     classe RottaNonRaggiungibile
       includi Iris::Azione
 
-      definisci chiama
+      definisci avvia(richiesta)
         arresta 405, errore: "Nessuna rotta trovata per questo percorso."
       fine
     fine

data/lib/iris/versione.ir

@@ -1,3 +1,3 @@
 modulo Iris
-  VERSIONE = "0.1.17"
+  VERSIONE = "0.2.0"
 fine

data/lib/iris.ir

@@ -10,10 +10,12 @@ modulo Iris
 
   classe Configurazione
     accessore :registra_azioni
+    accessore :cattura_errori
     accessore :blocco_recupero_errori
 
     definisci inizializzatore
-      @registra_azioni = si
+      @registra_azioni        = si
+      @cattura_errori         = no
       @blocco_recupero_errori = nullo
     fine
   fine

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iris-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.17
+  version: 0.2.0
 platform: ruby
 authors:
 - Francesco Ballardin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-04-09 00:00:00.000000000 Z
+date: 2020-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: italian-ruby