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
example
per 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