Skip to content

Commit 22c6d92

Browse files
committed
updated README.md and pyproject.toml files
1 parent 47a0b7f commit 22c6d92

2 files changed

Lines changed: 29 additions & 6 deletions

File tree

README.md

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,20 @@
77

88
Provides data for use in modeling.
99

10-
Interface consists of a single function ```load_data```. It accepts
10+
## 1. Installation
11+
12+
To install this package run:
13+
```
14+
pip install git+https://github.com/wegar-2/moddata.git@main
15+
```
16+
17+
## 2. API
18+
Interface contains functions:
19+
* `load_data` - loads predefined datasets
20+
* `make_milisec_data` - allows for generating 1 day of
21+
data on prices with predefined quotes arrival intensity
22+
23+
### 2.1. `load_data`
1124
a single parameter - name of the dataset to load.
1225

1326
List of currently available datasets:
@@ -18,18 +31,27 @@ Polish banks for period 2005-01-01 through 2024-12-31
1831
(data source: [stooq.com](https://stooq.com/))
1932
4. `sunspots` - daily total sunspot number data as per [SILSO](https://www.sidc.be/SILSO/datafiles)
2033
5. `geomagnetic_activity` - data on geomagnetic activity as per [GFZ Centre for Geosciences](https://kp.gfz.de/en/data)
34+
6. `world_bank_oil_gold_monthly_prices.parquet` - data on oil prices
35+
(average, Brent, Dubai) and gold price from
36+
[World Bank's Commodity Markets](https://www.worldbank.org/en/research/commodity-markets)
37+
38+
### 2.2. `make_milisec_data`
2139

2240

23-
To install this package run:
24-
```
25-
pip install git+https://github.com/wegar-2/moddata.git@main
26-
```
41+
42+
43+
## 3. Linting and Running Unit Tests
2744

2845
Run unit tests from the main package directory with:
2946
```
3047
pytest
3148
```
3249

50+
Run `ruff` check with:
51+
```commandline
52+
uv run ruff check
53+
```
54+
3355
Check tests coverage with:
3456
```
3557
pytest --cov=moddata tests/

pyproject.toml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,5 +37,6 @@ package-dir = {"" = "."}
3737
"moddata.data" = [
3838
"bankchurn.csv",
3939
"btc.zip",
40-
"pl_banking_stocks.parquet"
40+
"pl_banking_stocks.parquet",
41+
"world_bank_oil_gold_monthly_prices.parquet"
4142
]

0 commit comments

Comments
 (0)