Skip to main content
Incomplete provenance

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

Pre-release

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

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.0.0b2

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.0.0b2
File Actions
gl_observability_masking_binary-0.0.0b2-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for gl_observability_masking_binary-0.0.0b2-cp313-cp313-win_amd64.whl
gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp313-cp313-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.0.0b2-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.0.0b2-cp313-cp313-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.0.0b2-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for gl_observability_masking_binary-0.0.0b2-cp312-cp312-win_amd64.whl
gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp312-cp312-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.0.0b2-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.0.0b2-cp312-cp312-macosx_13_0_arm64.whl
gl_observability_masking_binary-0.0.0b2-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for gl_observability_masking_binary-0.0.0b2-cp311-cp311-win_amd64.whl
gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp311-cp311-manylinux_2_31_x86_64.whl
gl_observability_masking_binary-0.0.0b2-cp311-cp311-macosx_13_0_arm64.whl CPython 3.11 CPython 3.11 macOS 13.0+ ARM64 Details for gl_observability_masking_binary-0.0.0b2-cp311-cp311-macosx_13_0_arm64.whl

Total release size: 1.7 MB

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp313-cp313-win_amd64.whl
Size 135.4 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
84838911d86fe26dbdca7a7f79888b1afc7a3a9590dd5d9a30ce71bb7bb0e920
BLAKE2b-256 checksum
How to use checksums
c022b179cdefc647efd09197a5229b166c0a8d9d6fec34207f89bc8df034ef80
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 8, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
1b7765c2bdb700d7d624fa584f0b65496e1a66ef92940046cd339b07adc65b96
BLAKE2b-256 checksum
How to use checksums
4c7a7c13b91930c8f439f1e3d3003a9f27d0f64dc263fab1e5bfc0161efec623
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
c545524572d4f0061e2dda94213ed3010c05643bc921047bf6ee6cd367cd6fc5
BLAKE2b-256 checksum
How to use checksums
b77219855a993ec77afa45331585ec22d2281ee94c7b421fc1be711aed71b671
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 8, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp312-cp312-win_amd64.whl
Size 136.5 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
8b94eb00bdae4d19aeca191f881ca83c9f60beab7b58f5db039f9c9cc3586b00
BLAKE2b-256 checksum
How to use checksums
916e5997e5ba23b22e24985a4ceccd6dcb748ca067fc773b09df8e9747ce608d
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 8, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
39ff537336b550e6044c34f0f4c6209ebdb99c42f99fc8870f7c3a5db86f9e37
BLAKE2b-256 checksum
How to use checksums
32a601abe92aa6b63aa1995f533772ef3aa1cf4af018154e01f950bdf3ae1e2e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
6521f866c1c3651d7698af5cf4879a5234ea388848780e35c6421611a3ecdd14
BLAKE2b-256 checksum
How to use checksums
a700a7db547e11f8618f63058547793de8e45c32fa021de6b3e4fe2221d02fc4
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 8, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-cp311-cp311-win_amd64.whl
Size 136.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
fd9d22d9def2b2a92d75579c268cf77a0d92bb80ba093b04c016380168e1392c
BLAKE2b-256 checksum
How to use checksums
83762ea1a154da7b31dfeacd737b5aedd74bb860eaf12217d6b38746b60f31c0
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 8, 2026.

Transparency log

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
5bcca09789dedfefa1b5f54d473d6f432d70e8d300f73f6d292b8297b6fe67ca
BLAKE2b-256 checksum
How to use checksums
f95bf69866b85307365d3a92f281f92b0ab73fbaa90daafce76f405f796d8d3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.24

Release files / gl_observability_masking_binary-0.0.0b2-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.0.0b2-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
40d9373bed5653e67ec598006b80b77ce7e1b0af9d161d703e38d39443cc3f2d
BLAKE2b-256 checksum
How to use checksums
f4b35c411884206c07c176a27906e07ce4897467197671ec633b60d61266e0a3
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 8, 2026.

Transparency log

Security for gl-observability-masking-binary 0.0.0b2

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.0.0b2-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 8, 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