mangusta 0.4.6 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d2f20cc69e65ae5f20dc801665a0251238fb74ddb128a3952616c62145aac15
-  data.tar.gz: 04bcf00cb49c97528926b9fd5b0338f92718a99dfc35c68ca570c1ea811e076e
+  metadata.gz: 3025be0dedcde244996c477c8e879032a60a2e872aed4667f0858df3aec06be5
+  data.tar.gz: 71c12d3fcd5bb8887527ea04bc6b767fdbcdf94e54a29613a9b4b60df3f2731b
 SHA512:
-  metadata.gz: 4a913616f90146b989f11582d7d2c4a401983cc1841f3f87c4f5d63c555a401e5f5dac6177e280f7671b6ec49ebf5ad0e3cbba2d060bd9be1ad1ba7196ecd79a
-  data.tar.gz: 023f8792d2c6d8d45310a7e3c09def270db9c6a3966c7a97bc5308e32a213b3b03dd18fabc4f427b2ae8060dce1101c967fe792082b3518f050930bc91685d21
+  metadata.gz: da37743a7de44df5814952d6e06df610cecb001b6cd9e989a54c3ca87a4ee99957a2809ee63fd0b3b188dcc94afb169e64361e31d4558a927835ff08078209e3
+  data.tar.gz: df54fe5798baedc2a4492dfb5498965d053fd53e2ff380a49eb1c66d193c3f36fce57335a162cd93fa68bae21fa01b37bc58230685437bcada5a42dbdcbfe38b

data/Gemfile

@@ -3,5 +3,5 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in mangusta.gemspec
 gemspec
 
-gem "rake",           "~> 12.0"
+gem "rake",           "~> 13.0"
 gem "rspec",          "~> 3.0"

data/Gemfile.lock

@@ -1,46 +1,39 @@
 PATH
   remote: .
   specs:
-    mangusta (0.3.2)
+    mangusta (0.4.6)
       italian-ruby (~> 0.1)
       mongo (~> 2.11)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    bson (4.8.2)
+    bson (4.9.1)
     diff-lcs (1.3)
-    italian-ruby (0.2.7)
-      ruby2ruby (~> 2.4)
-    mongo (2.12.0)
+    italian-ruby (0.8.0)
+    mongo (2.12.1)
       bson (>= 4.8.2, < 5.0.0)
-    rake (12.3.3)
+    rake (13.0.1)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    ruby2ruby (2.4.4)
-      ruby_parser (~> 3.1)
-      sexp_processor (~> 4.6)
-    ruby_parser (3.14.2)
-      sexp_processor (~> 4.9)
-    sexp_processor (4.14.1)
+    rspec-support (3.9.3)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   mangusta!
-  rake (~> 12.0)
+  rake (~> 13.0)
   rspec (~> 3.0)
 
 BUNDLED WITH

data/lib/mangusta/core_ext/mongo.rb

@@ -12,6 +12,7 @@ module Mongo
     class View
       alias     :primo              :first
       alias     :lista              :entries
+      alias     :conteggio          :count
     end
   end
 end

data/lib/mangusta/documento.ir

@@ -13,9 +13,13 @@ modulo Mangusta
   #     includi Mangusta::Documento
   #
   #     campo           :titolo,    valore_iniziale: "Il Signore degli Anelli"
+  #
   #     appartiene_a    :autore,
   #       ripostiglio: "RipostiglioAutori",
   #       nome_campo: :id_autore
+  #
+  #     incorpora_molte :ristampe,
+  #       nome_classe: "Libro::Ristampa"
   #   fine
   #
   # Il metodo di classe `campo` ha come primo argomento obbligatorio il nome del campo,
@@ -25,24 +29,53 @@ modulo Mangusta
   #
   # I metodi di classe `appartiene_a`, `ha_molte`, `ha_e_appartiene_a_molte` (gli ultimi
   # due hanno alias `ha_molti` e `ha_e_appartiene_a_molti`) definiscono delle relazioni.
+  #
+  # I metodi di classe `incorpora_un` (alias `incorpora_una`) e `incorpora_molti` (alias
+  # `incorpora_molte`) definiscono dei documenti incorporati. Un esempio di documento
+  # incorporato è questo:
+  #
+  #   classe Libro
+  #     classe Ristampa
+  #       includi Mangusta::Documento
+  #
+  #       campo :anno
+  #
+  #       incorporato_in :libro,
+  #         nome_classe: "Libro"
+  #     fine
+  #   fine
   modulo Documento
 
     ##
     # Inizializzatore di un documento.
     # Si preoccupa di impostare campi ed eventuali valori iniziali.
     definisci inizializzatore(**attributi)
