Metadata-Version: 2.4
Name: auscopecat
Version: 1.0.1
Summary: Access to AuScope's catalogue of geoscience datasets from sources all over Australia
Author-email: AuScope MAINTAIN <cg-admin@csiro.au>
Project-URL: Repository, https://github.com/AuScope/AuScope-Cat
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 (LGPLv2)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: numpy
Requires-Dist: pandas

![Test Status](https://github.com/AuScope/AuScope-Cat/actions/workflows/python-build-test.yml/badge.svg)
[![Coverage Status](https://raw.githubusercontent.com/AuScope/AuScope-Cat/main/.github/badges/coverage.svg)](https://github.com/AuScope/AuScope-Cat/actions/workflows/python-build-test.yml)

# AuScope Catalogue
Home of 'auscopecat', a Python package that aims to allow access to AuScope's catalogue of geoscience datasets from sources all over Australia

## Development

### To install

1. Install Python v3.10 or higher (https://www.python.org/)
2. Install uv (https://docs.astral.sh/uv/getting-started/installation/)
3. Clone this repository

### To create and activate a new Python environment

```
uv venv
source .venv/bin/activate
uv sync
```

And to deactivate:
```
deactivate
```

**ALSO**

```
uv run $SHELL
```
will run an environment in a new shell

**TIP**: Use 'uv pip install "auscopecat@."' to install the local auscopecat package

### Pre-commit
This project comes with a pre-commit configuration `pre-commit install` to add it as a git hook.<br>
If you want to let Ruff fix a lot of the problems for you, you can use `ruff check . --fix`

### To search for WFS borehole datasets and download from one of them

```
$ uv run $SHELL
$ uv pip install "auscopecat@."
$ python3
>>> from auscopecat.api import search, download
>>> from auscopecat.auscopecat_types import ServiceType, DownloadType
>>> first_wfs = search('borehole', ServiceType.WFS)[0]
>>> BBOX = {
... "north": -24.7257367141281, "east": 131.38891993801204,
...  "south": -25.793715746583374, "west": 129.77844446004175
... }
>>> download(first_wfs, DownloadType.CSV, bbox=BBOX)
```

### To run tests

Run
```
uv run pytest
```
in the 'AuScope-Cat'root directory


