[translation] add tests

[kristapratico]

Test classes should inherit from this base class: https://github.com/Azure/azure-sdk-for-python/blob/b972486d549a66ae6b33d3f95486687c1b1ff45e/sdk/documenttranslation/azure-ai-documenttranslation/tests/testcase.py

• Add tests for sync client
• Add tests for async client
• Generate test recordings that we can use to run tests in playback mode (not live)

We should ensure that any sensitive information (like SAS tokens) are scrubbed from the test recordings. This is done automatically with the testcase/preparers.

See table where we are tracking testing scenarios across languages.

[kristapratico]

@mohamedshabanofficial

Running tests

After we write some tests, just wanted to note how to run them locally here.

Two modes: recorded and live

• Live runs against real azure resources and produces a recording of the network traffic in the tests/recordings folder
• Recorded runs against recorded network traffic and don't actually make any calls to the service. To create a recording for a particular test, just run it live first.

To toggle between the two modes, create a file called "testsettings_local.cfg" in \azure-sdk-for-python\tools\azure-sdk-tools\devtools_testutils\testsettings_local.cfg
Add 1 line:

live-mode: true

If you want to run in recorded mode, change to false.

Set environment variables:

set TRANSLATION_DOCUMENT_TEST_ENDPOINT=https://{your-resource-name}.cognitiveservices.azure.com/
set TRANSLATION_DOCUMENT_TEST_API_KEY={your document translation API key}
set TRANSLATION_DOCUMENT_NAME={your-resource-name}
set TRANSLATION_DOCUMENT_STORAGE_NAME={your-storage-blob-resource-name}
set TRANSLATION_DOCUMENT_STORAGE_KEY={your-storage-blob-api-key}
set TRANSLATION_DOCUMENT_CLIENT_SECRET=""
set TRANSLATION_DOCUMENT_CLIENT_ID=""
set TRANSLATION_CLIENT_SECRET=""
set TRANSLATION_CLIENT_ID=""
set TRANSLATION_TENANT_ID=""
set TRANSLATION_DOCUMENT_TENANT_ID=""

The test env is looking for the few variables that are set to empty string so we need them there, but they aren't actually used. Note: you will need a storage account to run these tests.

After these env vars are set, you should be able to simply run tests from commandline like:

pytest test_service.py

or run a particular test

pytest test_service.py -k test_translate

Running live tests in the CI pipelines
Comment /azp run python - translation - tests on your PR

[kristapratico]

closed with #17511