-      ritorna se se_stesso.classe.campi.nullo? o se_stesso.classe.campi.vuoto?
+      ritorna se campi.nessuno?
+      _assegna_valori_iniziali
+      assegna **attributi
+      assegna _id: IdOggetto.nuovo se _id.nullo?
+    fine
 
-      se_stesso.classe.campi.per_ognuno esegui |campo|
-        _inizializza_campo campo
+    ##
+    # Assegna dei valori al documento.
+    definisci assegna(**attributi)
+      attributi.per_ognuno esegui |nome_attributo, valore_attributo|
+        metodo_assegnazione = "#{nome_attributo}="
+        prossimo se se_stesso.non_risponde_a? metodo_assegnazione
+        se_stesso.manda metodo_assegnazione, valore_attributo
       fine
 
-      assegna **attributi
-      _genera_nuovo_id se ottieni_valore(:_id).nullo?
-      _genera_documento_padre **attributi se attributi.ha_chiave? :_padre
-      _memorizza_attributi_originali **attributi
+      se_stesso
     fine
 
+    ##
+    # Espone il documento come JSON.
+    definisci esponi(*chiavi_richieste, **relazioni_richieste)
+      espositore = Mangusta::Documento::Espositore.nuovo se_stesso, *chiavi_richieste, **relazioni_richieste
+      espositore.esponi
+    fine
+    alias     :in_mappa       :esponi
+
     ##
     # Recupera i campi definiti.
     definisci campi
@@ -57,141 +90,29 @@ modulo Mangusta
 
     ##
     # Recupera i documenti incorporati.
-    definisci documenti_incorporati
-      se_stesso.classe.documenti_incorporati || []
-    fine
-
-    ##
-    # Recupera il valore di un campo del documento.
-    definisci ottieni_valore(nome_campo)
-      valore_campo = ottieni_variabile_istanza "@#{nome_campo}"
-      ritorna valore_campo se valore_campo.non_è_una? Mappa
-      valore_campo.simbolizza
-    fine
-
-    ##
-    # Imposta il valore di un campo del documento.
-    definisci imposta_valore(nome_campo, valore_campo)
-      imposta_variabile_istanza "@#{nome_campo}", valore_campo
-    fine
-
-    ##
-    # Ottiene la rappresentazione per stampa dell'oggetto.
-    definisci inspect
-      "#<#{se_stesso.classe} #{se_stesso.esponi}>"
-    fine
-    definisci ai(opzioni = Mappa.nuova)
-      se definito? AwesomePrint
-        ap = AwesomePrint::Inspector.nuovo opzioni.fondi(indent: 2, ruby19_syntax: si)
-        "#<#{se_stesso.classe} #{ap.awesome se_stesso.esponi}>"
-      altrimenti
-        inspect
-      fine
-    fine
-
-    ##
-    # Uguaglianza di documenti.
-    definisci ==(documento)
-      _id == documento._id
-    fine
-    definisci ===(documento)
-      se_stesso == documento
-    fine
-    definisci eql?(documento)
-      se_stesso == documento
-    fine
-
-    ##
-    # Ottiene la rappresentazione in Mappa dei campi del documento.
-    definisci esponi(*chiavi_richieste, **relazioni_richieste)
-      Espositore.nuovo(se_stesso, *chiavi_richieste, **relazioni_richieste).esponi
+    definisci incorporati
+      se_stesso.classe.incorporati || []
     fine
 
     ##
-    # Assegna i parametri passati al documento. Considera anche gli alias.
-    definisci assegna(**parametri)
-      parametri.per_ognuno esegui |nome_parametro, valore_parametro|
-        nome_metodo_assegnamento = "#{nome_parametro}="
-        prossimo se se_stesso.non_risponde_a? nome_metodo_assegnamento
-        se_stesso.manda nome_metodo_assegnamento, _converti_in_id(valore_parametro)
+    # Codice da eseguire quando questo modulo verrà incluso.
+    definisci se_stesso.quando_incluso(classe_documento)
+      classe_documento.apri_classe esegui
+        includi Mangusta::Documento::MetodiCondivisi
+        estendi Mangusta::Documento::MetodiDiClasse
+        _inizializza_documento
       fine
