1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 03:32:12 +00:00
iiab/scripts/roles-needing-docs.py

27 lines
876 B
Python
Executable file

#!/usr/bin/env python3
'''
This script checks every role in the project and prints its name to stdout if
the role directory does not contain a README file and it is not listed in
scripts/docs-ignore.
For ease of use, you can pipe the output of this script to a file or to a
clipboard utility (e.g. pbcopy on macOS, xclip on Linux).
'''
import os
from os.path import join as make_path
from glob import glob
def included_roles():
all_roles = set(os.listdir("/opt/iiab/iiab/roles"))
excluded_roles = \
map(str.rstrip, open(make_path("/opt/iiab/iiab/scripts", "/opt/iiab/iiab/scripts/docs-ignore")))
included_roles = list(all_roles.difference(excluded_roles))
included_roles.sort()
return included_roles
for role in included_roles():
readme = make_path("/opt/iiab/iiab/roles", role, "README.*")
if not glob(readme):
print(role)