Amaliy loyiha — JSON katalog va CLI

~20 daq · Ruby · Tarmoq va amaliy loyiha

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.