{"categories":[{"label":"Python Modules","url":"https://skillfed.io/packages/category/software-development-libraries-python-modules/4"},{"label":"Markup","url":"https://skillfed.io/packages/category/text-processing-markup"}],"enrichment":{"capability":"Extends PyYAML to include other YAML files into a current YAML document, with support for local files, wildcards, and remote sources via fsspec (HTTP, S3, SFTP, etc.).","skillfed_tags":["yaml-composition","config-management","fsspec-integration"],"use_cases":["Organize application configuration across multiple YAML files by feature or environment, then include them all in a main config file.","Load configuration fragments from a remote HTTP server or S3 bucket at runtime without manual downloads.","Use wildcards to automatically include all YAML files matching a pattern from a directory.","Build layered configuration systems where base settings are in one file and environment-specific overrides are included conditionally.","Modularize Kubernetes manifests or Docker Compose definitions by splitting them into separate files and including them in a root manifest."],"what_it_does":"pyyaml-include is an extension to PyYAML that lets you split YAML configuration across multiple files and include them into a single document at parse time. Instead of managing one monolithic YAML file, you register a custom constructor that tells PyYAML to load and merge external files wherever you place the include tag. It works with local files, shell-style wildcards (*, ?, **), and remote sources like HTTP, S3, and SFTP via fsspec.\n\nThe package is useful for large configuration systems where you want to organize settings by component or environment. You can include files in mappings (as key-value pairs) or sequences (as list items), and the included YAML is parsed and merged into the document tree. Version 2.0 introduced fsspec support, making it possible to include files from cloud storage or web servers without manual downloads.","worth_installing":"Yes, with conditions. Install if you need to split YAML configuration across files and want a lightweight, actively maintained solution. The low install friction and broad Python support make it straightforward to adopt. However, the GPLv3+ copyleft license restricts use in proprietary closed-source projects\u2014verify license compatibility before committing. No known security vulnerabilities."},"id":"pyyaml-include","links":{"html":"https://skillfed.io/packages/pyyaml-include","md":"https://skillfed.io/packages/pyyaml-include.md","pypi":"https://pypi.org/project/pyyaml-include/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2024-11-09","license_spdx":null,"license_treatment":"copyleft","name":"pyyaml-include","python_support":"supports_current","summary":"An extending constructor of PyYAML: include other YAML files into current YAML document"},"popularity":{"monthly_downloads":5327704,"position":2118,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"2.2"}