Amaliy loyiha — JSON katalog va CLI
Muammodan boshlaylik
Obyekt, JSON, literal qidiruv va faylni bitta vositaga yig‘amiz.
Tushunib olamiz
Tashqi JSON modelga aylanishdan oldin tekshiriladi. Qidiruv IO’dan mustaqil funksiya bo‘ladi. Birinchi ishga tushish namunani yaratadi, keyingisi mavjud faylni o‘qiydi. Bu bir jarayonli o‘quv katalog; ko‘p mijozli backend uchun tranzaksiya va saqlash adapteri alohida kerak.
Ishlaydigan misol
Qo‘llab-quvvatlanayotgan stable Ruby (misollar Ruby 3.3+ sintaksisiga mos) ishlating. Kodni UTF-8 main.rbga saqlang va ruby main.rb bajaring. ruby -v, ruby -c main.rb tekshiradi. Gem va test darslarida Bundler orqali kerakli dependencylarni o‘rnating.
require "json"
Kitob = Struct.new(:nom, :narx, keyword_init: true)
def parse(h)
raise ArgumentError, "Model xato" unless h.is_a?(Hash) && h["nom"].is_a?(String) && h["narx"].is_a?(Integer)
raise ArgumentError, "Qiymat xato" if h["nom"].strip.empty? || h["narx"] < 0
Kitob.new(nom: h["nom"].dup.freeze, narx: h["narx"]).freeze
end
def qidir(katalog, q)
katalog.select { |k| k.nom.downcase.include?(q.downcase) }
end
begin
path = "katalog.json"
unless File.exist?(path)
File.write(path, JSON.generate([{nom:"Ruby asoslari",narx:25000},{nom:"Go asoslari",narx:30000}]), encoding: "UTF-8")
end
raise ArgumentError, "Fayl katta" if File.size(path) > 1_000_000
data = JSON.parse(File.read(path, encoding: "UTF-8"))
raise ArgumentError, "Array kerak" unless data.is_a?(Array)
katalog = data.map { |h| parse(h) }
topildi = qidir(katalog, ARGV.first || "ruby")
puts "Topilmadi" if topildi.empty?
topildi.each { |k| puts "#{k.nom}: #{k.narx}" }
rescue JSON::ParserError, ArgumentError, SystemCallError => e
warn "Katalog xatosi: #{e.message}"
exit 1
end
Natija va izoh
Birinchi ruby main.rb Ruby asoslari: 25000 chiqarishi kerak. Ruby main.rb go bilan boshqa kitobni toping. Mavjud JSON fayli namuna bilan avtomatik almashtirilmaydi.
[!WARNING] Exists tekshiruvi va keyingi yozish orasida boshqa jarayon holatni o‘zgartirishi mumkin. Haqiqiy multi-writer saqlash uchun boshqacha yechim tanlang.
Mustaqil mashq
Parse/qidiruvni Minitest bilan tekshirib add buyrug‘ini kiriting.
Avval yechimni ochmasdan o‘zingiz yozing. Natijani oldindan taxmin qiling, so‘ng haqiqiy natija bilan solishtiring. Oddiy kirishdan tashqari bo‘sh qiymat, nol yoki mavjud bo‘lmagan element kabi chegara holatlarini ham tekshiring.
Yechim va tekshirish yo‘li
Bo‘sh nom, manfiy narx, noto‘g‘ri JSON, topilmagan va case-insensitive qidiruvni test qiling. Keyingi bosqichda Rails yoki Rack HTTP adapteri qo‘shish mumkin; domen testlari saqlansin.
Xulosa
Tashqi JSON modelga aylanishdan oldin tekshiriladi.
Misolni ko‘chirib ishlatish bilan cheklanmang: qiymatlarni almashtiring, bitta qoidani o‘zgartiring va qaysi holatda xato chiqishini kuzating. Yangi bilimni kursdagi kichik loyihangizga alohida qadam sifatida qo‘shing.
Rasmiy manba: Ruby rasmiy hujjatlari, Ruby core API
Keyingi qadam: kurs loyihasini yangi talablar bilan kengaytiring va uning avtomatik tekshiruvlarini saqlang.