Metadata-Version: 2.4
Name: fennil
Version: 1.5.1
Summary: Viewer for kinematic earthquake simulations
Author: Kitware, Inc.
Author-email: Brendan Meade <brendanjmeade@gmail.com>
License: MIT License
License-File: LICENSE
Keywords: Application,Framework,Interactive,Python,Web
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: numpy
Requires-Dist: pandas<3
Requires-Dist: pydeck
Requires-Dist: python-dotenv
Requires-Dist: trame-dataclass
Requires-Dist: trame-deckgl>=2.0.4
Requires-Dist: trame-vuetify
Requires-Dist: trame>=3.12
Provides-Extra: app
Requires-Dist: pywebview; extra == 'app'
Provides-Extra: dev
Requires-Dist: nox; extra == 'dev'
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest-cov>=3; extra == 'dev'
Requires-Dist: pytest>=6; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

## fennil

![Fennil](https://raw.githubusercontent.com/brendanjmeade/fennil/main/fennil.jpg)

Viewer for kinematic earthquake simulations

Interactively displays [`celeri`](https://github.com/brendanjmeade/celeri)
models. `fennil` is a rebuild of the original
[`result_manager`](https://github.com/brendanjmeade/result_manager).

## Installation

Install the application/library

```console
pip install fennil
```

Run the application

```console
fennil
```

## Mapbox token

Get a Mapbox access token at:
https://docs.mapbox.com/help/getting-started/access-tokens/.

Set a Mapbox access token so base maps render with Mapbox styles. Either export
it in your shell or place it in a local `.env` file (for local development):

```console
export FENNIL_MAP_BOX_TOKEN="YOUR_TOKEN_HERE"
```

Or create a `.env` file in the project root containing:

```
FENNIL_MAP_BOX_TOKEN=YOUR_TOKEN_HERE
```

## Development setup

We recommend using uv for setting up and managing a virtual environment for your
development.

```console
# Create venv and activate
uv venv
source .venv/bin/activate

# Install & allow live code edit
uv pip install -e .

# Install all dev dependencies
uv sync --all-extras --dev
```

To run test/linting:

```console
pre-commit run --all
```

## License

This library is OpenSource and follows the MIT License. For more details, see
[LICENSE](https://github.com/brendanjmeade/fennil/blob/main/LICENSE)

## Commit message convention

Semantic release rely on
[conventional commits](https://www.conventionalcommits.org/) to generate new
releases and changelog.
