From e3c69c7c7dc09cf39e578e1df4b106745d02f48f Mon Sep 17 00:00:00 2001
From: Chris McDonough <chrism@agendaless.com>
Date: Sun, 28 Sep 2008 16:18:13 +0000
Subject:    - A deprecation warning is now issued when old API names from the 
     ``repoze.bfg.templates`` module are imported.

---
 CHANGES.txt                       |  7 +++++++
 repoze/bfg/template.py            | 13 ++++++++++++-
 repoze/bfg/tests/test_template.py |  4 ++++
 3 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 71537b48e..2b065c9b9 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -1,5 +1,12 @@
 Next release
 
+  Deprecations
+
+   - A deprecation warning is now issued when old API names from the
+     ``repoze.bfg.templates`` module are imported.
+
+0.3.9 (08/27/2008)
+
   Features
 
    - A ``repoze.bfg.location`` API module was added.
diff --git a/repoze/bfg/template.py b/repoze/bfg/template.py
index 2f3017bd6..526e9f0c9 100644
--- a/repoze/bfg/template.py
+++ b/repoze/bfg/template.py
@@ -4,10 +4,21 @@
 # ``render_template_to_response`` APIs should be imported from
 # ``repoze.bfg.chameleon_zpt`` in the future for optimum correctness,
 # while the ``render_transform`` and ``render_transform_to_response``
-# APIs should be imported from ``repoze.bfg.xsl``.
+# APIs should be imported from ``repoze.bfg.xslt``.
+from zope.deprecation import deprecated
 
 from repoze.bfg.chameleon_zpt import get_template
 from repoze.bfg.chameleon_zpt import render_template
 from repoze.bfg.chameleon_zpt import render_template_to_response
 from repoze.bfg.xslt import render_transform
 from repoze.bfg.xslt import render_transform_to_response
+
+for name in ('get_template', 'render_template', 'render_template_to_response'):
+    deprecated(name,
+               ('repoze.bfg.template.%s should now be imported as '
+                'repoze.bfg.chameleon_zpt.%s' % (name, name)))
+
+for name in ('render_transform', 'render_transform_to_response'):
+    deprecated(name,
+               ('repoze.bfg.template.%s should now be imported as '
+                'repoze.bfg.xlst.%s' % (name, name)))
diff --git a/repoze/bfg/tests/test_template.py b/repoze/bfg/tests/test_template.py
index 42baa6492..f66d045cd 100644
--- a/repoze/bfg/tests/test_template.py
+++ b/repoze/bfg/tests/test_template.py
@@ -4,9 +4,13 @@ from zope.component.testing import PlacelessSetup
 
 class Base(PlacelessSetup):
     def setUp(self):
+        from zope.deprecation import __show__
+        __show__.off()
         PlacelessSetup.setUp(self)
 
     def tearDown(self):
+        from zope.deprecation import __show__
+        __show__.on()
         PlacelessSetup.tearDown(self)
 
     def _zcmlConfigure(self):
-- 
cgit v1.2.3