From e5fa22cf926eaf3d60db0a43b15ee499080be04e Mon Sep 17 00:00:00 2001
From: Tom Vo <tomvothecoder@gmail.com>
Date: Tue, 5 Dec 2023 10:09:38 -0800
Subject: [PATCH] Update `.readthedocs.yml` to set env varibles

---
 .readthedocs.yml | 5 +++++
 docs/conf.py     | 8 --------
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 3be49e8e..ee39f113 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -9,6 +9,11 @@ build:
     os: "ubuntu-20.04"
     tools:
         python: "mambaforge-4.10"
+    jobs:
+        post_create_environment:
+            # Use conda run executable wrapper to set all env variables, including ESMFMKFILE.
+            # Source: https://github.com/readthedocs/readthedocs.org/issues/5339#issuecomment-1576603529
+            - conda run -n ${CONDA_DEFAULT_ENV} pip install . --no-deps
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
diff --git a/docs/conf.py b/docs/conf.py
index 01b3142c..c6b06944 100755
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -19,18 +19,10 @@
 #
 import os
 import sys
-from pathlib import Path
 from typing import Dict
 
 import sphinx_autosummary_accessors
 
-# A workaround that sets the "ESMFMKFILE" env variable for the Read The Docs
-# build to work. Read The Docs does not activate the conda environment which
-# causes "ESMFMKFILE" to not be set (required by `esmpy` and `xesmf`).
-# Source: https://github.com/conda-forge/esmf-feedstock/issues/91
-if os.environ.get("READTHEDOCS") and "ESMFMKFILE" not in os.environ:
-    os.environ["ESMFMKFILE"] = str(Path(os.__file__).parent.parent / "esmf.mk")
-
 sys.path.insert(0, os.path.abspath(".."))  # noqa: I001, I003
 import xcdat  # noqa: I001, E402