From 0d4879d538d9da9f5337d8178c0179098f1572d6 Mon Sep 17 00:00:00 2001
From: Matthew Barber <quitesimplymatt@gmail.com>
Date: Sat, 26 Feb 2022 14:56:23 +0000
Subject: [PATCH] RTD support

---
 .readthedocs.yml | 21 +++++++++++++++++++++
 pyproject.toml   |  9 ++++++---
 2 files changed, 27 insertions(+), 3 deletions(-)
 create mode 100644 .readthedocs.yml

diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 0000000..ffd01b6
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,21 @@
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.8"
+
+sphinx:
+   configuration: conf.py
+
+formats:
+   - pdf
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
diff --git a/pyproject.toml b/pyproject.toml
index a0ad657..bc9d131 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -11,14 +11,17 @@ license = "BSD-3-Clause"
 [tool.poetry.dependencies]
 python = ">=3.8,<3.10"
 bitarray = "^2.2.4"
-# some later version requires normalisation for chisquare values which I cba with
-scipy = "1.5.4"
+scipy = "1.5.4"  # TODO: don't pin a single version
 numpy = "^1.21.1"
+Sphinx = {version = "^4.4.0", optional = true}
+
+[tool.poetry.extras]
+# https://github.com/readthedocs/readthedocs.org/issues/4912#issuecomment-664002569
+docs = ["Sphinx"]
 
 [tool.poetry.dev-dependencies]
 pytest = "^6.2.4"
 pre-commit = "^2.13.0"
-Sphinx = "^4.4.0"
 sphinx-autobuild = "^2021.3.14"
 
 [build-system]