Skip to main content

CLI to make bulk updates to Quicksight datasets

Project description

quicksight-bulk-update-datasets

Makes bulk updates to Quicksight datasets.

[!NOTE] The only bulk update currently supported is a rename of table schema

Installation

pip install quicksight-bulk-update-datasets

Usage

quicksight-bulk-update-datasets [OPTIONS] ACCOUNT_ID SOURCE_SCHEMA TARGET_SCHEMA

Arguments:

  • ACCOUNT_ID: [required]
  • SOURCE_SCHEMA: [required]
  • TARGET_SCHEMA: [required]

Options:

  • --aws-profile TEXT
  • --dataset-id TEXT
  • --no-prompt / --no-no-prompt: [default: no-no-prompt]
  • --dry-run / --no-dry-run: [default: no-dry-run]
  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show help and exit.

Contributing

Prerequisites

To contribute you'll need:

You may also need to refer to the following as you're making changes:

Get the code

If you're not a member of the uktrade GitHub organisation, you should:

  1. Fork this repo at https://github.com/uktrade/quicksight-bulk-update-datasets/fork

  2. Clone the fork by running the following, replacing my-username-or-org with the username or organisation name you forked to:

    git clone git@github.com:my-username-or-org/quicksight-bulk-update-datasets.git
    cd quicksight-bulk-update-datasets.
    

If you are a member the uktrade GitHub organisation, you should:

  1. Clone this repo directly:

    git clone git@github.com:uktrade/quicksight-bulk-update-datasets.git
    cd quicksight-bulk-update-datasets
    

Install in editable mode

pip install -e .

Generating docs

pip install typer-cli
typer quicksight_bulk_update_datasets.py utils docs --name quicksight-bulk-update-datasets --output docs.md

Then manually copy and tweaking the docs from docs.md to the Usage section in README.md.


Releasing

After merging to the main branch, create a release from the Releases page.

  • The tag must be the form "vX.Y.Z" where X.Y.Z is the new SemVer 2.0 version.
  • You should press "Generate release notes" to automatically bring in titles of PRs since the previous release.
  • If there are many PRs, you should include an introductory paragraph highlighting the main changes.

Creating a GitHub release will automatically run the GitHub Actions workflow that releases to PyPI.

Only members of the uktrade GitHub organisation may create releases.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page