History

David Arnold e2a8c7fed3 test: fix universal type checker based on downstream use and more testing (#28619 ) * test: fix universal type checker based on downstream use and more testing * fix: type validation error reporting * fix: types; various * chore: switch off test-time type checking still too many errors		2024-11-28 23:35:32 +01:00
..
__init__.py	Testing Module (#28000 )	2024-10-07 09:46:49 +02:00
config.py	feat: better test & dumpster output (#28044 )	2024-10-09 12:05:19 +02:00
discovery.py	fix: finer grained test categorization of legacy frappe test case (#28387 )	2024-11-13 11:30:09 +01:00
environment.py	test: fix universal type checker based on downstream use and more testing (#28619 )	2024-11-28 23:35:32 +01:00
README.md	Testing Module (#28000 )	2024-10-07 09:46:49 +02:00
result.py	fix(testing): pdb post mortem (#28156 )	2024-10-17 18:52:25 +00:00
runner.py	fix: full compat mode for FrappeTestCase on run-tests cmd (#28457 )	2024-11-13 17:54:14 +01:00
utils.py	Testing Module (#28000 )	2024-10-07 09:46:49 +02:00

README.md

Frappe Testing Module

This module provides a comprehensive framework for running tests in Frappe applications. It includes functionality for test discovery, execution, result reporting, and environment setup.

Key Components

TestConfig: Configuration class for customizing test execution
TestRunner: Main class for running test suites with additional Frappe-specific functionality
TestResult: Custom test result class for improved output formatting and logging
discover_all_tests: Function to discover all tests in specified Frappe apps
discover_doctype_tests: Function to discover tests for specific DocTypes
discover_module_tests: Function to discover tests in specific modules

Usage

This module is typically used by Frappe's CLI commands for running tests, but can also be used programmatically for custom test execution scenarios.

For detailed information about each component, please refer to the well-commented code in the following files:

__init__.py: Module initialization and logging setup
runner.py: TestRunner class and test execution logic
discovery.py: Test discovery functions
result.py: Custom TestResult class for result handling
environment.py: Test environment setup and teardown

Example

from frappe.testing import TestConfig, TestRunner, discover_all_tests

config = TestConfig(failfast=True, verbose=2)
runner = TestRunner(cfg=config)
discover_all_tests(['my_app'], runner)
runner.run()

For more detailed information about each component and its functionality, please refer to the docstrings and comments in the respective files.