Skip to main content
Incomplete provenance

3 of 9 release files were uploaded without provenance metadata. View details.

GL Observability Masking

gl-observability-masking is a shared helper library for masking components designed for use by GLLM Core and GL Observability. It provides reusable rules and text masking primitives so the two libraries can share masking behavior without depending on each other.

For application developers: use GLLM Core or GL Observability. This package is a supporting dependency and is not intended to be installed or used directly in applications.

Key Features

  • Shared rule catalog: 28 built-in rules for credentials, tokens, and personal data.
  • Reusable masking primitives: immutable rule definitions, compiled patterns, and ordered text substitution with [NAME] placeholders.
  • Common failure vocabulary: rule-specific errors and failure modes for the consuming libraries.
  • No runtime dependencies: uses only the Python standard library and supports Python 3.11–3.13.
  • No logging side effects: emits no logs, avoiding feedback loops when called by logging components.

Installation

Prerequisites

Installation from PyPI

Install the released binary distribution using one of these package managers:

Using pip

pip install gl-observability-masking-binary

Using uv

uv add gl-observability-masking-binary

Using Poetry

poetry add gl-observability-masking-binary

The distribution name is gl-observability-masking-binary; the Python import name is gl_observability_masking. No runtime extras are required.

Development Installation (Git)

To work on the library's source code:

git clone git@github.com:GDP-ADMIN/gl-sdk.git
cd gl-sdk/libs/gl-observability-masking
uv sync --all-extras

The dev extra installs the testing, linting, and type-checking tools. Consuming libraries should depend on released distributions rather than this development checkout.

Shared Components

The following components are provided for maintainers integrating this package into GLLM Core and GL Observability:

Purpose Components
Define and select rules MaskingRule, BuiltInMaskingRule
Compile rules and mask strings CompiledMaskingRule, mask_text
Identify substitution failures MaskingRuleError
Express failure behavior MaskingMode

Each consumer or application selects its rules and their order. This package provides no ordered rule list or default rule set and operates only on strings. Consuming libraries define their own failure marker, policy, value traversal, and failure handling. mask_text applies the supplied rules sequentially and raises MaskingRuleError on substitution failure; it does not apply a failure mode itself.

For example, a consumer can explicitly select email and mobile masking:

from gl_observability_masking import BuiltInMaskingRule, CompiledMaskingRule, mask_text

rules = tuple(
    CompiledMaskingRule.from_masking_rule(rule) for rule in (BuiltInMaskingRule.EMAIL, BuiltInMaskingRule.ID_MOBILE)
)
print(mask_text("Contact alice@example.com at +6281234567890", rules))
# Contact [EMAIL] at [ID_MOBILE]

Each rule processes the previous rule's output. Order can change the placeholder or leave part of a sensitive value visible:

  • Select ID_NPWP before IPV4: the reverse order turns 01.234.567.8-901.000 into [IPV4]-901.000.
  • Select CONN_STRING_CREDS before EMAIL: the reverse order leaves the connection string's user name visible.
  • Select BEARER_TOKEN before JWT to replace a bearer JWT with one placeholder; the reverse order produces Bearer [JWT].

mask_text follows the caller's order without validating or rearranging it.

Regex masking is a safety net, not a guarantee that every sensitive value is removed. Rules can over-match ordinary values: CARD_LIKE_LUHN does not perform a Luhn check and can match numeric timestamps, while IPV4 can match four-part version numbers. ID_MOBILE handles contiguous digits, not phone numbers with spaces or dashes. FAIL_OPEN exposes the original unmasked value and is intended for non-production use.

Local Development

These commands are for contributors working on this helper library. Run them from the library directory with Python 3.11–3.13 and uv installed:

uv sync --all-extras
uv run python -m pytest
uv run ruff check .
uv run ruff format --check .
uv run mypy gl_observability_masking

Metadata

Release files for gl-observability-masking-binary 0.1.0.post1

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

Incomplete provenance

3 of 9 files were uploaded without provenance metadata.

We recommend further investigation before installing these files. View details.

Built distributions (wheels)

Table of built distributions (wheels) for gl-observability-masking-binary 0.1.0.post1
File Actions
gl_observability_masking_binary-0.1.0.post1-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp313-cp313-win_amd64.whl
gl_observability_masking_binary-0.1.0.post1-cp313-cp313-manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp313-cp313-manylinux_2_28_x86_64.whl
gl_observability_masking_binary-0.1.0.post1-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.1.0.post1-cp313-cp313-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.1.0.post1-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp312-cp312-win_amd64.whl
gl_observability_masking_binary-0.1.0.post1-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp312-cp312-manylinux_2_28_x86_64.whl
gl_observability_masking_binary-0.1.0.post1-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.1.0.post1-cp312-cp312-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.1.0.post1-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp311-cp311-win_amd64.whl
gl_observability_masking_binary-0.1.0.post1-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details for gl_observability_masking_binary-0.1.0.post1-cp311-cp311-manylinux_2_28_x86_64.whl
gl_observability_masking_binary-0.1.0.post1-cp311-cp311-macosx_13_0_arm64.whl CPython 3.11 CPython 3.11 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.1.0.post1-cp311-cp311-macosx_13_0_arm64.whl

