Belajar Statement Gabungan dan Trailing Commas

Cobalah untuk tidak menyatukan lebih dari satu pernyataan dalam satu baris.

Disarankan:

if foo == 'blah':

    do_blah_thing()

do_one()

do_two()

do_three()

Tidak disarankan:

if foo == 'blah': do_blah_thing()

do_one(); do_two(); do_three()

Kamu diizinkan untuk menuliskan kode if/for/while yang singkat dalam satu baris (tanpa mengganggu jalannya program). Namun, hindari melakukannya jika if/for/while tersebut memiliki tingkatan yang berbeda atau terdiri dari beberapa klausa, seperti if-else, try-finally, dan sejenisnya.

Tidak disarankan:

if foo == 'blah': do_blah_thing()

for x in lst: total += x

while t < 10: t = delay()

Sangat tidak disarankan:

if foo == 'blah': do_blah_thing()

else: do_non_blah_thing()

try: something()

finally: cleanup()

do_one(); do_two(); do_three(long, argument,

                             list, like, this)

if foo == 'blah': one(); two(); three()

Penggunaan Trailing Commas

Trailing commas biasanya opsional, kecuali dalam satu situasi di mana kita membuat variabel dengan tipe tuple yang hanya memiliki satu elemen, di mana koma tersebut harus hadir. Untuk menghindari kesalahan menghapus atau membersihkan, biasanya digunakan kurung untuk memperjelas kondisi tersebut.

Disarankan:

FILES = ('setup.cfg',)

OK, but confusing:

FILES = 'setup.cfg',

Meskipun trailing comma terkadang terlihat redundan, namun penggunaannya dapat mempermudah penggunaan VCS atau ketika menambahkan kode di masa depan. Untuk mengikuti pola yang disarankan, kamu dapat menempatkan nilai atau string pada baris baru, dengan indentasi yang sama dengan baris sebelumnya, dan menambahkan trailing comma. Kemudian, kurung, kurawal, atau siku dapat ditutup pada baris selanjutnya.

Biasanya, tidak lazim untuk menambahkan trailing comma pada baris di mana kamu menutup kurung, kurawal, atau siku, kecuali dalam kasus tuple dengan satu elemen.

Disarankan:

FILES = [

    'setup.cfg',

    'tox.ini',

    ]

initialize(FILES,

           error=True,

           )

Tidak disarankan:

FILES = ['setup.cfg', 'tox.ini',]

initialize(FILES, error=True,)

Anotasi Fungsi

Penggunaan anotasi fungsi sebaiknya mengikuti aturan konvensional untuk tanda titik dua (:) dan menggunakan spasi untuk tanda panah (->), sesuai dengan yang dijelaskan dalam PEP 484.

Yes:

def munge(input: AnyStr): ...

def munge() -> AnyStr: ...

 

No:

def munge(input:AnyStr): ...

def munge()->PosInt: …

Disarankan untuk tidak menggunakan tanda sama dengan (=) untuk menandai argumen kata kunci atau nilai default pada parameter fungsi, kecuali jika didukung oleh anotasi.

Yes:

def complex(real, imag=0.0):

    return magic(r=real, i=imag)

 

No:

def complex(real, imag = 0.0):

    return magic(r = real, i = imag)

Saat menggabungkan anotasi argumen dan nilai default, sebaiknya kamu menggunakan spasi sebelum dan sesudah tanda sama dengan (=).

Yes:

def munge(sep: AnyStr = None): ...

def munge(input: AnyStr, sep: AnyStr = None, limit=1000): ...

 

No:

def munge(input: AnyStr=None): ...

def munge(input: AnyStr, limit = 1000): …