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

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
File Actions
gl_observability_masking_binary-0.1.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for gl_observability_masking_binary-0.1.0-cp313-cp313-win_amd64.whl
gl_observability_masking_binary-0.1.0-cp313-cp313-manylinux_2_31_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.31+ x86-64 Details for gl_observability_masking_binary-0.1.0-cp313-cp313-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.1.0-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-cp313-cp313-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.1.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for gl_observability_masking_binary-0.1.0-cp312-cp312-win_amd64.whl
gl_observability_masking_binary-0.1.0-cp312-cp312-manylinux_2_31_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.31+ x86-64 Details for gl_observability_masking_binary-0.1.0-cp312-cp312-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.1.0-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-cp312-cp312-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.1.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for gl_observability_masking_binary-0.1.0-cp311-cp311-win_amd64.whl
gl_observability_masking_binary-0.1.0-cp311-cp311-manylinux_2_31_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.31+ x86-64 Details for gl_observability_masking_binary-0.1.0-cp311-cp311-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.1.0-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-cp311-cp311-macosx_13_0_arm64.whl

Total release size: 1.7 MB

Release files / gl_observability_masking_binary-0.1.0-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-cp313-cp313-win_amd64.whl
Size 135.4 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
a11e38013f035d868cbfa57ae1091f2f2fbe2c245d5043ba8971681337b2a2c0
BLAKE2b-256 checksum
How to use checksums
9df9b777791772a2b2b5a834d2daff8d1d3f8a15af9b38f4ece428dd2a787453
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0-cp313-cp313-manylinux_2_31_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-cp313-cp313-manylinux_2_31_x86_64.whl
Size 320.8 kB
Tags CPython 3.13 Linux glibc 2.31+ x86-64
SHA-256 checksum
How to use checksums
3a135ca95378060c83f7ac4d24f750a50c13be5ae0abb2e831041effe1464c31
BLAKE2b-256 checksum
How to use checksums
c959412396c20ab2db2e0f24779eeddc602fef70812db9dd3b6772f12ceae45b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.1.0-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-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
f8547e2b39b2b9fd7f568603802fa61772bfcfff9ec4dceb9563f67aa2a0363e
BLAKE2b-256 checksum
How to use checksums
81c019168c15bfd9ac0953285fce494ea2c309865a2cf83ff6f1ef8922f53514
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0-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-cp312-cp312-win_amd64.whl
Size 136.5 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
1941b4df4cc505f42e4ae8210ced1e1d4207dd322b312a1e89d919407f62ed24
BLAKE2b-256 checksum
How to use checksums
872abec52d137457cadf0454212ea0ae9408769b70e7bc430ec7ede7e4d8f43f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0-cp312-cp312-manylinux_2_31_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-cp312-cp312-manylinux_2_31_x86_64.whl
Size 322.0 kB
Tags CPython 3.12 Linux glibc 2.31+ x86-64
SHA-256 checksum
How to use checksums
c1a244f48c36201f1ce53e491796dd083a2d7d426ac26f1f51afc1c84dcb4254
BLAKE2b-256 checksum
How to use checksums
b50e13dcf0310bdf5d63dffed575fd9e4c49457e004d1cf4510bc11997e4f558
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.1.0-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-cp312-cp312-macosx_13_0_arm64.whl
Size 130.9 kB
Tags CPython 3.12 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
2e47a1d69419a058f397d18ecb5940882dd7bb45f4ae6b4971327518fa29578a
BLAKE2b-256 checksum
How to use checksums
1cc8a40a43614d279b73e23aadeee93f896103ba4d1c6fa61ec4cc309c74ae8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0-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-cp311-cp311-win_amd64.whl
Size 136.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
a967635a39067439b30bbfe2e8c5ae89b0d790c9f7300c602152a3d6597dc83d
BLAKE2b-256 checksum
How to use checksums
17175d5e0429da8521879fc02f5121986a650da3e7c90c1ed43a2762e62f40a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.1.0-cp311-cp311-manylinux_2_31_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-cp311-cp311-manylinux_2_31_x86_64.whl
Size 293.2 kB
Tags CPython 3.11 Linux glibc 2.31+ x86-64
SHA-256 checksum
How to use checksums
3116fc4a0061007af16ff1983e3e12ca5459d6830848ed5e8610d8d0b7f4b3a9
BLAKE2b-256 checksum
How to use checksums
1cfc7b54431168af97ca6b55309a8dac23e3c09064665f13c902c337f61b6342
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.1.0-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-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
9985fe9751b6b200ffdded653135d7d0a660ef06a98bfe814cf454cd86ccc61a
BLAKE2b-256 checksum
How to use checksums
691f904c9fa3722476a70a15548bbfc91488721cd58296f97f2dad7d1ecea41b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 9, 2026.

Transparency log

Security for gl-observability-masking-binary 0.1.0

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-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 9, 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