README.md

# S3 Utils

This repository contains a set of bash shell scripts that can ease access to the HPC4DR S3 storage service, the storage service meant for the long term data archiving and distribution. 

## Getting started

### Requirements

The scripts inside this repository need the bash shell and the openstack client to be installed together with the swift client libraries 

### Usage

Presently the following scripts are available:

- **get_s3_credentials**
  - it retrieves existing S3 credentials for a user within a project or creates new credentials.
- **revoke_s3_credentials**
  - it revokes existing S3 credentials for a user within a project.
- **get_s3_usage**
  - it prints the present data usage for a project.
- **get_rclone_config**
  - it creates an rclone configuration for accessing your project data

Make sure you make all the scripts executable before running them:

```
chmod +x s3-utils/scripts/*
s3-utils/scripts/get_s3_credentials 
```

## Using with rclone

aaaaa
aaaa