Metadata-Version: 2.4
Name: NEMO-reports
Version: 2.2.1
Summary: Reports plugin for NEMO
Author-email: Atlantis Labs LLC <atlantis@atlantislabs.io>
Project-URL: Homepage, https://gitlab.com/nemo-community/atlantis-labs/nemo-reports
Project-URL: Changelog, https://gitlab.com/nemo-community/atlantis-labs/nemo-reports/-/releases
Project-URL: Issues, https://gitlab.com/nemo-community/atlantis-labs/nemo-reports/-/issues
Project-URL: CI, https://gitlab.com/nemo-community/atlantis-labs/nemo-reports/-/pipelines
Keywords: NEMO
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Framework :: Django :: 5.2
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: Programming Language :: Python :: 3.15
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: django
Requires-Dist: python-dateutil
Provides-Extra: nemo-ce
Requires-Dist: NEMO-CE>=8.1.0; extra == "nemo-ce"
Provides-Extra: nemo
Requires-Dist: NEMO>=8.1.0; extra == "nemo"
Provides-Extra: dev-tools
Requires-Dist: pre-commit; extra == "dev-tools"
Requires-Dist: djlint; extra == "dev-tools"
Requires-Dist: black; extra == "dev-tools"
Dynamic: license-file

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/NEMO-Reports?label=python)](https://www.python.org/downloads/release/python-3110/)
[![PyPI](https://img.shields.io/pypi/v/nemo-reports?label=pypi%20version)](https://pypi.org/project/NEMO-Reports/)

# NEMO Reports

This plugin for NEMO adds a variety of reports.

# NEMO Compatibility

|     NEMO-reports     |   NEMO    |  NEMO-CE  |
|:--------------------:|:---------:|:---------:|
|      \>= 2.2.0       | \>= 8.1.0 | \>= 8.1.0 |
|      \>= 2.0.0       | \>= 7.0.0 | \>= 7.0.0 |
|      \>= 1.6.0       | \>= 4.5.0 |           |
|      \>= 1.0.0       | \>= 4.3.0 |           |

# Installation

`pip install NEMO-reports`

# Add NEMO Reports

in `settings.py` add to `INSTALLED_APPS`:

```python
INSTALLED_APPS = [
    '...',
    'NEMO_reports', # This needs to be before NEMO_billing (if installed) and NEMO
    '...'
    'NEMO_billing', # Optional
    '...'
    'NEMO',
    '...'
]
```

# Usage
Simply navigate to the `Reports` page in the `Administration` menu.

For non-administrator users, permissions are given per report, via `Detailed administration -> Users` (search for "report" in the permissions list)

## Options
Some options are available in `Customization -> Reports`:

* First day of the week (Sunday/Monday)
* Default report date range
* Excluding projects from report data
* Display format for duration
