cadlag-starter 1.0.4__tar.gz

cadlag_starter-1.0.4/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright (c) 2026 Cadlag
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

cadlag_starter-1.0.4/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: cadlag-starter
+Version: 1.0.4
+Summary: Cadlag Starter — public SDK demo models, strategies, data fixtures, and notebook walkthrough
+Maintainer-email: Cadlag <info@cadlag.pro>
+License: Apache-2.0
+Project-URL: Homepage, https://cadlag.pro
+Project-URL: Repository, https://github.com/cadlag-quant/cadlag
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cadlag-sdk<2.0,>=1.0.4
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: pyarrow>=14.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: nbconvert>=7.0; extra == "dev"
+Requires-Dist: nbformat>=5.9; extra == "dev"
+Requires-Dist: ipykernel>=6.0; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Provides-Extra: tensorflow
+Requires-Dist: tensorflow<2.16,>=2.14; extra == "tensorflow"
+Provides-Extra: pytorch
+Requires-Dist: torch>=2.1; extra == "pytorch"
+Provides-Extra: sklearn
+Requires-Dist: scikit-learn>=1.3; extra == "sklearn"
+Requires-Dist: joblib>=1.3; extra == "sklearn"
+Dynamic: license-file
+
+# Cadlag Starter
+
+Cadlag Starter is a small Apache-2.0 SDK demo package for building against a running Cadlag platform. It provides a synthetic OHLCV fixture, a thin MT5 ingest command, lightweight model and strategy provider entry points, and a packaged notebook walkthrough.
+
+## Install
+
+```bash
+pip install -e './cadlag-starter[dev,tensorflow,pytorch,sklearn]'
+```
+
+## Data Fixture
+
+```python
+from cadlag_starter.data import load_sample_ohlcv
+
+bars = load_sample_ohlcv()
+print(bars.head())
+```
+
+The bundled sample is deterministic synthetic data with public metadata attached to the returned DataFrame.
+
+## MT5 Ingest
+
+```bash
+cadlag-starter-ingest-mt5 \
+  --symbol EURUSD \
+  --interval H1 \
+  --start-date 2026-01-01 \
+  --end-date 2026-01-07 \
+  --dataset-name starter-eurusd-h1
+```
+
+The command is a convenience wrapper around `CadlagClient.data.ingest()` and can optionally query the platform after ingest with `--verify-readback`.

cadlag_starter-1.0.4/README.md

@@ -0,0 +1,33 @@
+# Cadlag Starter
+
+Cadlag Starter is a small Apache-2.0 SDK demo package for building against a running Cadlag platform. It provides a synthetic OHLCV fixture, a thin MT5 ingest command, lightweight model and strategy provider entry points, and a packaged notebook walkthrough.
+
+## Install
+
+```bash
+pip install -e './cadlag-starter[dev,tensorflow,pytorch,sklearn]'
+```
+
+## Data Fixture
+
+```python
+from cadlag_starter.data import load_sample_ohlcv
+
+bars = load_sample_ohlcv()
+print(bars.head())
+```
+
+The bundled sample is deterministic synthetic data with public metadata attached to the returned DataFrame.
+
+## MT5 Ingest
+
+```bash
+cadlag-starter-ingest-mt5 \
+  --symbol EURUSD \
+  --interval H1 \
+  --start-date 2026-01-01 \
+  --end-date 2026-01-07 \
+  --dataset-name starter-eurusd-h1
+```
+
+The command is a convenience wrapper around `CadlagClient.data.ingest()` and can optionally query the platform after ingest with `--verify-readback`.

cadlag_starter-1.0.4/cadlag_starter/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2026 Cadlag. Licensed under Apache 2.0.
+"""Public SDK demo assets for Cadlag."""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("cadlag-starter")
+except PackageNotFoundError:
+    __version__ = "0+unknown"
+
+__all__ = ["__version__"]

cadlag_starter-1.0.4/cadlag_starter/data/__init__.py

@@ -0,0 +1,8 @@
+# Copyright (c) 2026 Cadlag. Licensed under Apache 2.0.
+"""Synthetic public data fixtures for Cadlag Starter."""
+
+from __future__ import annotations
+
+from cadlag_starter.data.fixtures import load_sample_ohlcv, sample_asset_path, write_sample_ohlcv
+
+__all__ = ["load_sample_ohlcv", "sample_asset_path", "write_sample_ohlcv"]

cadlag_starter-1.0.4/cadlag_starter/data/fixtures.py

@@ -0,0 +1,78 @@
+# Copyright (c) 2026 Cadlag. Licensed under Apache 2.0.
+"""Deterministic synthetic OHLCV fixtures for demos and tests."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Final
+
+import numpy as np
+import pandas as pd
+
+_FIXTURE_NAME: Final = "sample_ohlcv"
+_METADATA: Final[dict[str, str]] = {
+    "fixture_name": _FIXTURE_NAME,
+    "fixture_kind": "public_synthetic_ohlcv",
+    "symbol": "QOSDEMO",
+    "interval": "H1",
+}
+
+
+def sample_asset_path(name: str = _FIXTURE_NAME) -> Path:
+    """Return the path to a bundled sample asset."""
+    if name != _FIXTURE_NAME:
+        raise ValueError(f"Unknown Cadlag Starter fixture: {name}")
+    return Path(__file__).resolve().parent / "assets" / f"{_FIXTURE_NAME}.parquet"
+
+
+def load_sample_ohlcv(name_or_path: str | Path = _FIXTURE_NAME) -> pd.DataFrame:
+    """Load the bundled synthetic OHLCV sample or a compatible Parquet file."""
+    path = (
+        sample_asset_path(name_or_path)
+        if isinstance(name_or_path, str) and name_or_path == _FIXTURE_NAME
+        else Path(name_or_path)
+    )
+    if not path.exists():
+        raise ValueError(f"OHLCV fixture does not exist: {path}")
+    frame = pd.read_parquet(path)
+    if "timestamp" in frame.columns:
+        frame["timestamp"] = pd.to_datetime(frame["timestamp"], utc=True)
+    frame.attrs.update(_METADATA)
+    return frame
+
+
+def write_sample_ohlcv(path: str | Path, *, rows: int = 240) -> Path:
+    """Write a deterministic public synthetic OHLCV Parquet fixture."""
+    if rows < 32:
+        raise ValueError("rows must be at least 32")
+
+    output_path = Path(path)
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    rng = np.random.default_rng(20260523)
+    timestamp = pd.date_range("2026-01-01T00:00:00Z", periods=rows, freq="h")
+    steps = rng.normal(loc=0.0002, scale=0.0035, size=rows).cumsum()
+    close = 100.0 + steps
+    open_ = close + rng.normal(loc=0.0, scale=0.05, size=rows)
+    spread = rng.uniform(0.03, 0.18, size=rows)
+    high = np.maximum(open_, close) + spread
+    low = np.minimum(open_, close) - spread
+    volume = rng.integers(900, 3200, size=rows)
+
+    frame = pd.DataFrame(
+        {
+            "timestamp": timestamp,
+            "symbol": _METADATA["symbol"],
+            "interval": _METADATA["interval"],
+            "open": open_.round(5),
+            "high": high.round(5),
+            "low": low.round(5),
+            "close": close.round(5),
+            "volume": volume.astype("int64"),
+            "provider": "synthetic",
+            "data_type": "ohlcv",
+        }
+    )
+    frame.attrs.update(_METADATA)
+    frame.to_parquet(output_path, index=False)
+    return output_path