semvec/pypi-packages huggingface dataset:
sobiraka 0.9.1
HTML and PDF documentation builder
License: MIT
Requires Python: >=3.11

# Собирака

**Собирака** — сборщик документации, разработанный в [Documentat](https://documentat.io/). Собирака основана на популярных проектах с открытым исходным кодом, таких как Pandoc и LaTeX, но добавляет к ним свои правила и проверки.

Сборщик ориентирован на подход «docs as code» и поддерживает [Markdown](https://sobiraka.documentat.io/writing/markdown.html) и [reStructuredText](https://sobiraka.documentat.io/writing/rest.html), в том числе с возможностью совмещать их в одном проекте. Вне зависимости от языка разметки, Собирака проверяет корректность всех [внутренних ссылок](https://sobiraka.documentat.io/writing/links.html) в рамках проекта. Также в исходных файлах поддерживаются условия, инклюды и другие [конструкции Jinja](https://sobiraka.documentat.io/writing/jinja.html).

Готовая документация собирается в форматах [HTML](https://sobiraka.documentat.io/build-html/) и [PDF](https://sobiraka.documentat.io/build-pdf/). Для формата HTML поддерживается [поиск по документации](https://sobiraka.documentat.io/overview/search.html). В рамках одного проекта возможно собирать [несколько документов](https://sobiraka.documentat.io/overview/terms.html), в том числе [на разных языках](https://sobiraka.documentat.io/overview/multilang.html).

Собирака предоставляет богатые возможности по кастомизации процесса сборки: от [шаблонов для HTML](https://sobiraka.documentat.io/web/customization.html#template) до [произвольного кода на Python](https://sobiraka.documentat.io/reference/processor-api.html).
nyl 0.10.5
Advanced templating engine for Kubernetes and GitOps.
License: MIT
Requires Python: >=3.11

# nyl

Nyl is a versatile tool for generating Kubernetes manifests from a simple YAML configuration, encouraging consistent and
reusable deployment configurations, project layouts and operational workflows.

## Installation

Requires Python 3.11 or newer.

    $ uvx nyl

For some features, additional programs must be available:

- [kubectl](https://kubernetes.io/de/docs/reference/kubectl/) for applying
- [helm](https://helm.sh/) for rendering Helm charts
- [kyverno](https://kyverno.io/docs/kyverno-cli/) ^1.13.x when using the Nyl `PostProcessor` resource
- [sops](https://github.com/getsops/sops) when using the SOPS secrets provider

## Local development

You can install the tools you need with [Mise](https://mise.jdx.dev/).

    $ mise install
    $ eval "$(mise activate)"

Install the project with [Uv](https://docs.astral.sh/uv/).

    $ uv sync

Use [Tire](https://github.com/NiklasRosenstein/tire/) tire for formatting, linting, type checking and unit tests.

    $ tire fmt [--check]
    $ tire lint
    $ tire check
    $ tire test

To live-preview the documentation, use

    $ mise run serve-docs

## Tracking upstream information

- Discussion around ArgoCD supporting Helm lookups (maybe with Project-level service account?), see
  https://github.com/argoproj/argo-cd/issues/5202#issuecomment-2088810772