mirror
/
mongo
mirror of https://github.com/mongodb/mongo
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
mongo/docs/testing
History
Erin McNulty f0ffa7be9a SERVER-109671 Document mongobridge (#43402) 
GitOrigin-RevId: 1e4f97c95e8fb8418dc8921f5e9302f9001f1fe0
 		2025-10-31 20:24:26 +00:00
..
OWNERS.yml SERVER-107550: Seed readme docs for resmoke-related tooling (#38540) 2025-07-16 21:10:31 +00:00
README.md SERVER-112569: Document fixture lifecycles better (#42763) 2025-10-20 22:37:25 +00:00
fsm_concurrency_testing_framework.md SERVER-100525: Audit unowned files for StorEx ownership (#34306) 2025-04-10 04:44:12 +00:00
hang_analyzer.md SERVER-109274 Use SIGABRT to dump cores when a debugger is not found (#41844) 2025-09-29 16:24:49 +00:00
network_fault_injection_mongobridge.md SERVER-109671 Document mongobridge (#43402) 2025-10-31 20:24:26 +00:00
otel_resmoke.md SERVER-106150 Rewrite private links to public links when we sync source code from 10gen/mongo to mongodb/mongo (#37153) 2025-06-12 18:23:51 +00:00
resmoke_modules.md SERVER-108972: Support loading resmoke libs and suites from module directories (#40272) 2025-08-19 21:25:48 +00:00

README.md

Testing

Most tests for MongoDB are run through resmoke, our test runner and orchestration tool. The entry point for resmoke can be found at buildscripts/resmoke.py

Concepts

Learn more about related topics using their own targeted documentation:

  • resmoke, the test runner
  • suites, how tests are grouped and configured
  • fixtures, specify the server topology that tests run against
  • hooks, logic to run before, after and/or between individual tests
  • testcases, Python-based unittest interfaces that resmoke can run as different "kinds" of tests.

Basic Example

First, ensure that your python venv is active and up to date:

python3 -m venv python3-venv
source python3-venv/bin/activate
buildscripts/poetry_sync.sh

and you've built the source binaries to run against, eg:

bazel build install-dist-test

Now, run the test content from one test file:

buildscripts/resmoke.py run --suites=no_passthrough jstests/noPassthrough/shell/js/string.js

The suite defined in buildscripts/resmokeconfig/suites/no_passthrough.yml includes that string.js file via glob selections, specifies no fixtures, no hooks, and a minimal config for the executor.