mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-09 20:26:33 +00:00
3529 invalid comments in 528 files, grandfathered in while the linter only saw the working-tree diff. Removal ran through the linter's own collectors, so detection and deletion cannot drift: a comment whose opener line is blank before it and whose closer line is blank after it loses all its lines, anything else loses only the comment region, and a line left holding a bare delimiter goes with it. Five files keep their comments behind a nocheck marker instead. Four are upstream configs whose inline docs are upstream's own (mautrix, systemd journald, nextcloud-oidc-login, MediaWiki). In littlejs the commented-out entries ARE the deactivation mechanism for an example tile, so deleting them would delete configuration. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
63 lines
1.7 KiB
Python
63 lines
1.7 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Generate a JSON file listing all Ansible role directories.
|
|
|
|
Usage:
|
|
python -m cli.build.list [--roles-dir path/to/roles] [--output path/to/roles/list.json | console]
|
|
"""
|
|
import os
|
|
import json
|
|
import argparse
|
|
|
|
from . import PROJECT_ROOT
|
|
|
|
|
|
def find_roles(roles_dir: str):
|
|
"""Return sorted list of role names under roles_dir."""
|
|
return sorted([
|
|
entry for entry in os.listdir(roles_dir)
|
|
if os.path.isdir(os.path.join(roles_dir, entry))
|
|
])
|
|
|
|
|
|
def write_roles_list(roles, out_file):
|
|
"""Write the list of roles to out_file as JSON."""
|
|
os.makedirs(os.path.dirname(out_file), exist_ok=True)
|
|
with open(out_file, 'w', encoding='utf-8') as f:
|
|
json.dump(roles, f, indent=2)
|
|
print(f"Wrote roles list to {out_file}")
|
|
|
|
|
|
def main():
|
|
default_roles_dir = str(PROJECT_ROOT / "roles")
|
|
default_output = os.path.join(default_roles_dir, 'list.json')
|
|
|
|
parser = argparse.ArgumentParser(description='Generate roles/list.json')
|
|
parser.add_argument(
|
|
'--roles-dir', '-r',
|
|
default=default_roles_dir,
|
|
help=f'Directory containing role subfolders (default: {default_roles_dir})'
|
|
)
|
|
parser.add_argument(
|
|
'--output', '-o',
|
|
default=default_output,
|
|
help=(
|
|
'Output path for roles list JSON '
|
|
'(or "console" to print to stdout, default: %(default)s)'
|
|
)
|
|
)
|
|
args = parser.parse_args()
|
|
|
|
if not os.path.isdir(args.roles_dir):
|
|
parser.error(f"Roles directory not found: {args.roles_dir}")
|
|
|
|
roles = find_roles(args.roles_dir)
|
|
|
|
if args.output.lower() == 'console':
|
|
print(json.dumps(roles, indent=2))
|
|
else:
|
|
write_roles_list(roles, args.output)
|
|
|
|
if __name__ == '__main__':
|
|
main()
|