Skip to content

Latest commit

 

History

History
126 lines (84 loc) · 4.7 KB

README.md

File metadata and controls

126 lines (84 loc) · 4.7 KB

@twilio-labs/plugin-assets

Plugin for the Twilio CLI to easily upload assets to a Twilio Assets service. Part of the Serverless Toolkit

npm (scoped) npm GitHub Code of Conduct PRs Welcome

This plugin adds functionality to the Twilio CLI to upload and manage assets to a Twilio Assets service. It's a part of the Serverless Toolkit and uses the Serverless API.

The plugin creates a new Runtime Service which it then uses as a bucket to which it upload assets. You can upload new files or list your available assets.

Requirements

Install the Twilio CLI

Via npm or yarn:

$ npm install -g twilio-cli
$ yarn global add twilio-cli

Via homebrew:

$ brew tap twilio/brew && brew install twilio

Usage

$ twilio plugins:install @twilio-labs/plugin-assets
$ twilio --help assets
USAGE
  $ twilio assets
...

Commands

twilio assets:init

Create a new assets service to use as a bucket

Create a new assets service to use as a bucket

USAGE
  $ twilio assets:init

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -o=(columns|json|tsv)            [default: columns] Format of command output.
  -p, --profile=profile            Shorthand identifier for your profile.

  --properties=properties          [default: service_sid, sid, domain_name] The asset service environment properties you
                                   would like to display (JSON output always shows all properties).

See code: src/commands/assets/init.js

twilio assets:list

List all the assets in the service

List all the assets in the service

USAGE
  $ twilio assets:list

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -o=(columns|json|tsv)            [default: columns] Format of command output.
  -p, --profile=profile            Shorthand identifier for your profile.

  --properties=properties          [default: sid, path, url, visibility] The asset properties you would like to display
                                   (JSON output always shows all properties).

See code: src/commands/assets/list.js

twilio assets:upload FILE

Upload a new asset to the Assets service

Upload a new asset to the Assets service

USAGE
  $ twilio assets:upload FILE

ARGUMENTS
  FILE  The path to the file you want to upload

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -o=(columns|json|tsv)            [default: columns] Format of command output.
  -p, --profile=profile            Shorthand identifier for your profile.

  --properties=properties          [default: sid, path, url, visibility] The asset properties you would like to display
                                   (JSON output always shows all properties).

See code: src/commands/assets/upload.js

Contributing

This project welcomes contributions from the community. Please see the CONTRIBUTING.md file for more details.

Code of Conduct

Please be aware that this project has a Code of Conduct. The tldr; is to just be excellent to each other ❤️

License

MIT