eb-features 0.2.0__tar.gz → 0.2.2__tar.gz

{eb_features-0.2.0 → eb_features-0.2.2}/LICENSE

@@ -1,28 +1,28 @@
-BSD 3-Clause License
-
-Copyright (c) 2025, Kyle Corrie
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+BSD 3-Clause License
+
+Copyright (c) 2025, Kyle Corrie
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

{eb_features-0.2.0/src/eb_features.egg-info → eb_features-0.2.2}/PKG-INFO

@@ -1,126 +1,126 @@
-Metadata-Version: 2.4
-Name: eb-features
-Version: 0.2.0
-Summary: Feature engineering utilities for panel time-series data in the Electric Barometer ecosystem.
-Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
-License-Expression: BSD-3-Clause
-Project-URL: Homepage, https://github.com/Economistician/eb-features
-Project-URL: Repository, https://github.com/Economistician/eb-features
-Project-URL: Issues, https://github.com/Economistician/eb-features/issues
-Project-URL: Documentation, https://economistician.github.io/eb-docs/
-Keywords: forecasting,features,feature-engineering,time-series,panel-data,operations-research
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Science/Research
-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: Operating System :: OS Independent
-Classifier: Topic :: Scientific/Engineering
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: numpy>=1.24
-Requires-Dist: pandas>=2.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Dynamic: license-file
-
-# Electric Barometer · Features (`eb-features`)
-
-[![CI](https://github.com/Economistician/eb-features/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-features/actions/workflows/ci.yml)
-![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
-![Python Versions](https://img.shields.io/pypi/pyversions/eb-features)
-![PyPI](https://img.shields.io/pypi/v/eb-features)
-
-Feature engineering primitives for panel-based forecasting systems, designed to integrate seamlessly with the Electric Barometer ecosystem.
-
----
-
-## Overview
-
-`eb-features` is a modular feature engineering library for panel-based forecasting systems. It provides reusable, deterministic transformations for constructing time-aware features across entities observed over time.
-
-Within the Electric Barometer ecosystem, `eb-features` serves as the upstream feature construction layer, producing standardized inputs for downstream evaluation and metric components. While designed to integrate seamlessly with Electric Barometer, the package remains framework-agnostic and can be used independently in other forecasting workflows.
-
----
-
-## Role in the Electric Barometer Ecosystem
-
-`eb-features` defines the feature engineering primitives used throughout the Electric Barometer ecosystem. It is responsible for constructing deterministic, panel-aware input features—such as lags, rolling aggregations, and calendar encodings—that serve as the foundational inputs to forecasting and evaluation workflows.
-
-This package focuses exclusively on feature construction and validation. It does not perform model training, forecast generation, metric evaluation, or decision logic. Those responsibilities are handled by downstream layers in the ecosystem that consume engineered features for modeling, selection, and operational assessment.
-
-By separating feature semantics from modeling and evaluation concerns, `eb-features` provides a stable, reusable foundation that ensures consistency and reproducibility across forecasting pipelines operating on heterogeneous panel data.
-
----
-
-## Installation
-
-`eb-features` is distributed as a standard Python package.
-
-```bash
-pip install eb-features
-```
-
-The package supports Python 3.10 and later.
-
----
-
-## Core Concepts
-
-- **Panel-aware feature construction** — Features are constructed with explicit awareness of entity boundaries and temporal ordering, ensuring correctness in multi-entity forecasting settings.
-- **Deterministic transformations** — Feature generation is designed to be reproducible and free of stochastic behavior, supporting auditability and consistent downstream evaluation.
-- **Temporal causality** — All features respect time directionality, preventing information leakage from future observations into historical feature sets.
-- **Rolling and lag semantics** — Common forecasting features such as lags and rolling aggregates are treated as first-class primitives with clear, well-defined behavior.
-- **Validation by construction** — Feature pipelines include explicit checks and constraints to ensure structural validity before model training or evaluation.
-
----
-
-## Minimal Example
-
-The example below shows how to construct lagged and rolling features for panel data while preserving entity boundaries and temporal ordering.
-
-```python
-import pandas as pd
-from eb_features.panel.lags import add_lag_features
-from eb_features.panel.rolling import add_rolling_features
-
-# Example panel data
-df = pd.DataFrame({
-    "entity_id": ["A", "A", "A", "B", "B"],
-    "date": pd.date_range("2024-01-01", periods=5, freq="D"),
-    "y": [10, 12, 11, 7, 9],
-})
-
-# Add lagged features
-df = add_lag_features(
-    df,
-    value_col="y",
-    lags=[1, 2],
-    entity_col="entity_id",
-    time_col="date",
-)
-
-# Add rolling features
-df = add_rolling_features(
-    df,
-    value_col="y",
-    windows=[3],
-    entity_col="entity_id",
-    time_col="date",
-)
-
-print(df)
-```
-
----
-
-## License
-
-BSD 3-Clause License.  
-© 2025 Kyle Corrie.
+Metadata-Version: 2.4
+Name: eb-features
+Version: 0.2.2
+Summary: Feature engineering utilities for panel time-series data in the Electric Barometer ecosystem.
+Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/Economistician/eb-features
+Project-URL: Repository, https://github.com/Economistician/eb-features
+Project-URL: Issues, https://github.com/Economistician/eb-features/issues
+Project-URL: Documentation, https://economistician.github.io/eb-docs/
+Keywords: forecasting,features,feature-engineering,time-series,panel-data,operations-research
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+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: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# Electric Barometer · Features (`eb-features`)
+
+[![CI](https://github.com/Economistician/eb-features/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-features/actions/workflows/ci.yml)
+![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
+![Python Versions](https://img.shields.io/pypi/pyversions/eb-features)
+![PyPI](https://img.shields.io/pypi/v/eb-features)
+
+Feature engineering primitives for panel-based forecasting systems, designed to integrate seamlessly with the Electric Barometer ecosystem.
+
+---
+
+## Overview
+
+`eb-features` is a modular feature engineering library for panel-based forecasting systems. It provides reusable, deterministic transformations for constructing time-aware features across entities observed over time.
+
+Within the Electric Barometer ecosystem, `eb-features` serves as the upstream feature construction layer, producing standardized inputs for downstream evaluation and metric components. While designed to integrate seamlessly with Electric Barometer, the package remains framework-agnostic and can be used independently in other forecasting workflows.
+
+---
+
+## Role in the Electric Barometer Ecosystem
+
+`eb-features` defines the feature engineering primitives used throughout the Electric Barometer ecosystem. It is responsible for constructing deterministic, panel-aware input features—such as lags, rolling aggregations, and calendar encodings—that serve as the foundational inputs to forecasting and evaluation workflows.
+
+This package focuses exclusively on feature construction and validation. It does not perform model training, forecast generation, metric evaluation, or decision logic. Those responsibilities are handled by downstream layers in the ecosystem that consume engineered features for modeling, selection, and operational assessment.
+
+By separating feature semantics from modeling and evaluation concerns, `eb-features` provides a stable, reusable foundation that ensures consistency and reproducibility across forecasting pipelines operating on heterogeneous panel data.
+
+---
+
+## Installation
+
+`eb-features` is distributed as a standard Python package.
+
+```bash
+pip install eb-features
+```
+
+The package supports Python 3.10 and later.
+
+---
+
+## Core Concepts
+
+- **Panel-aware feature construction** — Features are constructed with explicit awareness of entity boundaries and temporal ordering, ensuring correctness in multi-entity forecasting settings.
+- **Deterministic transformations** — Feature generation is designed to be reproducible and free of stochastic behavior, supporting auditability and consistent downstream evaluation.
+- **Temporal causality** — All features respect time directionality, preventing information leakage from future observations into historical feature sets.
+- **Rolling and lag semantics** — Common forecasting features such as lags and rolling aggregates are treated as first-class primitives with clear, well-defined behavior.
+- **Validation by construction** — Feature pipelines include explicit checks and constraints to ensure structural validity before model training or evaluation.
+
+---
+
+## Minimal Example
+
+The example below shows how to construct lagged and rolling features for panel data while preserving entity boundaries and temporal ordering.
+
+```python
+import pandas as pd
+from eb_features.panel.lags import add_lag_features
+from eb_features.panel.rolling import add_rolling_features
+
+# Example panel data
+df = pd.DataFrame({
+    "entity_id": ["A", "A", "A", "B", "B"],
+    "date": pd.date_range("2024-01-01", periods=5, freq="D"),
+    "y": [10, 12, 11, 7, 9],
+})
+
+# Add lagged features
+df = add_lag_features(
+    df,
+    value_col="y",
+    lags=[1, 2],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+# Add rolling features
+df = add_rolling_features(
+    df,
+    value_col="y",
+    windows=[3],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+print(df)
+```
+
+---
+
+## License
+
+BSD 3-Clause License.  
+© 2025 Kyle Corrie.

{eb_features-0.2.0 → eb_features-0.2.2}/README.md

@@ -1,94 +1,94 @@
-# Electric Barometer · Features (`eb-features`)
-
-[![CI](https://github.com/Economistician/eb-features/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-features/actions/workflows/ci.yml)
-![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
-![Python Versions](https://img.shields.io/pypi/pyversions/eb-features)
-![PyPI](https://img.shields.io/pypi/v/eb-features)
-
-Feature engineering primitives for panel-based forecasting systems, designed to integrate seamlessly with the Electric Barometer ecosystem.
-
----
-
-## Overview
-
-`eb-features` is a modular feature engineering library for panel-based forecasting systems. It provides reusable, deterministic transformations for constructing time-aware features across entities observed over time.
-
-Within the Electric Barometer ecosystem, `eb-features` serves as the upstream feature construction layer, producing standardized inputs for downstream evaluation and metric components. While designed to integrate seamlessly with Electric Barometer, the package remains framework-agnostic and can be used independently in other forecasting workflows.
-
----
-
-## Role in the Electric Barometer Ecosystem
-
-`eb-features` defines the feature engineering primitives used throughout the Electric Barometer ecosystem. It is responsible for constructing deterministic, panel-aware input features—such as lags, rolling aggregations, and calendar encodings—that serve as the foundational inputs to forecasting and evaluation workflows.
-
-This package focuses exclusively on feature construction and validation. It does not perform model training, forecast generation, metric evaluation, or decision logic. Those responsibilities are handled by downstream layers in the ecosystem that consume engineered features for modeling, selection, and operational assessment.
-
-By separating feature semantics from modeling and evaluation concerns, `eb-features` provides a stable, reusable foundation that ensures consistency and reproducibility across forecasting pipelines operating on heterogeneous panel data.
-
----
-
-## Installation
-
-`eb-features` is distributed as a standard Python package.
-
-```bash
-pip install eb-features
-```
-
-The package supports Python 3.10 and later.
-
----
-
-## Core Concepts
-
-- **Panel-aware feature construction** — Features are constructed with explicit awareness of entity boundaries and temporal ordering, ensuring correctness in multi-entity forecasting settings.
-- **Deterministic transformations** — Feature generation is designed to be reproducible and free of stochastic behavior, supporting auditability and consistent downstream evaluation.
-- **Temporal causality** — All features respect time directionality, preventing information leakage from future observations into historical feature sets.
-- **Rolling and lag semantics** — Common forecasting features such as lags and rolling aggregates are treated as first-class primitives with clear, well-defined behavior.
-- **Validation by construction** — Feature pipelines include explicit checks and constraints to ensure structural validity before model training or evaluation.
-
----
-
-## Minimal Example
-
-The example below shows how to construct lagged and rolling features for panel data while preserving entity boundaries and temporal ordering.
-
-```python
-import pandas as pd
-from eb_features.panel.lags import add_lag_features
-from eb_features.panel.rolling import add_rolling_features
-
-# Example panel data
-df = pd.DataFrame({
-    "entity_id": ["A", "A", "A", "B", "B"],
-    "date": pd.date_range("2024-01-01", periods=5, freq="D"),
-    "y": [10, 12, 11, 7, 9],
-})
-
-# Add lagged features
-df = add_lag_features(
-    df,
-    value_col="y",
-    lags=[1, 2],
-    entity_col="entity_id",
-    time_col="date",
-)
-
-# Add rolling features
-df = add_rolling_features(
-    df,
-    value_col="y",
-    windows=[3],
-    entity_col="entity_id",
-    time_col="date",
-)
-
-print(df)
-```
-
----
-
-## License
-
-BSD 3-Clause License.  
+# Electric Barometer · Features (`eb-features`)
+
+[![CI](https://github.com/Economistician/eb-features/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-features/actions/workflows/ci.yml)
+![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
+![Python Versions](https://img.shields.io/pypi/pyversions/eb-features)
+![PyPI](https://img.shields.io/pypi/v/eb-features)
+
+Feature engineering primitives for panel-based forecasting systems, designed to integrate seamlessly with the Electric Barometer ecosystem.
+
+---
+
+## Overview
+
+`eb-features` is a modular feature engineering library for panel-based forecasting systems. It provides reusable, deterministic transformations for constructing time-aware features across entities observed over time.
+
+Within the Electric Barometer ecosystem, `eb-features` serves as the upstream feature construction layer, producing standardized inputs for downstream evaluation and metric components. While designed to integrate seamlessly with Electric Barometer, the package remains framework-agnostic and can be used independently in other forecasting workflows.
+
+---
+
+## Role in the Electric Barometer Ecosystem
+
+`eb-features` defines the feature engineering primitives used throughout the Electric Barometer ecosystem. It is responsible for constructing deterministic, panel-aware input features—such as lags, rolling aggregations, and calendar encodings—that serve as the foundational inputs to forecasting and evaluation workflows.
+
+This package focuses exclusively on feature construction and validation. It does not perform model training, forecast generation, metric evaluation, or decision logic. Those responsibilities are handled by downstream layers in the ecosystem that consume engineered features for modeling, selection, and operational assessment.
+
+By separating feature semantics from modeling and evaluation concerns, `eb-features` provides a stable, reusable foundation that ensures consistency and reproducibility across forecasting pipelines operating on heterogeneous panel data.
+
+---
+
+## Installation
+
+`eb-features` is distributed as a standard Python package.
+
+```bash
+pip install eb-features
+```
+
+The package supports Python 3.10 and later.
+
+---
+
+## Core Concepts
+
+- **Panel-aware feature construction** — Features are constructed with explicit awareness of entity boundaries and temporal ordering, ensuring correctness in multi-entity forecasting settings.
+- **Deterministic transformations** — Feature generation is designed to be reproducible and free of stochastic behavior, supporting auditability and consistent downstream evaluation.
+- **Temporal causality** — All features respect time directionality, preventing information leakage from future observations into historical feature sets.
+- **Rolling and lag semantics** — Common forecasting features such as lags and rolling aggregates are treated as first-class primitives with clear, well-defined behavior.
+- **Validation by construction** — Feature pipelines include explicit checks and constraints to ensure structural validity before model training or evaluation.
+
+---
+
+## Minimal Example
+
+The example below shows how to construct lagged and rolling features for panel data while preserving entity boundaries and temporal ordering.
+
+```python
+import pandas as pd
+from eb_features.panel.lags import add_lag_features
+from eb_features.panel.rolling import add_rolling_features
+
+# Example panel data
+df = pd.DataFrame({
+    "entity_id": ["A", "A", "A", "B", "B"],
+    "date": pd.date_range("2024-01-01", periods=5, freq="D"),
+    "y": [10, 12, 11, 7, 9],
+})
+
+# Add lagged features
+df = add_lag_features(
+    df,
+    value_col="y",
+    lags=[1, 2],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+# Add rolling features
+df = add_rolling_features(
+    df,
+    value_col="y",
+    windows=[3],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+print(df)
+```
+
+---
+
+## License
+
+BSD 3-Clause License.  
 © 2025 Kyle Corrie.