Coverage for src / mafw / devtools / cli / documentation / __init__.py: 100%

1# Copyright 2025–2026 European Union 

2# Author: Bulgheroni Antonio (antonio.bulgheroni@ec.europa.eu) 

3# SPDX-License-Identifier: EUPL-1.2 

4"""CLI sub-package for building and managing versioned documentation.""" 

5 

6from __future__ import annotations 

7 

8import click 

9 

10from mafw.tools.click_extensions import AbbreviateGroup 

11 

12from .build import build, build_current_only, landing, redirects, requirements 

13from .prune import clean, prune 

14from .registry import registry 

15from .server import server 

16 

17CONTEXT_SETTINGS = {'help_option_names': ['-h', '--help']} 

18"""Click context settings for command line help aliases.""" 

19 

20 

21@click.group(context_settings=CONTEXT_SETTINGS, cls=AbbreviateGroup) 

22def documentation() -> None: 

23 """Build and manage versioned documentation.""" 

24 

25 

26documentation.add_command(build) 

27documentation.add_command(build_current_only) 

28documentation.add_command(redirects) 

29documentation.add_command(landing) 

30documentation.add_command(requirements) 

31documentation.add_command(prune) 

32documentation.add_command(clean) 

33documentation.add_command(registry) 

34documentation.add_command(server)