Metadata-Version: 2.4
Name: httk-core
Version: 2.0.0
Summary: httk₂ core functionality
Author-email: Rickard Armiento <rickard-gpg@armiento.net>
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://httk.org
Project-URL: Documentation, https://docs.httk.org/httk-core/
Project-URL: Repository, https://github.com/httk/httk-core
Project-URL: Issues, https://github.com/httk/httk-core/issues
Keywords: Materials Discovery,Materials Informatics,Materials Science
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: myst-nb; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-autoapi; extra == "docs"
Provides-Extra: release
Requires-Dist: build>=1.2; extra == "release"
Requires-Dist: twine>=6.0; extra == "release"
Dynamic: license-file

# httk-core

![Status: Pre-release](https://img.shields.io/badge/status-pre--release-red)

> **⚠️ PRE-RELEASE**
>
> The version assigned to *httk-core* designates the overall version of *httk₂*,
> and thus starts at v2.0.0. However, versions v2.0.* are to be considered
> prereleases, and semantic versioning will not be used until v2.1.0.

`httk-core` is the central lightweight dependency shared by httk₂ modules.

It provides:

- the `httk.core` package within the PEP 420 native `httk` namespace;
- shared view/backend and data-stream primitives; and
- plugin discovery and aggregate operations such as `httk.core.load`, to which
  other httk modules can register handlers.

Most users should install the [`httk2`](https://github.com/httk/httk2)
metapackage, which selects a useful set of httk modules:

```console
pip install httk2
```

Install only the core package with:

```console
pip install httk-core
```

Other distributions, such as `httk-io`, install their own packages under the
same `httk` namespace and can then be imported as `httk.io`.
