Function build_llms_txt

website/build.py:370–398

Render the llms.txt entry point with the curated category catalog.

(
    template_text: str,
    *,
    readme_text: str,
    stars_data: dict[str, dict],
    categories: Sequence[ParsedSection],
    total_entries: int,
)

def build_llms_txt(
    template_text: str,
    *,
    readme_text: str,
    stars_data: dict[str, dict],
    categories: Sequence[ParsedSection],
    total_entries: int,
) -> str:
    """Render the llms.txt entry point with the curated category catalog."""
    categories_md = annotate_entries_with_stars(
        link_llms_category_index_to_canonical_pages(
            extract_categories_body(readme_text).rstrip(),
            categories,
        ),
        stars_data,
        format_stars=lambda n: f"GitHub stars: {n}",
    )
    text_env = Environment(autoescape=False, trim_blocks=True, lstrip_blocks=True)
    rendered = text_env.from_string(template_text).render(
        site_url=SITE_URL,
        github_repo_url="https://github.com/vinta/awesome-python",
        contributing_url="https://github.com/vinta/awesome-python/blob/master/CONTRIBUTING.md",
        sponsorship_url=SPONSORSHIP_PUBLIC_URL,
        sitemap_url=SITEMAP_URL,
        categories_md=categories_md,
        total_entries=total_entries,
        total_categories=len(categories),
    )
    return rendered.rstrip() + "\n"


def annotate_entries_with_stars(