Skip to content

NewTec-GmbH/pySupersetCli

Repository files navigation

pySupersetCli

CLI tool for easy usage of the Superset API.

License Repo Status CI

Overview

More information on the deployment and architecture can be found in the doc folder.

Installation

git clone https://github.com/NewTec-GmbH/pySupersetCli.git
cd pySupersetCli
pip install .

Usage

Show help information:

pySupersetCli [-h] -u <user> -p <password> -s <server_url> [--version] [-v] [--no_ssl] [--basic_auth] {command} {command_options}

Flags

Flag Description
--verbose , -v Print full command details before executing the command. Enables logs of type INFO and WARNING.
--version Import a ticket from a JSON file.
--help , -h Show the help message and exit.
--no_ssl Disables SSL certificate verification.
--basic_auth Use basic authentication instead of LDAP.

Login options

To connect to the Superset server, provide all credentials via Command Line arguments: - --server <server URL> is required. - ID using --user <user> and --password <password>

Commands

Command Description
upload Upload a JSON file to a Superset instance.

Examples

Check out the all the Examples on how to use the pySupersetCli tool.

Compile into an executable

It is possible to create an executable file that contains the tool and all its dependencies. "PyInstaller" is used for this. Just run the following command on the root of the folder:

pyinstaller --noconfirm --onefile --console --name "pySupersetCli" --add-data "./pyproject.toml;."  "./src/pySupersetCli/__main__.py"

Used Libraries

Used 3rd party libraries which are not part of the standard Python package:

Issues, Ideas And Bugs

If you have further ideas or you found some bugs, great! Create an issue or if you are able and willing to fix it by yourself, clone the repository and create a pull request.

License

The whole source code is published under BSD-3-Clause. Consider the different licenses of the used third party libraries too!

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.