GitHub - lusingander/ddv: Terminal DynamoDB Viewer ⚡️

Terminal DynamoDB Viewer ⚡️

About

DDV is a TUI application to view Amazon DynamoDB in the terminal.

Warning

This application is designed to be used in a local environment or in a development environment with a small amount of data. It is not suitable for use in a production environment with large amounts of data.

Goals

Provide a simple way to view, search, update, and delete DynamoDB items in the terminal.

Note

This application is in early development. It is missing a lot of features and behaviors. Currently, update functions, such as creating or deleting items, are not implemented.

Non-Goals

Efficiently handling large tables for querying or updating.
Offering full support for all DynamoDB API operations.

Installation

Cargo

$ cargo install --locked ddv

Homebrew (macOS)

$ brew install lusingander/tap/ddv

X-CMD

Downloading binary

You can download pre-compiled binaries from releases.

Usage

After installation, run the following command:

Basically, you can use it in the same way as the AWS CLI.

In other words, if the default profile settings exist or the environment variables are set, you do not need to specify any options.

Options

DDV - Terminal DynamoDB Viewer ⚡️

Usage: ddv [OPTIONS]

Options:
  -r, --region <REGION>     AWS region
  -e, --endpoint-url <URL>  AWS endpoint url
  -p, --profile <NAME>      AWS profile name
  -h, --help                Print help
  -V, --version             Print version

Keybindings

The basic key bindings are as follows:

Key	Description
`Ctrl-C`	Quit app
`Enter`	Open selected item
`Backspace`	Go back to previous
`j/k/h/l` `↓/↑/←/→`	Select item / Scroll
`?`	Show help

Detailed operations on each view can be displayed by pressing ? key.

Config

If the DDV_CONFIG environment variable specifies the path to the config file, the config will be loaded.

The config file uses the following format:

# The default region to use if the region cannot be obtained from the command line options or AWS settings.
# type: string
default_region = "us-east-1"

[ui.table_list]
# The width of the table list.
# type: u16
list_width = 30

[ui.table]
# The maximum column width for each attributes.
# type: u16
max_attribute_width = 30
# The maximum width of the expansion.
# type: u16
max_expand_width = 35
# The maximum height of the expansion.
# type: u16
max_expand_height = 6