howto debug environment

How to debug environment issues

1: Make sure the right environment is active

which python  # on Linux/macOS
where python  # on Windows, gives path to Python executable

conda info --envs

pip list
pip show watertap idaes-pse pyomo

idaes environment-info
python -c "import watertap; print(watertap.__path__[0])"

2: Uninstall and reinstall WaterTAP in the environment

From the root of your local clone of the watertap repository, and after ensuring the correct environment is active:

pip uninstall --yes watertap && pip install -r requirements-dev.txt

NOTE The pip uninstall command only removes the connection between the local clone of the watertap repository and the Python package folder in the environment. It will not remove Python source files from the local repository clone. In other words, files in the working directory will be left as-is and you won't lose any committed or uncommitted progress by running the pip uninstall command.

2B: Uninstall and reinstall WaterTAP, IDAES, and Pyomo

pip uninstall --yes watertap idaes-pse pyomo && pip install -r requirements-dev.txt

3: Install WaterTAP in a new Conda environment

conda info --envs  # check existing envs to choose a different name for the new Conda env you're about to create
conda create --name watertap-dev-2 python=3.10 --yes && conda activate watertap-dev-2 && pip install -r requirements-dev.txt