DDV

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

$ x install ddv

Downloading binary

You can download pre-compiled binaries from releases.

Usage

After installation, run the following command:

$ ddv

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