Skip to content

A pytest plugin for posting test reports to google chat

License

Notifications You must be signed in to change notification settings

geokats7/pytest-google-chat

Repository files navigation

pytest-google-chat

PyPI version

Python versions

Notify google chat channel for test results


🧰 Installation

You can install pytest-google-chat via pip from PyPI:

$ pip install pytest-google-chat

📖 Usage

In order to use this plugin, you need to provide the command line flag --google-chat and a valid goggle chat webhook. The webhook, as all the other parameters, can be provided as a command line argument, as a value inside a config file or as an environment variable.

Command line options

Option Description Default value
--google-chat Enable the plugin (required) This doesn't need a value
--gc-webhook The webhook to send notifications to.
Important: Use double or single quotes for the value
None
--report-link The link to the report None
--report-title The title of the report None
--report-subtitle The subtitle of the report None
--gc-fail-image The url of an image to use when the test fails None
--gc-success-image The url of an image to use when the test succeeds None
--gc-config The path to the config file None

Using a config file

[GOOGLE-CHAT]
gc_webhook=https://chat.googleapis.com/v1/spaces/AAAA7GkHUoE/messages?key=XXXX&token=YYYY
report_link=https://link.to.report
report_title=My Report
report_subtitle=My Report Subtitle
gc_fail_image=https://link.to.image
gc_success_image=https://link.to.image

Using environment variables:

REPORT_TITLE="My Report" pytest --google-chat --gc-webhook=https://....

NOTE All previous methods can be used combined. The order of precedence is: command line options > config file > environment variable.

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 MIT license, "pytest-google-chat" is free and open source software.

Issues

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


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

About

A pytest plugin for posting test reports to google chat

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages