What is tigrbl-examples?
Packaged Tigrbl example modules migrated from the test support package.
Why use tigrbl-examples?
Use it when examples need a package boundary separate from pytest fixtures and conformance helper utilities.
When should I install tigrbl-examples?
Install it for runnable example modules, documentation checks, and integration tests that import shared example helpers.
Who is tigrbl-examples for?
Maintainers, extension authors, and documentation workflows that need importable Tigrbl examples.
Where does tigrbl-examples fit?
tigrbl-examples lives at pkgs/96_examples/tigrbl_examples and owns the migrated example module tree previously carried by tigrbl_tests.
How does tigrbl-examples work?
It exposes example modules directly under the tigrbl_examples import root so callers import tigrbl_examples.<module> without an extra nested examples namespace.
Install
uv add tigrbl-examples
pip install tigrbl-examples
Surface Coverage
| Surface | Value |
|---|---|
| PyPI package | tigrbl-examples |
| Repository path | pkgs/96_examples/tigrbl_examples |
| Python import root | tigrbl_examples |
| Console scripts | none declared |
| Entry points | none declared |
| Optional extras | none declared |
| Legal files | LICENSE, NOTICE |
| Supported Python | `3.10 |
What It Owns
tigrbl-examples owns the example package boundary. It does not own conformance assertions, package validation policy, or reusable pytest harness internals.
Implementation orientation:
tigrbl_examples: migrated beginner, intermediate, advanced, and expert example modules plus shared example helpers.
Public API and Import Surface
- Import roots:
tigrbl_examples. - Public symbols: public surface is module-oriented; import the needed example module or helper directly.
- Workspace dependencies:
tigrbl,tigrbl_client. - External runtime dependencies:
httpx>=0.27.0,<0.28,pytest>=8.0,pytest-asyncio>=0.24.0,uvicorn.
Usage Examples
Verify the installed package
python -m pip show tigrbl-examples
python - <<'PY'
from importlib.metadata import version
print(version("tigrbl-examples"))
PY
Import the package boundary
import tigrbl_examples
print(tigrbl_examples.__name__)
Import shared example helpers
from tigrbl_examples._support import pick_unique_port
print(pick_unique_port())
Run the migrated example tests
uv run pytest pkgs/96_examples/tigrbl_examples/tigrbl_examples -q
How To Choose This Package
Choose tigrbl-examples when you need importable example modules. Choose tigrbl_tests when you need reusable test helpers, fixtures, and conformance assertions.
Related Packages
Documentation Links
- Workspace docs
- Package catalog
- Package layout
- Current target
- Current state
- SSOT registry
- Release workflow
Support
- Community: Discord.
- Issues: GitHub Issues.
- Repository: pkgs/96_examples/tigrbl_examples.
Package-local Boundary
This README is the package-local distribution entry point for tigrbl-examples. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
Certification Status
- Package status: governed package in the
tigrbl/tigrblworkspace. - Governance source: SSOT registry.
- Release evidence: publish workflow validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
- Local certification guard:
pkgs/97_tests/tigrbl_tests/tests/unit/test_package_badges_and_notices.pyverifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge,LICENSE, andNOTICE. - Scope note: this README documents the package boundary. Runtime feature support remains governed by
.ssot/entities and the conformance docs linked below.
License
Licensed under the Apache License, Version 2.0. See LICENSE, NOTICE, and the official Apache 2.0 license text.
Metadata
Release files for tigrbl-examples 0.4.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tigrbl_examples-0.4.5.tar.gz | 68.2 kB | Without provenance | Details for tigrbl_examples-0.4.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tigrbl_examples-0.4.5-py3-none-any.whl | Python 3 | none | any | Details for tigrbl_examples-0.4.5-py3-none-any.whl |
Total release size: 249.9 kB
Release files / tigrbl_examples-0.4.5.tar.gz
| Download URL | tigrbl_examples-0.4.5.tar.gz |
|---|---|
| Size | 68.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c0474f364c8e64e910ed3ee2beba949be636ad6391f5677b7bb612b114298e47
|
|
BLAKE2b-256 checksum How to use checksums |
defd4a9b2c5094b95b9f4a4a20ce23b5379f3e3d7aa0ce8c38ad8d805805399b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / tigrbl_examples-0.4.5-py3-none-any.whl
| Download URL | tigrbl_examples-0.4.5-py3-none-any.whl |
|---|---|
| Size | 181.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
40209b50454fed0a442c69c7740519895aca9268ac0b39f6f0af6df0db297363
|
|
BLAKE2b-256 checksum How to use checksums |
a3bc611a0646181373bbe8521d8a6c45ad4c80f8c22044e9ab08169320c7c20c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for tigrbl-examples 0.4.5
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.