def create_tfref()

in tools/tfdoc.py [0:0]

• 26 lines of code
• 8 McCabe index (conditional complexity)

def create_tfref(module_path, files=False, show_extra=False, exclude_files=None,
                 readme=None):
  'Return tfdoc mark and generated content.'
  if readme:
    # check for overrides in doc
    opts = get_tfref_opts(readme)
    files = opts.get('files', files)
    show_extra = opts.get('show_extra', show_extra)
    if 'exclude' in opts:
      exclude_files = (exclude_files or []) + [opts['exclude']]
  abspath = os.path.abspath(module_path)
  try:
    if os.path.dirname(abspath).endswith('/modules'):
      mod_recipes = list(
          parse_recipes(module_path,
                        f'{REPO_URL}/modules/{os.path.basename(abspath)}'))
    else:
      mod_recipes = None
    mod_files = list(parse_files(module_path, exclude_files)) if files else []
    mod_variables = list(parse_variables(module_path, exclude_files))
    mod_outputs = list(parse_outputs(module_path, exclude_files))
    mod_fixtures = list(parse_fixtures(module_path, readme))
  except (IOError, OSError) as e:
    raise SystemExit(e)
  doc = format_tfref(mod_outputs, mod_variables, mod_files, mod_fixtures,
                     mod_recipes, show_extra)
  return Document(doc, mod_files, mod_variables, mod_outputs, mod_recipes)