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',
                           #... )

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

th2-common-utils-1.0.0.dev1937339442.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file th2-common-utils-1.0.0.dev1937339442.tar.gz.

File metadata

  • Download URL: th2-common-utils-1.0.0.dev1937339442.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for th2-common-utils-1.0.0.dev1937339442.tar.gz
Algorithm Hash digest
SHA256 d4bc49f2a6f89ecb2bdf1efd5f9113a6fe032c480ae2e835a4c74a8c3221611d
MD5 c92c099232cf255cc733af97a5eec098
BLAKE2b-256 0d387e72aa58bdf4728b0a99966df699d99fe789f5b4036f9d03c3a8609c2ec2

See more details on using hashes here.

File details

Details for the file th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl.

File metadata

  • Download URL: th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl
  • Upload date:
  • Size: 18.0 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for th2_common_utils-1.0.0.dev1937339442-py3-none-any.whl
Algorithm Hash digest
SHA256 21fd393a9a8ff6ab8a0bc93f03595aef67daba50a2043c1d6a117cbd646962e8
MD5 ae4af8a804bad7386c84714bfc5e9d60
BLAKE2b-256 7dd2b11f2c3db64f96e47fab8076cc35030b6f325ea4d0cb66506493b168cd0b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page