van.pg

van.pgは、ユニットテストのためのPostgreSQLデータベース（およびクラスタ）を簡単に作成を提供Pythonモジュールです。
のダーティデータベースの
テスト·データベースを作成するのに長い時間がかかる。一般的に、あなたはテスト·データベース·フィクスチャを再作成/削除することを決定したときに少し注意する必要があります。
また、データベースはにコミットされたかどうかを考え出すのはPostgreSQLには堅牢な方法はないように思われる。
だからvan.pgは、データベースが汚れているときにそれを通知するためにあなたに責任を配置する以外に選択肢がありません。これが適切に行われない場合、テスト分離が損なわれることになる。それは理想的ではないですが、私たちにできる最善。
あなたは一貫して、データベースのコミットを管理するために、トランザクション·パッケージ（http://pypi.python.org/pypi/transaction）を使用する場合は、1つの例外はある。このケースでは、トランザクションがコミットされるたびに汚されるリソースを求めることができます。
のtestresourcesとの統合の
これらの器具を使用するための一般的な方法は、testresources（http://pypi.python.org/pypi/testresources/）を経由する：
＆NBSP;は>>> testresourcesからResourcedTestCaseをインポート
＆NBSP; >>> van.pg輸入のDatabaseManagerから
＆NBSP; >>>輸入psycopg2
＆NBSP; >>> DEF（DB）INIT_DB：
＆NBSP; ... CONN = psycopg2.connect（ホスト= db.host、データベース= db.database）
＆NBSP; ... CUR = conn.cursor（）
＆NBSP; ... cur.execute（ "TABLE fooの（バー整数）を作成します。」）
＆NBSP; ... conn.commit（）
＆NBSP; ...はconn.close（）
＆NBSP; >>>クラスのMyTest（ResourcedTestCase）：
＆NBSP; ...
＆NBSP; ...資源= [（ 'db'と、のDatabaseManager（initialize_sql = INIT_DB））]
＆NBSP; ...
＆NBSP; ... DEF runTestの（自己）：
＆NBSP; ... CONN = psycopg2.connect（ホスト= self.db.host、データベース= self.db.database）
＆NBSP; ... CUR = conn.cursor（）
＆NBSP; ... cur.execute（「（1）fooの値に挿入します。」）
＆NBSP; ... conn.commit（）
＆NBSP; ... CUR = conn.cursor（）
＆NBSP; ... cur.execute（「* fooの中から選択」）
＆NBSP; ... self.assertEquals（cur.fetchall（）、[（1）]）
＆NBSP; ...＃注意：データベースに障害が発生した接続を閉じたり、ドロップする必要があります
＆NBSP; ...はconn.close（）
＆NBSP; ... self.db.dirtied（）＃我々は、DBを変更したので、再ロードを必要とする
実際にテストを実行します。
＆NBSP; >>> unittestの輸入TextTestRunnerから
＆NBSP; >>>輸入SYS
＆NBSP; >>>ランナー= TextTestRunner（ストリーム= sys.stdoutの）
＆NBSP; >>> runner.run（MyTestに（））■doctestの：+ ELLIPSIS
＆NBSP ;.
＆NBSP; ...
OK;＆NBSP
＆NBSP; ...
のテンプレートデータベースを使用しての
あなたが同じデータベースを何度も再作成する必要がある場合は、PostgreSQLがテンプレートデータベースからデータベースをコピーできるように速くなります。あなたは1のDatabaseManagerが別のテンプレートとして機能させることによってこれを行うことができます：
＆NBSP; >>> template_db =のDatabaseManager（initialize_sql = INIT_DB）
＆NBSP; >>>クラスMytest2の（MyTestという）：
＆NBSP; ...資源= [（ 'db'と、のDatabaseManager（テンプレート= template_db））]
＆NBSP; >>> runner.run（Mytest2の（））■doctestの：+ ELLIPSIS
＆NBSP ;.
＆NBSP; ...
OK;＆NBSP
＆NBSP; ...
のトランザクションの統合の
dirty_on_commit argumenキーワードがTrueの場合、のDatabaseManagerは、すべてのトランザクション·モジュールを介して行わコミットsuccessfull後に汚れるように、データベースをマークします。これは、データベースが手動でそれを通知する必要がない汚し各テストを意味します。
＆NBSP; >>>男=のDatabaseManager（dirty_on_commit =真）
この機能を使用する場合は、トランザクション（http://pypi.python.org/pypi/transaction）を自分でパッケージに依存する必要があります。
の既存のデータベースを使用して、の
デフォルトでは、van.pgは一時ディレクトリに新しいPostgreSQLクラスタを作成し、PostgreSQLのデーモンを起動します。これは、ほとんどの時間を動作しますが、非常に高速ではありません。
すでに稼動しているPostgreSQLクラスタをお持ちの場合は、環境変数VAN_PG_HOSTを設定することでそれを使用するvan.pg伝えることができます。例えば、ローカルのPostgreSQLサーバに対​​してvan.pgのテストを実行することが/ tmpに/ pgclusterでソケットが何です：
VAN_PG_HOST =を/ tmp / pgclusterのpython setup.pyテスト
警告：ターゲット·データベースにTEST_DBで始まるすべてのデータベースがドロップされる可能性が高い。
の閉会の接続の
あなたの試験はそれで行われた後、適切にデータベースへのすべての接続を閉じるように注意してください。オープン接続がある間PostgreSQLはデータベースをドロップすることはできません。これはテスト·データベースを削除しようとするとエラーにvan.pg原因となります。
のプログラムにより作成クラスターの
低いレベルでは、また、プログラム独自のPostgreSQLクラスタを操作することができます。
クラスタを初期化します。
＆NBSP; >>> van.pg輸入クラスタから
＆NBSP; >>>クラスタ=クラスタ（）
＆NBSP; >>> cluster.initdb（）
どの一時ディレクトリにデータベースを作成します：
＆NBSP; >>>輸入OS
＆NBSP; >>> DBDIR = cluster.dbdir
＆NBSP;でos.listdirで>>>「PG_VERSION '（DBDIR）
＆NBSP;真
それを起動します。
＆NBSP; >>> cluster.start（）
の作成/データベースをテストします。
＆NBSP; >>> DBNAME = cluster.createdb（）
私たちは、データベースに接続できます。
＆NBSP; >>>輸入psycopg2
＆NBSP; >>> CONN = psycopg2.connect（データベース= DBNAME、ホスト= cluster.dbdir）
＆NBSP; >>> CUR = conn.cursor（）
私たちは基本を行うことができますことを確認するためにデータベースをひねり：
＆NBSP; >>> cur.execute（「表X（Y int型）を作成します」）
＆NBSP; >>> cur.execute（「X値。INSERT INTO（1）」）
＆NBSP; >>> conn.commit（）
＆NBSP; >>> cur.execute（「* Xから選択」）
＆NBSP; >>> cur.fetchall（）[0] [0]
＆NBSP; 1
クラスタデーモンを停止します。
＆NBSP; >>>はconn.close（）
＆NBSP; >>> cluster.stop（）
再びそれを起動します。
＆NBSP; >>> cluster.start（）
＆NBSP; >>> CONN = psycopg2.connect（データベース= DBNAME、ホスト= cluster.dbdir）
＆NBSP; >>> CUR = conn.cursor（）
＆NBSP; >>> cur.execute（「* Xから選択」）
＆NBSP; >>> cur.fetchall（）[0] [0]
＆NBSP; 1
とクリーンアップ：
＆NBSP; >>>はconn.close（）
＆NBSP; >>> cluster.cleanup（）
＆NBSP; >>> cluster.dbdirはNoneです
＆NBSP;真
＆NBSP; >>> os.path.exists（DBDIR）
＆NBSPはFalse
の開発の
開発がGitHubの上で行われます：
＆NBSP; HTTP：//github.com/jinty/van.pg

のこのリリースではの新機能：

• サポートPythonの3.2ます。
• ドロップはPython 2.5をサポートします。
• 複数のPythonのバージョンに対するテストのためtox.iniを追加します。
• ファイル名を指定して実行PostgreSQLのサブプロセスとしてではなく、（pg_ctlを経由して）デーモンとしてします。
• の再整理、再利用およびテストカバレッジを向上させるためのコードをします。

の要件の

• のPythonます。