Skip to main content

Yandex.Taxi Testsuite Package

Project description

What is testsuite

Testsuite is a microservice-oriented test framework written in Python based on pytest.

Testsuite is written and supported by Yandex.Taxi, and is used to test Yandex.Taxi microservices written in C++ and Python.

The principal suggested approach to testing - although not the only one - is black box, when the service is tested through http calls.

Direct read and write access from test to database is supported to enable precondition setup and result assertions.

Installation

Installation using pip:

pip3 install yandex-taxi-testsuite

# testsuite with mongodb support
pip3 install yandex-taxi-testsuite[mongodb]

# testsuite with postgresql support
pip3 install yandex-taxi-testsuite[postgresql]
pip3 install yandex-taxi-testsuite[postgresql-binary]

# testsuite with redis support
pip3 install yandex-taxi-testsuite[redis]

# testsuite with mysql support
pip3 install yandex-taxi-testsuite[mysql]

# testsuite with clickhouse support
pip3 install yandex-taxi-testsuite[clickhouse]

# testsuite with rabbitmq support
pip3 install yandex-taxi-testsuite[rabbitmq]

You can also include testsuite into your project as submodule, e.g.:

mkdir -p submodules
git submodule add git@github.com:yandex/yandex-taxi-testsuite.git submodules/testsuite

Supported databases

Out-of-the-box testsuite supports the following databases:

  • PostgreSQL

  • MongoDB

  • Redis

  • MySQL/MariaDB 10+

  • ClickHouse

  • RabbitMQ

Supported operating systems

Testsuite runs on GNU/Linux and macOS operating systems.

Principle of operation

Testsuite sets up the environment for the service being tested:

  • Testsuite starts any required databases (postgresql, mongo, redis).

  • Before each test, testsuite fills the database with test data.

  • Testsuite starts its own web server (mockserver), which mimics (mocks) microservices other than the one being tested.

Testsuite starts the microservice being tested in a separate process.

Testsuite then runs tests.

A test performs http requests to the service and verifies that the requests were processed properly.

A test may check the results of an http call by looking directly into the service’s database.

A test may check whether the service has made calls to external services, as well as the order of calls and the data that was sent and received.

A test may check the internal state of the service as represented by the data the service sent to the test with the testpoint mechanism.

Source code

Testsuite open-source edition code is available here.

Documentation

For full documentation, including installation, tutorials, please see https://yandex.github.io/yandex-taxi-testsuite/.

Running testsuite

self-tests:

pytest3 ./tests

tests of example services:

cd docs/examples && make

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yandex_taxi_testsuite-0.1.39.tar.gz (96.7 kB view details)

Uploaded Source

Built Distribution

yandex_taxi_testsuite-0.1.39-py3-none-any.whl (123.7 kB view details)

Uploaded Python 3

File details

Details for the file yandex_taxi_testsuite-0.1.39.tar.gz.

File metadata

File hashes

Hashes for yandex_taxi_testsuite-0.1.39.tar.gz
Algorithm Hash digest
SHA256 7d5805fc77de73c060e8f696240c81f6f00c082b349eeefddc0ab94a3a666ca3
MD5 9c6d7d47c68d39b05f19ccb313d2a72c
BLAKE2b-256 73ee296836de32c89aba4783f050920d5edfb69c380f2dcf2c54bf06203851eb

See more details on using hashes here.

File details

Details for the file yandex_taxi_testsuite-0.1.39-py3-none-any.whl.

File metadata

File hashes

Hashes for yandex_taxi_testsuite-0.1.39-py3-none-any.whl
Algorithm Hash digest
SHA256 1ab6782fd057fcdb06ceb8bcc850a503b08fde2730763d983165b8a7408358dd
MD5 6a10d8d8bd7fe9d32a6b820f33de016d
BLAKE2b-256 819f96ee19e7726e16c5b3798e39c271ca3b4c41a903fb8e6bf04190b8dcd956

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page