Metadata-Version: 2.4
Name: minimindslab-yaml-key-diff
Version: 0.1.0
Summary: Compare two YAML documents and report added, removed, and changed scalar keys at the top level or along simple nested paths after parsing into plain Python data structures.
Author: MiniMindsLab
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# MiniMindsLab YAML Key Diff

A tiny, offline, standard-library-only utility for comparing two YAML-like documents after parsing into plain Python structures.

## Features

- Reports **added**, **removed**, and **changed** keys
- Deterministic path formatting for nested structures
- Treats list length/value changes as `changed`
- Raises clear `ValueError` for invalid input
- No network, subprocesses, eval/exec, or runtime dependencies

## Public API

```python
from minimindslab_yaml_key_diff import parse_yaml, diff_yaml_strings, diff_data
```

- `parse_yaml(text: str) -> object`
- `diff_yaml_strings(old_yaml: str, new_yaml: str) -> dict`
- `diff_data(old: object, new: object) -> dict`

## Output shape

```python
{
  "added": ["path.to.key"],
  "removed": ["path.to.key"],
  "changed": [
    {
      "path": "path.to.key",
      "old": 1,
      "new": 2
    }
  ]
}
```

## Notes

This package intentionally uses a minimal parser suitable for simple YAML/JSON-like configuration content (mappings, lists, strings, numbers, booleans, null). It is designed for small CI/local config comparisons.
