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()

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

戻り値:

dict, 解析されたフォームデータを格納する辞書。