feat: update built-in dataset to parquet and enforce dependencies

- Update built-in dataset to parquet

- Require Python >= 3.10

- Require Polars >= 1.37

Author: quantbai

README.md

@@ -3,7 +3,7 @@
 <img src="https://raw.githubusercontent.com/quantbai/elvers/main/assets/elvers.svg" alt="Elvers" width="500">
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![Polars](https://img.shields.io/badge/Polars-1.37+-CD853F.svg)](https://pola.rs/)
 
 </div>

elvers/data/crypto_1d.parquet

@@ -10,18 +10,21 @@
 from .panel import Panel
 
 
-def load(source: Optional[Union[str, Path, pl.DataFrame]] = None) -> Panel:
+def load(source: Optional[Union[str, Path, pl.DataFrame]] = None, format: str = "parquet") -> Panel:
     """Load data into a balanced Panel.
 
     Reads CSV/Parquet/DataFrame, validates schema, then expands to a
     fully balanced (N symbols x T days) long-format panel. Missing
     factor values are filled with null.
 
     When called with no arguments, loads the built-in sample dataset
-    (daily crypto OHLCV) bundled with the package.
+    (daily crypto OHLCV) bundled with the package. Can specify `format="csv"`
+    or `format="parquet"`.
     """
     if source is None:
-        ref = resources.files("elvers.data").joinpath("crypto_1d.csv")
+        if format not in ["csv", "parquet"]:
+            raise ValueError("format must be 'csv' or 'parquet'")
+        ref = resources.files("elvers.data").joinpath(f"crypto_1d.{format}")
         with resources.as_file(ref) as p:
             return load(p)
     df = _read_source(source)

elvers/io/loader.py

@@ -11,15 +11,16 @@ license = {text = "MIT"}
 authors = [
     {name = "quantbai", email = "quantbai@gmail.com"}
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies = [
-    "polars>=1.35.0,<2.0.0",
+    "polars>=1.37.0,<2.0.0",
 ]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
     "Intended Audience :: Financial and Insurance Industry",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -30,7 +31,7 @@ Homepage = "https://github.com/quantbai/elvers"
 Repository = "https://github.com/quantbai/elvers"
 
 [tool.setuptools.package-data]
-"elvers.data" = ["*.csv"]
+"elvers.data" = ["*.csv", "*.parquet"]
 
 [tool.setuptools.dynamic]
 version = {attr = "elvers.__version__"}

pyproject.toml

@@ -21,16 +21,17 @@ def get_version():
     url='https://github.com/quantbai/elvers',
     packages=find_packages(),
     include_package_data=True,
-    package_data={"elvers.data": ["*.csv"]},
+    package_data={"elvers.data": ["*.csv", "*.parquet"]},
     install_requires=[
-        'polars>=1.35.0,<2.0.0',
+        'polars>=1.37.0,<2.0.0',
     ],
     classifiers=[
         'Development Status :: 2 - Pre-Alpha',
         'Intended Audience :: Developers',
         'Intended Audience :: Financial and Insurance Industry',
         'Intended Audience :: Science/Research',
         'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
         'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3.13',
@@ -40,5 +41,5 @@ def get_version():
         'Topic :: Office/Business :: Financial :: Investment',
         'Topic :: Scientific/Engineering',
     ],
-    python_requires='>=3.11',
+    python_requires='>=3.10',
 )