added docs

Author: mostafa6765

README.md

@@ -107,21 +107,6 @@ alembic upgrade head
 
 * [postman collection documentation](https://documenter.getpostman.com/view/9920489/2sAYQZGBNJ)
 
-## Linting and formatting
-
-### with script
-
-```bash
-./scripts/lint.sh
-./scripts/format.sh
-```
-
-
-### with pre-commit
-
-```bash
-pre-commit install
-```
-
-> [!NOTE]  
-> pre-commit will run automatically when you commit your changes.
+## docs
+* [linting and formatting](_docs/lint-formatting.md)
+* [testing](_docs/testing.md)

_docs/lint-formatting.md

@@ -0,0 +1,18 @@
+# Linting and formatting
+
+## with script
+
+```bash
+./scripts/lint.sh
+./scripts/format.sh
+```
+
+
+## with pre-commit
+
+```bash
+pre-commit install
+```
+
+> [!NOTE]  
+> pre-commit will run automatically when you commit your changes.

_docs/testing.md

@@ -0,0 +1,21 @@
+# Testing
+This project uses `pytest` and `pytest-asyncio` for testing, along with `unittest` for unit testing (particularly for mocking and patching).
+
+# Run tests
+
+Tests can be run using the test script:
+
+```bash
+./scripts/test.sh
+```
+
+The script runs pytest with the following features:
+- Code coverage reporting (minimum 80% coverage required)
+- Coverage reports in terminal, HTML, and XML formats
+- Verbose output
+
+You can pass additional pytest arguments to the script:
+
+```bash
+./scripts/test.sh -s
+```