Metadata-Version: 2.1
Name: localstack-extension-diagnosis-viewer
Version: 0.1.1
Summary: LocalStack Extension: Diagnosis Viewer
Home-page: https://github.com/localstack/localstack-extensions/tree/main/diagnosis-viewer
Author: LocalStack Contributors
Author-email: info@localstack.cloud
Description-Content-Type: text/markdown; charset=UTF-8
Requires-Dist: diapretty
Provides-Extra: dev
Requires-Dist: localstack-core>=1.4; extra == "dev"

Diagnosis Viewer
===============================
[![Install LocalStack Extension](https://localstack.cloud/gh/extension-badge.svg)](https://app.localstack.cloud/extensions/remote?url=git+https://github.com/localstack/localstack-extensions/#egg=localstack-extension-diagnosis-viewer&subdirectory=diagnosis-viewer)

View the diagnostics endpoint directly in localstack

## Access Diagnosis Data

The extension is a web UI for the diagnosis endpoint of LocalStack, which is enabled when LocalStack is started with `DEBUG=1` and available at `curl -s localhost:4566/_localstack/diagnose`.
The web UI can then be reached at `http://localhost:4566/diapretty`.


## Installation

Install the extension by running:

```bash
localstack extensions install localstack-extension-diagnosis-viewer
```

## Development

### Install local development version

To install the extension into localstack in developer mode, you will need Python 3.10, and create a virtual environment in the extensions project.

In the newly generated project, simply run

```bash
make install
```

Then, to enable the extension for LocalStack, run

```bash
localstack extensions dev enable .
```

You can then start LocalStack with `EXTENSION_DEV_MODE=1` to load all enabled extensions.
Make sure to also set `DEBUG=1` so the diagnose endpoint necessary to populate the report is loaded.

```bash
EXTENSION_DEV_MODE=1 DEBUG=1 localstack start
```
