Sizcə, keyfiyyətli kod yazmaq nə deməkdir?

Keyfiyyətli kod:

• Oxunaqlı və başa düşülən: Digər proqramçılar (və gələcəkdə siz) üçün asan başa düşüləndir.
• Dəstəklənən: Asan dəyişdirilir, səhvlər düzəldilir və yeni funksiyalar əlavə olunur.
• Etibarlı: Müxtəlif şəraitdə düzgün və proqnozlaşdırıla bilən işləyir.
• Effektiv: Qəbul edilən performansa malikdir və resursları optimal istifadə edir.
• Test edilə bilən: Funksionallığını yoxlamaq üçün avtomatlaşdırılmış testlər yazmaq asandır.
• Standartlara uyğun: Qəbul edilən kod üslubu və memarlıq prinsiplərinə riayət edir.
• Sənədləşdirilmiş (lazım olduqda): Əsas qərarlar və mürəkkəb kod hissələri izah edilir.

Keyfiyyətli kodun bəzi aspektləri:

• Adlandırma: Dəyişənlər, funksiyalar və sinflər üçün mənalı adlar istifadə olunur.
• Struktura: Kod məntiqi olaraq modullara, funksiyalara və siniflərə bölünür.
• Təkrarlamadan qaçınma: Eyni kodun təkrarlanmasının qarşısını almaq.
• Xəta idarəetməsi: İstisna vəziyyətlərinə uyğun cavab verilir.

# Oxunaqlı və təmiz kod nümunəsi
def calculate_order_total(items):
    """
    Sifarişdəki elementlərin ümumi qiymətini hesablayır.
    """
    total_price = 0
    for item in items:
        total_price += item.price * item.quantity
    return total_price

# Daha aşağı keyfiyyətli kod nümunəsi (anlaşılmaz adlar, şərh yoxdur)
def calc(a):
    t = 0
    for b in a:
        t += b[0] * b[1]
    return t

Müqayisə cədvəli:

Aspekti	Keyfiyyətli kod	Keyfiyyətsiz kod
Oxunaqlıq	Asan oxunan və başa düşülən	Anlaşılması çətindir
Dəstək	Asan dəyişdirilə və təkmilləşdirilə bilər	Dəyişiklik etmək çətindir
Test ediləbilənlik	Asan avtomatlaşdırılmış testlər yazmaq	Testləri avtomatlaşdırmaq çətindir