s3-browser-cli

1.0.1 • Public • Published

S3 Browser CLI

A command-line utility to select S3 keys interactively.

Installation

NPM

Nix

Synopsis

s3select [options]

Options

  • --bucket <bucket-name>: A bucket to pre-select. When specifying the bucket parameter with the name of a valid S3 account owned by your AWS account, the inquirer-s3 module will start to browse at the root of this bucket.
  • --objectPrefix <key>: An S3 object prefix indicating where you'd like to start the browsing inside a bucket.
  • --enableFolderSelect: If set, the user is allowed to select an S3 folder prefix as a valid result, default false.
  • --enableFileObjectSelect: If set, the user is allowed to select an S3 object (files) as a valid result, default true.
  • --enableOtherBuckets: If set, the user should be allowed to navigate to buckets other than the bucket parameter specified, default true.

Note: It is invalid to pass an objectPrefix without specifying a valid bucket.
Note: The objectPrefix must be a folder, i.e. a key's prefix not the full object's key.

Usage

TMP_FILE=$(mktemp)
s3select 3>$TMP_FILE

SELECTED_S3_KEY=$(echo $TMP_FILE | jq -r '.prefix')

Why is getting the output so difficult?

This tool uses inquirer-s3 under the hood which depends on an old version of inquirer. In new versions of inquirer, there is a fix to this problem and inquirer uses stderr insted of stdout. We work around this limitation by using our custom file description with number 3.

/s3-browser-cli/

    Package Sidebar

    Install

    npm i s3-browser-cli

    Weekly Downloads

    0

    Version

    1.0.1

    License

    ISC

    Unpacked Size

    4.92 kB

    Total Files

    4

    Last publish

    Collaborators

    • martinloeper