diff --git a/pytest.ini b/pytest.ini
new file mode 100644
index 0000000..b712d00
--- /dev/null
+++ b/pytest.ini
@@ -0,0 +1,2 @@
+[pytest]
+norecursedirs = docs .*
diff --git a/tox.ini b/tox.ini
new file mode 100644
index 0000000..3f42158
--- /dev/null
+++ b/tox.ini
@@ -0,0 +1,74 @@
+[tox]
+envlist=black,flake8,mypy,py3
+
+[testenv]
+extras =
+  testing
+deps =
+  pytest-cov
+  dev: pdbpp
+commands =
+  pytest --doctest-modules \
+         {envsitepackagesdir}/swh/dataset \
+         --cov={envsitepackagesdir}/swh/dataset \
+         --cov-branch {posargs}
+
+[testenv:black]
+skip_install = true
+deps =
+  black==19.10b0
+commands =
+  {envpython} -m black --check swh
+
+[testenv:flake8]
+skip_install = true
+deps =
+  flake8
+commands =
+  {envpython} -m flake8
+
+[testenv:mypy]
+extras =
+  testing
+deps =
+  mypy
+commands =
+  mypy swh
+
+# build documentation outside swh-environment using the current
+# git HEAD of swh-docs, is executed on CI for each diff to prevent
+# breaking doc build
+[testenv:sphinx]
+whitelist_externals = make
+usedevelop = true
+extras =
+  testing
+deps =
+  # fetch and install swh-docs in develop mode
+  -e git+https://forge.softwareheritage.org/source/swh-docs#egg=swh.docs
+
+setenv =
+  SWH_PACKAGE_DOC_TOX_BUILD = 1
+  # turn warnings into errors
+  SPHINXOPTS = -W
+commands =
+  make -I ../.tox/sphinx/src/swh-docs/swh/ -C docs
+
+
+# build documentation only inside swh-environment using local state
+# of swh-docs package
+[testenv:sphinx-dev]
+whitelist_externals = make
+usedevelop = true
+extras =
+  testing
+deps =
+  # install swh-docs in develop mode
+  -e ../swh-docs
+
+setenv =
+  SWH_PACKAGE_DOC_TOX_BUILD = 1
+  # turn warnings into errors
+  SPHINXOPTS = -W
+commands =
+  make -I ../.tox/sphinx-dev/src/swh-docs/swh/ -C docs