FormEncode
さて、FormBuildにしろ、ToscaWidgets(twForm) にしろ、入力チェックにはFormEncodeを使っています。
FormEncodeは、文字列からpythonの値(intや、datetimeなど)に変換と入力チェックを同時にやってくれます。
入力チェックに通った文字列は安全に変換できるってことですね。
標準で、多くのバリデータを含んでいますが、拡張するのも簡単にできるようになっています。
FancyValidatorという、カスタムバリデータを作るための基底クラスも用意されています。
既存のバリデータを継承して、チェック内容を増やすのも簡単です。
ファイルアップロードのバリデータに、FieldStorageUploadConverterがすでにあります。
このバリデータを拡張して、イメージファイル専用のバリデータを作ってみました。
Python Imaging Library
PILと略されて呼ばれることもあります。
Pythonで画像処理をするときに、一番有名なモジュールと思われます。
標準ライブラリに入って欲しいくらいなのだけど、ライセンスの関係からか含まれる予定はありません。
フリーで使えるのは、最新版よりも1つ古いバージョンのものになります。
例えばサムネイルを作って保存するには以下のようになります。
import Image
im = Image.open(filename)
im.thumbnail(size, PIL.Image.ANTIALIAS)
im.save(thumbfilename)
ファイルから、イメージオブジェクトを作って、thumbnailメソッドで変換。
saveメソッドで保存。
というとてもわかりやすいインターフェイスです。
イメージファイルアップロード用のバリデータ
ファイルアップロードされる内容は色々ありますが、イメージファイルのみをアップロード対象とする場合も結構多いと思います。
こういう場合には、ファイルライクオブジェクトが返ってくるより、イメージオブジェクトが返ってくる方が自然に思えます。
FieldStorageUploadConverterを継承して、さらに、イメージに変換する処理を付け加えました。
from formencode import Invalid
from formencode.validators import *
import Image
import os
class ImageFile(FieldStorageUploadConverter):
def _to_python(self, value, state=None):
imagefile = FieldStorageUploadConverter._to_python(self, value, state)
try:
image = Image.open(imagefile.file)
if self.height is not None and image.size[1] > self.height:
raise Invalid('Please image height make less than %d.' % self.height,
value, state)
if self.width is not None and image.size[0] > self.width:
raise Invalid('Please image width make less than %d.' % self.width,
value, state)
return image
except IOError, e:
raise Invalid('Invalid format.', value, state)
これを使うと、Pylonsでrequest.params['image'] などに、Imageオブジェクトが格納されます。
また、ファイルの内容が画像でない(PILで処理できないフォーマット)の場合は、Invalid Format というエラーメッセージが設定されます。
また、バリデータをインスタンス化する際に、コンストラクタに、widthやheightを指定すると、アップロードされた画像のサイズをチェックして、サイズ内に収まっていない場合にバリデーションエラーにします。
参考
追記
サイズチェックを追加しました。
