dyno-viewer 0.1.2

No project description provided

Dyno-viewer

Dyno-viewer is dynamodb table viewer for your terminal build using textual.

This came out from me being frustrated with how clunky and slow the dynamodb viewier is in the aws console and me finding no good free alternative, That works the way i want it to work. Which is basically a spreadsheet with menus to change the table etc just like the aws console version and it being able to be used with just a keyboard

Note:

This is still in early alpha so some things to be expect things to be broken, I will fix them as i have time. Prs are welcome

Installing

prerequisites

You need the aws cli fully configured (see here for how to setup up auth)

note about AWS IAM Identity Center(used to be called aws sso) aws profiles:

if you are using sso profiles. Then you need to make sure that you have updated your config to use a sso-session profile otherwise the app won't work see this doc on how to do that. See this issue: https://github.com/boto/botocore/issues/2374 if you want to know why this is the case

right now this can be installed via flatpak and pip:

via pip

pip install dyno-viewer

via flatpak

There is a bundled .flatpak file that get generated on release which can be installed via:

flatpak install <bundled .flatpak filename>

Dev notes

Prerequisites

This repo uses poetry for package management and needs python 3.10.11 installed either via pyenv or asdf using the asdf-community/asdf-python addon

env PYTHON_CONFIGURE_OPTS="--enable-shared" asdf install python 3.10.11

or if using pyenv:

env PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install 3.10.11

see how to build cpython with --enable-shared for more info

Local dev setup

To install locally run:

poetry install
# to go into a virtual env shell 
poetry shell
# or run app via script
poetry run run_app

Testing textual notes

See testing notes doc

Flatpak notes

This repo supports local flatpak building to make the process easy there is a script that builds the flatpak, Which are loosely created from this really useful blog post. To run call via poe (a script runner for poetry):

poetry run poe flatpak_build

This will export the main packages into a requirements file and then build flatpak in the .flatpak folder then export that flatpak to a binary file in root called dyno-viewer.flatpak which can be installed on another computer via flatpak install dyno-viewer.flatpak

It also has support for doing other different options via arguments:

Install locally

poetry run poe flatpak_build -i 

This will install the flatpak locally instead of exporting it to a file (Useful for dev testing), Which then you can run it via:

flatpak run org.flatpak.dyno-viewer

Gpg key support

You can pass a gpg key for signing a flatpak, Which is best practice (see more on that here) via:

poetry run poe flatpak_build --gpg "<key id>"

If the gpg key is not in the default directory then you can also add the path to it via this argument:

poetry run poe flatpak_build --gpg "<key id>" --gh path/to/gpg/key