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
- Python 3.11–3.13 — Install Python.
- One package manager: pip, uv, or Poetry.
- For development from Git: Git, SSH access to
the GDP Labs SDK repository, and
uv.
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_NPWPbeforeIPV4: the reverse order turns01.234.567.8-901.000into[IPV4]-901.000. - Select
CONN_STRING_CREDSbeforeEMAIL: the reverse order leaves the connection string's user name visible. - Select
BEARER_TOKENbeforeJWTto replace a bearer JWT with one placeholder; the reverse order producesBearer [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)
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 logRelease 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 logRelease 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 logRelease 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 logRelease 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 logRelease 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 logSecurity 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.
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 logA 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.