Metadata-Version: 2.4
Name: catalogkit-core
Version: 0.1.1
Summary: Shared artifact models, canonical IDs, and merge semantics for CatalogKit.
Author: ClearMetric Labs
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/Clearmetric-Labs/CatalogKit
Project-URL: Source, https://github.com/Clearmetric-Labs/CatalogKit
Project-URL: Issues, https://github.com/Clearmetric-Labs/CatalogKit/issues
Keywords: catalog,lineage,metadata,graph
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.10.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Provides-Extra: release
Requires-Dist: build>=1.2.2; extra == "release"
Requires-Dist: twine>=5.1.1; extra == "release"

# catalogkit-core

`catalogkit-core` is the shared consistency layer for every CatalogKit module.

It owns:

- artifact schema versioning
- canonical ID normalization
- shared graph models
- deterministic JSON serialization
- merge semantics

It does **not** perform extraction by itself. Tool packages such as `catalogkit-query`
depend on `catalogkit-core` and emit artifacts that follow its contract.

## Install

```bash
python -m pip install catalogkit-core
```

## Imports

```python
from catalogkit.core import CatalogArtifact, Edge, Evidence, Node, Warning, merge
```

For local development:

```bash
python -m pip install -e ".[dev,release]"
```

## Contract

The source of truth for the shared artifact contract is
[`docs/contract.md`](docs/contract.md).
