# Azure Blob Storage File Operations

This tool provides a command-line interface for uploading, downloading, and managing files in Azure Blob Storage.

## Prerequisites

**Azure Connection String**: Create a file at `~/.rtx_sensors_azure` containing your Azure Storage connection string:
   ```bash
   echo "YOUR_CONNECTION_STRING" > ~/.rtx_sensors_azure
   ```

## Usage

The script can be run with the `run.sh` wrapper script.

For example, to download a `ncore` file:

```bash
./tests/validation/run.sh fullenv tools/azure/files.py --op download_file --folder_path . --container_name ncore-plus-zarr-files --object_name clipgt-34ae9459-b940-41e7-bca6-8088b30ecfd7_ncore_plus.zarr.itar
```

Documentation on all available options is available via `--help`:

```bash
./tests/validation/run.sh fullenv tools/azure/files.py --help
```

## Notes

- Downloaded files are organized as: `<folder_path>/<container_name>/<object_name>`. The script creates necessary directories automatically.
- Caching is enabled by default to save bandwidth and time. To disable caching use `--no-cache-data`.
- Progress bars show download status for large files.
