dbt-tests-adapter
For context and guidance on using this package, please read: "Testing a new adapter"
What is it?
This package includes reusable test cases that reinforce behaviors common to all or many adapter plugins. There are two categories of tests:
-
Basic tests that every adapter plugin is expected to pass. These are defined in
tests.adapter.basic. Given differences across data platforms, these may require slight modification or reimplementation. Significantly overriding or disabling these tests should be with good reason, since each represents basic functionality expected by dbt users. For example, if your adapter does not support incremental models, you should disable the test, by marking it withskiporxfail, as well as noting that limitation in any documentation, READMEs, and usage guides that accompany your adapter. -
Optional tests, for second-order functionality that is common across plugins, but not required for basic use. Your plugin can opt into these test cases by inheriting existing ones, or reimplementing them with adjustments. For now, this category includes all tests located outside the
basicsubdirectory. More tests will be added as we convert older tests defined on dbt-core and mature plugins to use the standard framework.
How to use it?
Each test case in this repo is packaged as a class, prefixed Base. To enable a test case to run with your adapter plugin, you should inherit the base class into a new class, prefixed Test. That test class will be discovered and run by pytest. It can also makes modifications if needed.
class TestSimpleMaterializations(BaseSimpleMaterializations):
pass
Distribution
To install:
pip install dbt-tests-adapter
This package is versioned in lockstep with dbt-core, and the same versioning guidelines apply:
- New "basic" test cases MAY be added in minor versions ONLY. They may not be included in patch releases.
- Breaking changes to existing test cases MAY be included and communicated as part of minor version upgrades ONLY. They MAY NOT be included in patch releases. We will aim to avoid these whenever possible.
- New "optional" test cases, and non-breaking fixes to existing test cases, MAY be added in minor or patch versions.
Assuming you adapter plugin is pinned to a specific minor version of dbt-core (e.g. ~=1.1.0), you can use the same pin for dbt-tests-adapter.
Note: This is packaged as a plugin using a python namespace package. It cannot have an __init__.py file in the part of the hierarchy to which it needs to be attached.
1 maintainer
Release files for dbt-tests-adapter 1.20.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dbt_tests_adapter-1.20.0.tar.gz | 175.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dbt_tests_adapter-1.20.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 425.7 kB
Release files / dbt_tests_adapter-1.20.0.tar.gz
| Download URL | dbt_tests_adapter-1.20.0.tar.gz |
|---|---|
| Size | 175.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
91562371852790a647c59270136a4461bfda7e7484f349fcd3473f0a1d6059c6
|
|
BLAKE2b-256 checksum How to use checksums |
5883ede118214addb99e8c45338d8b18e30a22872fc8c3043f429a538232e529
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 22, 2026.
Transparency logRelease files / dbt_tests_adapter-1.20.0-py3-none-any.whl
| Download URL | dbt_tests_adapter-1.20.0-py3-none-any.whl |
|---|---|
| Size | 250.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
333d0d08c1690278a8cf681989f6359a7a8a5b3da464f14430c3ea3ea32fa5ff
|
|
BLAKE2b-256 checksum How to use checksums |
3f53860853817edbc50168af0e4520f6c203270e92e20f9edb2ca82c62116f3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 22, 2026.
Transparency log
