diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e4f95ca4ed1c..4cf190229822 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -50,37 +50,67 @@ please refer to this Note that some tests require extra setup steps to install the required dependencies. -### Linux/Mac OS/WSL +
Linux / macOS / WSL | ++ + On Linux and macOS, you will be able to run the full test suite on Python + 3.9-3.12. + To install the necessary requirements, run the following commands from a + terminal window: + + ```bash + $ python3 -m venv .venv + $ source .venv/bin/activate + (.venv)$ pip install -U pip + (.venv)$ pip install -r requirements-tests.txt + ``` + + | +
Windows | ++ + Run the following commands from a Windows terminal to install all requirements: + + ```powershell + > python -m venv .venv + > .venv\Scripts\activate + (.venv) > pip install -U pip + (.venv) > pip install -r requirements-tests.txt + ``` + + To be able to run pytype tests, you'll also need to install it manually +as it's currently excluded from the requirements file: -On Linux and Mac OS, you will be able to run the full test suite on Python -3.9-3.12. -To install the necessary requirements, run the following commands from a -terminal window: + ```powershell + (.venv) > pip install -U pytype + ``` -```bash -$ python3 -m venv .venv -$ source .venv/bin/activate -(.venv)$ pip install -U pip -(.venv)$ pip install -r requirements-tests.txt -``` + | +
Using uv | +-### Windows + If you already have [uv](https://docs.astral.sh/uv/getting-started/installation/) installed, you can simply replace the commands above with: -Run the following commands from a Windows terminal to install all requirements: + ```shell + uv venv + uv pip install -r requirements-tests.txt + ``` -```powershell -> python -m venv .venv -> .venv\Scripts\activate -(.venv) > pip install -U pip -(.venv) > pip install -r "requirements-tests.txt" -``` + ```shell + uv pip install -U pytype + ``` -To be able to run pytype tests, you'll also need to install it manually -as it's currently excluded from the requirements file: - -```powershell -(.venv) > pip install -U pytype -``` + | +