Ce este o piatră prețioasă? – Ghiduri RubyGems

Descoperă misterul din spatele a ceea ce se află într-un RubyGem.

Structura unui Gem

Care gem are un nume, o versiune și o platformă. De exemplu, therake gem are o versiune 0.8.7 (din mai,2009). Platforma lui Rake este ruby, ceea ce înseamnă că funcționează pe orice platformă pe care rulează Rubyr.

Platformele se bazează pe arhitectura procesorului, pe tipul sistemului de operare și, uneori, pe versiunea sistemului de operare. Exemplele includ „x86-mingw32” sau „java”. Platforma indică faptul că gemul funcționează numai cu un ruby construit pentruaceeași platformă. RubyGems va descărca automat versiunea corectă pentru platforma dumneavoastră. Consultați gem help platform pentru detalii complete.

În interiorul gemelor se află următoarele componente:

• Cod (inclusiv testele și utilitățile de suport)
• Documentație
• gemspec

Care gem urmează aceeași structură standard de organizare a codului:

% tree freewillfreewill/├── bin/│ └── freewill├── lib/│ └── freewill.rb├── test/│ └── test_freewill.rb├── README├── Rakefile└── freewill.gemspec

Aici, puteți vedea componentele majore ale unui gem:

• Directorul lib conține codul pentru gem
• Directorul test sau spec conține testele, în funcție de cadrul de testare pe care dezvoltatorul îl folosește
• Un gem are de obicei un Rakefile, pe care programulerake îl folosește pentru a automatiza testele, a genera cod și a efectua alte sarcini.
• Această gemă include, de asemenea, un fișier executabil în directorulbin, care va fi încărcat în PATH al utilizatorului atunci când gemul esteinstalat.
• Documentația este de obicei inclusă în README și în linie cu codul.Când instalați o gemă, documentația este generată automat pentru dumneavoastră.Majoritatea gemelor includ documentația RDoc,dar unele folosesc în schimb YARD docs.
• Piesa finală este gemspec, care conține informații despre gemă.Fișierele gemului, informațiile de testare, platforma, numărul versiunii și multe altele sunt toate prezentate aici, împreună cu adresa de e-mail și numele autorului.

Mai multe informații despre fișierul gemspec

Constituirea propriei bijuterii

Gemspec

Gemspec specifică informațiile despre o bijuterie, cum ar fi numele, versiunea, descrierea, autorii și pagina de pornire.

Iată un exemplu de fișier gemspec. Puteți afla mai multe în cum să faceți agem.

% cat freewill.gemspecGem::Specification.new do |s| s.name = 'freewill' s.version = '1.0.0' s.summary = "Freewill!" s.description = "I will choose Freewill!" s.authors = s.email = '[email protected]' s.homepage = 'http://example.com/freewill' s.files = end

.