Rainbow Planet

IT技術を分かりやすく簡潔にまとめることによる学習の効率化、また日常の気付きを記録に残すことを目指します。

Python

Pythonでargparseを用いて引数を受け取って実行する方法

投稿日:2020年12月23日 更新日:

<目次>

(1) Pythonでargparseを用いて引数を受け取って実行する方法
 (1-1) argparseとは?
 (1-2) 基本的な使い方
 (1-3) サンプルプログラム
(2) 参考:argparseの引数の種類について
 (2-1) positional arguments
 (2-2) optional arguments

(1) Pythonでargparseを用いて引数を受け取って実行する方法

(1-1) argparseとは?

argparseはPythonで「位置指定引数」(positional arguments)を扱うためのパッケージです。位置指定引数とは引数の順番が意味を持つ引数です(順番を正しく保つ必要がある)。Python2.7でoptparseの後継機能として導入されています。

目次にもどる

(1-2) argparseの最も基本的な使い方

■STEP1:Parserオブジェクトの作成

まず最初のステップとして「parserオブジェクト」を作ります。
(STEP1)

import argparse
parser = argparse.ArgumentParser(description='Description of the argument')
 
■STEP2:引数の設定

次に「add_argument()」を使い、何の引数を待ち受けるかを教えます。それによりparserはプログラムのランタイム(実行時)にコマンドライン引数を処理する事ができます(ユーザが実行時に引数を与える)。
(STEP2)

parser.add_argument('indir', type=str, help='Input dir for videos')
parser.add_argument('outdir', type=str, help='Output dir for image')
 
■STEP3:引数の構文解析

parse_args()メソッドを用いて引数を構文解析(?)して格納します。
(STEP3)

args = parser.parse_args()

目次にもどる

(1-3) サンプルプログラム

argparseを使用して引数を受け取るサンプルプログラムをご紹介します。

(サンプルプログラム)

import argparse

def main():
    #(1)parsarオブジェクトの作成
    parser = argparse.ArgumentParser(description='Tiff to JPEG')
    #(2)引数を作成
    parser.add_argument('input', type=str, help='Input dir for Tiff')
    parser.add_argument('output', type=str, help='Output dir for JPEG')
    #(3)構文解析した引数を「args」変数にセット
    args = parser.parse_args()
    print(args.input)
    print(args.output)

if __name__ == '__main__':
    main()

上記サンプルプログラムをコマンドラインから、「スペース区切り」で引数を2つ与えて実行すると、その引数を受け取ってコンソール表示しています。

(図131)
引数に「ABCD」と「EFGH」を与えると、その引数を受け取って表示しています。
1つ目の引数が「indir」に格納され、2つ目の引数が「outdir」に格納されています。
ちなみに、引数を与える時はクォーテーションで囲まなくても正常に動作します。

目次にもどる

(2) 参考:argparseの引数の種類について

argparserにおける引数は2つの種類があり、基本は全て「①positional arguments」であり、「–help」のみが「②optional arguments」になります。

(2-1) positional arguments

引数には順序があり、最初に記述した引数が1つ目の変数(例では「input」)にセットされ、次に記述した引数が2つ目の変数にセットされます(例では「output」)。

(2-2) optional arguments

「–help」(及び短縮形の「-h」)は唯一のデフォルトで使えるオプション引数で「-」や「–」が付いているのが特徴です。「–help」は定義されている引数の情報をコンソールに出力します。

(図221)引数を定義したプログラムの末尾に「–help」を付けて実行すると引数の情報が表示されます。

 
また事前定義されているのは「–help」のみですが、optional argumentsは自身で定義する事もできます。
(例)
parser.add_argument('-r', '--rainbow')

 

Adsense審査用広告コード


Adsense審査用広告コード


-Python

執筆者:


comment

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

関連記事

PythonでSQLAlchemyを使ってOracleDBに接続する際に遭遇したエラーとその対処方法

本記事は次の記事の続編です。 (下記記事の手順を実行する際に遭遇したエラーについての備忘録) PythonでSQLAlchemyを使ってOracleDBに接続する方法 (0) 目次 (4) エラー対応 …

Python3.5&Anaconda4.2のインストール手順(CentOS6)とHelloWorldの方法

(0)目次&概説 (1) インストール資源の入手  (1-1) ディストリビューション  (1-2) GitHubのpyenvのリポジトリのコピーを取得する (2) インストールの実施  (2-1) …

Pythonでcsvのカラム名を変更する方法(Pandasのread_csvで読み込んだcsvのカラム名変更)

<目次> (1) Pythonでcsvのカラム名を変更する方法  (1-1) 構文①  (1-2) サンプルプログラム①  (1-3) 構文②  (1-4) サンプルプログラム② PythonのPan …

Python開発環境にPandasライブラリをインストールする手順

(0)目次&概説 (1) Pandasの導入  (1-1) Pandasとは? (2) オフラインインストール  (2-1) インストール資源の入手  (2-2) インストール時の諸注意  (2-3) …

Pythonのdatapackage学習中に遭遇したエラー「StopIteration」と「AttributeError」の対応

(0)目次&概説 (1) 記事の目的 (2) エラー1:AttributeError: ‘generator’ object has no attribute ‘n …

  • English (United States)
  • 日本語
Top