Introduzione

Ruby è un linguaggio di programmazione a oggetti particolarmente utilizzato in ambito web.
Viene qui mostrato come installare i pacchetti base disponibili direttamente in Ubuntu oppure utilizzando strumenti più adatti in ambiente di sviluppo (RVM, RubyGems).

Installazione

Se si avesse la necessità di installare una versione di Ruby differente da quella presente nei repository o comunque avere a disposizionie più versioni in ambiente di sviluppo, è consigliabile seguire la guida su RVM.

Installare il pacchetto ruby.

Installazione tramite RVM

Consultare il seguente guida.

Esecuzione script

Viene preso come esempio uno script che simula il lancio di un dado... con la speranza di fare 6

Salvare nella propria Home un file di testo col nome dado.rb contenente le seguenti stringhe:

print 'Premi invio per tirare il dado '
gets
risultato = rand(1..6)
risultato == 6 ? puts('Wow! Hai fatto 6 :)') : puts("Hai fatto #{risultato}")

Digitare nel terminale:
```
ruby dado.rb 
```
Se tutto è stato eseguito nel modo corretto si avvia un semplice gioco interattivo in cui viene lanciato un dado e si visualizzerà un risultato di questo tipo:
```
Premi invio per tirare il dado 
Hai fatto 3
```

Metodo alternativo

inserire all'inizio dello script la direttiva:
```
#!/usr/bin/env ruby
```
Rendere lo script eseguibile con il comando:
```
chmod u+x dado.rb
```
Sarà ora possibile avviare lo script con il comando:
```
./dado.rb
```

Shell interattiva

Ruby è provvisto di una shell interattiva chiamata irb. Tuttavia viene spesso preferita pry in quanto più performante e con funzionalità aggiuntive in particolare per il debug. In tal caso installare il pacchetto pry.

Per invocare la shell interattiva sarà, a seconda dei casi, sufficiente digitare il comando:
```
irb
```
oppure:
```
pry
```
Per uscire dalla shell interattiva, digitare:
```
exit
```
oppure la combinazione di tasti Ctrl+Z.

Rubocop

RuboCop è un analizzatore di codice in grado di rilevare eventuali divergenze dalle linee guida stilistiche riguardanti la sintassi di Ruby. Può rivelarsi uno strumento molto utile a migliorare il codice rilevando il cattivo utilizzo di:

indentazione
spazi vuoti
variabili inutilizzate
metodi (funzioni in Ruby) eccessivamente lunghe
altro..

Installare il pacchetto rubocop.

Il pacchetto è installabile anche tramite RubyGem.

Per utilizzarlo, supponendo di aver creato il file script.rb nella propria Home, attraverso il comando:

```
rubocop script.rb
```

Gestore pacchetti RubyGem

Ruby ha internamente un suo gestore di pacchetti RubyGem per aggiungere funzionalità al linguaggio.
Tuttavia è bene fare un distinguo in base al caso si stia utilizzando la versione di Ruby resa disponibile da Ubuntu oppure tramite un manager di versione.

RubyGem sarà il gestore pacchetti di riferimento nel caso si stia utilizzando una versione di Ruby installata tramite manager di versione.
Se invece si sta utilizzando la versione fornita da Ubuntu, è bene sapere che una vasta gamma di pacchetti aggiuntivi sono già presenti all'interno dei repository di Ubuntu. Pertanto in molti casi non sarà necessario ricorrere a metodi alternativi per installarli.
Tuttavia nel caso si optasse per l'utilizzo di RubyGem, sarà necessario impostare le variabili di ambiente aggiungendo nel file .bashrc presente nella propria home le seguenti righe:
```
## Ruby gem
export GEM_HOME="$HOME/.gem"
export PATH="$HOME/.gem/bin:$PATH"
```
Andrà quindi riavviato il terminale se in utilizzo.

Utilizzo

Il generico comando per installare un pacchetto è del tipo:

```
gem install NOME_PACCHETTO
```

Ad esempio, per installare il pacchetto rubocop, il comando diviene:

```
gem install rubocop
```

Per installare una versione specifica, ad es. la 0.86.0, il comando diviene:

```
gem install rubocop --version 0.86.0
```

Per ulteriori comandi consultare la guida ufficiale.

Guide per principianti

Ulteriori risorse

CategoryProgrammazione

-  ⇤ ← Versione 20 del 28/04/2021 16.36.42 → 
  Dimensione: 7078
  Autore: jeremie2
  Commento:
