diff options
| author | Simon Charette <charette.s@gmail.com> | 2025-02-16 08:36:12 +0100 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2025-02-16 08:37:55 +0100 |
| commit | 99ac8e2589ea978c1c80ff66b4536814121f77dd (patch) | |
| tree | 1c581642f5b8b138ac1375971dc84a1125406823 /docs/topics/testing | |
| parent | dc69a63f844b2ef3bc3371edde91644cf0bef0ee (diff) | |
Refs #35967 -- Doc'd DatabaseCreation.serialize_db_to_string() method.
Diffstat (limited to 'docs/topics/testing')
| -rw-r--r-- | docs/topics/testing/advanced.txt | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/topics/testing/advanced.txt b/docs/topics/testing/advanced.txt index d3822f0920..c2d1fc6c6e 100644 --- a/docs/topics/testing/advanced.txt +++ b/docs/topics/testing/advanced.txt @@ -842,6 +842,18 @@ can be useful during testing. If the ``keepdb`` argument is ``True``, then the connection to the database will be closed, but the database will not be destroyed. +.. function:: serialize_db_to_string() + + Serializes the database into an in-memory JSON string that can be used to + restore the database state between tests if the backend doesn't support + transactions or if your suite contains test classes with + :ref:`serialized_rollback=True <test-case-serialized-rollback>` enabled. + + This function should only be called once all test databases have been + created as the serialization process could result in queries against + non-test databases depending on your + :ref:`routing configuration <topics-db-multi-db-routing>`. + .. _topics-testing-code-coverage: Integration with ``coverage.py`` |