pyintrospect 0.2.0

Clean Python introspection wrapper

PyIntrospect

PyIntrospect is a lightweight Python introspection wrapper that transforms raw runtime inspection into a clean, structured, human-readable analysis layer.

Built on top of Python’s inspect, it turns chaotic module metadata into organized intelligence.

---

Features

PyIntrospect extracts and organizes:

• Submodules
• Variables
• Constants
• Functions (with signatures + return type if available)
• Classes (with inheritance + __init__ signature)
• Module source code
• Module file path
• Summary metadata (counts + stats)

---

Installation

pip install pyintrospect

---

Quick Start

import pyintrospect
import os

r = pyintrospect.Reflect(os)
r.summary()

---

Core Concept

Python already provides dir() and inspect, but:

• dir() → noisy, unstructured
• inspect → powerful but low-level

PyIntrospect adds a semantic layer on top of inspect, making output structured, readable, and categorized.

---

API Reference

Reflect(module, HideDunder=True, pretty=True)

Parameter	Description
module	Python module to inspect
HideDunder	If True, hides _private and __dunder__ members
pretty	If True, prints formatted output instead of returning raw data

---

Methods

summary()

r.summary()

Returns:

• module name
• file path
• version (if available)
• counts of all member types
• total members

---

submodules()

r.submodules()

variables()

r.variables()

constants()

r.constants()

functions()

r.functions()

classes()

r.classes()

source()

r.source()

path()

r.path()

all()

r.all()

---

CLI Usage

pyintrospect os
pyintrospect os --functions
pyintrospect requests --classes --raw

Options:

--dunder
--raw
--submodules
--variables
--constants
--functions
--classes
--source
--path
--all

---

Philosophy

Make Python introspection readable, structured, and meaningful.

---

Notes

• Built-in modules may not expose source code
• Some functions may not have signatures
• Private members are filtered via HideDunder

---

License

MIT License
Copyright (c) 2026 Hoàng Long