mangusta 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a0d32d01d6f5191b3b692cfc4bba85867a5de70e1f06f78c196432b16d428871
+  data.tar.gz: f2e5c89cc582a4ca05263759faea53435ab6aa259895410d030a34c7c3b79a16
+SHA512:
+  metadata.gz: f83fb4cc57ba6218819d7c8f581f4add317152742f71e98eb48d9d82e0b5f8f8d52338f90dd59dbb9f845e48ca4f75e6f514bc5f6e60e47a371a4ab85d2089b8
+  data.tar.gz: 13a5cbb8e41ab092a79b810c3fc78edca8228392224d0007dd346e7f3ea9b6fdb607119d487c9ed63362fc80091b217d59db276386c7635ebe672f3ce08904e2

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.7.0

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in mangusta.gemspec
+gemspec
+
+gem "rake",           "~> 12.0"
+gem "rspec",          "~> 3.0"
+gem "mongo",          "~> 2.11"
+gem "italian-ruby",   "~> 0.1.3"

data/Gemfile.lock

@@ -0,0 +1,47 @@
+PATH
+  remote: .
+  specs:
+    mangusta (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    bson (4.8.2)
+    diff-lcs (1.3)
+    italian-ruby (0.1.3)
+      ruby2ruby (~> 2.4)
+    mongo (2.11.4)
+      bson (>= 4.4.2, < 5.0.0)
+    rake (12.3.3)
+    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)
+      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)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  italian-ruby (~> 0.1.3)
+  mangusta!
+  mongo (~> 2.11)
+  rake (~> 12.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,36 @@
+# Mangusta
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/mangusta`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mangusta'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install mangusta
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/mangusta.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+richiedi "mangusta"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/mangusta/core_ext/mongo.rb

@@ -0,0 +1,17 @@
+module Mongo
+  class Collection
+    alias       :cerca              :find
+    alias       :inserisci_uno      :insert_one
+    alias       :inserisci_molti    :insert_many
+    alias       :aggiorna_uno       :update_one
+    alias       :aggiorna_molti     :update_many
+    alias       :cancella_uno       :delete_one
+    alias       :cancella_molti     :delete_many
+
+    class View
+      alias     :primo              :first
+      alias     :prima              :first
+      alias     :lista              :entries
+    end
+  end
+end

data/lib/mangusta/documento/campo.ir

@@ -0,0 +1,25 @@
+modulo Mangusta
+  modulo Documento
+    ##
+    # Gestisce un campo di un documento.
+    classe Campo
+
+      accessore   :nome
+      accessore   :valore_iniziale
+
+      ##
+      # Imposta nome e valore iniziale.
+      definisci inizializzatore(nome, **attributi)
+        se_stesso.nome =              nome
+        se_stesso.valore_iniziale =   attributi.ottieni(:valore_iniziale, nullo)
+      fine
+
+      ##
+      # Determina se il campo è stato creato con un valore iniziale.
+      definisci ha_valore_iniziale?
+        se_stesso.valore_iniziale.esiste?
+      fine
+
+    fine
+  fine
+fine

data/lib/mangusta/documento.ir

@@ -0,0 +1,124 @@
+modulo Mangusta
+  ##
+  # Aggiunge funzionalità di gestione di un documento.
+  # Includere questo modulo dentro una classe, es.
+  #
+  #   classe Libro
+  #     includi Mangusta::Documento
+  #   fine
+  #
+  # In questo modo sarà possibile definire campi e relazioni, es.
+  #
+  #   classe Libro
+  #     includi Mangusta::Documento
+  #
+  #     campo           :titolo,    valore_iniziale: "Il Signore degli Anelli"
+  #     appartiene_a    :autore,    classe: "Autore"
+  #   fine
+  #
+  # Il metodo di classe `campo` ha come primo argomento obbligatorio il nome del campo,
+  # che sarà la chiave del campo inserito nel documento. Il secondo argomento è opzionale,
+  # e se viene passata una Mappa con chiave :valore_iniziale, allora quel campo sarà
+  # creato con il valore iniziale passato.
+  #
+  # 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.
+  #
+  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?
+
+      se_stesso.classe.campi.per_ognuno esegui |campo|
+        _inizializza_campo campo
+      fine
+
+      attributi.per_ognuno esegui |nome_campo, valore_campo|
+        imposta_valore_campo nome_campo, valore_campo
+      fine
+
+      _genera_nuovo_id se ottieni_valore_campo(:_id).nullo?
+    fine
+
+    ##
+    # Recupera i campi definiti.
+    definisci campi
+      se_stesso.classe.campi || []
+    fine
+
+    ##
+    # Recupera il valore di un campo del documento.
+    definisci ottieni_valore_campo(nome_campo)
+      ottieni_variabile_istanza "@#{nome_campo}"
+    fine
+
+    ##
+    # Imposta il valore di un campo del documento.
+    definisci imposta_valore_campo(nome_campo, valore_campo)
+      imposta_variabile_istanza "@#{nome_campo}", valore_campo
+    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
+        fine
+      fine
+
+      ##
+      # Genera un nuovo id.
+      definisci _genera_nuovo_id
+        imposta_valore_campo :_id, BSON::ObjectId.new
+      fine
+
+    ##
+    # Codice da eseguire quando questo modulo verrà incluso.
+    definisci se_stesso.included(classe_documento)
+
+      classe_documento.class_eval esegui
+        classe << se_stesso
+          accessore     :campi
+
+          ##
+          # Aggiunge metodo di classe `campo` per creare nuovi campi.
+          definisci campo(nome, **attributi)
+            _memorizza_campo nome, **attributi
+          fine
+
+          privati
+
+            ##
+            # Memorizza un nuovo campo.
+            def _memorizza_campo(nome, **attributi)
+              se_stesso.campi <<  Mangusta::Documento::Campo.nuovo(nome, **attributi)
+
+              definisci_metodo nome esegui
+                ottieni_variabile_istanza "@#{nome}"
+              fine
+
+              definisci_metodo "#{nome}=" esegui |valore|
+                imposta_variabile_istanza "@#{nome}", valore
+              fine
+            fine
+
+        fine
+      fine
+
+      # Aggiunge campo `id` e imposta campi a [].
+      classe_documento.class_eval esegui
+        se_stesso.campi = []
+        _memorizza_campo :_id
+      fine
+
+    fine
+
+  fine
+fine

data/lib/mangusta/ripostiglio/risultato_ricerca.ir

@@ -0,0 +1,26 @@
+modulo Mangusta
+  modulo Ripostiglio
+    classe RisultatoRicerca
+
+      accessore :parametri_ricerca
+
+      definisci inizializzatore(collezione, classe_documento, **parametri)
+        @collezione         = collezione
+        @classe_documento   = classe_documento
+        @parametri_ricerca  = parametri
+      fine
+
+      definisci primo
+        documento_in_json = @collezione.cerca(**@parametri_ricerca).primo
+        Mangusta::Utilità.converti_in_documento documento_in_json, @classe_documento
+      fine
+
+      definisci lista
+        @collezione.cerca(**@parametri_ricerca).lista.mappa esegui |documento_in_json|
+          Mangusta::Utilità.converti_in_documento documento_in_json, @classe_documento
+        fine
+      fine
+
+    fine
+  fine
+fine

data/lib/mangusta/ripostiglio.ir

@@ -0,0 +1,172 @@
+modulo Mangusta
+  ##
+  # Aggiunge funzionalità di ricerca, creazione, aggiornamento e cancellazione
+  # di documenti da una collezione.
+  # Includere questo modulo in una classe, es.
+  #
+  #   classe RipostiglioLibri
+  #     includi Mangusta::Ripostiglio
+  #   fine
+  #
+  # In questo modo sarà possibile definire la collezione nella quale si
+  # potrà effettuare operazioni, es.
+  #
+  #   classe RipostiglioLibri
+  #     includi Mangusta::Ripostiglio
+  #
+  #     collezione  :libri
+  #     documento   "Libri"
+  #   fine
+  #
+  # Nella base dati Mongo verrà utilizzata la collezione `libri`.
+  # Verranno aggiunti i seguenti metodi alla classe RipostiglioLibri:
+  #   - `trova` -> accetta una Mappa come argomento, che rappresenta
+  #     i parametri di ricerca di un documento nella collezione.
+  #   - `tutti` -> esegue una ricerca senza filtri (su tutti i documenti
+  #     della collezione).
+  #
+  modulo Ripostiglio
+
+    ##
+    # Codice da eseguire quando questo modulo verrà incluso.
+    definisci se_stesso.included(classe_documento)
+      classe_documento.class_eval esegui
+        classe << se_stesso
+
+          accessore :_collezione
+          accessore :_nome_collezione
+          accessore :_classe_documento
+
+          ##
+          # Metodo per definire su che collezione agire.
+          definisci collezione(nome)
+            se_stesso._nome_collezione  = nome
+            se_stesso._collezione       = Mangusta.connessione[nome]
+          fine
+
+          ##
+          # Metodo per definire che classe documento usare.
+          definisci documento(nome_classe)
+            se_stesso._classe_documento = nome_classe
+          fine
+
+          ##
+          # Cerca documenti nella collezione.
+          definisci cerca(**parametri)
+            _risultato_ricerca **parametri
+          fine
+
+          ##
+          # Cerca documento per id, e ritorna il primo trovato.
+          definisci cerca_per_id(id)
+            _risultato_ricerca(_id: BSON::ObjectId(id)).primo
+          fine
+
+          ##
+          # Ritorna il primo documento del ripostiglio.
+          def primo
+            _risultato_ricerca.primo
+          fine
+
+          ##
+          # Cerca senza filtri, su tutti i documenti della collezione.
+          definisci prendi_tutti
+            _risultato_ricerca
+          fine
+          alias     :prendi_tutte         :prendi_tutti
+
+          ##
+          # Deposita un documento.
+          definisci deposita(documento)
+            documento_in_json = Mangusta::Utilità.converti_in_json(documento)
+            se_stesso._collezione.inserisci_uno documento_in_json
+            documento
+          fine
+
+          ##
+          # Deposita molti documenti.
+          definisci deposita_molti(documenti)
+            alza "L'argomento passato non è una lista" a_meno_che documenti.risponde_a? :mappa
+            documenti_in_json = documenti.mappa { |documento| Mangusta::Utilità.converti_in_json(documento) }
+            se_stesso._collezione.inserisci_molti documenti_in_json
+            documenti
+          fine
+          alias     :deposta_molte        :deposita_molti
+
+          ##
+          # Aggiorna un documento.
+          definisci aggiorna(documento, **valori_da_aggiornare)
+            alza "Il primo argomento deve essere una Stringa o un documento" a_meno_che
+              documento.classe == Stringa o documento.risponde_a? :_id
+
+            id_documento = documento.risponde_a?(:_id) ? documento._id : documento
+            id_documento = BSON::ObjectId id_documento
+            se_stesso._collezione.aggiorna_uno Mappa[_id: id_documento], Mappa["$set" => valori_da_aggiornare]
+            cerca_per_id(id_documento)
+          fine
+
+          ##
+          # Aggiorna molti documenti.
+          definisci aggiorna_molti(ricerca = Mappa.nuova, **valori_da_aggiornare)
+            alza "Il primo argomento deve essere una Mappa o una Lista di documenti" a_meno_che
+              ricerca.classe == Mappa o ricerca.risponde_a? :tutti?
+
+            ricerca_è_una_lista_documenti = no
+            se ricerca.classe != Mappa
+              ricerca_è_una_lista_documenti = ricerca.tutti? { |documento| documento.risponde_a? :_id }
+              alza "Il primo argomento è una Lista, ma non di documenti" a_meno_che ricerca_è_una_lista_documenti
+            fine
+
+            se ricerca_è_una_lista_documenti
+              filtro_lista_id_documenti = Mappa["$in": ricerca.mappa(&:_id)]
+              ricerca = Mappa[_id: filtro_lista_id_documenti]
+            fine
+
+            risultato_aggiornamento = se_stesso._collezione.aggiorna_molti ricerca,
+              Mappa["$set": valori_da_aggiornare]
+            risultato_aggiornamento.modified_count
+          fine
+          alias     :aggiorna_molte       :aggiorna_molti
+
+          ##
+          # Cancella un documento.
+          def cancella(documento)
+            alza "Il primo argomento deve essere una stringa o un documento" a_meno_che
+              documento.classe == Stringa o documento.risponde_a? :_id
+
+            id_documento = documento.risponde_a?(:_id) ? documento._id : documento
+            id_documento = BSON::ObjectId id_documento
+            risultato_cancellazione = se_stesso._collezione.cancella_uno Mappa[_id: id_documento]
+            risultato_cancellazione.deleted_count
+          fine
+
+          ##
+          # Cancella molti documenti.
+          def cancella_molti(documenti)
+            risultato_cancellazione = se_stesso._collezione.cancella_uno Mappa[_id: id_documento]
+            risultato_cancellazione.deleted_count
+          fine
+          alias     :cancella_molte       :cancella_molti
+
+          ##
+          # Cancella tutti i documenti.
+          definisci cancella_tutti
+            risultato_cancellazione = se_stesso._collezione.cancella_molti
+            risultato_cancellazione.deleted_count
+          fine
+
+          privati
+
+            ##
+            # Ritorna un risultato ricerca.
+            definisci _risultato_ricerca(**parametri)
+              Mangusta::Ripostiglio::RisultatoRicerca.nuovo(
+                se_stesso._collezione, se_stesso._classe_documento, **parametri)
+            fine
+
+        fine
+      fine
+    fine
+
+  fine
+fine

data/lib/mangusta/utilit/303/240/convertitori.ir

@@ -0,0 +1,21 @@
+modulo Mangusta
+  modulo Utilità
+
+    definisci se_stessa.converti_in_json(documento)
+      ritorna documento se documento.classe == Mappa
+      alza "L'oggetto passato non include Mangusta::Documento" a_meno_che documento.risponde_a? :campi
+
+      documento_convertito = Mappa.nuova
+      documento.campi.per_ognuno esegui |campo|
+        documento_convertito.deposita campo.nome, documento.ottieni_valore_campo(campo.nome)
+      fine
+      documento_convertito
+    fine
+
+    definisci se_stessa.converti_in_documento(documento_in_json, classe_documento)
+      ritorna nullo se documento_in_json.nullo?
+      Object.const_get(classe_documento).nuovo **documento_in_json
+    fine
+
+  fine
+fine

data/lib/mangusta/versione.ir

@@ -0,0 +1,3 @@
+modulo Mangusta
+  VERSIONE = "0.1.0"
+fine

data/lib/mangusta.ir

@@ -0,0 +1,25 @@
+require           "mongo"
+require_relative  "mangusta/core_ext/mongo"
+richiedi_tutti    "mangusta"
+
+modulo Mangusta
+  classe << se_stessa
+    accessore :connessione
+    accessore :base_dati
+    accessore :collezioni
+
+    definisci connetti(**parametri)
+      Mongo::Logger.logger.level = Logger::FATAL
+
+      alza "Passare le chiavi :indirizzo e :base_dati come argomenti." a_meno_che
+        parametri.ha_chiave? :indirizzo e parametri.ha_chiave? :base_dati
+
+      se_stessa.connessione ||= Mongo::Client.nuovo(
+        [ parametri.ottieni(:indirizzo) ],
+        database: parametri.ottieni(:base_dati))
+
+      se_stessa.base_dati   = se_stessa.connessione.database
+      se_stessa.collezioni  = se_stessa.base_dati.collections
+    fine
+  fine
+fine

data/mangusta.gemspec

@@ -0,0 +1,28 @@
+require "italian/ruby"
+richiedi_relativo "lib/mangusta/versione"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mangusta"
+  spec.version       = Mangusta::VERSIONE
+  spec.authors       = ["Francesco Ballardin"]
+  spec.email         = ["francesco.ballardin@gmail.com"]
+
+  spec.summary       = %q{Simple MongoDB ODM.}
+  spec.description   = %q{Simple MongoDB ODM. Yay!}
+  spec.homepage      = "https://github.com/Pluvie/ruby-mangusta"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/Pluvie/ruby-mangusta"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: mangusta
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Francesco Ballardin
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-03-29 00:00:00.000000000 Z
+dependencies: []
+description: Simple MongoDB ODM. Yay!
+email:
+- francesco.ballardin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/mangusta.ir
+- lib/mangusta/core_ext/mongo.rb
+- lib/mangusta/documento.ir
+- lib/mangusta/documento/campo.ir
+- lib/mangusta/ripostiglio.ir
+- lib/mangusta/ripostiglio/risultato_ricerca.ir
+- lib/mangusta/utilità/convertitori.ir
+- lib/mangusta/versione.ir
+- mangusta.gemspec
+homepage: https://github.com/Pluvie/ruby-mangusta
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/Pluvie/ruby-mangusta
+  source_code_uri: https://github.com/Pluvie/ruby-mangusta
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Simple MongoDB ODM.
+test_files: []