Mengapa pylint menolak nama variabel karakter tunggal?

Saya masih terbiasa dengan konvensi python dan menggunakan pylintuntuk membuat kode saya lebih pythonic, tapi saya bingung dengan fakta bahwa pylint tidak menyukai nama variabel karakter tunggal. Saya memiliki beberapa loop seperti ini:

for x in x_values:
   my_list.append(x)

dan ketika saya menjalankan pylint, saya mendapatkan Invalid name "x" for type variable (should match [a-z_][a-z0-9_]{2,30}- itu menunjukkan bahwa nama variabel yang valid harus antara 3 dan 31 karakter, tetapi saya telah melihat konvensi penamaan PEP8 dan saya tidak melihat sesuatu yang eksplisit mengenai satu huruf kecil , dan saya melihat banyak contoh yang menggunakannya.

Apakah ada sesuatu yang saya lewatkan di PEP8 atau apakah ini standar yang unik untuk pylint?

PyLint tidak hanya memeriksa rekomendasi PEP8. Ia juga memiliki rekomendasinya sendiri, salah satunya adalah bahwa nama variabel harus deskriptif dan tidak terlalu pendek.

Anda dapat menggunakan ini untuk menghindari nama pendek seperti itu:

my_list.extend(x_values)

Atau sesuaikan konfigurasi PyLint untuk memberi tahu PyLint nama variabel apa yang bagus.

Sedikit lebih detail tentang apa yang dicatat oleh brankar alex: Anda dapat memberi tahu PyLint untuk membuat pengecualian untuk nama variabel yang (Anda bersumpah kelingking) sangat jelas meskipun kurang dari tiga karakter. Temukan atau tambahkan ke file pylintrc Anda , di bawah [FORMAT]tajuk:

# Good variable names which should always be accepted, separated by a comma
good-names=i,j,k,ex,Run,_,pk,x,y

Di sini pk (untuk kunci primer), x, dan y adalah nama variabel yang telah saya tambahkan.

Dalam bahasa yang diketik dengan kuat, variabel nama 1 huruf bisa ok-ish, karena Anda biasanya mendapatkan tipe di samping nama dalam deklarasi variabel atau dalam prototipe fungsi / metode:

bool check_modality(string a, Mode b, OptionList c) {
    ModalityChecker v = build_checker(a, b);
    return v.check_option(c);
}

Dengan Python, Anda tidak mendapatkan informasi ini, jadi jika Anda menulis:

def check_modality(a, b, c):
    v = build_checker(a, b)
    return v.check_option(c)

Anda sama sekali tidak memberikan petunjuk kepada tim pemeliharaan tentang fungsi apa yang dapat dilakukan, dan bagaimana dipanggil, dan apa yang dikembalikannya. Jadi dengan Python, Anda cenderung menggunakan nama deskriptif:

def check_modality(name, mode, option_list):
    checker = build_checker(name, mode)
    return checker.check_option(option_list)

dan Anda bahkan menambahkan docstring yang menjelaskan apa yang dilakukan barang tersebut dan jenis apa yang diharapkan.

Saat ini juga ada opsi untuk mengganti regexp. Yaitu jika Anda ingin mengizinkan karakter tunggal sebagai variabel:

pylint --variable-rgx="[a-z0-9_]{1,30}$" <filename>

Jadi, pylintakan cocok dengan PEP8 dan tidak akan membawa pelanggaran tambahan di atas. Anda juga dapat menambahkannya ke .pylintrc.

Alasan yang lebih dalam adalah bahwa Anda mungkin ingat apa yang Anda inginkan a, b, c, x, y, dan zberarti ketika Anda menulis kode Anda, tetapi ketika orang lain membacanya, atau bahkan ketika Anda datang kembali ke kode Anda, kode menjadi jauh lebih mudah dibaca ketika Anda memberikan itu nama semantik. Kami tidak menulis sesuatu sekali di papan tulis dan kemudian menghapusnya. Kami sedang menulis kode yang mungkin bertahan selama satu dekade atau lebih, dan dibaca berkali-kali.

Gunakan nama semantik. Nama semantik Saya telah menggunakan telah seperti ratio, denominator, obj_generator, path, dll Mungkin perlu satu atau dua detik ekstra untuk mengetik mereka keluar, tapi saat Anda menyimpan mencoba untuk mencari tahu apa yang Anda tulis bahkan setengah jam dari itu adalah layak .