+   ← Versione 25 del 13/08/2021 11.25.41 → ⇥
  Dimensione: 5633
  Autore: jeremie2
  Commento: RubyGem per Ruby installato dal repo Ubuntu
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 14:
-Ubuntu mette a disposizione nei suoi [[Repository|Repository]] ufficiali i pacchetti relativi a una determinata versione di '''Ruby'''.<<BR>>
Questo può essere un limite qualora si abbia la necessità di fare riferimento a una versione differente o più specifiche versioni. In tal caso è preferibile affidarsi a un manager di versione come '''RVM'''. 

== Da repository Ubuntu ==
+{{{#!wiki tip
Se si avesse la necessità di installare una versione di '''Ruby''' differente da quella presente nei  [[Repository|repository]] o comunque avere a disposizionie più versioni in ambiente di sviluppo, è consigliabile seguire la guida su [[Programmazione/Ruby/Rvm|RVM]].
}}}
-Linea 21:
+Linea 20:
-== Tramite RVM ==
+= Installazione tramite RVM =
-Linea 23:
+Linea 22:
- * Consultare il [[#rvm|seguente paragrafo]].

= Gestore pacchetti RubyGem =

'''Ruby''' ha internamente un suo gestore di pacchetti [[https://rubygems.org/|RubyGem]] per aggiungere funzionalità al linguaggio.<<BR>>
Tuttavia è bene fare un distinguo in base al caso si stia utilizzando la versione di '''Ruby''' resa disponibile da Ubuntu oppure tramite un [[#rvm|manager di versione]].<<BR>>
 * Se si sta utilizzando la versione fornita da Ubuntu, è bene sapere che una vasta gamma di pacchetti aggiuntivi sono già presenti all'interno dei repository di Ubuntu. Pertanto non sarà necessario ricorrere a metodi alternativi per installarli.
 * Se invece si sta utilizzando una versione di Ruby installata tramite '''manager di versione''' è opportuno affidarsi a '''!RubyGem''' per installare pacchetti aggiuntivi.

Il generico comando per installare un pacchetto è del tipo:
 {{{
gem install NOME_PACCHETTO
}}}
Ad esempio, per installare il pacchetto ''rubocop'', il comando diviene:
 {{{
gem install rubocop
}}}
Per installare una versione specifica, ad es. la '''0.86.0''', il comando diviene:
 {{{
gem install rubocop --version 0.86.0
}}}

{{{#!wiki tip
Per ulteriori comandi consultare la [[https://guides.rubygems.org/rubygems-basics/|guida ufficiale]].
}}}
+ * Consultare il [[Programmazione/Ruby/Rvm|seguente guida]].
-Linea 57:
+Linea 32:
-Linea 59:
+Linea 33:
-Linea 68:
+Linea 41:
-In alternativa:
+== Metodo alternativo ==
-Linea 96:
+Linea 70:
-'''[[https://rubocop.org/|RuboCop]]''' è un analizzatore di codice in grado di rilevare eventuali divergenze dalle [[https://github.com/rubocop/ruby-style-guide/blob/master/README.adoc|linee guida]] stilistiche riguardanti la sintassi di '''Ruby'''.<<BR>>
[[AmministrazioneSistema/InstallareProgrammi|Installabile]] tramite il pacchetto [[apt://rubocop|rubocop]], può rivelarsi uno strumento molto utile a migliorare il codice rilevando il cattivo utilizzo di indentazione, spazi bianchi, variabili non utilizzate, metodi (funzioni in Ruby) eccessivamente lunghe, ecc..
+'''[[https://rubocop.org/|RuboCop]]''' è un analizzatore di codice in grado di rilevare eventuali divergenze dalle [[https://github.com/rubocop/ruby-style-guide/blob/master/README.adoc|linee guida]] stilistiche riguardanti la sintassi di '''Ruby'''. Può rivelarsi uno strumento molto utile a migliorare il codice rilevando il cattivo utilizzo di:
 * indentazione
 * spazi vuoti
 * variabili inutilizzate
 * metodi (funzioni in Ruby) eccessivamente lunghe
 * altro..
-Linea 99:
+Linea 77:
-Supponendo di aver creato il file `script.rb` nella propria '''Home''', per verificarne il codice digitare nel terminale:{{{
+[[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://rubocop|rubocop]].

{{{#!wiki tip
Il pacchetto è installabile anche tramite [[#gem|RubyGem]]. 
}}}

Per utilizzarlo, supponendo di aver creato il file `script.rb` nella propria '''Home''', attraverso il comando:
 {{{
-Linea 103:
+Linea 88:
-<<Anchor(rvm)>>
= RVM =
+ <<Anchor(gem)>>
= Gestore pacchetti RubyGem =
-Linea 106:
+Linea 91:
-Attraverso '''RVM''' ([[https://rvm.io/|Ruby Version Manager]]) sarà possibile in modo molto pratico:
 * installare più versioni di '''Ruby''';
 * impostare la versione predefinita;
 * passare rapidamente da una versione all'altra.
+'''Ruby''' ha internamente un suo gestore di pacchetti [[https://rubygems.org/|RubyGem]] per aggiungere funzionalità al linguaggio.<<BR>>
Tuttavia è bene fare un distinguo in base al caso si stia utilizzando la versione di '''Ruby''' resa disponibile da Ubuntu oppure tramite un [[Programmazione/Ruby/Rvm|manager di versione]].<<BR>>
 * '''!RubyGem''' sarà il gestore pacchetti di riferimento nel caso si stia utilizzando una versione di Ruby installata tramite [[Programmazione/Ruby/Rvm|manager di versione]].
 * Se invece si sta utilizzando la versione '''fornita da Ubuntu''', è bene sapere che una vasta gamma di pacchetti aggiuntivi sono già presenti all'interno dei repository di Ubuntu. Pertanto in molti casi non sarà necessario ricorrere a metodi alternativi per installarli.<<BR>>Tuttavia nel caso si optasse per l'utilizzo di '''!RubyGem''', sarà necessario impostare le variabili di ambiente aggiungendo nel file `.bashrc` presente nella propria '''home''' le seguenti righe:{{{
## Ruby gem
export GEM_HOME="$HOME/.gem"
export PATH="$HOME/.gem/bin:$PATH"
}}}Andrà quindi riavviato il terminale se in utilizzo.
-Linea 111:
+Linea 100:
-Seguono i passi per l'installazione e utilizzo base di '''RVM'''. Il tutto verrà installato in un ambiente ''sandboxed'' nella propria '''Home'''.
 
== Installazione di RVM ==
+== Utilizzo ==
-Linea 115:
+Linea 102:
-. Impostare il terminale come shell di login:
  * '''Terminale GNOME''':
   0. Dal menù selezionare '''Preferenze''' e quindi il proprio profilo.
   0. Selezionare il tab '''Comando''' e mettere una spunta alla voce '''Eseguire il comando come una shell di login'''.
  * '''Terminale KDE'''
   0. Dal menù selezionare '''''Impostazioni → Modifica profilo → Generale'''''.
   0. Alla voce comando modificare il testo in modo che risulti:{{{
/bin/bash --login
+Il generico comando per installare un pacchetto è del tipo:
 {{{
gem install NOME_PACCHETTO
-Linea 124:
+Linea 106:
-. Installare il pacchetto ''curl'' digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
sudo apt install curl
+Ad esempio, per installare il pacchetto ''rubocop'', il comando diviene:
 {{{
gem install rubocop
-Linea 127:
+Linea 110:
-. Installare ''rvm'':{{{
curl -L get.rvm.io | bash -s stable --auto
}}}
 0. Aggiornare il profilo ''bash'':{{{
. ~/.bash_profile
}}}
 0. Installare eventuali dipendenze:{{{
rvm requirements
+Per installare una versione specifica, ad es. la '''0.86.0''', il comando diviene:
 {{{
gem install rubocop --version 0.86.0
-Linea 137:
+Linea 115:
-== Installazione di Ruby e utilizzo ==

Il numero di versione viene qui generalizzato in '''x.x.x'''. Avere cura di sostituirlo con la versione interessata ('''2.7.2''', '''3.0.0''', ecc..).

||<:-2 #cccccc> '''Comandi'''                                      ||
|| `rvm list known`               || Lista versioni disponibili    ||
|| `rvm install ruby`             || Installare ultima versione    ||
|| `rvm install ruby-x.x.x `      || Installare versione specifica ||
|| `rvm --default use ruby-x.x.x` || Rendere versione predefinita  ||
|| `rvm use ruby-x.x.x `          || Seleziona versione da usare   ||
+{{{#!wiki tip
Per ulteriori comandi consultare la [[https://guides.rubygems.org/rubygems-basics/|guida ufficiale]].
}}}