Metadata-Version: 2.1
Name: VizAble
Version: 0.13.3
Summary: A web-based data visualization tool that generates accessible visualizations for all users, including people with visual impairments (low vision or blind).
License: MIT
Author: Chi-Ying Chuang
Author-email: rebekah890110@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: build (>=1.0.3,<2.0.0)
Requires-Dist: cffi (>=1.16.0,<2.0.0)
Requires-Dist: cleo (>=2.1.0,<3.0.0)
Requires-Dist: crashtest (>=0.4.1,<0.5.0)
Requires-Dist: distlib (>=0.3.8,<0.4.0)
Requires-Dist: dulwich (>=0.21.7,<0.22.0)
Requires-Dist: exceptiongroup (>=1.2.0,<2.0.0)
Requires-Dist: google-generativeai (>=0.5.0,<0.6.0)
Requires-Dist: great-tables (>=0.2.0,<0.3.0)
Requires-Dist: ipykernel (>=6.29.1,<7.0.0)
Requires-Dist: jinja2 (>=3.1.3,<4.0.0)
Requires-Dist: matplotlib (>=3.8.4,<4.0.0)
Requires-Dist: numpy (>=1.26.4,<2.0.0)
Requires-Dist: openpyxl (>=3.1.2,<4.0.0)
Requires-Dist: pandas (>=2.2.0,<3.0.0)
Requires-Dist: pickleshare (>=0.7.5,<0.8.0)
Requires-Dist: plotly (>=5.20.0,<6.0.0)
Requires-Dist: poetry (>=1.7.1,<2.0.0)
Requires-Dist: pyarrow (>=15.0.0,<16.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: rsconnect-python (>=1.22.0,<2.0.0)
Requires-Dist: seaborn (>=0.13.2,<0.14.0)
Requires-Dist: setuptools (==70.0.0)
Requires-Dist: shiny (>=0.8.0,<0.9.0)
Requires-Dist: shinyswatch (>=0.4.2,<0.5.0)
Requires-Dist: shinywidgets (>=0.3.1,<0.4.0)
Requires-Dist: sphinx (>=7.2.6,<8.0.0)
Requires-Dist: sphinx-press-theme (>=0.8.0,<0.9.0)
Requires-Dist: wheel (>=0.42.0,<0.43.0)
Description-Content-Type: text/markdown

# VizAble
[![PyPI - Version](https://img.shields.io/pypi/v/VizAble?style=for-the-badge&logo=PyPI&logoColor=white&color=blue&link=https%3A%2F%2Fpypi.org%2Fproject%2FVizAble%2F)](https://pypi.org/project/VizAble/)
[![GitHub Release](https://img.shields.io/github/v/release/Rebekah-Chuang/VizAble?display_name=release&style=for-the-badge&link=https%3A%2F%2Fgithub.com%2FRebekah-Chuang%2FVizAble%2Freleases)](https://github.com/Rebekah-Chuang/VizAble/releases)
[![GitHub License](https://img.shields.io/github/license/Rebekah-Chuang/VizAble?style=for-the-badge&link=https%3A%2F%2Fgithub.com%2FRebekah-Chuang%2FVizAble%3Ftab%3DMIT-1-ov-file%23readme)](https://github.com/Rebekah-Chuang/VizAble?tab=MIT-1-ov-file#readme)
[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/Rebekah-Chuang/VizAble/run-pytest-with-tox.yaml?style=for-the-badge&label=Tests)](https://github.com/Rebekah-Chuang/VizAble/actions/workflows/run-pytest-with-tox.yaml)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/VizAble?style=for-the-badge&link=https%3A%2F%2Fpypi.org%2Fproject%2FVizAble%2F)](https://pypi.org/project/VizAble/)
[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white&style=for-the-badge)](https://conventionalcommits.org)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json&style=for-the-badge)](https://python-poetry.org/)

**VizAble** is a web-based data visualization tool that generates accessible visualizations for all users, including people with visual impairments (low vision or blind). There are 2 ways that you can access to **VizAble**:


## Web Application
You can access the web application version of **VizAble** by visiting the following link:
[Go to VizAble](https://rebekah-chuang.shinyapps.io/vizable/)

## Install Package from PyPI or GitHub
You can also install the **VizAble** package and run the application locally on your machine. Below are the instructions for installation and usage:
### A. Prerequisites
Before getting started, ensure you have the following requirements in place:
1. **Python Version:** Ensure you have Python version **3.9** or higher installed. You can verify your Python version by running:
    ```python
    python --version
    ```
2. **Virtual Environment Setup:** It's recommended to create and activate a virtual environment before installation. Below is an example of creating and activating a virtual environment using Python's built-in `venv` module. Note that this is just one example, and there are other options available for creating virtual environments:

    a. Create a virtual environment (replace `env_name` with your desired environment name):
    ```
    python -m venv env_name
    ```
    b. Activate the virtual environment:
    ```
    source env_name/bin/activate
    ```

### B. Installation
You can install **VizAble** either from **PyPI** for the latest stable version or directly from **GitHub** for the latest development version:

1. Install the latest stable version from **PyPI** using `pip`:
    ```
    pip install -U VizAble
    ```
2. Or, install the latest development version from **GitHub**:
    ```
    pip install -U git+https://github.com/Rebekah-Chuang/VizAble.git
    ```

### Usage
To run the **VizAble** application, execute the following command:
```
VizAble.run_app
```
Once executed, a link will be displayed in the terminal. You can open this link in your web browser to access the application.
