Testlaşni çuqurroq örganiş

Nimalarni örganasiz
- Testlarni
tests/papkasi,conftest.pyva-kbilan qanday tartiblaş - Tayyorlaş va tozalaş uçun fixture scopelari va
yieldli fixturelar - Örnatilgan
monkeypatch,capsysvacaplogfixturelari unittest.mock:Mock,patch,return_value,side_effect- Test dubli (test double) qaçon kerak va yaxşi test qanday böladi
Nega bu muhim
Samarqanddagi yetkazib beriş ilovasi SMS yuboradi, muhit özgaruvçilarini (kod taşqarisida saqlanadigan va os.environ orqali öqiladigan sozlamalar) öqiydi va muvaffaqiyatsiz tölovlarni logga yozadi. Testlar haqiqiy SMS yubora olmaydi va tarmoqni kuta olmaydi. pytest bilan testlaş darsi asoslarni örgatdi; bu darsda taşqi dunyo bilan boğlanadigan kodni testlaymiz.
pytest ni kompyuteringizda işga tuşiring
pytest fayllarini ("▶ Muharrirda işga tuşiriş" tugmasi yöq bloklarni) kompyuteringizda işga tuşiring. Işga tuşiriladigan bloklar brauzerda işlaydigan unittest.mock, logging va oddiy assert dan foydalanadi.
Test töplamini tartiblaş
Test fayllari bir neçta bölsa, tests/ papkasidan foydalaning:
shop_project/
├── shop.py
├── pytest.ini # pythonpath = .
└── tests/
├── conftest.py # umumiy fixturelar
├── test_orders.py
└── test_shop.py- pytest
conftest.pyni avtomatik yuklaydi; undagi fixturelar şu papkadagi va undan pastdagi papkalardagi har bir test faylida işlaydi. - Testlarni xatti-harakat böyiça nomlang:
test_discount2emas,test_large_discount_logs_warning. pytest.inidagipythonpath = .testlargaimport shopqiliş imkonini beradi.pytest -k "currency or receipt"faqat nomi mos keladigan testlarni işga tuşiradi (collected 6 items / 4 deselected / 2 selected).
Fixture scopelari va yield li fixturelar
return örniga yield işlatadigan fixture tozalaş (teardown) qismiga ega böladi: yield dan keyingi kod testdan keyin, hatto test yiqilsa ham bajariladi. tests/conftest.py:

