italian-ruby 0.8.7 → 0.8.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83284550d7e3870fcb441f11d5a0ddec4823c6eb230f1416ce9895e246748782
-  data.tar.gz: 56b67fa379e306eb12ee16fe129019db57092820f412897191a9047b1dbcee22
+  metadata.gz: 3efadda6bc7f8e926de0dccb34bb0031e2161eca5472bb1cdf97c992ae355249
+  data.tar.gz: 432898e75e2e29eb8e7a6cd696852fd073fd94686bfc53ae97f4d6aaf52ba0c7
 SHA512:
-  metadata.gz: '0852d6a8a169ae6b2421d6c9df88595eca1dbd62588c874d597053541441736b62d798385bdbff233b8f19c49e86584bbe326b6693224864e2babb40e4b5fed1'
-  data.tar.gz: d5214dafb0d58cfeb16f6f1927d5ba17796cd932b361ecea13dc18595760eed35437bcf28e6b8b3095833d0dd51348f2e754835c64f418980b7c5d7360bad1e3
+  metadata.gz: 01fc3cd7ee7aa304b8bab37e9abfde97f8baecf6fe8b2aaa0e2e0934bfa6e39419856168b1581418773ffc856e87b8d9b5ed05c9916d31a8b1552f8f3dcc2ec5
+  data.tar.gz: 14b5fadcb6e1b225f2b0d4b10e2130984f97475798b9b6cfefe2aab5209cd66e8ba9b7c315c3a553e93fff6a17b3cbdcb54fe66aedf7649e0ed760bde513e738

data/README.md

@@ -38,11 +38,11 @@ A questo punto ci sono due strade. Prima strada, usare l'eseguibile `italian-rub
 ```ruby
 # persona.ir
 classe Persona
-  def inizializzatore(nome)
+  definisci inizializzatore(nome)
     @nome = nome
   fine
 
-  def come_ti_chiami?
+  definisci come_ti_chiami?
     stampa "Ciao, mi chiamo #{@nome}."
   fine
 fine
@@ -63,7 +63,7 @@ Oppure si può richiedere all'interno di codice sorgente Ruby standard, in modo
 ```ruby
 # libreria_interessantissima.rb
 modulo LibreriaInteressantissima
-  def se_stesso.metodo_interessantissimo
+  definisci se_stesso.metodo_interessantissimo
     stampa "Che roba!"
   fine
 fine
@@ -93,15 +93,56 @@ GemmaImpossibile.esiste?
 >
 > \- un tizio saggio, qualche anno fa.
 
