diff options
Diffstat (limited to 'doc/summarize.py')
-rwxr-xr-x | doc/summarize.py | 30 |
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 |