summaryrefslogtreecommitdiff
path: root/doc/summarize.py
diff options
context:
space:
mode:
Diffstat (limited to 'doc/summarize.py')
-rwxr-xr-xdoc/summarize.py30
1 files changed, 16 insertions, 14 deletions
diff --git a/doc/summarize.py b/doc/summarize.py
index cfaec6f7a..833436cee 100755
--- a/doc/summarize.py
+++ b/doc/summarize.py
@@ -5,8 +5,10 @@ summarize.py
Show a summary about which Numpy functions are documented and which are not.
"""
+from __future__ import division, absolute_import, print_function
import os, glob, re, sys, inspect, optparse
+import collections
sys.path.append(os.path.join(os.path.dirname(__file__), 'sphinxext'))
from sphinxext.phantom_import import import_phantom_module
@@ -72,26 +74,26 @@ def main():
# report
in_sections = {}
- for name, locations in documented.iteritems():
+ for name, locations in documented.items():
for (filename, section, keyword, toctree) in locations:
in_sections.setdefault((filename, section, keyword), []).append(name)
- print "Documented"
- print "==========\n"
+ print("Documented")
+ print("==========\n")
last_filename = None
for (filename, section, keyword), names in sorted(in_sections.items()):
if filename != last_filename:
- print "--- %s\n" % filename
+ print("--- %s\n" % filename)
last_filename = filename
- print " ** ", section
- print format_in_columns(sorted(names), options.cols)
- print "\n"
+ print(" ** ", section)
+ print(format_in_columns(sorted(names), options.cols))
+ print("\n")
- print ""
- print "Undocumented"
- print "============\n"
- print format_in_columns(sorted(undocumented.keys()), options.cols)
+ print("")
+ print("Undocumented")
+ print("============\n")
+ print(format_in_columns(sorted(undocumented.keys()), options.cols))
def check_numpy():
documented = get_documented(glob.glob(SOURCE_DIR + '/*.rst'))
@@ -134,7 +136,7 @@ def get_undocumented(documented, module, module_name=None, skip=[]):
if full_name in skip: continue
if full_name.startswith('numpy.') and full_name[6:] in skip: continue
- if not (inspect.ismodule(obj) or callable(obj) or inspect.isclass(obj)):
+ if not (inspect.ismodule(obj) or isinstance(obj, collections.Callable) or inspect.isclass(obj)):
continue
if full_name not in documented:
@@ -147,8 +149,8 @@ def format_in_columns(lst, max_columns):
Format a list containing strings to a string containing the items
in columns.
"""
- lst = map(str, lst)
- col_len = max(map(len, lst)) + 2
+ lst = [str(_m) for _m in lst]
+ col_len = max([len(_m) for _m in lst]) + 2
ncols = 80//col_len
if ncols > max_columns:
ncols = max_columns