Skip to main content

CLI tool to allow submitters to upload to and download from the EBI S3 buckets.

Project description

hca-util

This tool is intended to allow HCA wranglers and contributors to upload and download data to/from the HCA S3 bucket.

https://github.com/ebi-ait/hca-util

Prerequisites

Users need to have

  1. Basic command-line knowledge
  2. Python3.x installed on their machine
  3. Credentials to access data in the S3 bucket (access and secret keys)

Install and configure

  1. Get the tool from PyPi

     $ pip install hca-util
    
  2. Run the hca-util tool

     $ hca-util
     Type ? to list commands
     hca>
    
  3. Run config command specifying your credentials

     hca> config ACCESS_KEY SECRET_KEY
    

Step 2 opens an interactive prompt.

Step 3 adds a new hca-util profile to your local AWS configuration which the tool uses.

Use the tool to upload and download data

The following commands are currently possible.

command                         description
=======                         ===========
config ACCESS_KEY SECRET_KEY    Configure your machine with credentials
create [project_name] [-udx]    Create an upload directory for project (authorised user only)
                                Project name is optional
                                If specified, needs to be between 1-12 alphanumeric characters with no space
list                            List contents of bucket (authorised user only)
list DIR_NAME                   List contents of directory
select DIR_NAME                 Select active directory for upload and download
dir                             Show selected directory
upload F1 [f2] [f3] ...         Multi-files upload to selected directory
upload .                        Upload all files from current user directory
delete F1 [f2] [f3] ...         Delete specified file(s) from selected directory
delete .                        Delete all files from selected directory
download F1 [f2] [f3] ...       Download specified file(s) from selected directory to local machine
download .                      Download all files from selected directory to local machine

Type ? or help to list commands.

Type help <command> to display help info about a command.

Note only authorised users (for e.g. wranglers, devs) with their elevated access can create directory and list all directories.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hca-util-0.0.6.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

hca_util-0.0.6-py3-none-any.whl (13.2 kB view details)

Uploaded Python 3

File details

Details for the file hca-util-0.0.6.tar.gz.

File metadata

  • Download URL: hca-util-0.0.6.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.42.0 CPython/3.6.9

File hashes

Hashes for hca-util-0.0.6.tar.gz
Algorithm Hash digest
SHA256 a6bde7c6ff2e8515829c6797ea29f8dd144f287ce519e2bb26fce98f7a7ed4b2
MD5 c07c905c9137da234b9ee9e0a7f3ef4b
BLAKE2b-256 6eb9e0e9c126dc11f85446edad828ac2f090792dd843f027bf5726e2d598b659

See more details on using hashes here.

File details

Details for the file hca_util-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: hca_util-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 13.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.42.0 CPython/3.6.9

File hashes

Hashes for hca_util-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 da08e2faf7eb31ba21c223e59bcd311b1ad6e734977d07e5c3fcd35c17fdb10b
MD5 1453c748b33f0f4661a16204dc8cde23
BLAKE2b-256 90480a6d1aedd56e2bcb61d5d948b93343b43a903bdf7dd0802f502e94d71e7c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page