italian-ruby 0.8.4 → 0.8.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +50 -9
- data/lib/italian/ruby/core_ext/date.rb +13 -0
- data/lib/italian/ruby/core_ext/file.rb +1 -0
- data/lib/italian/ruby/core_ext/integer.rb +1 -0
- data/lib/italian/ruby/core_ext/string.rb +5 -0
- data/lib/italian/ruby/core_ext/time.rb +16 -0
- data/lib/italian/ruby/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 433611007aff5c0a90a6e32dbfae70af80100cedd0887b22623b1df579182755
|
4
|
+
data.tar.gz: b05901a1bac4e364a4fb96abd048d704b158f3455b1d454e7497c64cd1c57c42
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: d37589cdfe5bf89369f0e9daf920bdd49efd229de69188db63337e05b8bc3ebe5c2cb6b46e498c628729030746a856d88b58e0dc32ae18a63ce5c9f1bf5d50fe
|
7
|
+
data.tar.gz: 24a250da1292a6f1e2826b6fbb8c0bf2af08bcb667ceeeeb64d43280951bc5377fcff746385212f33b8b44634b64e4d3646630b85d43c24ba724bc8f3386814c
|
data/README.md
CHANGED
@@ -38,11 +38,11 @@ A questo punto ci sono due strade. Prima strada, usare l'eseguibile `italian-rub
|
|
38
38
|
```ruby
|
39
39
|
# persona.ir
|
40
40
|
classe Persona
|
41
|
-
|
41
|
+
definisci inizializzatore(nome)
|
42
42
|
@nome = nome
|
43
43
|
fine
|
44
44
|
|
45
|
-
|
45
|
+
definisci come_ti_chiami?
|
46
46
|
stampa "Ciao, mi chiamo #{@nome}."
|
47
47
|
fine
|
48
48
|
fine
|
@@ -63,7 +63,7 @@ Oppure si può richiedere all'interno di codice sorgente Ruby standard, in modo
|
|
63
63
|
```ruby
|
64
64
|
# libreria_interessantissima.rb
|
65
65
|
modulo LibreriaInteressantissima
|
66
|
-
|
66
|
+
definisci se_stesso.metodo_interessantissimo
|
67
67
|
stampa "Che roba!"
|
68
68
|
fine
|
69
69
|
fine
|
@@ -93,15 +93,56 @@ GemmaImpossibile.esiste?
|
|
93
93
|
>
|
94
94
|
> \- un tizio saggio, qualche anno fa.
|
95
95
|
|
96
|
-
Volete sapere la verità su Italian Ruby? Ecco come funziona.
|
97
|
-
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`).
|
96
|
+
Volete sapere la verità su Italian Ruby? Ecco come funziona.
|
98
97
|
|
99
|
-
|
98
|
+
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.
|
99
|
+
|
100
|
+
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:
|
101
|
+
- 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).
|
102
|
+
- I tempi di caricamento iniziali della gemma sono ridotti di molto.
|
103
|
+
- La velocità di processazione e traduzione del sorgente è aumentata di molto.
|
104
|
+
- È mantenuta l'esatta corrispondenza fra i numeri di riga fra sorgente originale e sorgente tradotto.
|
105
|
+
|
106
|
+
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:
|
107
|
+
|
108
|
+
```ruby
|
109
|
+
classe Libro
|
110
|
+
|
111
|
+
accessore :titolo
|
112
|
+
|
113
|
+
definisci inizializzatore(titolo)
|
114
|
+
@titolo = titolo
|
115
|
+
fine
|
116
|
+
|
117
|
+
fine
|
118
|
+
```
|
119
|
+
|
120
|
+
e questo codice Ruby:
|
121
|
+
|
122
|
+
```ruby
|
123
|
+
require "italian/ruby"
|
124
|
+
richiedi_relativo "libro"
|
125
|
+
|
126
|
+
class Library
|
127
|
+
|
128
|
+
attr_accessor :books
|
129
|
+
|
130
|
+
def initialize
|
131
|
+
@books = []
|
132
|
+
end
|
133
|
+
|
134
|
+
def add(title)
|
135
|
+
@books << Libro.new(title)
|
136
|
+
end
|
137
|
+
end
|
138
|
+
```
|
139
|
+
|
140
|
+
Questo codice risulta perfettamente valido e funzionante.
|
100
141
|
|
101
142
|
Per concludere, ci sono degli avvertimenti.
|
102
|
-
1.
|
103
|
-
2.
|
143
|
+
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.).
|
144
|
+
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!
|
104
145
|
|
105
146
|
## Contribuire
|
106
147
|
|
107
|
-
Bug e issue qui -> https://github.com/
|
148
|
+
Bug e issue qui -> https://github.com/Pluvie/italian-ruby.
|
@@ -24,6 +24,7 @@ class Date
|
|
24
24
|
alias :anno_precedente :prev_year
|
25
25
|
alias :in_stringa :to_s
|
26
26
|
alias :in_data :to_date
|
27
|
+
alias :in_tempo :to_time
|
27
28
|
alias :giorno_della_settimana :cwday
|
28
29
|
alias :formatta :strftime
|
29
30
|
|
@@ -31,6 +32,18 @@ class Date
|
|
31
32
|
self.prev_year.prev_year
|
32
33
|
end
|
33
34
|
alias :due_anni_precedenti :due_anni_fa
|
35
|
+
|
36
|
+
alias :original_equality :==
|
37
|
+
def ==(other)
|
38
|
+
return (self == other.to_date) if other.is_a? Time
|
39
|
+
original_equality other
|
40
|
+
end
|
41
|
+
|
42
|
+
alias :original_compare :<=>
|
43
|
+
def <=>(other)
|
44
|
+
return (self <=> other.to_date) if other.is_a? Time
|
45
|
+
original_compare other
|
46
|
+
end
|
34
47
|
end
|
35
48
|
|
36
49
|
Data = Date
|
@@ -8,6 +8,7 @@ class String
|
|
8
8
|
alias :prima_maiuscola :capitalize
|
9
9
|
alias :in_simbolo :to_sym
|
10
10
|
alias :in_stringa :to_s
|
11
|
+
alias :in_numero :to_i
|
11
12
|
alias :dividi :split
|
12
13
|
alias :maiuscola :upcase
|
13
14
|
alias :maiuscolo :upcase
|
@@ -25,6 +26,10 @@ class String
|
|
25
26
|
alias :spoglia :strip
|
26
27
|
alias :conteggio :count
|
27
28
|
alias :conteggia :count
|
29
|
+
alias :codifica :encoding
|
30
|
+
alias :codifica_in :encode
|
31
|
+
alias :codifica_valida? :valid_encoding?
|
32
|
+
alias :forza_codifica_a :force_encoding
|
28
33
|
|
29
34
|
def esiste?
|
30
35
|
!nil? and self != ""
|
@@ -17,6 +17,22 @@ class Time
|
|
17
17
|
def in_data
|
18
18
|
self.to_date
|
19
19
|
end
|
20
|
+
|
21
|
+
def in_tempo
|
22
|
+
self
|
23
|
+
end
|
24
|
+
|
25
|
+
alias :original_equality :==
|
26
|
+
def ==(other)
|
27
|
+
return (self.to_date == other) if other.is_a? Date
|
28
|
+
original_equality other
|
29
|
+
end
|
30
|
+
|
31
|
+
alias :original_compare :<=>
|
32
|
+
def <=>(other)
|
33
|
+
return (self.to_date <=> other) if other.is_a? Date
|
34
|
+
original_compare other
|
35
|
+
end
|
20
36
|
end
|
21
37
|
|
22
38
|
Tempo = Time
|
data/lib/italian/ruby/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: italian-ruby
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.8.
|
4
|
+
version: 0.8.10
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Francesco Ballardin
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2020-06-
|
11
|
+
date: 2020-06-30 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: bundler
|