bpo-32173: linecache.py add lazycache to __all__ and use dict.clear to clear the cache

Lib/linecache.py

@@ -10,28 +10,28 @@
 import os
 import tokenize
 
-__all__ = ["getline", "clearcache", "checkcache"]
-
-def getline(filename, lineno, module_globals=None):
-    lines = getlines(filename, module_globals)
-    if 1 <= lineno <= len(lines):
-        return lines[lineno-1]
-    else:
-        return ''
+__all__ = ["getline", "clearcache", "checkcache", "lazycache"]
 
 
-# The cache
-
 # The cache. Maps filenames to either a thunk which will provide source code,
 # or a tuple (size, mtime, lines, fullname) once loaded.
 cache = {}
 
 
 def clearcache():
     """Clear the cache entirely."""
+    cache.clear()
+
 
-    global cache
-    cache = {}
+def getline(filename, lineno, module_globals=None):
+    """Get a line for a Python source file from the cache.
+    Update the cache if it doesn't contain an entry for this file already."""
+
+    lines = getlines(filename, module_globals)
+    if 1 <= lineno <= len(lines):
+        return lines[lineno - 1]
+    else:
+        return ''
 
 
 def getlines(filename, module_globals=None):
@@ -56,11 +56,10 @@ def checkcache(filename=None):
 
     if filename is None:
         filenames = list(cache.keys())
+    elif filename in cache:
+        filenames = [filename]
     else:
-        if filename in cache:
-            filenames = [filename]
-        else:
-            return
+        return
 
     for filename in filenames:
         entry = cache[filename]
@@ -109,8 +108,10 @@ def updatecache(filename, module_globals=None):
                     # for this module.
                     return []
                 cache[filename] = (
-                    len(data), None,
-                    [line+'\n' for line in data.splitlines()], fullname
+                    len(data),
+                    None,
+                    [line + '\n' for line in data.splitlines()],
+                    fullname
                 )
                 return cache[filename][2]
 

Misc/NEWS.d/next/Library/2018-10-26-10-14-23.bpo-32173.e0C5dF.rst

@@ -0,0 +1,3 @@
+Add `lazycache` function to `__all__` in `linecache` module.
+Remove `global` keyword reference and use `clear()` to remove elements in `dict`.
+Small refactoring in `getline` method to remove unnecessary `else` condition.