今回はPythonの「argparse」の基礎と「add_argument」の使い方について解説していこうと思います!
第1弾はこちら!
https://chaldene.net/argparse-argumentparser
第3弾はこちら!
https://chaldene.net/argparse-parseargs
「argparse」はコマンドライン引数を渡してくれるもので、Pythonエンジニアを目指している方は知っておいた方が良いものになります。
ぜひこの記事でマスターしていってください!
この記事はPythonの公式ドキュメントを参考にしています。
Pythonに限らず、プログラミング言語の公式ドキュメントは非常に読みにくいので、この記事でわかりやすく解説していきます。
「argparse使ってみたい」
「コマンドライン引数を渡してみたい」
「argparseって何?」
「自作モジュール作ってみたい」
「他の人が書いたコードでargparseの部分がわからない」
このような人のお役に立てれば幸いです。
それでは早速本題に入っていきましょう!
「argparse」はPythonの基礎を理解していないと難しいので、Pythonの基礎を理解していない人は以下を参考に学習してください!
https://chaldene.net/python-book
まずはargparseについて説明していきましょう。
argparseは一言で言えば以下のようになります。
コマンドライン引数を渡せる。
これではよくわからないですよね。
「コマンドライン引数」とは、以下のようにPythonファイルを呼び出す際に渡せる値のことです。
少し詳しく説明すると、--nはname
で今回はcardeneを渡しています。
--age
は30という値を渡しています。
こんな感じの関数があったとして、cardeneがname
引数に、30がage
に渡されるということです。
どうでしょうか理解できたでしょうか?
このように引数が指定されることで、ユーザーごとにカスタムして使えるようにになります。
僕自身Pypiに自作モジュールをあげたことがあります。
https://pypi.org/project/comnamepy/
このモジュールもterminalでも使用することができ、その際には「コマンドライン引数」を渡す必要があります。
この記事ではその方法を学んでいきます。
「コマンドライン引数」を設定する際、結構細かく設定できるのでぜひ全てマスターしていってください!
前章の一番途中に作成したものがadd_argumentです。
add_argumentは1つ1つのコマンドライン引数を細かく設定するものです。
5行目、6行目がadd_argumentですね。
色々設定されているのが確認できますが何を設定しているのかわからないと思います。
この章で1つ1つ解説していくので学んでいってください!
では早速1つ1つ確認していきましょう!
「コマンドライン引数」の名前。
コマンドライン引数の名前を設定できます。
この部分で位置引数(必須引数)かオプション引数かを指定できる。
指定方法としては接頭辞が使われる。
デフォルトでは--
を名前の先頭につけることで自動でオプション引数と認識される。
この接頭辞は変更することができるので、以下の記事を参考にしてください。
https://chaldene.net/argparse-argumentparser
cardene、nameなど。
--cardene
、--age
など。
実際に見ていきましょう!
5行目と6行目のname
と--age
が「コマンドライン引数」名です。
terminalでpython main.py --h
と実行してください。
3行目のpositional argumentsが位置引数で、6行目のoptional argumentsがオプション引数です。
--
が先頭についてるものがオプション引数と認識されていますね。
これより先は以下の記事にまとめています。
https://chaldene.net/argparse-addargument
より詳しくaddargumentについて学ぶことができるので、興味がある方はぜひ! (もちろん無料です!)