From: Tim Peters <tim.peters@gmail.com>
Date: Sun, 8 Aug 2004 01:52:57 +0000 (+0000)
Subject: Deprecate the doctest.is_private() function.
X-Git-Tag: v2.4a3~331
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bafb1fed516a252eaeb1aa52a5287d838fe4603f;p=thirdparty%2FPython%2Fcpython.git

Deprecate the doctest.is_private() function.
---

diff --git a/Lib/doctest.py b/Lib/doctest.py
index 6e2834057a2e..bf39e3800325 100644
--- a/Lib/doctest.py
+++ b/Lib/doctest.py
@@ -377,6 +377,9 @@ def is_private(prefix, base):
     Return true iff base begins with an (at least one) underscore, but
     does not both begin and end with (at least) two underscores.
 
+    >>> import warnings
+    >>> warnings.filterwarnings("ignore", "is_private", DeprecationWarning,
+    ...                         "doctest", 0)
     >>> is_private("a.b", "my_func")
     False
     >>> is_private("____", "_my_func")
@@ -392,6 +395,9 @@ def is_private(prefix, base):
     >>> is_private("", "")  # senseless but consistent
     False
     """
+    warnings.warn("is_private is deprecated; it wasn't useful; "
+                  "examine DocTestFinder.find() lists instead",
+                  DeprecationWarning)
     return base[:1] == "_" and not base[:2] == "__" == base[-2:]
 
 def _extract_future_flags(globs):