-      se_stesso
-    fine
-
-    ##
-    # Accede al valore dell'attributo originale del documento,
-    # passando oltre gli accessori, per accedere a campi non modellati.
-    definisci [](attributo)
-      @_attributi_originali.prendi attributo
-    fine
-
-    ##
-    # Accede al documento padre, se presente.
-    definisci _padre
-      @_padre
     fine
 
     privati
 
       ##
-      # Imposta il valore iniziale di un campo.
-      definisci _inizializza_campo(campo)
-        se campo.ha_valore_iniziale?
-          imposta_variabile_istanza "@#{campo.nome}", campo.valore_iniziale
-        altrimenti
-          imposta_variabile_istanza "@#{campo.nome}", nullo
+      # Assegna i valori iniziali ai campi.
+      definisci _assegna_valori_iniziali
+        campi.seleziona { |campo| campo.ha_valore_iniziale? }.per_ognuno esegui |campo|
+          campo.assegna se_stesso, campo.valore_iniziale
         fine
       fine
 
-      ##
-      # Genera un nuovo id.
-      definisci _genera_nuovo_id
-        imposta_valore :_id, IdOggetto.nuovo
-      fine
-
-      ##
-      # Genera il puntatore al documento padre.
-      definisci _genera_documento_padre(**attributi)
-        @_padre = attributi.prendi :_padre
-      fine
-
-      ##
-      # Converte in IdOggetto una stringa.
-      # Se la conversione fallisce, ritorna la stringa iniziale.
-      definisci _converti_in_id(stringa)
-        ritorna stringa se stringa.non_è_una? Stringa
-        IdOggetto.converti(stringa)
-      recupera
-        stringa
-      fine
-
-      ##
-      # Memorizza gli attiributi originali del documento.
-      definisci _memorizza_attributi_originali(**attributi)
-        @_attributi_originali = attributi
-      fine
-
-    ##
-    # Codice da eseguire quando questo modulo verrà incluso.
-    definisci se_stesso.quando_incluso(classe_documento)
-
-      classe_documento.apri_classe esegui
-        estendi Mangusta::Documento::MetodiDiClasse
-
-        classe << se_stesso
-          accessore     :campi
-          accessore     :relazioni
-          accessore     :documenti_incorporati
-        fine
-
-        se_stesso.campi                 = []
-        se_stesso.relazioni             = []
-        se_stesso.documenti_incorporati = []
-
-        _memorizza_campo :_id
-      fine
-
-    fine
-
   fine
 fine

data/lib/mangusta/documento/campo.ir

@@ -6,12 +6,16 @@ modulo Mangusta
 
       accessore   :nome
       accessore   :valore_iniziale
+      accessore   :per_relazione
+      accessore   :per_incorporato
 
       ##
       # Imposta nome e valore iniziale.
-      definisci inizializzatore(nome, **parametri)
-        se_stesso.nome =              nome
-        se_stesso.valore_iniziale =   parametri.prendi(:valore_iniziale, nullo)
+      definisci inizializzatore(nome, **opzioni)
+        se_stesso.nome              = nome
+        se_stesso.valore_iniziale   = opzioni.prendi :valore_iniziale, nullo
+        se_stesso.per_relazione     = opzioni.prendi :per_relazione, no
+        se_stesso.per_incorporato   = opzioni.prendi :per_incorporato, no
       fine
 
       ##
@@ -20,6 +24,36 @@ modulo Mangusta
         se_stesso.valore_iniziale.esiste?
       fine
 
+      ##
+      # Determina se il campo è stato creato per una relazione.
+      definisci per_relazione?
+        se_stesso.per_relazione == si
+      fine
+
+      ##
+      # Determina se il campo è stato creato per un documento incorporato.
+      definisci per_incorporato?
+        se_stesso.per_incorporato == si
+      fine
+
+      ##
+      # Ottiene il valore del campo.
+      definisci valore(documento)
+        valore_campo = documento.ottieni_variabile_istanza "@#{nome}"
+
+        se valore_campo.risponde_a? :simbolizza
+          valore_campo.simbolizza
+        altrimenti
+          valore_campo
+        fine
+      fine
+
+      ##
+      # Assegna il valore al campo.
+      definisci assegna(documento, valore_da_assegnare)
+        documento.imposta_variabile_istanza "@#{nome}", valore_da_assegnare
+      fine
+
     fine
   fine
 fine

data/lib/mangusta/documento/espositore.ir

