Skip to main content

Allure Common API

Release Status Downloads

The package contains classes and functions for users of Allure Report. It can be used to enhance reports using an existing Allure adapter or to create new adapters.

Allure Report logo


User's API

Install an adapter that suits your test framework. You can then add more information to the report by using functions from the allure module.

Decorators API

Use these functions as decorators of your own functions, e.g.:

import allure

@allure.title("My test")
def test_fn():
    pass

The full list of decorators:

  • allure.title
  • allure.description
  • allure.description_html
  • allure.label
  • allure.severity
  • allure.epic
  • allure.feature
  • allure.story
  • allure.suite
  • allure.parent_suite
  • allure.sub_suite
  • allure.tag
  • allure.id
  • allure.manual
  • allure.link
  • allure.issue
  • allure.testcase
  • allure.step

Refer to the adapter's documentation for the information about what decorators are supported and what functions they can be applied to.

Runtime API

Most of the functions of Runtime API can be accessed via allure.dynamic.*. Call them at runtime from your code.

The full list includes:

  • allure.dynamic.title
  • allure.dynamic.description
  • allure.dynamic.description_html
  • allure.dynamic.label
  • allure.dynamic.severity
  • allure.dynamic.epic
  • allure.dynamic.feature
  • allure.dynamic.story
  • allure.dynamic.suite
  • allure.dynamic.parent_suite
  • allure.dynamic.sub_suite
  • allure.dynamic.tag
  • allure.dynamic.id
  • allure.dynamic.manual
  • allure.dynamic.link
  • allure.dynamic.issue
  • allure.dynamic.testcase
  • allure.dynamic.parameter
  • allure.attach
  • allure.attach.file
  • allure.step

Refer to the adapter's documentation for the information about what functions are supported and where you can use them.

Adapter API

You may use allure-pytest-commons to build your own Allure adapter. The key elements of the corresponding API are:

  • allure_python_commons.model2: the object model of Allure Report.
  • allure_python_commons.logger: classes that are used to emit Allure Report objects (tests, containers, attachments):
    • AllureFileLogger: emits to the file system.
    • AllureMemoryLogger: collects the objects in memory. Useful for testing.
  • allure_python_commons.lifecycle.AllureLifecycle: an implementation of Allure lifecycle that doesn't isolate the state between threads.
  • allure_python_commons.reporter.AllureReporter: an implementation of Allure lifecycle that supports some multithreaded scenarios.

A new version of the API is likely to be released in the future as we need a decent support for multithreaded and async-based concurrency (see here and here).

Release files for allure-python-commons 2.16.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for allure-python-commons 2.16.1
File Size Uploaded
allure_python_commons-2.16.1.tar.gz 15.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for allure-python-commons 2.16.1
File Interpreter ABI Platform
allure_python_commons-2.16.1-py3-none-any.whl Python 3 none any Details

Total release size: 32.7 kB

Release files / allure_python_commons-2.16.1.tar.gz

Download URL allure_python_commons-2.16.1.tar.gz
Size 15.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3bfb00982a17dd325581f7ca7ebc142d4e3ba2a001ba1f800c2d4e69ddf54a82
BLAKE2b-256 checksum
How to use checksums
1706bad27c0d10d9c7f03b40bcf85d7d56e098a44b4de13e7fed177fdf528f89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / allure_python_commons-2.16.1-py3-none-any.whl

Download URL allure_python_commons-2.16.1-py3-none-any.whl
Size 16.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bcc9698e3df33bcc83ab9df276c4e17c8f8007837e216b17bc9b0385043d00c2
BLAKE2b-256 checksum
How to use checksums
45538e55e46cf7f90a0e7a2c3938fa17563e6d6539ce268344c217f7638377b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

2.16.1 This release

2 release files

2.16.0

2 release files

2.15.3

2 release files

2.15.2

2 release files

2.15.1

2 release files

2.15.0

2 release files

2.14.1

2 release files

2.13.4

2 release files

2.13.3

2 release files

2.13.2

2 release files

2.13.1

2 release files

2.12.0

2 release files

2.11.1

2 release files

2.10.0

2 release files

2.9.45

2 release files

2.9.44

2 release files

2.9.42

2 release files

2.9.41

2 release files

2.8.40

2 release files

2.8.34

2 release files

2.8.32

2 release files

2.8.31

2 release files

2.8.30

2 release files

2.8.29

2 release files

2.8.22

2 release files

2.8.21

2 release files

2.8.20

2 release files

2.8.19

2 release files

2.8.18

2 release files

2.8.17

2 release files

2.8.16

2 release files

2.8.15

2 release files

2.8.14

2 release files

2.8.12

2 release files

2.8.11

2 release files

2.8.10

2 release files

2.8.9

2 release files

2.8.7

2 release files

2.8.6

2 release files

2.8.5

2 release files

2.8.4

2 release files

2.8.3

2 release files

2.8.2

2 release files

2.8.1

2 release files

2.8.0

2 release files

2.7.1

2 release files

2.7.0

2 release files

2.6.5

2 release files

2.6.4

2 release files

2.6.3

2 release files

2.6.2

2 release files

2.6.1

2 release files

2.6.0

2 release files

2.5.5

2 release files

2.5.4

2 release files

2.5.3

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.1

2 release files

2.4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page