Metadata-Version: 2.1
Name: superset-extender
Version: 1.0.0
Summary: An Apache-Superset extension app that enhances it with tagging, workspaces, batch cleaning
Home-page: https://gitlab.com/rework-space.com/apache-superset/superset-extender
Author: Rework-space
License: Apache License, Version 2.0
Project-URL: Bug Tracker, https://gitlab.com/rework-space.com/apache-superset/superset-extender/-/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: python-dotenv
Requires-Dist: flask
Requires-Dist: flask-sqlalchemy
Requires-Dist: requests
Requires-Dist: python-dateutil
Requires-Dist: flask-wtf
Requires-Dist: loguru
Requires-Dist: prettytable
Requires-Dist: pdoc3
Requires-Dist: flask-bcrypt
Requires-Dist: flask-login
Requires-Dist: psycopg2-binary
Requires-Dist: flask-oidc
Requires-Dist: flask-migrate
Requires-Dist: waitress
Requires-Dist: itsdangerous (==2.0.1)
Requires-Dist: sphinx
Requires-Dist: sphinx-tabs
Requires-Dist: karma-sphinx-theme
Requires-Dist: build
Requires-Dist: twine
Requires-Dist: importlib-metadata ; python_version < "3.10"

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
-->

# Superset Extender

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![build status](https://gitlab.com/rework-space.com/apache-superset/superset-extender/badges/main/pipeline.svg)](https://gitlab.com/rework-space.com/apache-superset/superset-extender/-/jobs)

An Apache-Superset extension app that enhances it with tagging, workspaces, batch cleaning.

[**Why Superset Extender?**](#why-superset-extender) |
[**Supported Databases**](#supported-databases) |
[**Installation and Configuration**](#installation-and-configuration) |
[**Contributor Guide**](#contributor-guide) |
[**Getting started**](#getting-started) |

## Why Superset Extender?

The Superset-Extender provides:

- A **batch cleaner app** to remove entities on Apache-Superset based on predefined criteria
- An easy integration with **Apache-Airflow** for scheduled actions
- A **no-code interface** for tagging, categorizing Apache-Superset entities into workspaces
- A web-based interface for interacting with the Apache Superset API
- A **CLI**

## Screenshots

**Get a better view of superset dashboards**

<kbd><img title="Dashboards" src="https://gitlab.com/rework-space.com/apache-superset/superset-extender/-/raw/main/src/supextend/static/img/demo/superset-extender-dashboards.png"/></kbd><br/>

**Add and remove tags**

<kbd><img title="Tags" src="https://gitlab.com/rework-space.com/apache-superset/superset-extender/-/raw/main/src/supextend/static/img/demo/superset-extension-tags.png"/></kbd><br/>

**Support for categorization**

<kbd><img title="Workspaces" src="https://gitlab.com/rework-space.com/apache-superset/superset-extender/-/raw/main/src/supextend/static/img/demo/superset-extender-demo.png"/></kbd><br/>



## Supported Databases

Superset-extender can save deleted entities on any SQL-speaking datastore that has a Python DB-API driver and a SQLAlchemy dialect.

## Contributor Guide

Interested in contributing? 
Check out our [CONTRIBUTING.md](CONTRIBUTING.md)
to find resources around contributing along with a detailed guide on
how to set up a development environment.

## Getting started

- **Using pip**
```bash
# Install Superset-Extender in editable (development) mode
$ pip install supextend

# View help
$ supextend --help

# Run migrations (default database: )
$ supextend upgrade-metastore

# Initialize with data from superset
$ supextend  init

# Start the Flask dev web server from inside your virtualenv
$ supextend  run

# View charts and dashboards on superset
$ supextend  report-superset

# Remove superset charts and/or dashboards
$ supextend  clean-superset
```
