Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nyankiyoshi/pytest-django-queries
Generate performance reports from your django database performance tests.
https://github.com/nyankiyoshi/pytest-django-queries
benchmark benchmark-framework benchmark-suite benchmarking performance-monitoring pytest pytest-django pytest-plugin
Last synced: 21 days ago
JSON representation
Generate performance reports from your django database performance tests.
- Host: GitHub
- URL: https://github.com/nyankiyoshi/pytest-django-queries
- Owner: NyanKiyoshi
- License: mit
- Created: 2019-05-03T06:35:58.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-01T16:03:49.000Z (almost 4 years ago)
- Last Synced: 2024-10-29T15:33:07.204Z (about 2 months ago)
- Topics: benchmark, benchmark-framework, benchmark-suite, benchmarking, performance-monitoring, pytest, pytest-django, pytest-plugin
- Language: Python
- Homepage: https://pytest-django-queries.readthedocs.io/
- Size: 521 KB
- Stars: 77
- Watchers: 3
- Forks: 3
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
pytest-django-queries
Generate performance reports from your django database performance tests
(inspired by coverage.py).
## Usage
Install `pytest-django-queries`, write your pytest tests and mark any
test that should be counted or use the `count_queries` fixture.
Note: to use the latest development build, use `pip install --pre pytest-django-queries`
```python
import pytest
@pytest.mark.count_queries
def test_query_performances():
Model.objects.all()
# Or...
def test_another_query_performances(count_queries):
Model.objects.all()
```
Each test file and/or package is considered as a category. Each test inside a "category"
compose its data, see [Visualising Results](#visualising-results) for more details.
You will find the [full documentation here](https://pytest-django-queries.readthedocs.io/).
## Recommendation when Using Fixtures
You might end up in the case where you want to add fixtures that are generating queries
that you don't want to be counted in the results–or simply, you want to use the
`pytest-django` plugin alongside of `pytest-django-queries`, which will generate
unwanted queries in your results.
For that, you will want to put the `count_queries` fixture as the last fixture to execute.
But at the same time, you might want to use the the power of pytest markers, to separate
the queries counting tests from other tests. In that case, you might want to do something
like this to tell the marker to not automatically inject the `count_queries` fixture into
your test:
```python
import pytest
@pytest.mark.count_queries(autouse=False)
def test_retrieve_main_menu(fixture_making_queries, count_queries):
pass
```
Notice the usage of the keyword argument `autouse=False` and the `count_queries` fixture
being placed last.
## Using pytest-django alongside of pytest-django-queries
We recommend you to do the following when using `pytest-django`:
```python
import pytest
@pytest.mark.django_db
@pytest.mark.count_queries(autouse=False)
def test_retrieve_main_menu(any_fixture, other_fixture, count_queries):
pass
```
## Integrating with GitHub
TBA.
## Testing Locally
Simply install `pytest-django-queries` through pip and run your
tests using `pytest`. A report should have been generated in your
current working directory in a file called with `.pytest-queries`.
Note: to override the save path, pass the `--django-db-bench PATH` option to pytest.
## Visualising Results
You can generate a table from the tests results by using the `show` command:
```shell
django-queries show
```
You will get something like this to represent the results:
```shell
+---------+--------------------------------------+
| Module | Tests |
+---------+--------------------------------------+
| module1 | +-----------+---------+------------+ |
| | | Test Name | Queries | Duplicated | |
| | +-----------+---------+------------+ |
| | | test1 | 0 | 0 | |
| | +-----------+---------+------------+ |
| | | test2 | 1 | 0 | |
| | +-----------+---------+------------+ |
+---------+--------------------------------------+
| module2 | +-----------+---------+------------+ |
| | | Test Name | Queries | Duplicated | |
| | +-----------+---------+------------+ |
| | | test1 | 123 | 0 | |
| | +-----------+---------+------------+ |
+---------+--------------------------------------+
```
## Exporting the Results (HTML)
For a nicer presentation, use the `html` command, to export the results as HTML.
```shell
django-queries html
```
It will generate something [like this](https://pytest-django-queries.readthedocs.io/en/latest/html_export_results.html).
## Comparing Results
You can run `django-queries backup` (can take a path, optionally) after
running your tests then rerun them. After that, you can run `django-queries diff`
to generate results looking like this:
## Development
First of all, clone the project locally. Then, install it using the below command.
```shell
./setup.py develop
```
After that, you need to install the development and testing requirements. For that,
run the below command.
```shell
pip install -e .[test]
```