@@ -5,63 +5,139 @@ modulo Mangusta
     classe Espositore
 
       ##
-      # Imposta campi e relazioni richieste.
-      definisci inizializzatore(documento, *chiavi_richieste, **relazioni_richieste)
-        @documento            = documento
-        @campi_richiesti      = chiavi_richieste.seleziona { |chiave| chiave.in? documento.campi.mappa(&:nome) }
-        @relazioni_dirette    = chiavi_richieste.seleziona { |chiave| chiave.in? documento.relazioni.mappa(&:nome) }
-        @relazioni_annidate   = relazioni_richieste.chiavi
-        @relazioni_richieste  = relazioni_richieste
+      # Inizializza l'espositore.
+      definisci inizializzatore(documento, *interi_richiesti, **filtrati_richiesti)
+        @documento = documento
+        @filtrati_richiesti = filtrati_richiesti
+
+        alza "campi, relazioni o incorporati da esporre interamente devono essere Simboli" se
+          interi_richiesti.almeno_uno? { |intero_richiesto| intero_richiesto.non_è_un? Simbolo }
+
+        alza "relazioni o incorporati da filtrare deve essere una Mappa con chiave Simbolo e valore Liste di Simboli" se
+          filtrati_richiesti.chiavi.almeno_una? { |chiave| chiave.non_è_un? Simbolo } o
+          filtrati_richiesti.valori.almeno_uno? { |lista| lista.non_è_una? Lista } o
+          filtrati_richiesti.valori.almeno_uno? { |lista| lista.almeno_uno? { |valore| valore.non_è_un? Simbolo } }
+
+        @campi = documento.campi.seleziona esegui |campo|
+          campo.nome.in? interi_richiesti
+        fine
+        @relazioni_intere = documento.relazioni.seleziona esegui |relazione|
+          relazione.nome.in? interi_richiesti
+        fine
+        @relazioni_filtrate = documento.relazioni.seleziona esegui |relazione|
+          relazione.nome.in? filtrati_richiesti.chiavi
+        fine
+        @incorporati_interi = documento.incorporati.seleziona esegui |incorporato|
+          incorporato.nome.in? interi_richiesti
+        fine
+        @incorporati_filtrati = documento.incorporati.seleziona esegui |incorporato|
+          incorporato.nome.in? filtrati_richiesti.chiavi
+        fine
+
+        @campi              = @documento.campi se @campi.nessuno?
+        @incorporati_interi = @documento.incorporati se @incorporati_interi.nessuno? e @incorporati_filtrati.nessuno?
       fine
 
       ##
       # Espone il documento.
       definisci esponi
-        @documento_convertito = Mangusta::Utilità.converti_in_json @documento,
-          *(@relazioni_dirette + @relazioni_annidate)
+        documento_esposto = Mappa.nuova
 
-        se @campi_richiesti.nessuno?
-          @documento_convertito
-        altrimenti
-          filtra_esposizione
-        fine
+        _esponi_campi_su                documento_esposto
+        _esponi_incorporati_interi_su   documento_esposto
+        _esponi_incorporati_filtrati_su documento_esposto
+        _esponi_relazioni_intere_su     documento_esposto
+        _esponi_relazioni_filtrate_su   documento_esposto
+
+        documento_esposto
       fine
 
-      ##
-      # Filtra l'esposizione del documento sui campi o relazioni richieste.
-      definisci filtra_esposizione
-        esposizione_filtrata = Mappa.nuova
+      privati
+
+        ##
+        # Espone i campi sul documento esposto.
+        definisci _esponi_campi_su(documento_esposto)
+          @campi.per_ognuno esegui |campo|
+            valore_campo = @documento.manda campo.nome
+            prossimo se valore_campo.nullo? o campo.nome == :_padre
+
+            se valore_campo.è_una? Mappa
+              valore_campo = valore_campo.simbolizza
+            altrimenti_se valore_campo.è_una? Lista
+              valore_campo = valore_campo.mappa(&:simbolizza) recupera valore_campo
+            fine
 
-        @campi_richiesti.per_ognuno esegui |campo_richiesto|
-          prossimo se campo_richiesto.non_è_un? Simbolo
-          esposizione_filtrata.deposita campo_richiesto, @documento_convertito.prendi(campo_richiesto, nullo)
+            documento_esposto.deposita campo.nome, valore_campo
+          fine
         fine
 
