added warning and fix docs

Author: Friskes

README.md

@@ -25,7 +25,7 @@ The functionality of the classic context manager is also available.
 
 - Optional parameters:
     - `assert_q_count`: The expected number of database requests is otherwise "AssertionError: N not less than or equal to N queries"
-    - `number_runs`: The number of runs of the test function `_`
+    - `number_runs`: The number of runs of the test function / test for loop
     - `verbose`: Displaying the final results of the test measurements
     - `advanced_verb`: Displaying the result of each test measurement
     - `auto_call_func`: Autorun of the decorated function (without arguments)

src/capture_db_queries/decorators.py

@@ -94,6 +94,13 @@ def __enter__(self) -> Self:
         if self.debug:
             print('__enter__')
 
+        if self.number_runs > 1:
+            warnings.warn(
+                f'При использовании: {type(self).__name__} как контекстного менеджера'
+                'параметр number_runs > 1 не используеться.',
+                category=FutureWarning,
+                stacklevel=2,
+            )
         self.start = time.perf_counter()
         self._enter()
         return self
@@ -223,7 +230,7 @@ def test_request():
 
     - assert_q_count: Ожидаемое количество запросов к БД иначе
      "AssertionError: N not less than or equal to N queries"
-    - number_runs: Количество запусков тестовой функции `_`
+    - number_runs: Количество запусков тестовой функции / тестового цикла
     - verbose: Отображение финальных результатов тестовых замеров
     - advanced_verb: Отображение результа каждого тестового замера
     - auto_call_func: Автозапуск декорируемой функции (без аргументов)