yuzu-data 0.5.1

Native I/O layer: reads CSV, gzip CSV, and Parquet price and fundamental files into yuzu-core panels.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# yuzu-data

[![crates.io](https://img.shields.io/crates/v/yuzu-data)](https://crates.io/crates/yuzu-data)

Native I/O layer for [citrusquant](https://github.com/citrusquant/citrusquant):
reads price and fundamental files into
[`yuzu-core`](https://crates.io/crates/yuzu-core) panels.

## Formats

The file format is detected from content, not the object key, so existing data
keeps working and mirrors can migrate incrementally:

- **gzip CSV** (`.csv.gz`) — the default write format.
- **plain CSV** (`.csv`).
- **Apache Parquet** (`.parquet`) — columns matched by name (`day`, `adj_close`,
  `pe`, …; one column per symbol for combined panels); the `day` column may be an
  integer `YYYYMMDD`, a `YYYY-MM-DD` string, or a logical `date`. Reading only —
  writing/rebuild output stays gzip CSV.

All three work out of the box; the loaders probe `.csv.gz`, then `.parquet`,
then `.csv` for each symbol/panel.

Parquet pulls the arrow stack. Consumers that only need CSV/gzip and want to
avoid that dependency can opt out:

```toml
yuzu-data = { version = "0.1", default-features = false }
```

**On-disk / object-key contract** (directory tree, CSV columns, series-name map):
[Input data layout](https://github.com/citrusquant/citrusquant/blob/main/docs/data-layout.md).

Engine semantics (panels, NAV, Report):
[backtest-engine.md](https://github.com/citrusquant/citrusquant/blob/main/docs/backtest-engine.md).

## License

MIT