Ruby Language
Creazione / gestione gemma
Ricerca…
File Gemspec
Ogni gemma ha un file nel formato di <gem name>.gemspec che contiene i metadati relativi alla gemma e ai suoi file. Il formato di un gemspec è il seguente:
Gem::Specification.new do |s|
# Details about gem. They are added in the format:
s.<detail name> = <detail value>
end
I campi richiesti da RubyGems sono:
O author = string o authors = array
Usa author = se c'è un solo autore e authors = quando ce ne sono diversi. Per authors= usa un array che elenca i nomi degli autori.
files = array
Qui array è un elenco di tutti i file nella gemma. Questo può anche essere usato con la funzione Dir[] , ad esempio se tutti i file si trovano nella directory /lib/ , quindi puoi usare files = Dir["/lib/"] .
name = string
Qui stringa è solo il nome della tua gemma. Rubygems consiglia alcune regole da seguire quando si nomina la gemma.
- Usa caratteri di sottolineatura, NESSUN SPAZI
- Usa solo lettere minuscole
- Utilizza hypens per l'estensione gem (ad esempio se il tuo gioiello è denominato
exampleper un'estensione, lo chiamerestiexample-extension) in modo che quando è richiesta l'estensione, può essere richiesto comerequire "example/extension".
RubyGems aggiunge anche "Se pubblichi una gemma su rubygems.org, può essere rimosso se il nome è discutibile, viola la proprietà intellettuale oi contenuti della gemma soddisfano questi criteri. Puoi segnalare tale gemma sul sito di supporto di RubyGems."
platform=
Non lo so
require_paths=
Non lo so
summary= string
String è un riassunto dello scopo delle gemme e qualsiasi cosa tu voglia condividere sulla gemma.
version= string
L'attuale numero di versione della gemma.
I campi consigliati sono:
email = string
Un indirizzo email che verrà associato alla gemma.
homepage= string
Il sito web in cui vive la gemma.
license= o licenses=
Non lo so
Costruire una gemma
Una volta creato il tuo gioiello per pubblicarlo devi seguire alcuni passaggi:
- Costruisci il tuo gioiello con
gem build <gem name>.gemspec(il file gemspec deve esistere) - Crea un account RubyGems se non ne hai già uno qui
- Assicurati che non esistano gemme che condividono il nome delle tue gemme
- Pubblica la tua gemma con
gem publish <gem name>.<gem version number>.gem
dipendenze
Per elencare l'albero delle dipendenze:
gem dependency
Per elencare quali gemme dipendono da una gemma specifica (per esempio bundler)
gem dependency bundler --reverse-dependencies