Emit deprecation warnings when gid/two phase is used.

James William Pye · James William Pye · commit 148d5f53c803 · 2010-09-01T16:37:29.000-07:00
diff --git a/postgresql/documentation/changes.txt b/postgresql/documentation/changes.txt
@@ -9,6 +9,7 @@ Changes
  * Add support for DOMAINs in registered composites. (Elvis Pranskevichus)
  * Properly raise StopIteration in Cursor.__next__ (Elvis Pranskevichus)
  * Fix Startup() usage for Python 3.2.
+ * Emit deprecation warning when 'gid' is given to xact().
 
 1.0.1 released on 2010-04-24
 ----------------------------
diff --git a/postgresql/driver/pq3.py b/postgresql/driver/pq3.py
@@ -43,6 +43,8 @@
 from ..types import io as pg_types_io
 from ..types.io import lib as io_lib
 
+import warnings
+
 # Map element3.Notice field identifiers
 # to names used by message.Message.
 notice_field_to_name = {
@@ -2044,6 +2046,9 @@ def _e_metas(self):
 	def __init__(self, database, isolation = None, mode = None, gid = None):
 		self.database = database
 		self.gid = gid
+		if gid is not None:
+			# XXX: remove in 1.1
+			warnings.warn("two phase interfaces will not exist in 1.1; do not use the 'gid' parameter", DeprecationWarning, stacklevel=3)
 		self.isolation = isolation
 		self.mode = mode
 		self.state = 'initialized'
