pytest-pypom-navigation

======================= pytest-pypom-navigation

.. image:: https://travis-ci.org/davidemoro/pytest-pypom-navigation.svg?branch=develop :target: https://travis-ci.org/davidemoro/pytest-pypom-navigation :alt: See Build Status on Travis CI

.. image:: https://readthedocs.org/projects/pytest-pypom-navigation/badge/?version=latest :target: http://pytest-pypom-navigation.readthedocs.io

.. image:: https://codecov.io/gh/davidemoro/pytest-pypom-navigation/branch/develop/graph/badge.svg :target: https://codecov.io/gh/davidemoro/pytest-pypom-navigation

.. image:: https://pyup.io/repos/github/davidemoro/pytest-pypom-navigation/python-3-shield.svg :target: https://pyup.io/repos/github/davidemoro/pytest-pypom-navigation/ :alt: Python 3

Core engine for cookiecutter QA package

This Pytest_ plugin was generated with Cookiecutter_ along with @hackebrot's Cookiecutter-pytest-plugin template.

Features

pytest-pypom-navigation is not intended to be used as a standalone package.

It provides the core engine (pytest fixtures) needed by the strong opinionated scaffolding solution called cookiecutter-qa_ that let you generate a fully working QA testing hello world project based on Selenium/Splinter with just one command.

It is also used by the pytest-play_ engine for collecting variables for tests parametrization.

Tests

You can run "pytest-pypom-navigation" tests via tox_::

$ pip install tox
$ tox -epy36

Contributing

Contributions are very welcome. Tests can be run with tox_, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the Apache Software License 2.0_ license, "pytest-pypom-navigation" is free and open source software

Issues

If you encounter any problems, please file an issue_ along with a detailed description.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _@hackebrot: https://github.com/hackebrot .. _MIT: http://opensource.org/licenses/MIT .. _BSD-3: http://opensource.org/licenses/BSD-3-Clause .. _GNU GPL v3.0: http://www.gnu.org/licenses/gpl-3.0.txt .. _Apache Software License 2.0: http://www.apache.org/licenses/LICENSE-2.0 .. _cookiecutter-pytest-plugin: https://github.com/pytest-dev/cookiecutter-pytest-plugin .. _file an issue: https://github.com/davidemoro/pytest-pypom-navigation/issues .. _pytest: https://github.com/pytest-dev/pytest .. _tox: https://tox.readthedocs.io/en/latest/ .. _pip: https://pypi.python.org/pypi/pip/ .. _PyPI: https://pypi.python.org/pypi .. _cookiecutter-qa: https://github.com/davidemoro/cookiecutter-qa .. _pytest-play: https://github.com/davidemoro/pytest-play

Changelog

2.0.3 (2019-01-17)

• remove pytest 4.0 deprecation get_marker (still compatible with old versions)

• removed internal component parametrizer, use external parametrizer.Parametrizer now

2.0.2 (2018-04-01)

• make credentials and base url variables optional

2.0.1 (2018-01-03)

• fix get_page_instance (missing page kwargs before page construction)

2.0.0 (2018-01-02)

• navigation will no more be initialized automatically with an open browser by default since pypom_navigation is used by third party plugins even for non UI plugins. This way we avoid to open a browser if it is not needed and explicitly requested with a set page or visit page

• you can override the default page timeout using a pytest-variables configuration named default_timeout

• add new method get_page_instance on navigation

1.0.0 (2017-12-19)

• navigation initialized with kwargs (including variables coming from pytest variables too)

• add global timeout for all pages (default 10)

• base_page fixture no longer opens page by default. It's up to you visiting a page now

0.1.1 (2017-10-30)

• support fallback page classes in action_performed

0.1.0 (2017-10-12)

• Add update_page and action_performed methods on navigation.
• Wait for pages to load when visiting them.

0.0.1 (2017-06-13)

• First release