Total release size: 1.7 MB

Release files / gl_observability_masking_binary-0.1.0.post1-cp313-cp313-win_amd64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp313-cp313-win_amd64.whl
Size 135.5 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
a0e81cba5e7de21123961ed152d18852d7be0517024c6e9a33cb5fe3b261f66a
BLAKE2b-256 checksum
How to use checksums
595ed4b3894e8eb6955529b2b3ad995c9817083b3560697e5a193765ee730467
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0.post1-cp313-cp313-manylinux_2_28_x86_64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while other files in this release have provenance metadata, this file does not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp313-cp313-manylinux_2_28_x86_64.whl
Size 317.7 kB
Tags CPython 3.13 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
a23fb65b40c12bca3e989f9c95c8a6c2392edc7262e39ecadf8d322549056c83
BLAKE2b-256 checksum
How to use checksums
b18be1d5ebede81ee23e9b0c3034ede50cfc65af95ac4916a12cdc15e0322432
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"AlmaLinux","version":"8.10","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / gl_observability_masking_binary-0.1.0.post1-cp313-cp313-macosx_13_0_arm64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp313-cp313-macosx_13_0_arm64.whl
Size 131.2 kB
Tags CPython 3.13 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
f860f2e1894533ecee78c0796aeacd0ef87544a8c96f7254683d2ee092018301
BLAKE2b-256 checksum
How to use checksums
ddfe50d630d7b1a9c58cea7e50ea1f21d3a24d4e4932b7ef95886b464559e7bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0.post1-cp312-cp312-win_amd64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp312-cp312-win_amd64.whl
Size 136.6 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
740a86660339e804dc114dde4fc251594e3c8f75ddaf96d55e1a8d67aff594b3
BLAKE2b-256 checksum
How to use checksums
f5d9187e282a7697959345f998a58d55bcfa882ffb9f951f7e77e86162624180
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0.post1-cp312-cp312-manylinux_2_28_x86_64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while other files in this release have provenance metadata, this file does not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp312-cp312-manylinux_2_28_x86_64.whl
Size 316.0 kB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
456afd8a88eebe0a99593af670cf353f8aca2f0d510647e736a4f62a6d33b887
BLAKE2b-256 checksum
How to use checksums
fd70122a281c92003e700394e5c8f2c76bcbe5009d9a87d40ca1721dd1264b97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"AlmaLinux","version":"8.10","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / gl_observability_masking_binary-0.1.0.post1-cp312-cp312-macosx_13_0_arm64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp312-cp312-macosx_13_0_arm64.whl
Size 131.0 kB
Tags CPython 3.12 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
903792f3174a02e9508f67ef39b8f3af2e71cb42c79dc52aa594d8e4d59f3515
BLAKE2b-256 checksum
How to use checksums
5f5750431759761956f45beca8a31a0dc103ab9db2acd0a3a6fa4113d3b664db
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0.post1-cp311-cp311-win_amd64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp311-cp311-win_amd64.whl
Size 136.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
7b78ade47bf124a49977763bb6cc36ed26297548df208d28f55d4b15688bd4a9
BLAKE2b-256 checksum
How to use checksums
2c9c0acef79716829c8f56e50b2548a8c4806bb1fd5edb922ce0d419ac1c11d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0.post1-cp311-cp311-manylinux_2_28_x86_64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while other files in this release have provenance metadata, this file does not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp311-cp311-manylinux_2_28_x86_64.whl
Size 288.6 kB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
c6d389f875a73a81e50568475e05254b64054ae8bea0274a18b206bf6465fc7f
BLAKE2b-256 checksum
How to use checksums
8e23f1a9dd08f46f5f4e7eeaababd32e8cb1441ac40f9f864898e1ae52d1daa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"AlmaLinux","version":"8.10","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / gl_observability_masking_binary-0.1.0.post1-cp311-cp311-macosx_13_0_arm64.whl

Incomplete provenance

This file belongs to a release with incomplete provenance: while this file has provenance metadata, other files in this release do not.

We recommend further investigation before installing this file. View details.

Download URL gl_observability_masking_binary-0.1.0.post1-cp311-cp311-macosx_13_0_arm64.whl
Size 131.0 kB
Tags CPython 3.11 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
4d8a1b9c6e429ec5bae6410830fdd36ea0c448fe376f83bff2691f0fac2b0dc0
BLAKE2b-256 checksum
How to use checksums
1f974e248cd5a25f254560d03a95da6bdc55930a629c4d33873a71170964ed33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Security for gl-observability-masking-binary 0.1.0.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Incomplete provenance

3 of 9 release files were uploaded without provenance metadata.

Files with provenance 6 / 9
Files without provenance 3 / 9
Select from 9 files

Attestation for gl_observability_masking_binary-0.1.0.post1-cp313-cp313-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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