# waternsw-grabber #

**waternsw_grabber** downloads bore records from the WaterNSW data portal.  
https://realtimedata.waternsw.com.au

## Installation ##

1. Install `waternsw-grabber`

```
pip install git+http://git.wrl.unsw.edu.au:3000/danh/waternsw-grabber.git
```

2. Install `Firefox`  
https://www.mozilla.org/en-GB/firefox/

3. Download the Mozilla `geckodriver`  
https://github.com/mozilla/geckodriver/releases

4. Ensure `geckodriver` is in your system search path  
(the easiest way is to keep the executable in your working directory)

## Usage ##

```python
from waternsw_grabber import telemetered_bore_downloader, extract_records

basin_name = 'Bega River Basin'
download_dir = '.'

# Download bore records
telemetered_bore_downloader(basin_name, download_dir)

# Extract zip archives
extract_records(basin_name, download_dir)
```