cyqstats 0.1.0__tar.gz

cyqstats-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 toto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cyqstats-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include readme.md
+include pyproject.toml
+recursive-include src/cyqstats *.pyx *.pxd *.pyi

cyqstats-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: cyqstats
+Version: 0.1.0
+Summary: Streaming statistics and grouped aggregations for large event streams
+Author: Cyquant Contributors
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.23
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: Cython>=3.0; extra == "dev"
+Dynamic: license-file
+
+# Cyqstats
+
+**Cyqstats** es una librería para cálculo de métricas en streaming orientada a datasets grandes.
+
+## Estado actual (MVP)
+
+Este repositorio ya incluye la base funcional para avanzar:
+
+- `StreamStats` para agregaciones incrementales globales:
+  - `count`, `sum`, `mean`, `min`, `max`, `var`, `std`.
+- `GroupedStreamStats` para agregaciones por grupo (`int32` recomendado en tu pipeline):
+  - `add(group_ids, values)`, `merge(...)`, `to_dict()`, `result_arrays()`.
+- Merge estable por fórmula de momentos (Welford combinable), ideal para procesar por chunks.
+
+## Quickstart
+
+```python
+from random import Random
+from cyqstats import StreamStats, GroupedStreamStats
+
+rng = Random(42)
+values = [rng.gauss(0, 1) for _ in range(100_000)]
+
+# Global
+s = StreamStats()
+s.add_values(values)
+print(s.result())
+
+# Grouped
+gids = [i % 50 for i in range(len(values))]
+g = GroupedStreamStats(n_groups=50)
+g.add(gids, values)
+print(g.result_arrays()["mean"][:5])
+```
+
+## Instalación local
+
+```bash
+pip install -U pip
+pip install -e ".[dev]"
+```
+
+## Tests
+
+```bash
+PYTHONPATH=src pytest -q
+```
+
+## Próximos pasos recomendados
+
+1. **Cythonizar el hot path** (`add_values` y `add`) manteniendo esta API.
+2. Agregar percentiles streaming (P² como primera implementación).
+3. Añadir benchmark CLI comparando contra `pandas.groupby`.
+4. Publicar wheels (`manylinux`, `macOS`, `Windows`).
+
+## Licencia
+
+MIT.

cyqstats-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61", "wheel", "Cython>=3.0", "numpy>=1.23"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cyqstats"
+version = "0.1.0"
+description = "Streaming statistics and grouped aggregations for large event streams"
+readme = "readme.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Cyquant Contributors" }]
+dependencies = ["numpy>=1.23"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.4", "Cython>=3.0"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

cyqstats-0.1.0/readme.md

@@ -0,0 +1,58 @@
+# Cyqstats
+
+**Cyqstats** es una librería para cálculo de métricas en streaming orientada a datasets grandes.
+
+## Estado actual (MVP)
+
+Este repositorio ya incluye la base funcional para avanzar:
+
+- `StreamStats` para agregaciones incrementales globales:
+  - `count`, `sum`, `mean`, `min`, `max`, `var`, `std`.
+- `GroupedStreamStats` para agregaciones por grupo (`int32` recomendado en tu pipeline):
+  - `add(group_ids, values)`, `merge(...)`, `to_dict()`, `result_arrays()`.
+- Merge estable por fórmula de momentos (Welford combinable), ideal para procesar por chunks.
+
+## Quickstart
+
+```python
+from random import Random
+from cyqstats import StreamStats, GroupedStreamStats
+
+rng = Random(42)
+values = [rng.gauss(0, 1) for _ in range(100_000)]
+
+# Global
+s = StreamStats()
+s.add_values(values)
+print(s.result())
+
+# Grouped
+gids = [i % 50 for i in range(len(values))]
+g = GroupedStreamStats(n_groups=50)
+g.add(gids, values)
+print(g.result_arrays()["mean"][:5])
+```
+
+## Instalación local
+
+```bash
+pip install -U pip
+pip install -e ".[dev]"
+```
+
+## Tests
+
+```bash
+PYTHONPATH=src pytest -q
+```
+
+## Próximos pasos recomendados
+
+1. **Cythonizar el hot path** (`add_values` y `add`) manteniendo esta API.
+2. Agregar percentiles streaming (P² como primera implementación).
+3. Añadir benchmark CLI comparando contra `pandas.groupby`.
+4. Publicar wheels (`manylinux`, `macOS`, `Windows`).
+
+## Licencia
+
+MIT.

cyqstats-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cyqstats-0.1.0/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, Extension
+from Cython.Build import cythonize
+import numpy as np
+
+extensions = [
+    Extension(
+        "cyqstats._cycore",
+        ["src/cyqstats/_cycore.pyx"],
+        include_dirs=[np.get_include()],
+    )
+]
+
+setup(
+    ext_modules=cythonize(
+        extensions,
+        compiler_directives={
+            "language_level": "3",
+            "boundscheck": False,
+            "wraparound": False,
+            "cdivision": True,
+            "nonecheck": False,
+            "initializedcheck": False,
+        },
+    )
+)

cyqstats-0.1.0/src/cyqstats/__init__.py

@@ -0,0 +1,6 @@
+"""Cyquant public API."""
+
+from .core import StreamStats
+from .grouped import GroupedStreamStats
+
+__all__ = ["StreamStats", "GroupedStreamStats"]