Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

th2-common-utils-py

Python library with useful functions for developers and QA needs.

Installation

pip install th2-common-utils

Usage

1. Message fields access

The library provides a convenient way for Message fields access.

Instead of this:

msg.fields['BO5Items'].list_value.values[0].message_value.fields['segment_instance_number'].message_value.fields['segment_number'].simple_value

You can do this:

import th2_common_utils

msg['BO5Items'][0]['segment_instance_number']['segment_number']

2. Converters

  • message_to_dict(message) - note, you will lose all metadata of the Message.
  • dict_to_message(fields, session_alias, message_type) - where:
    • fields - required argument - message fields as a python dict;
    • session_alias and message_type - optional arguments - used to generate message metadata.
  • dict_to_root_message_filter(message_type, message_filter, metadata_filter, ignore_fields, check_repeating_group_order, time_precision, decimal_precision) - all arguments are optional.
  • message_to_typed_message(message, message_type) - where:
    • message - Message object;
    • message_type - TypedMessage class object.
  • message_to_table(message) - where:
    • message - Message object or dict.

To import functions above:

from th2_common_utils import message_to_dict, dict_to_message # ...

3. Working with events

th2-common-utils provides the class to work with events - EventUtils.

Methods of EventUtils class:

  • create_event_body(component) - creates event body from component as bytes.
  • create_event_id() - creates EventID.
  • create_event(id, parent_id, start_timestamp, end_timestamp, status, name, type, body, attached_message_ids) - creates event; all arguments are optional.

To use functions above:

from th2_common_utils import EventUtils as eu

my_event = eu.create_event(id=eu.create_event_id,
                           name='My event',
                           #... )

Metadata

Release files for th2-common-utils 1.0.0.dev1937339442

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

Source distribution (sdist)

Source distribution for th2-common-utils 1.0.0.dev1937339442
File Size Uploaded
th2-common-utils-1.0.0.dev1937339442.tar.gz 10.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for th2-common-utils 1.0.0.dev1937339442
File Interpreter ABI Platform
th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl Python 3 none any Details

Total release size: 28.8 kB

Release files / th2-common-utils-1.0.0.dev1937339442.tar.gz

Download URL th2-common-utils-1.0.0.dev1937339442.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
d4bc49f2a6f89ecb2bdf1efd5f9113a6fe032c480ae2e835a4c74a8c3221611d
BLAKE2b-256 checksum
How to use checksums
0d387e72aa58bdf4728b0a99966df699d99fe789f5b4036f9d03c3a8609c2ec2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

Release files / th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl

Download URL th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl
Size 18.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21fd393a9a8ff6ab8a0bc93f03595aef67daba50a2043c1d6a117cbd646962e8
BLAKE2b-256 checksum
How to use checksums
7dd2b11f2c3db64f96e47fab8076cc35030b6f325ea4d0cb66506493b168cd0b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

Release history Release notifications | RSS feed

2.2.0

2 release files

2.1.0

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.6.3

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

This release
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