Académique Documents
Professionnel Documents
Culture Documents
PEP8:TheStyleGuideforPythonCode
F m b
PP 8
p f -b PP 8 b
(f m).
m v v f P mp
b m P b. P mp
fm PP b f
mpm f P
m PP 257 ( v) p fm
P , m fm B
vv v m v f
p v b b f.
M pj v . v f
f, pj-pf p f pj.
BB
f m m f
. pv mpv b f
m pm f P . PP
20 , b .
http://pep8.org/
1/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
b . mp.
pj m mp. m
f m mp.
B m mp: b mm
j pp. b, b jm.
xmp b. !
p: b b mpb j mp PP!
m p :
1.
pp m b, v f
m f PP.
2.
b b (mb f
) pp p
m m ( XP ).
3.
B q p f
b mf .
4.
m mpb v f P
pp f mm b .
4 p p v.
pp m v P
mp j p, b b,
. f b
pp; b m f f
b f .
http://pep8.org/
2/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
# p m.
f = _f_m(v_, v_,
v_, v_f)
# M fm .
f _f_m(
v_, v_, v_,
v_f):
p(v_)
# v.
f = _f_m(
v_, v_,
v_, v_f)
# m f fb v m.
f = _f_m(v_, v_,
v_, v_f)
# F q b.
f _f_m(
v_, v_, v_,
v_f):
p(v_)
4-p p f .
p:
# *m* b 4 p.
f = _f_m(
v_, v_,
v_, v_f)
p f
f -m q
b mp , mb f
(..
http://pep8.org/
f ), p p, p p p
3/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
4-p f bq f m
. p v f f
f -m, b 4
p. PP xp p ( ) f
v fm
f -
m. pb p , b m :
# x .
f (___
___):
_m()
# mm, pv m
# pp x .
f (___
___):
# b , fb.
_m()
# m x .
f (___
___):
_m()
b/b/p m- m
p f -p f f , :
m_ = [
1, 2, 3,
4, 5, 6,
]
= m_f___m(
'', 'b', '',
'', '', 'f',
)
m b p f f m-
, :
http://pep8.org/
4/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
m_ = [
1, 2, 3,
4, 5, 6,
]
= m_f___m(
'', 'b', '',
'', '', 'f',
)
b p?
p pf m.
b b m
b.
P 3 mx f b p f .
P 2 mx f b p b v
p xv.
v P 2 mm p
p,
b mx b p.
bm . p mm!
Mxmm
m mxmm f 79 .
F f b f x f (
mm), b m 72 .
m q m pb v v f
p -b-, v p
v j m.
f pp m p v f ,
m m ff . m v pp
http://pep8.org/
5/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
80, v f p m p
f m pp . m b b m ff
m pp .
m m pf . F m xv
pm b m m ,
m fm 80 100 (ffv
mxmm 99 ), pv mm
pp 72 .
P b vv q m 79
( /mm 72).
pf f pp b P mp
p, b b. b b
v mp b pp xp p. b
pf b f .
B m b ppp m. F xmp, , mp
m mp , b pb:
p('/p//m/f////') f_1, \
p('/p//m/f/b/', '') f_2:
f_2.(f_1.())
( pv m f-m f f
f m
-m.)
m.
M ppp. pf p
b b p f p, bf . m
xmp:
(Bb):
f ____(f, , ,
='b', mp=, =0):
http://pep8.org/
6/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
f ( == 0 == 0
== '' mp == ''
> 100):
V(", ")
f == 0 == 0 ( == ''
mp ):
V(" ' -- v %, %" %
(, ))
Bb.____(f, , ,
, mp, )
B
p-v f f b .
M f b b .
x b m b (p) p p f f.
B m b m b b f - (.. f
mm mpm).
b f, p, .
P p - (..
^) fm f p; M
p p, m m p
p f f f. , m b-b
v m - fm f p
p.
F
P b F-8 (
P 2).
F ( P 2) F-8 ( P 3) v
.
b, -f b f
http://pep8.org/
7/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
pp mm m m
- ; ,
\x , \ , \ , \
pf - .
F P 3.0 b, f p pb f
b ( PP 3131): f P b M
- f, v fb (
m , bbv m ).
, mm m b .
xp () - f, (b) m f
. m b pb M
pv f m.
p pj b p m
p.
mp
mp b p , ..:
mp
mp
mp ,
fm bp mp Pp, PP
mp p p f f, j f m
mm , bf m b .
http://pep8.org/
8/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mp b p f :
1.
b mp
2.
p mp
3.
pp/b pf mp
p b b p f mp.
P v
____
pf f mp.
b mp mm, m b
b b bv ( v b m) f
mp m f (
p p
.p ):
mp mp.b
fm mp mp b
fm mp.b mp xmp
v, xp v mp pb v b
mp, p mpx p
b mp b vb:
fm . mp b
fm .b mp xmp
b v mpx p
b mp.
mp v mp v b v b mv
P 3.
mp fm - m,
p :
fm m mp M
http://pep8.org/
9/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
fm f.b. mp
f p m , p m :
mp m
mp f.b.
m.M
mp (
f.b.. .
fm <m> mp * ) b v,
m m p mp, f b
m m . fb f
mp, pb f p f
pb P (f xmp, v p P mpm f
f f fm p m
x f b v v).
pb m , b pb
f pp.
Q
P, -q b-q m.
PP m mm f . P .
b q , v,
v b . mpv b.
F p-q , b q b
v PP 257.
XP
P Pv
v x p f :
http://pep8.org/
10/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mm p, b b. :
pm(m[1], {: 2})
pm( m[ 1 ], { : 2 } )
mm bf mm, m, :
f x == 4: p x, ; x, = , x
f x == 4 : p x , ; x , = , x
v, b p, v
q m ( p
p). x , b m v m m f
p pp. xp: pm m, p
m.
http://pep8.org/
11/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
m[ + ff:pp + ff]
m[1: 9], m[1 :9], m[1:9 :3]
m[ : : pp]
m[ : pp]
mm bf p p m f
f :
pm(1)
pm (1)
mm bf p p x :
[''] = [x]
[''] = [x]
M p m ( ) p
.
x = 1
= 2
_vb = 3
http://pep8.org/
12/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
x
= 1
= 2
_vb = 3
mm
v p . B vb, b
f: .. b f b p
m. m pv m
pj ( P f) v p-mm j .
b p p :
m (
= ), m m ( += , -=
.), mp (
== , < ,
= + 1
bm += 1
x = x*2 - 1
p2 = x*x + *
= (+b) * (-b)
=+1
bm +=1
x = x * 2 - 1
p2 = x * x + *
= ( + b) * ( - b)
http://pep8.org/
13/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
m f pm v.
f mpx(, m=0.0):
m(=, =m)
f mpx(, m = 0.0):
m( = , = m)
F m f
v p
->
f p. ( F
b f m b f .)
f m(p: ): ...
f m() -> : ...
f m(p:): ...
f m()->P: ...
mb m f v, p
(b f m v b
f).
f m(p: = ): ...
f m(p: , p: = , m=1000): ...
http://pep8.org/
14/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mp m (mp m m )
.
f f == 'b':
_b_()
_()
_()
_()
f f == 'b': _b_()
_(); _(); _()
mm p f/f/ m b
m , v f m- m. v f
!
f f == 'b': _b_()
f x : += x
< 10: = ()
f :
f f == 'b': _b_()
: __b_()
: m()
f: p()
http://pep8.org/
15/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
MM
mm mm. m
p f p mm p-- !
mm b mp . f mm p ,
f b p, f b
(v f f!).
f mm , p b m. B mm
f m pp b f mp ,
p.
p f - p.
, f .
P fm - p : p mm
, 120% v b b pp
p .
B mm
B mm pp m ( ) f m,
m v . f b mm
p ( x mm).
Pp b mm p b
#.
mm
mm p.
http://pep8.org/
16/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mm mm m m.
mm b p b p fm m.
# p.
mm f f bv.
x = x + 1
# m x
B mm, f:
x = x + 1
# mp f b
m
v f m (... )
mm PP 257.
f pb m, f, , m.
f -pb m, b v
mm b m . mm
pp f
PP 257 b v. m mp,
"""
m b b f, ..:
""" fb
p p fb bb f.
"""
F , p p
"""
m .
V BP
http://pep8.org/
17/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
f v v bv, V, f,
f. :
__v__ = "$v$"
# $$
b f m , bf
, p b b bv b.
M V
m v f P b b f m, v
mp v, mm
m . m p ( p
fm) b , b x b
ff , pf.
v Pp
m vb pb p f P f
v f mpm.
pv: m
f ff m . p b b
m b , p fm f.
f m mm :
( )
( pp )
___
PP
PP___
p
http://pep8.org/
( p, m , p)
18/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mx
(ff fm p b !)
p___
(!)
bbv p, p f bbv.
Pv
pv .
f q pfx p m
. m P, b m f mp.
F xmp,
v m
.()
f p m
_m , _ , _mm
. (
mp p f f PX m ,
p pmm fm .)
X11 b X f pb f. P,
m b b m m
pfx bj, f m pfx m m.
, f p fm
( b mb v):
___ : . ..
fm M mp *
mp bj m
___ : b v v f
P , .. :
.pv(m, _='m')
__b__ : m b, v
m m ( FB,
__b
bm
_FB__b ;
b).
__b______ : m bj
b v - mp. ..
__mp__
http://pep8.org/
____ ,
__f__ . v v m; m
19/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
m.
Ppv: m v
m v
v ( ), (pp ),
(pp ) vb m.
m f, b fm m
. mp , .
P M m
M v , - m. b
m m f mpv b. P p v
, - m, f .
x m ++ mp P
m pv v (.. m bj ) f,
/++ m (..
_ ).
m
m m p v.
m v f f m b
f m pm b.
p v f b m: m b m
( ), p v
f xp m b .
xp m
B xp b , m v pp .
v, ffx xp m (f
http://pep8.org/
20/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
xp ).
b Vb m
( p vb m f m .)
v b m f f.
M f v
fm M mp *
____
mm pv xp b, v f pfx
b ( m
b m -pb).
F m
F m b , p b
mpv b.
mx x pv
(.. .p), b mpb.
F m m
f f m m.
f f m m.
f f m m v ,
b pp bbv
p p.
. (Pp b v
b m.)
M m Vb
f m : p b
mpv b.
f -pb m vb.
http://pep8.org/
21/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
v m b, v
P m m .
P m m m: f F b
m
__ , b b F.__ . (
F._F__ .) , b b
v m f b b
b.
: m v b f __m ( b).
f m v p
p . xmp
MX_VF
f
m vb (v:
b) b pb -pb. f b, -pb;
m pb m pb b -pb.
Pb b xp f ,
mmm v b mpb . -pb
b b b p; m
-pb b v b mv.
m pv , b pv
P ( m f ).
f b p f b P
(f p ). m b
fm, x mf p f bv.
, m xp b
b pb, p f b P,
b b b .
http://pep8.org/
22/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
m, P :
Pb b v .
f pb b m v , pp
b m. pfb
bbv p p. (v, ,
pf p f vb m b
, p f m m.)
1: m m mm bv f m.
F mp pb b, b xp j b m,
mp /m m. p m P
pv p f m, f mp
b f bv. ,
pp f mpm b mp b
x.
1: Pp - .
2: p f bv -ff f, ff f.
3: v pp f mp xpv p;
b m bv (v)
p.
f b b, v b
b , m m b
. v P m
m m, m f m
b m. p v b m b
v b m m.
1: mp m m m,
f b b m m b m,
m .
http://pep8.org/
23/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
2: m m m , b
____() , v. v m m m
m pfm m.
3: v m m. b v
m p b v .
Pb f
b mpb pp pb f.
, mp b b b
pb f.
m f pb, m
xp m b pv f xmp fm
b mpb . m f
b m b .
b pp p, m xp m
pb P
____
b.
____
mp
m pb P.
____
ppp, f (p, m,
, f, b m) b pfx
.
f f mp (p,
m ) .
mp m b mpm .
m m mp m
xp m p f m P,
p
____
.p
m xp f fm bm.
PMM MM
b v
http://pep8.org/
24/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
mpm f P (PP, J, P, , P,
).
F xmp, P ff mpm f -p
f m fm
+= b
= + b .
pm f v P ( f m p)
p mpm f.
pfm v p f b,
''.j()
fm b
. m
v mpm.
mp b
, v q p.
, b f
f x
f x
.. vb m f
m v. v m v p (
) b f b x!
... . b xp
f , fm m b pf.
f f :
f f :
mpm p mp, b
mpm x p (
____ ) x p
mp.
mm ff vv,
f._()
pv m mp m.
http://pep8.org/
25/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
PP 207 fxv m b P. ,
p m p
> x
p m f
x ==
x < , >= x
>
x <= , m
x != . ()
<
m()
mx()
p. v, b mpm x p
f x.
f m f m m b
mb xp f.
f f(x): 2*x
f = mb x: 2*x
f fm m m f f bj
pf f f <mb>. m f f
b p . f m
m m bf mb xp ff v
xp f m (.. b mb
xp)
v xp fm
fm
xp
Bxp
Bxp .
v f xp
m m .
xp b
xp ,
xp . m q ?
pmm, pbm (
PP 3151 f xmp f b f b
xp )
m v pp , ffx
http://pep8.org/
26/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
xp f xp . -
xp f - f fm f
p ffx.
xp ppp. P 3, X fm
b xp pm
b.
b p xp ( X P 2
X fm P 3.3+), v
f xp ( pv b m
v b, mb x f
xp xp m).
xp P 2,
f fm
V('m')
V, 'm' .
fm P 3 x.
p- fm m xp m
fm,
p.
xp, m pf xp v pb
f b
xp:
F xmp, :
:
mp pfm_pf_m
xp mp:
pfm_pf_m =
xp:
mx bp
xp, m p pm -,
pbm. f xp
pm ,
xp xp:
(b xp qv
xp Bxp: ).
http://pep8.org/
27/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
f mb m f b xp :
1.
f xp b p
b; b
.
2.
f m p , b
xp pp p
. ...f
b b .
b xp m, pf xp m
b x P 2.6:
:
p_()
xp xp x:
PF((x))
x pp P 3, v mb
pbm mm-b x.
p m , pf xp xp
P 3.3 v p f
, f /xp , m
v.
mmm m f . , v m b.
:
v = []
xp :
__f()
:
_v(v)
http://pep8.org/
28/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
:
# b!
_v([])
xp :
# b _v()
__f()
p f ,
m p pmp b f .
/f m pb.
x m b v p f
m v m q
. F xmp:
.b_():
_ff__()
:
_ff__()
xmp pv fm
____
__x__
m m
f . B xp mp .
B m. m f
xp, f m . f
m xp, m v
xp
, xp
m b p f f (f b).
f f(x):
http://pep8.org/
29/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
f x >= 0:
m.q(x)
:
f b(x):
f x < 0:
m.q(x)
f f(x):
f x >= 0:
m.q(x)
f b(x):
f x < 0:
m.q(x)
m f m.
m m f m P
. v f b mpb P
2.0 q.
''.()
''.()
f pfx ffx.
()
()
p. F
xmp:
: f f.('b'):
: f f[:3] == 'b':
bj p mp
()
mp p . :
http://pep8.org/
30/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
: f (bj, ):
: f p(bj) p(1):
f bj , p m m b
! P 2, v mm b ,
b, :
f (bj, b):
P 3,
x (
) b bj f ( q f
F q, (, , p), f mp q
f. :
: f q:
f q:
: f (q)
f (q)
f p.
p v b m ( m
, .p) m m.
mp b v F
== . :
f :
f == :
http://pep8.org/
31/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
:
f :
F
p f PP 484, f f
.
b f mpb, f P 3
pfb PP 484 x. ( m fm
mm f pv .)
xpm mm
pv PP .
v, b, xpm f PP 484
. F xmp, m p p b
pp PP 484 p , v
, bv p
b.
P b b vv p
, b f f b f.
F m ff f f
mm p mm f fm:
# p:
p f f; p .
(M f- f b mp fm p b
f PP 484.)
, p p, p . P p
b f m p
bv b .
http://pep8.org/
32/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
p f m.
v, xp f p b p m
p v p. F pp PP 484
mm f b f: .p f b p
pf f p .p f. b f b b
b, p ( b pm)
p p
F b b mpb, f
b fm f mm. B, P 3 :
qv f:
mp p
pp x, p
p .
1.
PP 7, f , v m
2.
B Mm
p://b../f/.x
3.
http://pep8.org/
33/34
6/19/2016
PEP8:TheStyleGuideforPythonCode
p- pp
xp f . x f P, m
b p p f p
m -p f ,
bq b p.
4.
p://.p.m//m
5.
p p p://b.m/p/p
6.
mp p p://mp-. p://b.m/J/mp
m b p pb m.
http://pep8.org/
34/34