Ruby’yi yüklemek ve ilk GEM projenizi oluşturmak, çalıştırmak, test etmek ve oluşturmak için adım adım bir eğitim.
Birkaç basit adım izlerseniz Ruby ile başlamak hızlıdır. Bu kılavuzda, Ruby’yi kuracak, yeni bir mücevher projesi iskele, küçük bir program yazacak, testler çalıştıracak ve bir mücevher yapısı üreteceksiniz.
Hızlı üretken olabilmeniz için minimal ve pratik tutacağım.
1) Ruby’yi kurun
- RVM (Ruby Sürüm Yöneticisi, MacOS/Linux) kullanma:
curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm install ruby --latest
rvm use ruby --default
ruby --version
gem --version
bundler --version
2) Yeni bir proje oluşturun
Ruby kullanır bundler Bağımlılık yönetimi ve proje iskele için.
bundle gem my_gem
cd my_gem
Bu temel bir yapı yaratır:
my_gem/
├─ Gemfile
├─ lib/
│ └─ my_gem.rb
├─ my_gem.gemspec
└─ spec/
└─ my_gem_spec.rb
3) İlk programınızı yazın
Açık lib/my_gem.rb ve basit bir modül tanımlayın:
module MyGem
def self.greet(name = "Ruby")
"Hello, #{name}!"
end
end
Çalıştır:
ruby -e "require_relative 'lib/my_gem.rb'; puts MyGem.greet"
4) Bağımlılıkları Yönetin
Bağımlılık eklerseniz Gemfileyükleyin:
bundle install
Genellikle ilk “merhaba dünya” için buna ihtiyacınız olmayacaktır, ancak HTTP istemcileri veya web çerçeveleri gibi kütüphaneleri çektiğinizde çok önemlidir.
5) Kodunuzu biçimlendirin
Rubocop’u kurun ve kullanın:
gem install rubocop
rubocop
rubocop -a
6) Basit bir test ekleyin (RSPEC)
Düzenlemek spec/my_gem_spec.rb:
require "my_gem"
RSpec.describe MyGem do
it "greets with default name" do
expect(MyGem.greet).to eq "Hello, Ruby!"
end
it "greets a custom name" do
expect(MyGem.greet("World")).to eq "Hello, World!"
end
end
Testler çalıştırın:
bundle exec rspec
# or verbose:
bundle exec rspec -v
7) Bir mücevher oluşturun
Mücevherinizi Oluşturun:
gem build my_gem.gemspec
Test Yükleme:
gem install ./my_gem-0.1.0.gem
bundle viz
9) İsteğe bağlı: rubocop ile tiftik
Belirtildiği gibi, daha fazla yapılandırma için:
rubocop --auto-gen-config
Görsel Genel Bakış
İşte ilk projenizin basit bir akışı:
flowchart LR A[Install Ruby] --> B[bundle gem my_gem] B --> C[Edit lib/my_gem.rb] C --> D[ruby run] D --> E[bundle exec rspec] E --> F[rubocop] F --> G[gem build] G --> H[gem install]
Sırada ne var?
- Popüler Taşları Keşfedin:
- Web çerçeveleri: Sinatra, Rails
- Test: RSPEC
- HTTP istemci: faraday
- Bir mücevher, bir CLI aracı veya bir Rails uygulaması oluşturun ve Rubygems’te yayınlayın.
İlk Ruby Geminizi yeni oluşturdunuz, test ettiniz ve inşa ettiniz. Küçük tutun, hızlı bir şekilde yineleyin ve Ruby’nin esnekliğinin tadını çıkarın.