From 27e0d6ebf8e4b1f67a1a536fac351f329a961ecc Mon Sep 17 00:00:00 2001
From: Abraham Flaxman <abie@uw.edu>
Date: Mon, 10 Apr 2023 11:42:47 -0700
Subject: [PATCH] BUG: pin PyMC to old version

Also update docs to correspond; see issue #36 for details.
---
 README.rst | 21 ++++++++++++++-------
 setup.py   |  2 +-
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/README.rst b/README.rst
index 925c3ff..617340a 100644
--- a/README.rst
+++ b/README.rst
@@ -2,10 +2,6 @@
     :target: https://travis-ci.org/ihmeuw/dismod_mr
     :alt: Latest Version
 
-============
-Introduction
-============
-
 This project is the descriptive epidemiological meta-regression tool,
 DisMod-MR, which grew out of the Global Burden of Disease (GBD) Study
 2010.  DisMod-MR has been developed for the Institute of Health
@@ -27,11 +23,11 @@ Dismod MR requires PyMC2 which does not play nicely with normal Python
 installation tools.  Fortunately, ``conda`` has solved this issue for us.
 So first you'll need to setup a conda environment
 (after `installing conda, if necessary <https://docs.conda.io/projects/conda/en/latest/user-guide/install/>`_)
-and install ``pymc``.  Then you can install ``dismod_mr`` using ``pip``.
+and install ``pymc`` version ``2.3.8``.  Then you can install ``dismod_mr`` using ``pip``.
 
 .. code-block:: sh
 
-   conda create --name=dismod_mr python=3.6 pymc
+   conda create --name=dismod_mr python=3.6 pymc==2.3.8
    conda activate dismod_mr
    pip install dismod_mr
 
@@ -61,12 +57,23 @@ package index.
 
 .. code-block:: sh
 
-   conda create --name=dismod_mr python=3.6 pymc
+   conda create --name=dismod_mr python=3.6 pymc==2.3.8
    conda activate dismod_mr
    git clone git@github.com:ihmeuw/dismod_mr.git
    cd dismod_mr
    pip install -e .
 
+To test this, you can use ``pytest``, which you must first install.
+
+.. code-block:: sh
+
+   pip install pytest
+   pytest
+
+If you have things setup right, this will still generate many
+warnings, but there should be no tests that produce failures or
+errors.
+
 Coding Practices
 ----------------
 
diff --git a/setup.py b/setup.py
index b3d2766..99d8c87 100644
--- a/setup.py
+++ b/setup.py
@@ -18,7 +18,7 @@
     install_requirements = [
         'numpy>=1.7.1',
         'scipy>=0.12.0',
-        'pymc>=2.3.6',
+        'pymc==2.3.8',
         'networkx==2.3',
         'pandas>=0.23.4,<1.1',
         'numba==0.51.0',