Skip to content

Commit

Permalink
add dev notes to README
Browse files Browse the repository at this point in the history
  • Loading branch information
leifdenby committed May 22, 2024
1 parent 0cfc543 commit a553abd
Showing 1 changed file with 27 additions and 3 deletions.
30 changes: 27 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,38 @@ The full configuration file specification is given in [mllam_data_prep/config/sp

## Installation

The easiest way to install the package is to clone the repository and install it using pip:
To simply use `mllam-data-prep` you can install the most recent tagged version from pypi with pip:

```bash
git clone https://github.com/mllam/mllam-data-prep
python -m pip install mllam-data-prep
```

## Developing `mllam-data-prep`

To work on developing `mllam-data-prep` it easiest to install and manage the dependencies with [pdm](https://pdm.fming.dev/). To get started clone your fork of [the main repo](https://github.com/mllam/mllam-data-prep) locally:

```bash
git clone https://github.com/<your-github-username>/mllam-data-prep
cd mllam-data-prep
pip install .
```

Use pdm to create and use a virtualenv:

```bash
pdm venv create
pdm use --venv in-project
pdm install
```

All the linting is handelled by `pre-commit` which can be setup to automatically be run on each `git commit` by installing the git commit hook:

```bash
pdm run pre-commit install
```

The branch, commit, push and make a pull-request :)


## Usage

The package is designed to be used as a command-line tool. The main command is `mllam-data-prep` which takes a configuration file as input and outputs a training dataset in the form of a `.zarr` dataset named from the config file (e.g. `example.danra.yaml` produces `example.danra.zarr`).
Expand Down

0 comments on commit a553abd

Please sign in to comment.