1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
# Run SDK tests
This document describes how to create a dev environment in order to run SDK tests
or execute the various commands available in the toolbox.
## Set up a virtual environment
1. If you don't already have it, install Python:
- Windows: [Python website][python_website] or from the [Windows store][python_312]
- Ubuntu/Debian `sudo apt-get install python3`
- RHEL/CentOS `sudo yum install python3`
Python is also available in Bash for Windows natively.
2. Clone the repository and go to the folder
```
git clone https://github.com/Azure/azure-sdk-for-python.git
cd azure-sdk-for-python
```
3. Create a [virtual environment][virtual_environment]
You can initialize a virtual environment this way:
```
python -m venv env # Might be "python3" or "py -3.8" depending on your Python installation
source env/bin/activate # Linux shell (Bash, ZSH, etc.) only
./env/scripts/activate # PowerShell only
./env/scripts/activate.bat # Windows CMD only
```
4. Setup your development environment
Install the development requirements for a specific library (located in the `dev_requirements.txt` file at the root of the library), [Tox][tox] and an editable install of your library. For example, to install requirements for `azure-ai-formrecognizer`:
```
azure-sdk-for-python> cd sdk/formrecognizer/azure-ai-formrecognizer
azure-sdk-for-python/sdk/formrecognizer/azure-ai-formrecognizer> pip install -r dev_requirements.txt
azure-sdk-for-python/sdk/formrecognizer/azure-ai-formrecognizer> pip install "tox<5"
azure-sdk-for-python/sdk/formrecognizer/azure-ai-formrecognizer> pip install -e .
```
5. Create a .env file to store your secrets.
The recommended place to store your .env file in the root of the SDK repository, as it will be gitignored.
## Follow test-running guidance
After following the steps above, you'll be able to run recorded SDK tests with `pytest`. For more information about tests -- how to run live tests, write new tests, etc. -- refer to the documentation in [tests.md][tests].
<!-- LINKS -->
[python_website]: https://www.python.org/downloads/
[python_312]: https://apps.microsoft.com/detail/9ncvdn91xzqp
[tests]: https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md
[tox]: https://tox.wiki/en/latest/
[virtual_environment]: https://docs.python.org/3/tutorial/venv.html
|
