Skip to main content

A minimalistic Google Storage client

Project description

gs is a command line interface (CLI) that provides a set of essential commands for Google Cloud Storage. It is modeled after the AWS CLI’s aws s3 command. Its features are:

  • Python 3 compatibility

  • A minimalistic set of dependencies

  • A tiny footprint

Installation

pip install gs

Synopsis

Usage:

gs [OPTIONS] COMMAND [ARGS]...

Options:
--version

Show the version and exit.

--help

Show this message and exit.

Commands:

gs configure

Set gs config options, including the API key.

gs cp

Copy files to, from, or between buckets.

gs ls

List buckets or objects in a bucket/prefix.

gs mb

Create a new bucket.

gs mv

Move files to, from, or between buckets.

gs rb

Permanently delete an empty bucket.

gs rm

Delete objects (files) from buckets.

gs sync

Sync a directory of files with bucket/prefix.

Run gs configure to configure Google service account access credentials that will be used by the gs command. You can create a new service account key at https://console.cloud.google.com/iam-admin/serviceaccounts.

Credentials

Before making API calls, gs ingests API credentials in the following order of priority:

  • First, gs checks if a GOOGLE_APPLICATION_CREDENTIALS environment variable is set. If so, it attempts to load and use credentials from the service account credentials filename referenced by the variable.

  • If that varible is not set, gs attempts to load service account credentials previously configured with gs configure (stored in ~/.config/gs/config.json).

  • If that fails, gs attempts to load a service account API token from Google instance metadata.

  • If that fails, gs gives up and prints an error.

https://travis-ci.org/kislyuk/gs.png https://img.shields.io/pypi/v/gs.svg https://img.shields.io/pypi/l/gs.svg https://codecov.io/gh/kislyuk/gs/branch/master/graph/badge.svg

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

gs-0.1.1.tar.gz (16.0 kB view details)

Uploaded Source

Built Distribution

gs-0.1.1-py2.py3-none-any.whl (18.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file gs-0.1.1.tar.gz.

File metadata

  • Download URL: gs-0.1.1.tar.gz
  • Upload date:
  • Size: 16.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/2.7

File hashes

Hashes for gs-0.1.1.tar.gz
Algorithm Hash digest
SHA256 81c07fa0195522fa2ce1953a9c2599355215110ae3e8c6a91decfaee688bf669
MD5 f0ff1a643c8b3861ab57277901aefc1f
BLAKE2b-256 c45d7de8eadde19b626e92c486bbe2252ad6236eb202d83292185006db01379a

See more details on using hashes here.

File details

Details for the file gs-0.1.1-py2.py3-none-any.whl.

File metadata

  • Download URL: gs-0.1.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 18.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/2.7

File hashes

Hashes for gs-0.1.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 72ed583fca617d705af2158d810a16b2fad1dcdf6c4ff0b17f349e7fd62f0d49
MD5 5530444701d041979072c451c70a1a1b
BLAKE2b-256 d58273c999596dd2e9d9c5b6f85cf7a4b35d7b3a9e179dec3603af1e75715ac0

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