Pin all < 1.0.0 requirements exactly (#4829)

* Constrain all < 1.0.0 requirements to an exact version and document
* revert back to ipykernel 6.17 to to fix docs build

requirements.txt

@@ -1,130 +1,136 @@
-alabaster~=0.7.12
+# this file contains constrants and not requirements for our CI job
+# it is not intended to be used outside CI but we keep the name requirements.txt
+# since some tools are hard coded to look for that name when scanning requirements
+# This should contain all post 1.0.0 packages constrained to a minor version e.g. with ~=
+# and all pre 1.0.0 pacakges and packages not using a
+# 3 part version number to an exact version using ==
+alabaster==0.7.12
 argon2-cffi~=21.3.0
 argon2-cffi-bindings~=21.2.0
 asttokens~=2.1.0
 attrs~=22.1.0
-autodocsumm~=0.2.9
+autodocsumm==0.2.9
 azure-core~=1.26.0
 azure-identity~=1.12.0
 Babel~=2.11.0
-backcall~=0.2.0
+backcall==0.2.0
 beautifulsoup4~=4.11.1
 bleach~=5.0.1
-broadbean~=0.11.0
+broadbean==0.11.0
 cachetools~=5.2.0
 certifi~=2022.9.24
 cffi~=1.15.1
 charset-normalizer~=2.1.1
 click~=8.1.3
 click-default-group~=1.2.2
-colorama~=0.4.5
+colorama==0.4.5
 contextlib2~=21.6.0
 coverage~=6.5.0
 cryptography~=38.0.1
-cycler~=0.11.0
+cycler==0.11.0
 debugpy~=1.6.3
 decorator~=5.1.1
 deepdiff~=6.2.1
-defusedxml~=0.7.1
-docutils~=0.17.1
-entrypoints~=0.4
+defusedxml==0.7.1
+docutils==0.17.1
+entrypoints==0.4
 exceptiongroup~=1.0.0rc9
 execnet~=1.9.0
 executing~=1.2.0
 fastjsonschema~=2.16.2
 fonttools~=4.38.0
-future~=0.18.2
+future==0.18.2
 google-api-core~=2.10.2
 google-auth~=2.14.0
 googleapis-common-protos~=1.57.0
 h5netcdf~=1.1.0
 h5py~=3.7.0
 hypothesis~=6.58.0
-idna~=3.4
+idna==3.4
 imagesize~=1.4.1
 importlib-metadata~=5.0.0; python_version < '3.10'
 importlib-resources~=5.9.0; python_version < '3.9'
 incremental~=22.10.0
 iniconfig~=1.1.1
-ipykernel~=6.18.1
+ipykernel~=6.17.1
 ipython~=8.6.0
-ipython-genutils~=0.2.0
+ipython-genutils==0.2.0
 ipywidgets~=8.0.2
 jedi~=0.18.1
 Jinja2~=3.1.2
-jsonpointer~=2.3
+jsonpointer==2.3
 jsonschema~=4.17.0
 jupyter-client~=7.4.3
 jupyter-core~=5.1.0
-jupyterlab-pygments~=0.2.2
+jupyterlab-pygments==0.2.2
 jupyterlab-widgets~=3.0.3
 kiwisolver~=1.4.4
-lazy_loader~=0.1
+lazy_loader==0.1
 lxml~=4.9.1
 MarkupSafe~=2.1.1
 matplotlib~=3.6.1
-matplotlib-inline~=0.1.6
+matplotlib-inline==0.1.6
 mistune~=2.0.4
 msal~=1.20.0
 msal-extensions~=1.0.0
 mypy==0.991
 mypy-extensions~=0.4.3
-nbclient~=0.7.0
+nbclient==0.7.0
 nbconvert~=7.2.2
 nbformat~=5.7.0
-nbsphinx~=0.8.9
+nbsphinx==0.8.9
 nest-asyncio~=1.5.6
 notebook~=6.5.1
 numpy~=1.23.4
-opencensus~=0.11.0
-opencensus-context~=0.1.3
+opencensus==0.11.0
+opencensus-context==0.1.3
 opencensus-ext-azure~=1.1.7
 ordered-set~=4.1.0
-packaging~=21.3
+packaging==21.3
 pandas~=1.5.1
 pandocfilters~=1.5.0
-parso~=0.8.3
-pickleshare~=0.7.5
+parso==0.8.3
+pickleshare==0.7.5
 Pillow~=9.3.0
 pluggy~=1.0.0
 portalocker~=2.6.0
-prometheus-client~=0.15.0
+prometheus-client==0.15.0
 prompt-toolkit~=3.0.31
 protobuf~=4.21.8
 psutil~=5.9.3
-pure-eval~=0.2.2
+pure-eval==0.2.2
 py~=1.11.0
-pyasn1~=0.4.8
-pyasn1-modules~=0.2.8
-pycparser~=2.21
+pyasn1==0.4.8
+pyasn1-modules==0.2.8
+pycparser==2.21
 Pygments~=2.13.0
 PyJWT~=2.6.0
 pyparsing~=3.0.9
 PyQt5~=5.15.7
 PyQt5-Qt5~=5.15.2
 PyQt5-sip~=12.11.0
-pyqtgraph~=0.13.1
-pyrsistent~=0.19.1
+pyqtgraph==0.13.1
+pyrsistent==0.19.1
 pytest~=7.2.0
-pytest-asyncio~=0.20.1
+pytest-asyncio==0.20.1
 pytest-cov~=4.0.0
 pytest-forked~=1.4.0
 pytest-mock~=3.10.0
-pytest-rerunfailures~=10.2
+pytest-rerunfailures==10.2
 pytest-xdist~=3.0.2
 python-dateutil~=2.8.2
 pytz~=2022.5
 PyVISA~=1.12.0
-PyVISA-sim~=0.5.1
+PyVISA-sim==0.5.1
 pywin32==305; sys_platform == 'win32'
 pywinpty~=2.0.8; sys_platform == 'win32'
-PyYAML~=6.0
+PyYAML==6.0
 pyzmq~=24.0.1
 requests~=2.28.1
-rsa~=4.9
-ruamel.yaml~=0.17.21
-ruamel.yaml.clib~=0.2.7
-schema~=0.7.5
+rsa==4.9
+ruamel.yaml==0.17.21
+ruamel.yaml.clib==0.2.7
+schema==0.7.5
 scipy==1.9.3
 Send2Trash~=1.8.0
 six~=1.16.0
@@ -133,7 +139,7 @@ snowballstemmer~=2.2.0
 sortedcontainers~=2.4.0
 soupsieve~=2.3.2.post1
 Sphinx @ git+https://github.com/jenshnielsen/sphinx.git@fix_9884_5_3
-sphinx-favicon~=0.2
+sphinx-favicon==0.2
 sphinx-issues~=3.0.1
 sphinx-jsonschema~=1.19.1
 sphinx-rtd-theme~=1.1.0
@@ -143,11 +149,11 @@ sphinxcontrib-htmlhelp~=2.0.0
 sphinxcontrib-jsmath~=1.0.1
 sphinxcontrib-qthelp~=1.0.3
 sphinxcontrib-serializinghtml~=1.1.5
-sphinxcontrib-towncrier~=0.3.0a0
-stack-data~=0.6.0
-stringparser~=0.5
-tabulate~=0.9.0
-terminado~=0.17.0
+sphinxcontrib-towncrier==0.3.0a0
+stack-data==0.6.0
+stringparser==0.5
+tabulate==0.9.0
+terminado==0.17.0
 tinycss2~=1.2.1
 tomli~=2.0.1
 tornado~=6.2
@@ -162,11 +168,11 @@ typing_extensions~=4.4.0
 uncertainties~=3.1.7
 urllib3~=1.26.12
 versioningit~=2.1.0
-wcwidth~=0.2.5
-webencodings~=0.5.1
+wcwidth==0.2.5
+webencodings==0.5.1
 websockets~=10.3
 widgetsnbextension~=4.0.3
-wincertstore~=0.2
+wincertstore==0.2
 wrapt~=1.14.1
 xarray~=2022.11.0
 zipp~=3.11.0