Metadata-Version: 2.4
Name: jetfuelburn
Version: 3.1.0
Summary: A Python package for calculating fuel burn of commercial aircraft.
Author-email: Michael Weinold <michaelphilippweinold+jetfuelburn@gmail.com>
Maintainer-email: Michael Weinold <michaelphilippweinold+jetfuelburn@gmail.com>
License: MIT
Project-URL: source, https://github.com/sustainableaviation/jetfuelburn
Project-URL: homepage, https://jetfuelburn.readthedocs.io
Project-URL: tracker, https://github.com/sustainableaviation/jetfuelburn/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pint
Provides-Extra: testing
Requires-Dist: pytest; extra == "testing"
Requires-Dist: pytest-cov; extra == "testing"
Requires-Dist: python-coveralls; extra == "testing"
Provides-Extra: optionaldependencies
Requires-Dist: pandas; extra == "optionaldependencies"
Requires-Dist: plotly>=5.24.0; extra == "optionaldependencies"
Dynamic: license-file

# JetFuelBurn

[![PyPI Downloads](https://img.shields.io/pypi/dm/jetfuelburn?label=PyPI%20Downloads&logo=pypi&logoColor=white)](h[ttps://pypi.org/project/jetfuelburn/](https://pypistats.org/packages/jetfuelburn))
[![License: MIT](https://img.shields.io/pypi/l/jetfuelburn?label=License&logo=open-source-initiative&logoColor=white)](https://pypi.org/project/jetfuelburn/)
![Coverage](https://raw.githubusercontent.com/sustainableaviation/jetfuelburn/refs/heads/badges/coverage.svg)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/jetfuelburn?logo=python&logoColor=white)](https://pypi.org/project/jetfuelburn/)
[![Code style: black](https://img.shields.io/badge/Code%20Style-Black-000000.svg)](https://github.com/psf/black)

A Python package for calculating fuel burn of commercial aircraft.  
Maintainance Team: [@michaelweinold](https://github.com/michaelweinold)

## Installation

See [the package documentation](https://jetfuelburn.readthedocs.io/) for installation instructions.

## Development

### Documentation

The package documentation is based on [`mkdocs`](https://www.mkdocs.org). To build the documentation locally, install required packages from the `docs/_requirements.txt` file and navigate to the package root directory to execute:

```bash
mkdocs serve
```

### Testing

Package tests are based on [`pytest`](https://docs.pytest.org/en/stable/). To run all tests, navigate to the package root directory and execute:

```bash
pytest
```

When developing with Visual Studio Code, test can also be run from [the Test Explorer sidebar](https://code.visualstudio.com/docs/python/testing).

### CI/CD

The package uses [GitHub Actions](https://github.com/features/actions) for continuous integration and deployment. The CI/CD pipeline is defined in the `.github/workflows` directory.

| Workflow | Description | Trigger |
|----------|-------------|---------|
| `.github/workflows/test_package.yml` | Runs all tests. | Every new pull request and push to the `main` branch. |
| `.github/workflows/publish_testpypi.yml` | Runs all tests and uploads the package to TestPyPI. | Every new version `tag`. |
| `.github/workflows/publish_pypi.yml` | Runs all tests and uploads the package to PyPI. | Every new version `release`. |
