{"author":"Anatoly Bubenkov, Paylogic International and others","author_email":"bubenkoff@gmail.com","bugtrack_url":null,"classifiers":["Development Status :: 6 - Mature","Intended Audience :: Developers","License :: OSI Approved :: MIT License","Operating System :: MacOS :: MacOS X","Operating System :: Microsoft :: Windows","Operating System :: POSIX","Programming Language :: Python :: 2","Programming Language :: Python :: 2.7","Programming Language :: Python :: 3","Programming Language :: Python :: 3.4","Programming Language :: Python :: 3.5","Programming Language :: Python :: 3.6","Programming Language :: Python :: 3.7","Topic :: Software Development :: Libraries","Topic :: Software Development :: Testing","Topic :: Utilities"],"description":"Services plugin for pytest testing framework\n============================================\n\n.. image:: https://img.shields.io/pypi/v/pytest-services.svg\n :target: https://pypi.python.org/pypi/pytest-services\n.. image:: https://img.shields.io/pypi/pyversions/pytest-services.svg\n :target: https://pypi.python.org/pypi/pytest-services\n.. image:: https://img.shields.io/coveralls/pytest-dev/pytest-services/master.svg\n :target: https://coveralls.io/r/pytest-dev/pytest-services\n.. image:: https://travis-ci.org/pytest-dev/pytest-services.svg?branch=master\n :target: https://travis-ci.org/pytest-dev/pytest-services\n.. image:: https://readthedocs.org/projects/pytest-services/badge/?version=latest\n :target: https://readthedocs.org/projects/pytest-services/?badge=latest\n :alt: Documentation Status\n\nInstall pytest-services\n-----------------------\n\n::\n\n pip install pytest-services\n\n\n.. _pytest: http://pytest.org\n.. _pytest-xdist: https://pypi.python.org/pypi/pytest-xdist\n.. _pytest-splinter: https://pypi.python.org/pypi/pytest-splinter\n.. _pytest-bdd: https://pypi.python.org/pypi/pytest-bdd\n.. _pytest-django: https://pypi.python.org/pypi/pytest-django\n.. _memcached: http://memcached.org\n.. _xvfb: http://en.wikipedia.org/wiki/Xvfb\n.. _mysql-server: http://dev.mysql.com/\n\nFeatures\n--------\n\nThe plugin provides a set of fixtures and utility functions to start service processes for your tests with\npytest_\n\n\nFixtures\n--------\n\n* run_services\n Determines whether services should be run or not. False by default if not in distributed environment\n (without pytest-xdist_). Can be manually set to True by overriding this fixture in your test config or\n just by using `--run-services` command line argument (see below).\n\nInfrastructure fixtures\n***********************\n\n* worker_id\n Id of the worker if tests are run using pytest-xdist_. It is set to `local` if tests are not run using\n pytest-xdist_ (with `--dist` command line option set to `load`).\n Has a deprecated alias ``slave_id`` which will be removed in a future version.\n* session_id\n Test session id. Globally unique, and of course also guaranteed to be different for potentially multiple test\n sessions running on same test node via pytest-xdist_.\n* watcher_getter\n Function to instantiate test service watcher (popen object). Includes automatic finalization (exiting) of the\n service process, and testing the service before returning the watcher from the function.\n Example of usage for memcached service:\n\n.. code-block:: python\n\n @pytest.fixture(scope='session')\n def memcached(request, run_services, memcached_socket, watcher_getter):\n \"\"\"The memcached instance which is ready to be used by the tests.\"\"\"\n if run_services:\n return watcher_getter(\n name='memcached',\n arguments=['-s', memcached_socket],\n checker=lambda: os.path.exists(memcached_socket),\n # Needed for the correct execution order of finalizers\n request=request,\n )\n\n* services_log\n Logger used for debug logging when managing test services.\n* root_dir\n Parent directory for test service artifacts (disk based). Set to `/tmp` by default.\n* base_dir\n Base directory for test service artifacts (disk based), unique subdirectory of `root_dir`.\n Automatically removed recursively at the end of the test session.\n* temp_dir\n `Temporary` directory (disk based), subfolder of the `base_dir`.\n Used for strictly temporary artifacts (for example - folder where files are uploaded from the user input).\n* memory_root_dir\n Parent directory for test service artifacts (memory based). Main idea of having memory base directory is to\n store performance-critical files there. For example - mysql service will use it to store database file, it speeds up\n mysql server a lot, especially database management operations.\n Set to `/var/shm` by default, with a fallback to 'root_dir`. Note that if apparmor is running on your system, most\n likely it will prevent your test service to use it (for example - mysql has it's apparmor profile). You you'll need\n to disable such profile in apparmor configuration.\n Example of disabling apparmor for mysqld:\n\n.. code-block:: sh\n\n sudo ln -s /etc/apparmor.d/usr.sbin.mysqld /etc/apparmor.d/disable/\n sudo /etc/init.d/apparmor restart\n\n* memory_base_dir\n Base directory for test service artifacts (memory based), unique subdirectory of `memory_root_dir`.\n Automatically removed recursively at the end of the test session.\n* memory_temp_dir\n `Temporary` directory (memory based), subfolder of the `base_dir`.\n* lock_dir\n Lock files directory for storing locks created for resource assignment (ports, display, etc). Subfolder of\n `memory_root_dir`.\n* run_dir\n Process id and socket files directory (like system-wide `/var/run` but local for test session). Subfolder of\n `memory_root_dir`.\n* port_getter\n Function to get unallocated port.\n Automatically ensures locking and un-locking of it on application level via flock.\n* display_getter\n Function to get unallocated display.\n Automatically ensures locking and un-locking of it on application level via flock.\n* lock_resource_timeout\n Used in function lock_resource.\n A maximum of total sleep between attempts to lock resource.\n\nService fixtures\n****************\n\n* memcached\n Start memcached_ instance.\n Requires `pylibmc` installed or `memcache` indicated as an extra (`pip install 'pytest-services[memcached]'`).\n* memcached_socket\n Memcached unix socket file name to be used for connection.\n* memcached_connection\n Memcached connection string.\n* do_memcached_clean\n Determine if memcached should be cleared before every test run. Equals to `run_services` fixture by default.\n Requires `pylibmc` installed or `memcache` indicated as an extra (`pip install 'pytest-services[memcached]'`).\n* memcached_client\n A pylibmc.Client instance bound to the service.\n Requires `pylibmc` installed or `memcache` indicated as an extra (`pip install 'pytest-services[memcached]'`).\n* mysql\n Start mysql-server_ instance.\n* mysql_database_name\n MySQL database name to be created after initialization of the mysql service `system` database.\n* mysql_database_getter\n Function with single parameter - database name. To create additional database(s) for tests.\n Used in `mysql_database` fixture which is used by `mysql` one.\n* mysql_connection\n MySQL connection string.\n* xvfb\n Start xvfb_ instance.\n* xvfb_display\n Xvfb display to use for connection.\n* xvfb_resolution\n Xvfb display resolution to use. Tuple in form `(1366, 768, 8)`.\n\nUtility functions\n*****************\n\nDjango settings\n^^^^^^^^^^^^^^^\n\nIn some cases, there's a need of switching django settings during test run, because several django projects are tested\nwhithin the single test suite.\n`pytest_services.django_settings` simplifies switching of django settings to a single function call:\n\n* setup_django_settings\n Override the enviroment variable and call the _setup method of the settings object to reload them.\n\nExample of usage:\n\nconftest.py:\n\n.. code-block:: python\n\n from pytest_services import django_settings\n\n django_settings.clean_django_settings()\n django_settings.setup_django_settings('your.project.settings')\n\nNote that the nice project pytest-django_ doesn't help with the situation, as it's single django project oriented, as\nwell as standard django testing technique. Single project approach works fine, as long as there are no fixtures to share\nbetween them, but when there are fixtures to share, then you can get benefit of joining several django projects tests\ninto a single test run, because all session-scoped fixtures will be instantiated only once for all projects tests.\nThe benefit is only visible if you have big enough test suite and your fixtures are heavy enough.\n\n\nCommand-line options\n--------------------\n\n* `--run-services`\n Force services to be run even if tests are executed in a non-distributed way (without pytest-xdist_).\n* `--xvfb-display`\n Skip xvfb service to run and use provided display. Useful when you need to run all services except the xvfb_\n to debug your browser tests, if, for example you use pytest-splinter_ with or without pytest-bdd_.\n\nExample\n-------\n\ntest_your_test.py:\n\n.. code-block:: python\n\n import MySQLdb\n\n\n def test_some_mysql_stuff(mysql):\n \"\"\"Test using mysql server.\"\"\"\n conn = MySQLdb.connect(user='root')\n\n\nContact\n-------\n\nIf you have questions, bug reports, suggestions, etc. please create an issue on\nthe `GitHub project page `_.\n\n\nLicense\n-------\n\nThis software is licensed under the `MIT license `_\n\nSee `License file `_\n\n\n© 2014 Anatoly Bubenkov, Paylogic International and others.\n\nAuthors\n=======\n\n`Anatoly Bubenkov `_\n idea and implementation\n\nThese people have contributed to `pytest-services`, in alphabetical order:\n\n* `Alessio Bogon `_\n* `Dmitrijs Milajevs `_\n* `Jason R. Coombs `_\n* `Joep van Dijken `_\n* `Magnus Staberg `_\n* `Michael Shriver `_\n* `Oleg Pidsadnyi `_\n* `Zac Hatfield-Dodds `_\n\nChangelog\n=========\n\n2.2.1\n-----\n\n- #42: Retry on ``zc.lockfile.LockError`` in ``file_lock``, use existing timeout kwarg (mshriver)\n\n2.2.0\n-----\n\n- #38: Retry to lock resource if zc.lockfile.LockError is raised. Fix needed for pytest-xdist. (StabbarN)\n\n2.1.0\n-----\n\n- #34: Deprecated ``slave_id`` fixture in favor of ``worker_id``,\n for compatibility with ``pytest-xdist`` 2.\n\n2.0.1\n-----\n\n- #20: Added workaround for issue with SysLogHandler.\n\n2.0.0\n-----\n\n- #23: Rely on ``zc.lockfile`` for lockfile behavior.\n- #28: Fixtures now supports later versions of mysql and no longer\n support versions of mysql prior to ``mysql --initialize`` support.\n- #29: Fix issues with later versions of mysql where ``mysql_defaults_file``\n fixture would prevent startup of mysql.\n- Fixed issue in test suite where mysql fixture was not tested.\n- Removed ``pytest_services.locks.lock_file``.\n\n1.3.1\n-----\n\n- Fix race condition causing when using port_getter/display_getter (youtux)\n\n\n1.3.0\n-----\n\n- Add `request` param to watcher_getter to have proper execution order\n of finalizers (youtux).\n\n1.2.1\n-----\n\n- Swap kill and terminate in watcher_getter finalization, allowing\n for a more polite SIGTERM for terminating child procs on Unix. See\n #15 for details (jaraco)\n\n1.2.0\n-----\n\n- Make pylibmc an optional dependency, available as an extra (jaraco)\n\n1.1.15\n------\n\n- Fixed hang with updated netcat-openbsd>=1.130.3 (joepvandijken)\n\n1.1.14\n------\n\n- Use a different strategy to determine whether xvfb supports (youtux )\n\n1.1.12\n------\n\n- use realpath for mysql base dir (bubenkoff)\n\n1.1.11\n------\n\n- exclude locked displays for xvfb (bubenkoff)\n\n1.1.7\n-----\n\n- django settings fix (olegpidsadnyi)\n\n1.1.3\n-----\n\n- django 1.8 support (bubenkoff)\n\n1.1.2\n-----\n\n- old django support fix (olegpidsadnyi)\n\n1.1.0\n-----\n\n- django 1.7+ support (bubenkoff)\n\n1.0.10\n------\n\n- removed auto artifacts cleanup (bubenkoff)\n\n1.0.8\n-----\n\n- fixed popen arguments (bubenkoff)\n\n1.0.2\n-----\n\n- added port and display getters (bubenkoff)\n\n1.0.1\n-----\n\n- Improved documentation (bubenkoff)\n\n1.0.0\n-----\n\n- Initial public release\n","description_content_type":"","docs_url":null,"download_url":"","downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":"https://github.com/pytest-dev/pytest-services","keywords":"","license":"MIT license","license_expression":null,"license_files":null,"maintainer":"","maintainer_email":"","name":"pytest-services","package_url":"https://pypi.org/project/pytest-services/","platform":"","project_url":"https://pypi.org/project/pytest-services/","project_urls":{"Homepage":"https://github.com/pytest-dev/pytest-services"},"provides_extra":null,"release_url":"https://pypi.org/project/pytest-services/2.2.1/","requires_dist":null,"requires_python":"","summary":"Services plugin for pytest testing framework","version":"2.2.1","yanked":false,"yanked_reason":null}

Package search

pytest-services

project_urls

Dependencies

All package metadata

Releases