-        @relazioni_dirette.per_ognuna esegui |relazione_richiesta|
-          alza Relazione::NonInclusa, "per poter esporre la relazione `#{relazione_richiesta}` è necessario prima includerla" se
-            relazione_richiesta.non_è_un? Simbolo o @documento_convertito.non_ha_chiave? relazione_richiesta
-          esposizione_filtrata.deposita relazione_richiesta, @documento_convertito.prendi(relazione_richiesta)
+        ##
+        # Espone gli incorporati interi.
+        definisci _esponi_incorporati_interi_su(documento_esposto)
+          @incorporati_interi.per_ognuno esegui |incorporato|
+            valore_incorporato = @documento.manda incorporato.nome
+            considera incorporato.tipologia
+            quando :singolo
+              documento_esposto.deposita incorporato.nome, valore_incorporato.esponi
+            quando :multiplo
+              documento_esposto.deposita incorporato.nome, valore_incorporato.mappa(&:esponi)
+            fine
+          fine
         fine
 
-        @relazioni_richieste.per_ognuna esegui |nome_relazione, campi_relazione_richiesti|
-          prossima se campi_relazione_richiesti.non_è_una? Lista
-          valore_relazione = @documento_convertito.prendi nome_relazione, nulla
-          se valore_relazione.è_una? Mappa
-            esposizione_filtrata.deposita nome_relazione, valore_relazione
-              .seleziona { |chiave, valore| chiave.in? campi_relazione_richiesti }
-          altrimenti_se valore_relazione.è_una? Lista
-            valori_filtrati = valore_relazione.mappa esegui |singolo_valore_relazione|
-              prossima se singolo_valore_relazione.non_è_una? Mappa
-              singolo_valore_relazione.seleziona { |chiave, valore| chiave.in? campi_relazione_richiesti }
+        ##
+        # Espone gli incorporati filtrati.
+        definisci _esponi_incorporati_filtrati_su(documento_esposto)
+          @incorporati_filtrati.per_ognuno esegui |incorporato|
+            valore_incorporato = @documento.manda incorporato.nome
+            campi_incorporato_filtrati = @filtrati_richiesti.prendi incorporato.nome
+            considera incorporato.tipologia
+            quando :singolo
+              documento_esposto.deposita incorporato.nome, valore_incorporato.esponi(*campi_incorporato_filtrati)
+            quando :multiplo
+              documento_esposto.deposita incorporato.nome, valore_incorporato
+                .mappa { |documento_incorporato| documento_incorporato.esponi *campi_incorporato_filtrati }
             fine
-            esposizione_filtrata.deposita nome_relazione, valori_filtrati.compatta
-          altrimenti
-            prossima
           fine
         fine
 
-        esposizione_filtrata
-      fine
+        ##
+        # Espone le relazioni intere.
+        definisci _esponi_relazioni_intere_su(documento_esposto)
+          @relazioni_intere.per_ognuna esegui |relazione|
+            alza Relazione::NonInclusa, "la relazione #{relazione.nome} deve essere inclusa per "\
+              "poter essere esposta" se relazione.documenti_in_memoria.nullo?
+
+            valore_relazione = @documento.manda relazione.nome
+            considera relazione.tipologia
+            quando :appartiene_a
+              documento_esposto.deposita relazione.nome, valore_relazione.esponi
+            quando :ha_molti, :ha_e_appartiene_a_molti
+              documento_esposto.deposita relazione.nome, valore_relazione.mappa(&:esponi)
+            fine
+          fine
+        fine
+
+        ##
+        # Espone le relazioni filtrate.
+        definisci _esponi_relazioni_filtrate_su(documento_esposto)
+          @relazioni_filtrate.per_ognuna esegui |relazione|
+            alza Relazione::NonInclusa, "la relazione #{relazione.nome} deve essere inclusa per "\
+              "poter essere esposta" se relazione.documenti_in_memoria.nullo?
+
+            valore_relazione = @documento.manda relazione.nome
+            prossima se valore_relazione.nulla?
+
+            campi_relazione_filtrati = @filtrati_richiesti.prendi relazione.nome
+            considera relazione.tipologia
+            quando :appartiene_a
+              documento_esposto.deposita relazione.nome, valore_relazione.esponi(*campi_relazione_filtrati)
+            quando :ha_molti, :ha_e_appartiene_a_molti
+              documento_esposto.deposita relazione.nome, valore_relazione
+                .mappa { |documento_relazionato| documento_relazionato.esponi *campi_relazione_filtrati }
+            fine
+          fine
+        fine
 
     fine
   fine