-Volete sapere la verità su Italian Ruby? Ecco come funziona. Ho preso ispirazione da questa gemma che si chiama [Bato](https://github.com/jjuliano/bato). Praticamente è la stessa cosa di Italian Ruby solo che in filippino. Bato vuole dire "Roccia" in filippino. Bato funziona usando la gemma [RubyParser](https://github.com/seattlerb/ruby_parser) che parsa codice Ruby e lo converte in espressioni sexp, e la gemma [Ruby2Ruby](https://github.com/seattlerb/ruby2ruby) che converte espressioni sexp in codice Ruby.
-In mezzo a queste due, ci infiliamo la nostra gemma, che, patchando il ruby parser, legge codice in italiano e lo converte in espressioni sexp. Il trucco sta nel file `lib/italian/ruby/ruby_parser_patches.rb` dove vengono definite nuove keywords al posto di quelle originali (es. `classe` al posti di `class`).
+Volete sapere la verità su Italian Ruby? Ecco come funziona.
 
-Bato però ha solo un binario che permette di eseguire codice filippino. Italian Ruby, invece, permette di inglobare codice italiano all'interno di progetti Ruby già esistenti. Avete un gigantesco codebase con megabyte di codice, ma volete riscrivere un solo piccolo pezzettino in italiano? Con Italian Ruby si può.
+Inizialmente, avevo preso ispirazione da questa gemma che si chiama [Bato](https://github.com/jjuliano/bato). L'idea, praticamente, è la stessa di Italian Ruby solo che in filippino. Bato vuole dire "Roccia" in filippino. Bato funziona usando la gemma [RubyParser](https://github.com/seattlerb/ruby_parser) che parsa codice Ruby e lo converte in espressioni sexp, e la gemma [Ruby2Ruby](https://github.com/seattlerb/ruby2ruby) che converte espressioni sexp in codice Ruby. In mezzo a queste due, si inserisce Bato, che, patchando il ruby parser, legge codice in filippino e lo converte in espressioni sexp.
+
+Ora, Italian Ruby ha un suo parser vero e proprio. È molto semplice, per ora, e si basta sulla lettura contestuale di ogni riga del sorgente, ma senza dividere le parole e senza cercare di ricostruire l'intero albero sintattico astratto. In questo modo si hanno vari vantaggi:
+- Non si dipende più dalle gemme `ruby_parser` e `ruby_2_ruby`. Il che significa che ogni nuova funzionalità del linguaggio è automaticamente e direttamente disponibile anche in Italian Ruby, senza aspettare che vengano aggiornate queste due gemme (es. il pattern-matching di Ruby 2.7).
+- I tempi di caricamento iniziali della gemma sono ridotti di molto.
+- La velocità di processazione e traduzione del sorgente è aumentata di molto.
+- È mantenuta l'esatta corrispondenza fra i numeri di riga fra sorgente originale e sorgente tradotto.
+
+Un'altra differenza fra Bato e Italian Ruby è che Bato ha solo un binario che permette di eseguire codice filippino. Italian Ruby, invece, permette di inglobare codice italiano all'interno di progetti Ruby già esistenti. Avete un gigantesco codebase con megabyte di codice, ma volete riscrivere un solo piccolo pezzettino in italiano? Con Italian Ruby si può. Ad esempio, prendiamo questo sorgente Italian Ruby:
+
+```ruby
+classe Libro
+
+  accessore :titolo
+
+  definisci inizializzatore(titolo)
+    @titolo = titolo
+  fine
+
+fine
+```
+
+e questo codice Ruby:
+
+```ruby
+require "italian/ruby"
+richiedi_relativo "libro"
+
+class Library
+
+  attr_accessor :books
+
+  def initialize
+    @books = []
+  end
+
+  def add(title)
+    @books << Libro.new(title)
+  end
+end
+```
+
+Questo codice risulta perfettamente valido e funzionante.
 
 Per concludere, ci sono degli avvertimenti.
-1. il namespace verrà sporcato. Ho fatto del mio meglio per essere più chirurgico possibile, ma se fate `require "italian/ruby"` sappiate che verranno su un sacco di classi e di alias nuovi (es. `Oggetto.nuovo` ecc.).
-2. il `richiedi` e `richiedi_relativo` funzionano traducendo un file sorgente in italiano nella cartella `.italian-ruby`, che viene creata in automatico nella home dell'utente. Viene ricreato l'intero percorso del file, in modo tale da preservarne l'unicità e il riferimento con il sorgente iniziale. Unaa volta tradotto, il file viene caricato in memoria con il `require` di Ruby. Non so se questo possa creare problemi. Immagino di no. Ma vi ho avvertito!
+1. Il namespace verrà sporcato. Ho fatto del mio meglio per essere più chirurgico possibile, ma se fate `require "italian/ruby"` sappiate che verranno su un sacco di classi e di alias nuovi (es. `Oggetto.nuovo` ecc.).
+2. Il `richiedi` e `richiedi_relativo` funzionano traducendo un file sorgente in italiano nella cartella `.italian-ruby`, che viene creata in automatico nella home dell'utente. Viene ricreato l'intero percorso del file, in modo tale da preservarne l'unicità e il riferimento con il sorgente iniziale. Unaa volta tradotto, il file viene caricato in memoria con il `require` di Ruby. Non so se questo possa creare problemi. Immagino di no. Ma vi ho avvertito!
 
 ## Contribuire
 
-Bug e issue qui -> https://github.com/[USERNAME]/italian-ruby.
+Bug e issue qui -> https://github.com/Pluvie/italian-ruby.

data/lib/italian/ruby/core_ext/date.rb

@@ -33,9 +33,15 @@ class Date
   end
   alias         :due_anni_precedenti        :due_anni_fa
 
-  alias :original_compare :==
+  alias :original_equality :==
   def ==(other)
     return (self == other.to_date) if other.is_a? Time
+    original_equality other
+  end
+
+  alias :original_compare :<=>
+  def <=>(other)
+    return (self <=> other.to_date) if other.is_a? Time
     original_compare other
   end
 end

data/lib/italian/ruby/core_ext/time.rb

@@ -22,9 +22,15 @@ class Time
     self
   end
 
-  alias :original_compare :==
+  alias :original_equality :==
   def ==(other)
     return (self.to_date == other) if other.is_a? Date
+    original_equality other
+  end
+
+  alias :original_compare :<=>
+  def <=>(other)
+    return (self.to_date <=> other) if other.is_a? Date
     original_compare other
   end
 end

data/lib/italian/ruby/version.rb

@@ -1,5 +1,5 @@
 module Italian
   module Ruby
-    VERSION = "0.8.7"
+    VERSION = "0.8.8"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: italian-ruby
 version: !ruby/object:Gem::Version
-  version: 0.8.7
+  version: 0.8.8
 platform: ruby
 authors:
 - Francesco Ballardin