Cleanup requirements.txt and dev-requirements.txt

.github/actions/deploy/action.yml

@@ -19,7 +19,6 @@ runs:
     - name: Setup dependencies
       run: |
         python3 -m pip install -r requirements.txt
-        python3 -m pip install -r dev-requirements.txt
       shell: bash
     - name: Deploy support components
       run: |

.github/workflows/deploy-grafana-dashboards.yaml

@@ -22,7 +22,6 @@ jobs:
       - name: Setup dependencies
         run: |
           python3 -m pip install -r requirements.txt
-          python3 -m pip install -r dev-requirements.txt
           sudo apt install jsonnet
 
       - name: Setup gcloud

.github/workflows/deploy-hubs.yaml

@@ -63,7 +63,6 @@ jobs:
               - "deployer/**"
               - "helm-charts/**"
               - "requirements.txt"
-              - "dev-requirements.txt"
               - "config/secrets.yaml"
               - ".github/workflows/deploy-hubs.yaml"
               - ".github/actions/deploy/*"

.github/workflows/doc-links.yml

@@ -13,11 +13,6 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v2
-        with:
-          # chartpress is used by doc/conf.py,
-          # and requires information about the latest tagged commit, which
-          # requires the git history.
-          fetch-depth: 0
 
       - name: Install environment
         uses: conda-incubator/setup-miniconda@v2

dev-requirements.txt

@@ -1,5 +1,13 @@
-pytest
-pytest-asyncio
+# These requirements represents the needs for doing various tasks in this git
+# repo besides using the deployer script.
+#
+
+# chartpress is relevant to build and push helm-charts/images/hub/Dockerfile and
+# update basehub's default values to reference the new image.
+chartpress
+
+# requests is used by extra_scripts/rsync-active-users.py
 requests
-beautifulsoup4
+
+# rich is used by extra_scripts/count-auth0-apps.py
 rich

docs/reference/ci-cd.md

@@ -11,7 +11,6 @@ following paths are modified:
 - deployer/**
 - helm-charts/**
 - requirements.txt
-- dev-requirements.txt
 - config/secrets.yaml
 - config/clusters/**
 - .github/workflows/deploy-hubs.yaml

requirements.txt

@@ -1,6 +1,18 @@
-backoff
-chartpress
+# This file represents the needs for the deployer script to function, while the
+# dev-requirements.txt file represents the needs in this repo in general.
+#
+
+# ruamel.yaml is used to read and write .yaml files.
 ruamel.yaml
+
+# auth0 is used to communicate with Auth0's REST API that we integrate with in
+# various ways.
 auth0-python
-jhub-client==0.1.4
+
+# jsonschema is used for validating cluster.yaml configurations
 jsonschema
+
+# jhub_client, pytest, and pytest_asyncio are used for our health checks
+jhub-client==0.1.4
+pytest
+pytest-asyncio