it-swarm.asia

Python dosya adlandırma kuralı?

PEP-8'in bu bölümünü gördüm https://www.python.org/dev/peps/pep-0008/#package-and-module-names

Bunun bir modülün/sınıfın/paketin dosya adına karşılık gelip gelmediği konusunda net değilim.

Her birine bir örnek verirsem, dosya adları uygunsa alt çizgi ile küçük olmalı mı? Veya başka bir şey?

164
darkace

Alıntılama https://www.python.org/dev/peps/pep-0008/#package-and-module-names :

Modüllerin kısa, tamamen küçük harfli adları olmalıdır. Okunabilirliği geliştirirse, modül adında alt çizgiler kullanılabilir. Python paketlerinin de kısa, tümü küçük harfli adları olmalıdır, ancak alt çizgi kullanımı önerilmez.

sınıflar için:

Sınıf adları normalde CapWords kuralını kullanmalıdır.

Ve işlev ve (yerel) değişken adları olmalıdır:

okunabilirliği artırmak için kelimeler alt çizgilerle ayrılmış küçük harfle yazılır

Bir modül, sınıf ve paket arasındaki fark için bu cevap konusuna bakın:

  • A Python modülü basitçe bir Python kaynak dosyasıdır ve sınıfları, işlevleri ve global değişkenleri ortaya çıkarabilir).
  • A Python paketi sadece Python modülünün) bir dizinidir.

PEP 8 size şunu söyler :

  • modüller (dosya adları) kısa, tümü küçük harfli isimler olmalıdır ve alt çizgi içerebilir;
  • paketler (dizinler) kısa, tümü küçük harfli isimler, tercihen alt çizgi içermemelidir;
  • sınıflar CapWords kuralını kullanmalıdır.

PEP 8, isimlerin kısa; bu cevap , diğer adlar için de geçerli olan (sınıflar, paketler, vb.) değişken adları oluştururken nelere dikkat edilmesi gerektiği konusunda iyi bir genel bakış sunar:

  • değişken adları tam tanımlayıcı değildir;
  • ayrıntıları yorumlara koymak;
  • çok özel ad çok özel kod anlamına gelebilir;
  • hızlı arama için kısa kapsamlar tutun;
  • okunabilirliği düşünerek zaman harcayın.

İşlemi tamamlamak için, adlandırma kurallarına iyi bir genel bakış Google Python Stil Kılavuz bölümünde verilmiştir.

171
agold

Here , farklı Python ad kuralları) için bir bağlantıdır.

Python için stil kılavuzu, Guido’nun adlandırma kuralları önerilerine dayanmaktadır.

enter image description here

7
Vlad Bezden