Metadata-Version: 2.4
Name: BuffaloCore
Version: 0.2.0
Summary: The foundational dependency for Buffalo projects.
Author-email: "David D. Marshall" <ddmarsha@calpoly.edu>
License-Expression: GPL-3.0-only
Project-URL: Documentation, https://buffaloherd.codeberg.page/BuffaloCoreDocs
Project-URL: Repository, https://codeberg.org/BuffaloHerd/BuffaloCore
Project-URL: Changelog, https://buffaloherd.codeberg.page/BuffaloCoreDocs/CHANGELOG.html
Project-URL: Issues, https://codeberg.org/BuffaloHerd/BuffaloCore/issues
Project-URL: License, https://buffaloherd.codeberg.page/BuffaloCoreDocs/LICENSE.html
Keywords: buffalo projects,numpy,diagnostics
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: numpy==2.2.*
Provides-Extra: examples
Dynamic: license-file

# Buffalo Core

Buffalo Core provides shared typed numerics and structured diagnostics for Buffalo projects.
It is the small foundation package that downstream Buffalo libraries such as Buffalo Wings and Buffalo Panel can build on without depending on one another for low-level conventions.

## Included Modules

- `buffalo_core.typing` provides shared NumPy-oriented type aliases such as `FloatArray` and `IntInput`.
- `buffalo_core.numeric` provides normalization helpers for flexible numeric inputs.
- `buffalo_core.diagnostics` provides structured diagnostics and `OperationResult[T]` for value-plus-report workflows.

## Quick Example

```python
from buffalo_core.numeric import as_float_array
from buffalo_core.typing import FloatArray


def normalize_samples(values: FloatArray) -> FloatArray:
    return as_float_array(values)
```

## Learn More

- Documentation: https://buffaloherd.codeberg.page/BuffaloCoreDocs
- Source: https://codeberg.org/BuffaloHerd/BuffaloCore
- Changelog: https://buffaloherd.codeberg.page/BuffaloCoreDocs/CHANGELOG.html
