{"categories":[{"label":"Markup","url":"https://skillfed.io/packages/category/text-processing-markup/2"}],"enrichment":{"capability":"Braq is a Python library for parsing and rendering section-based human-readable documents where content is organized under square-bracket headers with plain-text bodies.","skillfed_tags":["text-format","config-parsing","documentation"],"use_cases":["Parse configuration files that mix human-readable help text with embedded dictionary data structures.","Extract and organize docstrings from Python functions using custom section-based documentation formats.","Construct structured AI prompts that interleave instructions, user input, and conversation history in readable sections.","Build custom document formats for domain-specific applications by extending Braq's section abstraction.","Store and retrieve multi-section documents where sections may repeat and their bodies concatenate automatically."],"what_it_does":"Braq is a lightweight text format and parser designed around the idea that structured data can be organized into human-readable sections, each with a header in square brackets and a body of plain text. The library provides functions to parse Braq documents into dictionaries (mapping headers to bodies) and to render Section objects back into formatted text. It supports embedding dictionary data structures via the Paradict format within sections, making it suitable for config files, code documentation, and AI prompt construction.\n\nThe format is deliberately simple: a document consists of an optional unnamed section at the top, followed by named sections. Multiple sections with the same header are concatenated. The library has no external runtime dependencies, making it quick to install and integrate. It targets developers who want a middle ground between plain text and rigid structured formats like JSON or YAML, particularly for use cases where readability and human editability matter as much as machine parsing.","worth_installing":"Yes, if you need a lightweight, dependency-free way to parse or generate section-based text documents. The format is simple and the library is stable. However, the project is dormant with minimal community activity, so consider it for self-contained use cases rather than as a foundation for a larger ecosystem. Not suitable if you require active maintenance or frequent updates."},"id":"braq","links":{"html":"https://skillfed.io/packages/braq","md":"https://skillfed.io/packages/braq.md","pypi":"https://pypi.org/project/braq/"},"maintenance":{"status":"dormant"},"meta":{"latest_release":"2024-12-10","license_spdx":null,"license_treatment":"permissive","name":"braq","python_support":"supports_current","summary":"Structured text format with sections"},"popularity":{"monthly_downloads":125472,"position":11815,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.0.12"}