Pythonにはsqlite3という、SQLiteのインターフェイスモジュールがあるんだけど、Python 2.5の日本語ドキュメントのとおりやろうとすると微妙にハマる、という話。

　日本語ドキュメントのsqlite3ページには、以下のようなコード例が載ってます。

c = conn.cursor()

# Create table
c.execute('''create table stocks
(date text, trans text, symbol text,
 qty real, price real)''')

# Insert a row of data
c.execute("""insert into stocks
          values ('2006-01-05','BUY','RHAT',100,35.14)""")

　ところが、これだと実際にはinsertがデータベースに反映されない。実はinsertなどの操作を行った最後に、sqlite3.Connectionオブジェクトのcommit()メソッドを行わないとコミットが行われず、変更が実行されない模様。

　で、実はPython 2.5.2ドキュメントのsqlite3ページには、このあとに以下のようなコードが追加されております。

# Save (commit) the changes
conn.commit()

# We can also close the cursor if we are done with it
c.close()

　にも関わらず、「Connection Object」のページにはcommit()に関する記述がないのでさらに混乱は深まる……。ちなみに、Python 2.6.4のドキュメントではちゃんとcommit()メソッドについて記述されており、commit()を実行しないとデータベースへの変更が行われないよ、またrollback()メソッドを実行すれば前回のcommit()までの内容を取り消せるよ、との旨が書かれてます。

　教訓：日本語ドキュメントを当てにせず、ちゃんと原文を読め。

　Pythonには動的に関数を作ったり、クラスのメソッド呼び出しをカスタマイズするための機構が用意されています。ということで、それを使って遊んでみた。

　まず、Pythonではクラスで__getattr__メソッドを定義することで、クラスに対する任意の属性値アクセスを横取りすることができる。

　Pythonのクラスやオブジェクトは、それぞれが持つ属性（クラスならメンバ関数/変数）を__dict__というdictionary内に格納している。たとえばとあるオブジェクトaに対し「a.x」という操作を行うと、まずPython処理系はそのオブジェクトが持つ__dict__内で「x」という名前を持つメンバ変数/関数を探し、存在しなければ続いてそのオブジェクトのクラスが持つ__dict__内、続いてそのクラスの派生元クラスの__dict__内、という順でメンバ変数/関数を探索する。

　この作業を行って、通常すべての__dict__内で該当する名前が存在しなければエラーとなり例外を発生させるのだが、もしオブジェクト/クラス/派生元クラス内で__getattr__()メソッドが定義されていた場合、例外を発生させずに__getattr__()メソッドが呼び出される仕組みになっている。

　まぁ、サンプルコードを見たほうが分かりやすいかと。下記は、メソッドを呼び出すと、そのメソッド名を返すというクラス「echo」の例。

$ python
Python 2.6.1 (r261:67515, Jul  7 2009, 23:51:51)
[GCC 4.2.1 (Apple Inc. build 5646)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> class echo(object):
...     def __getattr__(self, name):
...             return lambda: name
...
>>> o = echo()
>>> o.hoge()
'hoge'
>>> o.foobar()
'foobar'
>>> o.abcdefg()
'abcdefg'

　__getattr__()メソッドは、あるオブジェクトの属性値/属性メソッドにアクセスしようとした際に、そのオブジェクト/クラス/派生元クラス内で目的となる属性が見つからなかった場合に呼び出される。引数nameにはアクセスしようとした属性の名前が与えられる。ここではlambda構文を使用し、引数nameを返す関数を__getattr__の戻り値とした。

　また、オブジェクトの__dict__属性に値を追加することで、動的に任意の属性をオブジェクトに追加できる。

　下記は、オブジェクトにメソッドを追加するメソッド「teach」を備えたクラス「echo2」の例。

>>> class echo2(object):
...     def teach(self, key, value):
...             self.__dict__[key] = lambda : value
...
>>> o = echo2()
>>> o.hoge()
Traceback (most recent call last):
  File "", line 1, in
AttributeError: 'echo2' object has no attribute 'hoge'
>>> o.teach("hoge", "foobar")
>>> o.hoge()
'foobar'
>>> o.teach("abcdefg", "alphabet")
>>> o.abcdefg()
'alphabet'

　このへんの仕組みがどのような場合に有効化というと、たとえば単純なメソッドを大量に用意したい場合。下記は、「False」を返すis_a()〜is_z()までを一気に定義するというもの。

>>> for i in "abcdefghijklmnopqrstuvwxyz":
...     o.__dict__["is_"+i] = lambda : False
...
>>> o.is_a()
False

　覚えておくと、たまにラクができるかも。