#!/usr/bin/env python3
"""
Génère une section de documentation "type-along" pour un tutoriel,
en utilisant une version spécifiée en argument.

Usage:
    python generate_type_along.py <version>

Arguments:
    version (str) : La version (tag git) à utiliser dans la documentation.

Exemple:
    python generate_type_along.py v1.0.0
"""

import sys

def generate_type_along(version: str) -> str:
    """
    Génère une section de documentation "type-along" pour une version donnée.

    Args:
        version (str): La version (tag git) à inclure dans la documentation.

    Returns:
        str: La section de documentation formatée.
    """
    template = """.. type-along:: For those who follow the tutorial with the help of the git repository

    Now you need to checkout the :tutorial:`{version} <src/tag/{version}/README.md>` version::

          git switch --detach {version}
"""
    return template.format(version=version)

def main() -> None:
    """Point d'entrée principal du script."""
    if len(sys.argv) != 2:
        print("Erreur : Une version doit être spécifiée en argument.")
        print(f"Usage: {sys.argv[0]} <version>")
        sys.exit(1)

    version = sys.argv[1]
    print(generate_type_along(version))

if __name__ == "__main__":
    main()
