# Gemfile
gem 'pry', group: [:development, :test]
gem 'pry-byebug', group: [:development, :test] # Adım adım hata ayıklama için önerilir
gem 'pry-doc', group: [:development, :test]    # Çevrimdışı dokümantasyon için

bundle install

gem install pry pry-byebug pry-doc

def hesaplama_yap(sayi1, sayi2)
  toplam = sayi1 + sayi2
  carpim = sayi1 * sayi2
  binding.pry # Kod burada duraklayacak ve Pry oturumu başlayacak
  fark = sayi1 - sayi2
  bolum = sayi1.to_f / sayi2.to_f
  "Sonuçlar: Toplam: #{toplam}, Çarpım: #{carpim}, Fark: #{fark}, Bölüm: #{bolum}"
end

puts hesaplama_yap(10, 5)

• `next` : Mevcut metodun bir sonraki satırına atlar. Eğer mevcut satırda bir metod çağrısı varsa, o metodun içine girmez, metodun yürütülmesini tamamlar ve metod çağrısından sonraki satıra geçer. Yüksek seviyeli akışı takip etmek için idealdir.
• `step` (s): Eğer mevcut satırda bir metod çağrısı varsa, bu metodun içine girer ve çağrılan metodun ilk satırında durur. Derinlemesine inceleme ve iç metodların çalışma mantığını anlamak için kullanılır.
• `continue` (c): Kodu duraklatılan yerden devam ettirir. Bir sonraki `binding.pry` çağrısına veya programın sonuna kadar çalışmasını sağlar.
• `exit` (q, quit): Mevcut Pry oturumundan çıkar ve programın normal akışına devam etmesini sağlar. Eğer iç içe Pry oturumları varsa, bir üst oturuma döner.
• `exit!` (!!!): Tüm Pry oturumlarından çıkar ve programın tamamen durmasını sağlar. Genellikle kurtarılamaz bir hata durumunda veya debug işlemini tamamen sonlandırmak istediğinizde kullanılır.
• `ls` (list locals/methods): Mevcut kapsamdaki tüm yerel değişkenleri, instance değişkenlerini (`@`), sınıf değişkenlerini (`@@`), global değişkenleri (`$`) ve metodları listeler. `ls -l` ile daha detaylı bilgi, `ls -G variables` ile sadece değişkenler, `ls -M` ile mevcut nesnenin metodları gibi filtrelemeler yapılabilir. Bu komut, o anki durumu görmek için paha biçilmezdir.
• `cd <nesne_adı>` (change directory): Pry oturumunun kapsamını belirtilen nesneye (örneğin bir sınıf, bir modül veya bir nesnenin instance'ı) değiştirir. Bu sayede o nesnenin içindeki metodlara ve değişkenlere doğrudan erişebilirsiniz. `cd ..` ile bir üst kapsama, `cd /` ile kök kapsama dönebilirsiniz.
• `whereami` (w): Pry'ın durduğu kod satırlarını ve çevresindeki bağlamı (genellikle 5-10 satır öncesi ve sonrası) gösterir. Bu, kodun neresinde olduğunuzu ve hangi kod bloğunda çalıştığınızı anlamak için çok faydalıdır.
• `show-source <metod_adı>`: Belirtilen metodun kaynak kodunu gösterir. Bu, özellikle bir kütüphanenin veya karmaşık bir metodun iç işleyişini anlamak için kullanılır. Örneğin, `show-source Array#map` komutu `Array` sınıfının `map` metodunun kaynak kodunu gösterir.
• `show-doc <metod_adı>`: Belirtilen metodun RDoc/YARD formatındaki dokümantasyonunu gösterir. Bu, bir metodun ne işe yaradığını, hangi argümanları aldığını ve ne döndürdüğünü hızlıca öğrenmek için harika bir yoldur. Örneğin, `show-doc String#split`.
• `hist` (history): Daha önce çalıştırılmış Pry komutlarını listeler. Önceki komutları tekrar kullanmak veya incelemek için kullanışlıdır.
• `play <dosya_adı>`: Bir Ruby dosyasını Pry içinde çalıştırır. Bu, yeni kod parçacıklarını test etmek veya hızlıca bir betiği çalıştırmak için kullanılabilir.
• `edit`: Harici bir editörde kod düzenlemenize olanak tanır. Örneğin, `edit -c "def new_method; puts 'Hello'; end"` ile yeni bir metod tanımlayabilir veya `edit some_file.rb` ile bir dosyayı düzenleyebilirsiniz. Değişiklikler kaydedildiğinde Pry oturumunuza geri dönersiniz.

• `pry-byebug`: Bu eklenti, geleneksel hata ayıklayıcıların temel komutlarını (örneğin `break`, `next`, `step`, `continue`) Pry'a entegre eder. Özellikle adım adım ilerleme ve breakpoint (kırılma noktası) yönetimi için kritik öneme sahiptir. Kurulumdan sonra `binding.pry` ile oturumu başlattığınızda otomatik olarak aktifleşir. Programın belirli bir satırda otomatik olarak duraklamasını sağlamak için `break` komutunu kullanabilirsiniz.
  
  Kod:

  # Örnek kullanım:
  def veriyi_islem(veri)
    ara_sonuc = veri * 2
    # binding.pry # Eğer burayı kaldırırsak, breakpoint ile durabiliriz
    nihai_sonuc = ara_sonuc + 10
    nihai_sonuc
  end
  
  # Pry konsolu içinde:
  # break veriyi_islem # 'veriyi_islem' metodunun başlangıcına breakpoint ekle
  # continue
  # next # adım adım ilerle
  # break my_file.rb:45 if some_condition # Koşullu breakpoint
  # break --list # Mevcut breakpointleri listele
  # break --delete 1 # ID'si 1 olan breakpointi sil

• `pry-doc`: Ruby çekirdek kütüphaneleri ve standart kütüphaneler için belgeleri çevrimdışı erişilebilir hale getirir. İnternet bağlantısına ihtiyaç duymadan `show-doc` komutuyla metod belgelerini görüntülemenizi sağlar, bu da hızlı referans ve öğrenme için mükemmeldir. `show-doc Hash#merge` gibi kullanımlar çok yaygındır.
• `pry-stack_explorer`: Çağrı yığınını (call stack) incelemenizi sağlar. `stack` komutuyla mevcut çağrı yığınını görebilir ve `frame` komutuyla farklı yığın kareleri arasında geçiş yaparak kodun nasıl bir akış izlediğini anlayabilirsiniz. Bu, özellikle karmaşık ve iç içe metod çağrılarının olduğu durumlarda sorunun kaynağını bulmada çok yardımcıdır.
  
  Kod:

  # Pry konsolu içinde:
  # stack # Çağrı yığınını göster
  # frame 1 # Yığındaki bir üst kareye geç
  # ls    # Yeni karedeki değişkenleri ve metodları gör
  # frame 0 # Tekrar mevcut kareye dön

• `pry-rails`: Rails uygulamaları için Pry'ı daha entegre hale getirir. `rails console` komutu yerine varsayılan olarak Pry'ı kullanmanızı sağlar ve Rails ortamına özgü yardımcı metodları (örneğin, modeller, controllerlar) Pry içinde kolayca erişilebilir kılar.

class User
  attr_accessor :name, :age

  def initialize(name, age)
    @name = name
    @age = age
  end

  def get_status # Durumu belirleyen metod
    if @age < 18
      "Çocuk"
    elsif @age >= 18 && @age <= 65
      "Yetişkin"
    else
      binding.pry # Buraya bir duraklama noktası ekleyelim
      "Emekli" # Yanlış, 65'ten büyükler "Yaşlı" olmalıydı
    end
  end

  def check_eligibility
    puts "Kontrol ediliyor: #{name}"
    status = get_status
    puts "Durum: #{status}"
    status
  end
end

user1 = User.new("Ayşe", 15)
user2 = User.new("Mehmet", 30)
user3 = User.new("Zeynep", 70) # Hatalı çıktıyı beklediğimiz kullanıcı

user1.check_eligibility
user2.check_eligibility
user3.check_eligibility # Bu çağrı 'binding.pry' noktasında duraklayacak

• `ls @age` komutuyla `@age` instance değişkeninin değerini kontrol edin. `70` olduğunu göreceksiniz.
• `whereami` komutuyla mevcut kod bağlamını ve durduğunuz satırı (else bloğu içinde) görün.
• Bu noktada, `70` yaşındaki bir kullanıcı için "Emekli" çıktısının doğru olmadığını fark edersiniz. Mantıksal hata buradadır.
• Düzeltme için `exit` ile Pry'dan çıkın ve kodu düzenleyin:
  
  Kod:

      else
        "Yaşlı" # Doğru çıktı bu olmalıydı
      end

• Kodu tekrar çalıştırarak hatanın giderilip giderilmediğini teyit edin.

• Sadece Geliştirme Ortamında Kullanım: `binding.pry` çağrılarını production ortamında bırakmaktan kaçının. Bu, uygulamanızın performansını ciddi şekilde etkileyebilir ve güvenlik açıkları oluşturabilir. `Gemfile`'da `group: [:development, :test]` kullanmak bu riski azaltır.
• Kalıcı `binding.pry`'dan Kaçının: Hata ayıklama işlemi bittikten sonra tüm `binding.pry` satırlarını kodunuzdan kaldırdığınızdan emin olun. Git commit'leri sırasında bu tür debug noktalarını gözden kaçırmamak için dikkatli olun.
• Sık Kullanılan Komutlar için Takma Adlar (Aliases): Pry, sıkça kullandığınız uzun komutlar için takma adlar (alias) tanımlamanıza olanak tanır. Örneğin, `.pryrc` dosyanıza `alias hist 'hist --show-file'` ekleyerek komut geçmişinizi daha rahat görebilirsiniz.
• Karmaşık Çağrı Yığınlarında `pry-stack_explorer`: Özellikle birçok iç içe metod çağrısı içeren karmaşık senaryolarda `pry-stack_explorer`'ı kullanarak çağrı yığınını incelemek ve farklı yığın kareleri arasında geçiş yapmak, hatanın nerede başladığını anlamanıza yardımcı olur.
• Pry'ın Kendi Belgelerine ve Topluluk Kaynaklarına Başvurun: Pry çok zengin bir araçtır ve tüm özelliklerini öğrenmek zaman alabilir. Resmi Pry GitHub Sayfası ve Ruby on Rails Debugging Rehberi (Pry kullanımı hakkında detaylı bilgi içerir) gibi kaynaklar, bilginizi derinleştirmek için harika başlangıç noktalarıdır.
• Koşullu Breakpointler Kullanın: `pry-byebug` ile gelen `break` komutunun koşullu breakpoint özelliklerini kullanarak yalnızca belirli bir durum oluştuğunda kodun duraklamasını sağlayabilirsiniz. Bu, özellikle büyük veri kümeleriyle çalışırken veya nadiren ortaya çıkan hataları ayıklarken çok zaman kazandırır.
  
  Kod:

  # break MyApp::User#save if user.invalid? # Sadece kullanıcı geçersizse dur

• Geri Dönüş Değerlerini İnceleyin: Pry oturumunda iken, bir metodun veya ifadenin geri dönüş değerini hemen konsola yazdırarak kontrol edebilirsiniz. Örneğin, `my_object.some_method` yazıp Enter'a basmak, metodun o anki dönüş değerini gösterecektir.
  
  Kod:

  # Pry içinde:
  # user.age # 70
  # user.name.reverse # "epyA"

Hata ayıklama, bir yazılım geliştiricisinin en temel ve en önemli yeteneklerinden biridir. Pry gibi güçlü bir araçla bu süreci interaktif hale getirmek, sadece hataları bulmanızı hızlandırmakla kalmaz, aynı zamanda kodunuzun iç işleyişini daha derinlemesine anlamanızı sağlar.

Genişletmek için tıkla ...