{"categories":[{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/9"},{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation/2"}],"enrichment":{"capability":"A Sphinx extension that renders reStructuredText documentation content from external data files (JSON, YAML, CSV) using templating, allowing you to keep data separate from documentation source.","skillfed_tags":["sphinx-extension","data-driven-docs","templating"],"use_cases":["Render API endpoint documentation from a YAML schema file that is version-controlled separately from docs.","Generate configuration reference tables from JSON files that are auto-generated by your build system.","Build comparison matrices or feature tables from CSV data without manually editing reStructuredText.","Keep deployment or environment documentation synchronized with YAML configuration files.","Create dynamic release notes or changelog tables from structured data sources."],"what_it_does":"sphinxcontrib-datatemplates is a Sphinx extension that bridges external data files and documentation by rendering reStructuredText content from JSON, YAML, and CSV sources using Jinja2-style templating. Instead of hardcoding data into your documentation, you maintain it separately and reference it via template directives\u2014useful when documentation needs to reflect live configuration, API schemas, or tabular data that changes independently of the docs themselves.\n\nThe extension provides template functions like `make_list_table` and `make_list_table_from_mappings` to convert nested data structures into reStructuredText tables. It depends on Sphinx, PyYAML, defusedxml (for safe XML parsing), and sphinxcontrib-runcmd. The package is in Beta status, last released in late 2023, and supports Python 3.8 through 3.12.","worth_installing":"Yes, if you use Sphinx and need to keep documentation content synchronized with external data files. The low install friction and permissive license make it a straightforward addition. However, the aging maintenance status (last release 2023-12-21, 967 days old) means you should verify compatibility with your Sphinx version and be prepared to maintain a fork if critical issues arise."},"id":"sphinxcontrib-datatemplates","links":{"html":"https://skillfed.io/packages/sphinxcontrib-datatemplates","md":"https://skillfed.io/packages/sphinxcontrib-datatemplates.md","pypi":"https://pypi.org/project/sphinxcontrib-datatemplates/"},"maintenance":{"status":"aging"},"meta":{"latest_release":"2023-12-21","license_spdx":null,"license_treatment":"permissive","name":"sphinxcontrib.datatemplates","python_support":"supports_current","summary":"Sphinx extension for rendering data files as nice HTML"},"popularity":{"monthly_downloads":125465,"position":11816,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.11.0"}