Metadata-Version: 2.1
Name: evidence-ext
Version: 0.7.0
Summary: `evidence-ext` is a Meltano utility extension.
License: Apache-2.0
Author: Meltano
Author-email: hello@meltano.com
Requires-Python: >=3.8,<4
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: PyYAML (>=6.0.0,<7.0.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Requires-Dist: meltano.edk (>=0.4.0,<0.5.0)
Requires-Dist: nodejs-bin[cmd] (>=18.4.0a4,<19.0.0)
Requires-Dist: typer (>=0.6.1,<0.10.0)
Description-Content-Type: text/markdown

# evidence-ext

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/MeltanoLabs/evidence-ext/main.svg)](https://results.pre-commit.ci/latest/github/MeltanoLabs/evidence-ext/main)

`evidence-ext` is A Meltano utility extension for [Evidence.dev](https://evidence.dev) 📊

## Testing with Meltano

This extension includes a sample Evidence project, along with a `meltano.yml` project file, allowing you to test Evidence with Meltano.

```shell
# install Meltano
pipx install meltano
# install the Meltano project locally
meltano install
# run evidence in dev mode
meltano invoke evidence dev
# build the example evidence project
meltano invoke evidence build
```

## Upgrading Evidence Versions

From time to time you may need to upgrade the version of an evidence project.

```shell
# install latest version of evidence
meltano invoke evidence upgrade
# run arbitrary npm commands for evidence
meltano invoke evidence npm {args}
```

## Installing this extension for local development

1. Install the project dependencies with `poetry install`:

```shell
cd path/to/your/project
poetry install
```

2. Verify that you can invoke the extension:

```shell
poetry run evidence_extension --help
poetry run evidence_extension describe --format=yaml
poetry run evidence_invoker --help # if you have are wrapping another tool
```

## Template updates

This project was generated with [copier](https://copier.readthedocs.io/en/stable/) from the [Meltano EDK template](https://github.com/meltano/edk).
Answers to the questions asked during the generation process are stored in the `.copier_answers.yml` file.

Removing this file can potentially cause unwanted changes to the project if the supplied answers differ from the original when using `copier update`.

