Vous êtes sur la page 1sur 34

6/19/2016

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.

m[1:9], m[1:9:3], m[:9:3], m[1::3], m[1:9:]


m[:pp], m[:pp:], m[::p]
m[+ff : pp+ff]
m[: pp_f(x) : p_f(x)], m[:: p_f(x)]
m[ + ff : pp + ff]

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 (

== , < ,

> , != , <> , <= , >= , , , , ), B ( , , ).


f p ff p , p
p p(). jm;
v, v m p, v m m
f p b f b p.

= + 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

f m(p: =): ...


f m(p: , m = 1000): ...

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

_(); _(); _(, m,


, , )
f f == 'b': (); (); ()

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 (

__q__ , ____ , ____ , ____ , ____ ,

____ ) 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 :

f mb(f, : , f: = 1000000, **f_p:


"""mb f fm f p."""
< >

qv f:

f mb(f, , f=1000000, **f_p):


# p: (, , **) ->
"""mb f fm f p."""
< >

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

Vous aimerez peut-être aussi