Pythonのコーディング規約を現役エンジニアが解説【初心者向け】

初心者向けにPythonのコーディング規約について解説しています。コーディング規約とは、色々な書き方が出来るプログラミング言語において、統一の書き方を決めることです。コードの規模が大きくなったり複数人開発が必要になった場合に必要になります。今回はPython公式のPEP8について確認してみます。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonのコーディング規約について解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事をまずご覧ください。

 

なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

コーディング規約について詳しく説明していくね!

大石ゆかり

お願いします!

 

コーディング規約とは

コーディング規約とは、プログラムのコーディングにおける指針、ガイドラインのことです。一般に、企業、コミュニティ、製品といった単位でコーディング規約を定めます。

コーディング規約では変数名や関数名などの命名規則や、ファイル中でのレイアウトなど、様々な規則を定めます。

コーディング規約を定める目的は、コードの可読性や保守性を向上し、バグを抑止することです。

コーディング規約への準拠を目視で確かめるのは大変です。統合開発環境(IDE)やエディタがコーディング規約に従うように補佐したり、コーディング規約に従っているか点検するチェッカー(lint)を用いるのが一般的です。

 

公式コーディング規約のPEP8、その他のコーディング規約

PEP8はPythonの公式コーディング規約で、ここで公開されています。

PEP8では、「コードは書かれる頻度よりも、読まれる頻度が高い」という考え方が根底にあります。PEP8は、Pythonコード全般の可読性を向上させ、一貫したスタイルを提供することを目的としています。

PEP8以外では、Google Python Style Guideが有名です。ソフトウェアの特性にあわせてPEP8を拡張したもので、PylonsやDjangoの規約があります。

[PR] Pythonで挫折しない学習方法を動画で公開中

PEP8の主なルール

はじめにpep8モジュールをインストールしました。

pip install pep8

サンプルとして、以下sample.pyを用いました。このファイルには「インデントにタブを用いている」というPEP8違反があります。

def func():
	a = b + c

pep8を実行しました。–show-sourceオプションで違反のある箇所のソースコードも表示するようにしました。

 

$ pep8 --show-source sample.py
sample.py:2:1: W191 indentation contains tabs
        a = b + c
^

ソースコードを以下のように修正しました。(インデントに半角スペース4個を使うようにしました)

def func():
    a = b + c

再度pep8を実行しました。今度は何も表示されず、違反の解消されたことがわかりました。

$ pep8 --show-source sample.py

 

監修してくれたメンター

橋本紘希

システムインテグレータ企業勤務のシステムエンジニア。

開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。

初心者向けの書籍を使って人工知能(AI)や機械学習について学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。