import pytest
class FakeDatabase:
def __init__(self):
self.orders = []
def close(self):
print("yopildi")
@pytest.fixture
def db():
database = FakeDatabase() # tayyorlaş
print("ulandi")
yield database # test şu yerda işlaydi
database.close() # tozalaş, test yiqilsa hamdb dan foydalanadigan ikkita test bilan pytest -q -s (printlarni körsatadi) quyidagini beradi:
ulandi
.yopildi
ulandi
.yopildi
2 passed in 0.01sScope fixture qança tez-tez yaratilişini belgilaydi:
| Scope | Bir marta yaratiladi | Nima uçun |
|---|---|---|
function (standart) | har bir testda | test özgartiradigan har qanday narsa |
module | har bir test faylida | sekin, faqat öqiladigan tayyorgarlik |
session | har bir işga tuşirişda | test serveri |
@pytest.fixture(scope="module") kabi kengroq scopelar tezroq, lekin umumiy böladi (Köp uçraydigan xatolarga qarang).
Örnatilgan fixturelar: monkeypatch, capsys, caplog
tmp_path ni allaqaçon bilasiz. pytest bilan yana uçtasi keladi. Pastroqdagi işga tuşiriladigan muqobil misol shop.py dagiga öxşaş funksiyalarni özi aniqlaydi. tests/test_shop.py:
import shop
def test_currency_from_env(monkeypatch):
monkeypatch.setenv("SHOP_CURRENCY", "USD")
assert shop.get_currency() == "USD"
def test_ask_quantity(monkeypatch):
monkeypatch.setattr("builtins.input", lambda prompt: "3")
assert shop.ask_quantity() == 3
def test_receipt(capsys):
shop.print_receipt({"somsa": 8000})
captured = capsys.readouterr()
assert captured.out == "somsa: 8000 söm\n"
def test_large_discount_logs(caplog):
assert shop.apply_discount(100000, 60) == 40000
assert "katta çegirma 60%" in caplog.textmonkeypatchmuhit özgaruvçilarini (setenv,delenv) va atributlarni (setattr) örnatadi hamda testdan keyin har bir özgarişni bekor qiladi.capsysçiqarilgan matnni,caplogesa log yozuvlarini uşlab oladi.
Standart kutubxona brauzerda xuddi şunday qila oladi:
import logging
import os
import unittest
from unittest.mock import patch
logger = logging.getLogger("shop")
def get_currency():
return os.environ.get("SHOP_CURRENCY", "söm")
def ask_quantity():
return int(input("Neçta? "))
def apply_discount(price, percent):
if percent > 100:
raise ValueError("foiz köpi bilan 100 bölişi kerak")
if percent > 50:
logger.warning("katta çegirma %s%%", percent)
return price * (100 - percent) // 100
with patch.dict(os.environ, {"SHOP_CURRENCY": "USD"}):
assert get_currency() == "USD"
with patch("builtins.input", return_value="3"):
assert ask_quantity() == 3
case = unittest.TestCase()
with case.assertLogs("shop", level="WARNING") as logs:
assert apply_discount(100000, 60) == 40000
print(logs.output)
with case.assertRaisesRegex(ValueError, "köpi bilan 100"):
apply_discount(100000, 150)
print("barça tekşiruvlar ötdi")['WARNING:shop:katta çegirma 60%']
barça tekşiruvlar ötdiHeç narsa logga yozilmasa, assertLogs yiqiladi; assertRaisesRegex esa pytest.raises(..., match=...) kabi işlaydi.
Mock: çaqiruvlarni yozib boradigan soxta obyekt
Mock har qanday atribut yoki çaqiruvni qabul qiladi va uni yozib qoladi. return_value çaqiruv nima qaytarişini belgilaydi:
from unittest.mock import Mock
sms = Mock()
sms.send.return_value = "yetkazildi"
print(sms.send("+998901234567", "Palovingiz yölda"))
print("çaqiruvlar:", sms.send.call_count)
sms.send.assert_called_once_with("+998901234567", "Palovingiz yölda")
print("assert_called_once_with ötdi")yetkazildi
çaqiruvlar: 1
assert_called_once_with ötdiside_effect çaqiruvni istisno çaqiradigan yoki röyxat elementlarini birma-bir qaytaradigan qiladi; xatolarni qayta işlaş aynan şunday testlanadi:
from unittest.mock import Mock
def notify(sms, phone):
try:
return sms.send(phone, "Buyurtma tayyor")
except ConnectionError:
return "keyinroq qayta urinamiz"
sms = Mock()
sms.send.side_effect = ConnectionError("tarmoq işlamayapti")
print(notify(sms, "+998901234567"))
sms.send.side_effect = ["xato", "yetkazildi"]
print(sms.send(), sms.send())keyinroq qayta urinamiz
xato yetkazildipatch: nomni bitta test uçun almaştiriş
Kod öz boğliqligini özi topsa, unga mockni uzata olmaysiz. patch("module.name") nomni Mock bilan almaştiradi va keyin qaytarib qöyadi; u kontekst menejeri yoki dekorator sifatida işlaydi:
import random
from unittest.mock import patch
def pick_winner(names):
return random.choice(names)
with patch("random.choice", return_value="Dilnoza") as fake_choice:
print(pick_winner(["Aziza", "Bobur", "Dilnoza"]))
fake_choice.assert_called_once_with(["Aziza", "Bobur", "Dilnoza"])
@patch("random.choice")
def test_winner(fake_choice):
fake_choice.return_value = "Jasur"
assert pick_winner(["Jasur", "Bobur"]) == "Jasur"
test_winner()
print("test_winner ötdi")Dilnoza
test_winner ötdiDekorator mockni argument sifatida uzatadi. Bu işlaydi, çunki pick_winner random.choice ni işlayotgan paytda qidiradi (Köp uçraydigan xatolarga qarang).
Test dublilarimi yoki haqiqiy obyektlarmi?
Test dubli (mock, soxta klass yoki stub) sekin, işonçsiz yoki boşqarib bölmaydigan narsa örnini bosadi: tarmoq, SMS şlyuzi, soat, tasodifiylik. Öz mantiqingiz uçun haqiqiy obyektlardan foydalaning.
Vaqt va tasodifiylik uçun köpinça mock kerak emas: soatni yoki seed berilgan generatorni taşqaridan uzating (inject), yaʼni uni argument sifatida bering:
import random
from datetime import datetime
def greeting(now=datetime.now):
return "Xayrli tong" if now().hour < 12 else "Xayrli kun"
assert greeting(lambda: datetime(2026, 9, 16, 9, 0)) == "Xayrli tong"
assert greeting(lambda: datetime(2026, 9, 16, 15, 0)) == "Xayrli kun"
rng = random.Random(42)
print([rng.randint(1, 6) for _ in range(5)])[6, 1, 1, 6, 3]Asosiy dastur greeting() ni çaqiradi; testlar esa belgilangan soatni uzatadi. Seed berilgan random.Random har safar bir xil sonlarni beradi.
Coverage (qamrov) testlaringiz qaysi qatorlarni bajarganini körsatadi: pytest-cov ni örnating va pytest --cov=shop ni işga tuşiring. 100% har bir qator bajarilganini bildiradi, tekşirilganini emas, şuning uçun uni testlanmagan kod xaritasi deb qarang.
Yaxşi test:
- bitta xatti-harakatni tekşiradi va şu böyiça nomlanadi;
- tez va deterministik (har safar bir xil natija);
- mustaqil: yolğiz ham, istalgan tartibda ham ötadi;
- içki tafsilotlarni emas, natijalarni tekşiradi;
- kod buzilganda yiqiladi (tekşiriş uçun uni bir marta buzib köring).
Özingiz sinab köring
Bu qayta urinuvçi funksiya juda erta taslim böladi. Test ötadigan qiling.
Köp uçraydigan xatolar
1. Nomni işlatilgan joyda emas, aniqlangan joyda patch qiliş
rates.py fetch_rate() ni aniqlaydi, prices.py esa from rates import fetch_rate qilib, ikkinçi nom yaratadi. rates.fetch_rate ni patch qiliş unga taʼsir qilmaydi:
from unittest.mock import patch
from prices import price_in_som
def test_price_wrong_path():
with patch("rates.fetch_rate", return_value=12500): # Yomon
assert price_in_som(2) == 25000 def fetch_rate():
> raise ConnectionError("testlarda internet yöq")
E ConnectionError: testlarda internet yöqTuzatiş: nomni kod uni qidiradigan joyda patch qiling: patch("prices.fetch_rate", return_value=12500).
2. Özgaruvçan holatli module scopedagi fixture
Yuqoridagi db fixture, endi scope="module" bilan (Yomon: butun fayl uçun bitta röyxat):
def test_add_order(db):
db.orders.append("palov")
assert db.orders == ["palov"]
def test_no_orders_yet(db):
assert db.orders == []E AssertionError: assert ['palov'] == []
E
E Left contains one more item: 'palov'test_no_orders_yet yolğiz işga tuşirilsa ötadi, lekin test_add_order dan keyin yiqiladi. Tuzatiş: özgaruvçan obyektlar uçun standart function scopedan foydalaning.
3. Testlanayotgan narsaning özini mock qiliş
from unittest.mock import Mock
class Cart:
def __init__(self, prices):
self.prices = prices
def total(self):
return sum(self.prices) * 2 # xato
cart = Cart([15000, 8000])
cart.total = Mock(return_value=23000) # Yomon: haqiqiy metodni almaştiradi
assert cart.total() == 23000
print("test ötdi, lekin haqiqiy jami", Cart.total(cart))test ötdi, lekin haqiqiy jami 46000Test faqat mockni testlaydi. Tuzatiş: taşqi boğliqliklarni (tarmoq, vaqt, SMS) mock qiling, öz kodingizni esa haqiqatan işga tuşiring.
4. Heç qaçon bölmagan çaqiruvni tekşiriş
from unittest.mock import Mock
def place_order(items, sms):
total = sum(items.values())
if total > 1_000_000: # xato: har bir buyurtma SMS yuborişi kerak
sms.send(f"Buyurtma jami: {total} söm")
return total
sms = Mock()
place_order({"palov": 35000}, sms)
sms.send.assert_called_with("Buyurtma jami: 35000 söm")AssertionError: expected call not found.
Expected: send('Buyurtma jami: 35000 söm')
Actual: not called.Test haqiqiy xatoni topdi. Tuzatiş: testni emas, kodni tuzating; call_args aslida nima bölganini körsatadi.
Maşqlar
1. Soxta valyuta kursi APIsi
amount * api.get_rate("USD") ni qaytaradigan usd_to_som(amount, api) ni yozing. get_rate i 12650 qaytaradigan Mock bilan 20 USD uçun natijani çop eting, çaqiruvni assert_called_once_with bilan tekşiring va "çaqiruv tekşirildi" ni çop eting.
Yeçim
from unittest.mock import Mock
def usd_to_som(amount, api):
return amount * api.get_rate("USD")
api = Mock()
api.get_rate.return_value = 12650
print(usd_to_som(20, api))
api.get_rate.assert_called_once_with("USD")
print("çaqiruv tekşirildi")253000
çaqiruv tekşirildi2. monkeypatch bilan muhit özgaruvçilari
Kompyuteringizda işga tuşiring: greet.py da greeting() bor, u f"Salom, {name}!" ni qaytaradi, bu yerda name - USER_NAME muhit özgaruvçisi yoki "döst". monkeypatch bilan ikkita pytest testi yozing: biri özgaruvçini örnatadi, boşqasi uni olib taşlaydi.
Yeçim
test_greet.py:
from greet import greeting
def test_name_from_env(monkeypatch):
monkeypatch.setenv("USER_NAME", "Aziza")
assert greeting() == "Salom, Aziza!"
def test_default_name(monkeypatch):
monkeypatch.delenv("USER_NAME", raising=False)
assert greeting() == "Salom, döst!".. [100%]
2 passed in 0.01s3. Işlagunça qayta uriniş
send_with_retry(sms, text, attempts=3) ni yozing: sms.send(text) ni u ConnectionError çaqirmay qolgunça çaqiring; uriniş raqamini, hammasi muvaffaqiyatsiz bölsa None ni qaytaring. side_effect bilan ikki marta yiqilib, keyin muvaffaqiyatli böladigan mockni va doim yiqiladigan mockni testlang. Har bir natija va çaqiruvlar sonini çop eting.
Yeçim
from unittest.mock import Mock
def send_with_retry(sms, text, attempts=3):
for attempt in range(1, attempts + 1):
try:
sms.send(text)
return attempt
except ConnectionError:
pass
return None
flaky = Mock()
flaky.send.side_effect = [ConnectionError(), ConnectionError(), "ok"]
print(send_with_retry(flaky, "Salom"), flaky.send.call_count)
broken = Mock()
broken.send.side_effect = ConnectionError("işlamayapti")
print(send_with_retry(broken, "Salom"), broken.send.call_count)3 3
None 34. tmp_path bilan yield li fixture
Kompyuteringizda işga tuşiring: orders.py da fayldagi qatorlar sonini qaytaradigan count_orders(path) bor. tmp_path da ikki qatorli orders.csv yaratadigan, testdan keyin esa "öçirilmoqda orders.csv" ni çop etib, faylni öçiradigan yield li fixture yozing. pytest -q -s ni işga tuşiring.
Yeçim
test_orders.py:
import pytest
from orders import count_orders
@pytest.fixture
def orders_file(tmp_path):
path = tmp_path / "orders.csv"
path.write_text("palov,35000\nsomsa,8000\n", encoding="utf-8")
yield path
print("öçirilmoqda", path.name)
path.unlink()
def test_count_orders(orders_file):
assert count_orders(orders_file) == 2.öçirilmoqda orders.csv
1 passed in 0.01s5. Dam oliş kunlaridagi hisobotlar
daily_report(sms, now) ni yozing: dam oliş kunlarida (now().weekday() >= 5) u "reports" loggeriga INFO darajasida "dam oliş kuni, hisobot yöq" ni yozadi; boşqa kunlarda sms.send("Kunlik hisobot tayyor") ni çaqiradi. Ikkala holatni Mock, belgilangan soatlar, assertLogs va assert_not_called bilan testlang, keyin "2 ta test ötdi" ni çop eting.
Yeçim
import logging
import unittest
from datetime import datetime
from unittest.mock import Mock
logger = logging.getLogger("reports")
def daily_report(sms, now=datetime.now):
if now().weekday() >= 5:
logger.info("dam oliş kuni, hisobot yöq")
return
sms.send("Kunlik hisobot tayyor")
def test_weekday_sends():
sms = Mock()
daily_report(sms, now=lambda: datetime(2026, 9, 16)) # çorşanba
sms.send.assert_called_once_with("Kunlik hisobot tayyor")
def test_weekend_logs():
sms = Mock()
with unittest.TestCase().assertLogs("reports", level="INFO") as logs:
daily_report(sms, now=lambda: datetime(2026, 9, 19)) # şanba
sms.send.assert_not_called()
assert logs.output == ["INFO:reports:dam oliş kuni, hisobot yöq"]
test_weekday_sends()
test_weekend_logs()
print("2 ta test ötdi")2 ta test ötdiXulosa
- Testlarni
tests/ga joylang, fixturelarniconftest.pyda ulaşing va bir qismini-kbilan işga tuşiring. yieldli fixturelar tozalaş qöşadi; kengroqscopelar tezroq, lekin holatni ulaşadi.monkeypatch,capsysvacaplogmuhit, çiqiş va loglar bilan işlaydi.Mockçaqiruvlarni yozib boradi;return_valuevaside_effectularni boşqaradi.- Nomni işlatilgan joyda patch qiling va faqat taşqi boğliqliklarni mock qiling: tarmoq, vaqt, tasodifiylik.