tkFormData プログラム仕様

CGI/WSGI環境からのフォームデータとファイルアップロードを解析するためのユーティリティモジュール。

このモジュールは、HTTPリクエストのGETクエリ文字列やPOSTリクエストのmultipart/form-data形式のデータを簡単に解析し、フォームデータやアップロードされたファイルにアクセスするためのクラスと関数を提供します。 tkFormData.py ライブラリドキュメント

tklib.tkcgi.tkFormData.get_params()

HTTPリクエストメソッドに基づいて、GETまたはPOSTリクエストのパラメータとファイル情報を取得します。

REQUEST_METHOD 環境変数をチェックし、GETリクエストの場合は QUERY_STRING を、 POSTリクエストの場合は CONTENT_TYPE に応じて tkFormData クラスを使用してリクエストボディを解析します。

戻り値:: tuple, (request_method, query_string, query_params, form_storage) を含むタプル。 - request_method (str): リクエストメソッド (例: 'GET', 'POST')。 - query_string (str or bytes): オリジナルのクエリ文字列またはPOSTボディの生データ。 - query_params (dict): 解析されたクエリパラメータまたはフォームデータ。 - form_storage (tkFormData or None): multipart/form-data の場合に tkFormData オブジェクト、それ以外は None。

class tklib.tkcgi.tkFormData.tkFormData(environ, input_stream)

ベースクラス: object

CGI/WSGI環境からのHTTPリクエストデータを解析し、フォームデータとアップロードされたファイルを抽出するクラス。

GETリクエストのクエリ文字列と、POSTリクエストの application/x-www-form-urlencoded および multipart/form-data 形式のデータを処理します。

get_file(name)

指定された名前のアップロードファイルを返します。

パラメータ:: name -- str, 取得したいファイルのフォームフィールド名。
戻り値:: dict or None, ファイルの情報 (filename, content) を含む辞書、またはファイルが見つからない場合は None。

get_form_data()

解析されたフォームデータ（キーと値のペア）を返します。