Какво за вас е качествен код?

За мен качественият код има следните характеристики:

• Четливост: Лесен за разбиране от други разработчици (и за себе си след половин година).
• Поддържане: Промените и корекциите на грешки се извършват бързо и безопасно.
• Тестване: Кодът е разделен на модули, които лесно могат да бъдат изолирани и тествани.
• Чистота: Без дублиране (DRY), ясни имена на променливи и функции, спазване на стиловете за кодиране.
• Ефективност: Оптимално използване на ресурси (процесор, памет) за задачата.
• Надеждност: Взема предвид възможни грешки (изключения, null стойности) и ги обработва правилно.
• Документация: При необходимост съдържа ясни коментари или документация.

Пример за чист код, който избягва дублиране:

// Лошо: дублиране на логика
fun processUser(user: User) {
    if (user.isActive) {
        println("Обработка на активен потребител ${user.name}")
        // Много код...
    } else {
        println("Обработка на неактивен потребител ${user.name}")
        // Същият много код...
    }
}

// Добре: извличане на повтарящата се логика
fun processUser(user: User) {
    println("Обработка на потребител ${user.name}") // Общата логика
    if (user.isActive) {
        processActiveUser(user)
    } else {
        processInactiveUser(user)
    }
    // Много код... // Общата логика след if/else
}

fun processActiveUser(user: User) {
    // Само специфична логика за активни
}

fun processInactiveUser(user: User) {
    // Само специфична логика за неактивни
}

Пример, който демонстрира четливост и ясни имена:

// Лошо
fun calc(a: Int, b: Int): Int {
    return a + b
}

// Добре
fun calculateSum(firstNumber: Int, secondNumber: Int): Int {
    return firstNumber + secondNumber
}