python-introspect
Extensible analysis of callable signatures, dataclass fields, type hints, and docstrings, plus signature-derived callable declaration projection.
Quick start
from python_introspect import SignatureAnalyzer
def resize(image, factor: float = 0.5, *, preserve_range: bool = True):
"""Resize an image.
Args:
image: Input image.
factor: Scale factor.
preserve_range: Preserve the input intensity range.
"""
parameters = SignatureAnalyzer().analyze(resize)
for name, info in parameters.items():
print(name, info.param_type, info.default_value, info.is_required)
analyze is the unified entry point for functions, methods, classes,
dataclass types, and instances. It returns a mapping of names to
ParameterInfo records.
Use callable_declaration_kwargs when declaration identity should omit
keyword arguments equal to their signature defaults. The caller supplies value
equality so array, lazy, or other framework-specific values keep their owning
semantics.
Extension points
Use register_namespace_provider to contribute names used while resolving
forward references and register_type_resolver to unwrap application proxy
types. Wrappers can declare their user-facing inspection target through the
signature-target helpers in python_introspect.signature_analyzer.
Installation
python -m pip install python-introspect
The runtime depends on metaclass-registry. Repository and issues: OpenHCSDev/python-introspect.
Documentation
The maintained sources are in docs/source. Documentation
changes are checked by the repository's documentation
workflow;
the local warnings-as-errors build command is documented in
development.rst.
Parameter declarations in 0.2
UnifiedParameterAnalyzer now returns the original ParameterInfo declarations
from SignatureAnalyzer. UnifiedParameterInfo, its source_type tag, and
analyze_nested were removed. Use analyze and the declared param_type for
parameter topology.
ParameterInfo retains its five public fields, constructor and _replace
operation, and is now a frozen declaration rather than a tuple. Tuple unpacking
and NamedTuple helpers are no longer supported. Dataclass descriptions are
derived on first help access; value/default overlays preserve that deferred
source, and renaming preserves the original field's help. Callable descriptions
still participate eagerly in inferred parameter types. A presentation extraction
error yields absent help without discarding valid types/defaults. Factory errors
remain uncached and retryable.
1 maintainer
Metadata
1 maintainer
Release files for python-introspect 0.2.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 | |
|---|---|---|---|
| python_introspect-0.2.5.tar.gz | 56.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_introspect-0.2.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 98.4 kB
Release files / python_introspect-0.2.5.tar.gz
| Download URL | python_introspect-0.2.5.tar.gz |
|---|---|
| Size | 56.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c06cc644c5f9deac5a539519017f81fe8de615ed8c0bb6a9638fe0d2ff5a48f8
|
|
BLAKE2b-256 checksum How to use checksums |
f67cf3e5ae3cdc5ebe770077a112a2c17a2ff170ddc20e789d3c32292764bf43
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / python_introspect-0.2.5-py3-none-any.whl
| Download URL | python_introspect-0.2.5-py3-none-any.whl |
|---|---|
| Size | 42.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
384d4abb979eb0e373eadba4ff879bc04fab829afd7c3822530bcfd9c42d8e96
|
|
BLAKE2b-256 checksum How to use checksums |
ea91c54752c7440800faec6ac3c81712995e2a200c5a052d03d76f610375ca56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
