파이썬 튜터리얼 정리 4.8 코딩 스타일 (중요 PEP8)

파이썬 튜터리얼 정리 4.8 막간, 코딩스타일 (PEP8)

- 다른 사람들이 자신의 코드를 보기 쉽게 하는 것은 중요!

- 스타일 가이드로  PEP 8 이 나옴

- 매우 읽기 쉽고, 눈이 편안한 코딩스타일

- 모든 파이썬 개발자는 이 문서 필독!

- PEP8 중요내용

* 들려 쓰기- 4-스페이스 사용 / 탭 사용x

: 4개의 스페이스는 작은 들여쓰기 (더 많은 중첩 도를 허락한다) 와 큰 들여쓰기 (읽기 쉽다) 사이의 좋은 절충입니다. 

 탭은 혼란을 일으키고, 없애는 것이 최선입니다.

* インデントには空白 4 つを使い、タブは使わないこと。

: 空白 4 つは (深くネストできる) 小さいインデントと (読み易い) 大きいインデントのちょうど中間に当たります。

タブは混乱させるので、使わずにおくのが良いです。

* '79자'를 넘지 않도록 줄 넘김 하세요.

: 이것은 작은 화면을 가진 사용자를 돕고 큰 화면에서는 여러 코드 파일들을 나란히 볼 수 있게 합니다.

* ソースコードの幅が 79 文字を越えないように行を折り返すこと。

こうすることで小さいディスプレイを使っているユーザも読み易くなり、大きなディスプレイではソースコードファイルを並べることもできるようになります。

* 함수, 클래스, 함수 내의 큰 코드 블록 사이에 빈 줄을 넣어 분리하세요.

関数やクラスや関数内の大きめのコードブロックの区切りに空行を使うこと。

* 가능하다면, 주석은 별도의 줄로 넣으세요.

可能なら、コメントは行に独立で書くこと。

* 독스트링을 사용하세요.

docstring を使うこと。

* 연산자들 주변과 콤마 뒤에 스페이스를 넣고, 괄호 바로 안쪽에는 스페이스를 넣지 마세요

: a = f(1, 2) + g(3, 4).

演算子の前後とコンマの後には空白を入れ、括弧類のすぐ内側には空白を入れないこと: a = f(1, 2) + g(3, 4)。

* 클래스와 함수들에 일관성 있는 이름을 붙이세요

: 관례는 클래스의 경우 CamelCase, 함수와 메서드의 경우 lower_case_with_underscores 입니다. 

첫 번째 메서드 인자의 이름으로는 항상 self 를 사용하세요 (클래스와 메서드에 대한 자세한 내용은 클래스와의 첫 만남 을 보세요).

クラスや関数に一貫性のある名前を付けること。慣習では CamelCase をクラス名に使い、 lower_case_with_underscores を関数名やメソッド名に使います。常に self をメソッドの第 1 引数の名前 (クラスやメソッドについては クラス初見 を見よ) として使うこと。

* 여러분의 코드를 국제적인 환경에서 사용하려고 한다면 특별한 인코딩을 사용하지 마세요. 

 어떤 경우에도 파이썬의 기본, UTF-8, 또는 단순 ASCII조차, 이 최선입니다.

あなたのコードを世界中で使ってもらうつもりなら、風変りなエンコーディングは使わないこと。どんな場合でも、Python のデフォルト UTF-8 またはプレーン ASCII が最も上手くいきます。

* 마찬가지로, 다른 언어를 사용하는 사람이 코드를 읽거나 유지할 약간의 가능성만 있더라도, 식별자에 ASCII 이외의 문자를 사용하지 마세요.

同様に、ほんの少しでも他の言語を話す人がコードを読んだりメンテナンスする可能性があるのであれば、非 ASCII 文字も識別子に使うべきではありません。