Metadata-Version: 2.1
Name: pytest-mh
Version: 1.0.4
Summary: Pytest multihost plugin
Project-URL: Homepage, https://github.com/next-actions/pytest-mh
Project-URL: Bug Tracker, https://github.com/next-actions/pytest-mh/issues
Author-email: Pavel Březina <pbrezina@redhat.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: colorama
Requires-Dist: parallel-ssh
Requires-Dist: pytest
Requires-Dist: pyyaml
Description-Content-Type: text/markdown

# pytest_mh - pytest multihost test framework

`pytest-mh` is a pytest plugin that, in its basics, allows you to run shell
commands and scripts over SSH on remote Linux or Windows hosts. You want to use
it to execute system or application tests for your project on remote host or
hosts (or containers) while running pytest locally and thus keeping your local
machine intact.

The plugin also provides building blocks that can be used to setup and teardown
your tests, perform automatic clean up of all changes done on the remote host
and build a flexible and unified high-level API to manipulate the hosts from
your tests.

## Documentation

**See the full documentation here: https://pytest-mh.readthedocs.io.**

## Example usage

The following snippet was taken from the [SSSD](https://github.com/SSSD/sssd)
project.

```python
    @pytest.mark.topology(KnownTopology.AD)
    @pytest.mark.topology(KnownTopology.LDAP)
    @pytest.mark.topology(KnownTopology.IPA)
    @pytest.mark.topology(KnownTopology.Samba)
    def test__id(client: Client, provider: GenericProvider):
        u = provider.user("tuser").add()
        provider.group("tgroup_1").add().add_member(u)
        provider.group("tgroup_2").add().add_member(u)

        client.sssd.start()
        result = client.tools.id("tuser")

        assert result is not None
        assert result.user.name == "tuser"
        assert result.memberof(["tgroup_1", "tgroup_2"])
```