pretty-mod 0.1.2__tar.gz → 0.2.1__tar.gz

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/CLAUDE.md

@@ -2,30 +2,33 @@
 
 `pretty-mod` is a python package built on pyo3 to explore python packages for LLMs
 
-# Getting oriented
+## getting oriented
 
 - read @RELEASE_NOTES.md, @README.md, @pyproject.toml, and @justfile
 
-# run the tests
+## run the tests
 
 ```
 just test
 ```
 
-if for some reason you need to only build (just test does this automatically)
+if you only need to build (`just test` runs `just build` automatically)
 
 ```
 just build
 ```
 
-# run the local python package
+## run the local python package
 
 ```
 uv run pretty-mod tree fastapi.routing
 ```
 
-# run the remote python package
+## run the remote python package
 
 ```
 uvx pretty-mod tree fastapi.routing
-```
+```
+
+# IMPORTANT
+- avoid breaking changes to the public api defined by type stubs in @python/pretty_mod/_pretty_mod.pyi

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/Cargo.lock

@@ -1017,7 +1017,7 @@ dependencies = [
 
 [[package]]
 name = "pretty-mod"
-version = "0.1.2"
+version = "0.2.1"
 dependencies = [
  "flate2",
  "pyo3",

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "pretty-mod"
-version = "0.1.2"
+version = "0.2.1"
 edition = "2021"
 
 [lib]

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pretty-mod
-Version: 0.1.2
+Version: 0.2.1
 License-File: LICENSE
 Summary: A python module tree explorer for LLMs (and humans)
 Author-email: zzstoatzz <thrast36@gmail.com>
@@ -12,8 +12,9 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
 a python module tree explorer for LLMs (and humans)
 
-> [!IMPORTANT]
-> for all versions `>=0.1.0`, wheels for different operating systems are built via `maturin` and published to pypi, install `<0.1.0` for a pure python version
+> [!NOTE]
+> - For all versions `>=0.1.0`, wheels for different operating systems are built via `maturin` and published to PyPI. Install `<0.1.0` for a pure Python version.
+> - Starting from v0.2.0, output includes colors by default. Use `PRETTY_MOD_NO_COLOR=1` to disable.
 
 ```bash
 # Explore module structure
@@ -32,57 +33,89 @@ a python module tree explorer for LLMs (and humans)
 └── 📦 tool
     └── ⚡ functions: main
 
-# Inspect function signatures
-» uvx pretty-mod sig json:dumps
-📎 dumps
-├── Parameters:
-├── obj
-├── *
-├── skipkeys=False
-├── ensure_ascii=True
-├── check_circular=True
-├── allow_nan=True
-├── cls=None
-├── indent=None
-├── separators=None
-├── default=None
-├── sort_keys=False
-└── **kw
-
-# Auto-download packages from PyPI (no install needed!)
-» uvx pretty-mod tree requests --quiet
-📦 requests
-├── 📜 __all__: delete, get, head, options, patch, post, put, request
-├── ⚡ functions: check_compatibility, delete, get, head, options, patch, post, put, request
-├── 🔷 classes: ConnectTimeout, ConnectionError, DependencyWarning, FileModeWarning, HTTPError, JSONDecodeError, NullHandler, PreparedRequest, ReadTimeout, Request, RequestException, RequestsDependencyWarning, Response, Session, Timeout, TooManyRedirects, URLRequired
-├── 📌 constants: __author__, __author_email__, __build__, __cake__, __copyright__, __description__, __license__, __title__, __url__, codes
-├── 📦 adapters
-│   ├── 🔷 classes: BaseAdapter, HTTPAdapter
-│   └── 📌 constants: DEFAULT_POOL_TIMEOUT, DEFAULT_POOLBLOCK, DEFAULT_POOLSIZE, DEFAULT_RETRIES
-├── 📦 api
-│   └── ⚡ functions: delete, get, head, options, patch, post, put, request
-├── 📦 auth
-│   └── 🔷 classes: AuthBase, HTTPBasicAuth, HTTPDigestAuth, HTTPProxyAuth
-├── 📦 certs
-├── 📦 compat
-├── 📦 cookies
-├── 📦 exceptions
-├── 📦 help
-├── 📦 hooks
-├── 📦 models
-├── 📦 sessions
-├── 📦 status_codes
-├── 📦 structures
-└── 📦 utils
+# Inspect function signatures (even if the package is not installed)
+» uv run pretty-mod sig fastmcp:FastMCP --quiet
+📎 FastMCP
+├──  Parameters:
+├──  self
+├──  name: str | None=None
+├──  instructions: str | None=None
+├──  auth: OAuthProvider | None=None
+├──  lifespan: Callable[[FastMCP[LifespanResultT]], AbstractAsyncContextManager[LifespanResultT]] | None=None
+├──  tool_serializer: Callable[[Any], str] | None=None
+├──  cache_expiration_seconds: float | None=None
+├──  on_duplicate_tools: DuplicateBehavior | None=None
+├──  on_duplicate_resources: DuplicateBehavior | None=None
+├──  on_duplicate_prompts: DuplicateBehavior | None=None
+├──  resource_prefix_format: Literal['protocol', 'path'] | None=None
+├──  mask_error_details: bool | None=None
+├──  tools: list[Tool | Callable[..., Any]] | None=None
+├──  dependencies: list[str] | None=None
+├──  include_tags: set[str] | None=None
+├──  exclude_tags: set[str] | None=None
+├──  log_level: str | None=None
+├──  debug: bool | None=None
+├──  host: str | None=None
+├──  port: int | None=None
+├──  sse_path: str | None=None
+├──  message_path: str | None=None
+├──  streamable_http_path: str | None=None
+├──  json_response: bool | None=None
+└──  stateless_http: bool | None=None
 ```
 
-## Installation
+## installation
 
 ```bash
 uv add pretty-mod
 ```
 
-## Usage
+
+## cli
+
+`pretty-mod` includes a command-line interface for shell-based exploration:
+
+> [!IMPORTANT]
+> all commands below can be run ephemerally with `uvx`, e.g. `uvx pretty-mod tree json`
+
+```bash
+# Explore module structure
+pretty-mod tree json
+
+# Go deeper into the tree with --depth
+pretty-mod tree requests --depth 3
+
+# Display function signatures  
+pretty-mod sig json:loads
+
+# Get JSON output for programmatic use
+pretty-mod tree json -o json | jq '.tree.submodules | keys'
+pretty-mod sig json:dumps -o json | jq '.parameters'
+pretty-mod sig os.path:join
+
+# Explore packages even without having them installed
+pretty-mod tree django
+pretty-mod tree flask --depth 1
+
+# Use --quiet to suppress download messages
+pretty-mod tree requests --quiet
+
+# Version specifiers - explore specific versions
+pretty-mod tree toml@0.10.2
+pretty-mod sig toml@0.10.2:loads
+
+# Submodules with version specifiers (correct syntax)
+pretty-mod tree prefect.server@2.10.0  # ✅ Works
+pretty-mod tree prefect@2.10.0.server  # ❌ Invalid - version must come last
+
+# Package name differs from module name
+pretty-mod tree pydocket::docket       # PyPI package 'pydocket' contains module 'docket'
+pretty-mod tree pillow::PIL            # PyPI package 'pillow' contains module 'PIL'
+pretty-mod tree pillow::PIL@10.0.0    # Specific version of pillow
+pretty-mod sig pillow::PIL.Image:open  # Works with signatures too
+```
+
+## python sdk
 
 ```python
 from pretty_mod import display_tree
@@ -134,45 +167,55 @@ print(display_signature("json:loads"))
 ```
 </details>
 
-## CLI
+## customization
 
-Pretty-mod includes a command-line interface for quick exploration:
+pretty-mod supports extensive customization through environment variables:
 
-> [!IMPORTANT]
-> all commands below can be run ephemerally with `uvx`, e.g. `uvx pretty-mod tree json`
+### display characters
 
 ```bash
-# Explore module structure
-pretty-mod tree json
-
-# Go deeper into the tree with --depth
-pretty-mod tree requests --depth 3
+# Use ASCII-only mode for terminals without Unicode support
+PRETTY_MOD_ASCII=1 pretty-mod tree json
 
-# Display function signatures  
-pretty-mod sig json:loads
-pretty-mod sig os.path:join
-
-# Explore packages even without having them installed
-pretty-mod tree django
-pretty-mod tree flask --depth 1
+# Customize individual icons
+PRETTY_MOD_MODULE_ICON="[M]" pretty-mod tree json
+PRETTY_MOD_FUNCTION_ICON="fn" pretty-mod tree json
+PRETTY_MOD_CLASS_ICON="cls" pretty-mod tree json
+```
 
-# Use --quiet to suppress download messages
-pretty-mod tree requests --quiet
+### colors
 
-# Version specifiers - explore specific versions
-pretty-mod tree toml@0.10.2
-pretty-mod sig toml@0.10.2:loads
+pretty-mod uses an earth-tone color scheme by default:
 
-# Submodules with version specifiers (correct syntax)
-pretty-mod tree prefect.server@2.10.0  # ✅ Works
-pretty-mod tree prefect@2.10.0.server  # ❌ Invalid - version must come last
+```bash
+# Disable colors entirely
+PRETTY_MOD_NO_COLOR=1 pretty-mod tree json
+# or use the standard NO_COLOR environment variable
+NO_COLOR=1 pretty-mod tree json
+
+# Override specific colors with hex values
+PRETTY_MOD_MODULE_COLOR="#FF6B6B" pretty-mod tree json
+PRETTY_MOD_FUNCTION_COLOR="#4ECDC4" pretty-mod tree json
 ```
 
-## Examples
+available color environment variables:
+- `PRETTY_MOD_MODULE_COLOR` - Modules/packages (default: #8B7355)
+- `PRETTY_MOD_FUNCTION_COLOR` - Functions (default: #6B8E23)
+- `PRETTY_MOD_CLASS_COLOR` - Classes (default: #4682B4)
+- `PRETTY_MOD_CONSTANT_COLOR` - Constants (default: #BC8F8F)
+- `PRETTY_MOD_EXPORTS_COLOR` - __all__ exports (default: #9370DB)
+- `PRETTY_MOD_SIGNATURE_COLOR` - Signatures (default: #5F9EA0)
+- `PRETTY_MOD_TREE_COLOR` - Tree structure lines (default: #696969)
+- `PRETTY_MOD_PARAM_COLOR` - Parameter names (default: #708090)
+- `PRETTY_MOD_TYPE_COLOR` - Type annotations (default: #778899)
+- `PRETTY_MOD_DEFAULT_COLOR` - Default values (default: #8FBC8F)
+- `PRETTY_MOD_WARNING_COLOR` - Warning messages (default: #DAA520)
+
+## examples
 
-See the [`examples/`](examples/) directory for more detailed usage patterns and advanced features.
+see the [`examples/`](examples/) directory for more detailed usage patterns and advanced features.
 
-## Development
+## development
 
 ```bash
 gh repo clone zzstoatzz/pretty-mod && cd pretty-mod

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/README.md

@@ -2,8 +2,9 @@
 
 a python module tree explorer for LLMs (and humans)
 
-> [!IMPORTANT]
-> for all versions `>=0.1.0`, wheels for different operating systems are built via `maturin` and published to pypi, install `<0.1.0` for a pure python version
+> [!NOTE]
+> - For all versions `>=0.1.0`, wheels for different operating systems are built via `maturin` and published to PyPI. Install `<0.1.0` for a pure Python version.
+> - Starting from v0.2.0, output includes colors by default. Use `PRETTY_MOD_NO_COLOR=1` to disable.
 
 ```bash
 # Explore module structure
@@ -22,57 +23,89 @@ a python module tree explorer for LLMs (and humans)
 └── 📦 tool
     └── ⚡ functions: main
 
-# Inspect function signatures
-» uvx pretty-mod sig json:dumps
-📎 dumps
-├── Parameters:
-├── obj
-├── *
-├── skipkeys=False
-├── ensure_ascii=True
-├── check_circular=True
-├── allow_nan=True
-├── cls=None
-├── indent=None
-├── separators=None
-├── default=None
-├── sort_keys=False
-└── **kw
-
-# Auto-download packages from PyPI (no install needed!)
-» uvx pretty-mod tree requests --quiet
-📦 requests
-├── 📜 __all__: delete, get, head, options, patch, post, put, request
-├── ⚡ functions: check_compatibility, delete, get, head, options, patch, post, put, request
-├── 🔷 classes: ConnectTimeout, ConnectionError, DependencyWarning, FileModeWarning, HTTPError, JSONDecodeError, NullHandler, PreparedRequest, ReadTimeout, Request, RequestException, RequestsDependencyWarning, Response, Session, Timeout, TooManyRedirects, URLRequired
-├── 📌 constants: __author__, __author_email__, __build__, __cake__, __copyright__, __description__, __license__, __title__, __url__, codes
-├── 📦 adapters
-│   ├── 🔷 classes: BaseAdapter, HTTPAdapter
-│   └── 📌 constants: DEFAULT_POOL_TIMEOUT, DEFAULT_POOLBLOCK, DEFAULT_POOLSIZE, DEFAULT_RETRIES
-├── 📦 api
-│   └── ⚡ functions: delete, get, head, options, patch, post, put, request
-├── 📦 auth
-│   └── 🔷 classes: AuthBase, HTTPBasicAuth, HTTPDigestAuth, HTTPProxyAuth
-├── 📦 certs
-├── 📦 compat
-├── 📦 cookies
-├── 📦 exceptions
-├── 📦 help
-├── 📦 hooks
-├── 📦 models
-├── 📦 sessions
-├── 📦 status_codes
-├── 📦 structures
-└── 📦 utils
+# Inspect function signatures (even if the package is not installed)
+» uv run pretty-mod sig fastmcp:FastMCP --quiet
+📎 FastMCP
+├──  Parameters:
+├──  self
+├──  name: str | None=None
+├──  instructions: str | None=None
+├──  auth: OAuthProvider | None=None
+├──  lifespan: Callable[[FastMCP[LifespanResultT]], AbstractAsyncContextManager[LifespanResultT]] | None=None
+├──  tool_serializer: Callable[[Any], str] | None=None
+├──  cache_expiration_seconds: float | None=None
+├──  on_duplicate_tools: DuplicateBehavior | None=None
+├──  on_duplicate_resources: DuplicateBehavior | None=None
+├──  on_duplicate_prompts: DuplicateBehavior | None=None
+├──  resource_prefix_format: Literal['protocol', 'path'] | None=None
+├──  mask_error_details: bool | None=None
+├──  tools: list[Tool | Callable[..., Any]] | None=None
+├──  dependencies: list[str] | None=None
+├──  include_tags: set[str] | None=None
+├──  exclude_tags: set[str] | None=None
+├──  log_level: str | None=None
+├──  debug: bool | None=None
+├──  host: str | None=None
+├──  port: int | None=None
+├──  sse_path: str | None=None
+├──  message_path: str | None=None
+├──  streamable_http_path: str | None=None
+├──  json_response: bool | None=None
+└──  stateless_http: bool | None=None
 ```
 
-## Installation
+## installation
 
 ```bash
 uv add pretty-mod
 ```
 
-## Usage
+
+## cli
+
+`pretty-mod` includes a command-line interface for shell-based exploration:
+
+> [!IMPORTANT]
+> all commands below can be run ephemerally with `uvx`, e.g. `uvx pretty-mod tree json`
+
+```bash
+# Explore module structure
+pretty-mod tree json
+
+# Go deeper into the tree with --depth
+pretty-mod tree requests --depth 3
+
+# Display function signatures  
+pretty-mod sig json:loads
+
+# Get JSON output for programmatic use
+pretty-mod tree json -o json | jq '.tree.submodules | keys'
+pretty-mod sig json:dumps -o json | jq '.parameters'
+pretty-mod sig os.path:join
+
+# Explore packages even without having them installed
+pretty-mod tree django
+pretty-mod tree flask --depth 1
+
+# Use --quiet to suppress download messages
+pretty-mod tree requests --quiet
+
+# Version specifiers - explore specific versions
+pretty-mod tree toml@0.10.2
+pretty-mod sig toml@0.10.2:loads
+
+# Submodules with version specifiers (correct syntax)
+pretty-mod tree prefect.server@2.10.0  # ✅ Works
+pretty-mod tree prefect@2.10.0.server  # ❌ Invalid - version must come last
+
+# Package name differs from module name
+pretty-mod tree pydocket::docket       # PyPI package 'pydocket' contains module 'docket'
+pretty-mod tree pillow::PIL            # PyPI package 'pillow' contains module 'PIL'
+pretty-mod tree pillow::PIL@10.0.0    # Specific version of pillow
+pretty-mod sig pillow::PIL.Image:open  # Works with signatures too
+```
+
+## python sdk
 
 ```python
 from pretty_mod import display_tree
@@ -124,45 +157,55 @@ print(display_signature("json:loads"))
 ```
 </details>
 
-## CLI
+## customization
 
-Pretty-mod includes a command-line interface for quick exploration:
+pretty-mod supports extensive customization through environment variables:
 
-> [!IMPORTANT]
-> all commands below can be run ephemerally with `uvx`, e.g. `uvx pretty-mod tree json`
+### display characters
 
 ```bash
-# Explore module structure
-pretty-mod tree json
-
-# Go deeper into the tree with --depth
-pretty-mod tree requests --depth 3
+# Use ASCII-only mode for terminals without Unicode support
+PRETTY_MOD_ASCII=1 pretty-mod tree json
 
-# Display function signatures  
-pretty-mod sig json:loads
-pretty-mod sig os.path:join
-
-# Explore packages even without having them installed
-pretty-mod tree django
-pretty-mod tree flask --depth 1
+# Customize individual icons
+PRETTY_MOD_MODULE_ICON="[M]" pretty-mod tree json
+PRETTY_MOD_FUNCTION_ICON="fn" pretty-mod tree json
+PRETTY_MOD_CLASS_ICON="cls" pretty-mod tree json
+```
 
-# Use --quiet to suppress download messages
-pretty-mod tree requests --quiet
+### colors
 
-# Version specifiers - explore specific versions
-pretty-mod tree toml@0.10.2
-pretty-mod sig toml@0.10.2:loads
+pretty-mod uses an earth-tone color scheme by default:
 
-# Submodules with version specifiers (correct syntax)
-pretty-mod tree prefect.server@2.10.0  # ✅ Works
-pretty-mod tree prefect@2.10.0.server  # ❌ Invalid - version must come last
+```bash
+# Disable colors entirely
+PRETTY_MOD_NO_COLOR=1 pretty-mod tree json
+# or use the standard NO_COLOR environment variable
+NO_COLOR=1 pretty-mod tree json
+
+# Override specific colors with hex values
+PRETTY_MOD_MODULE_COLOR="#FF6B6B" pretty-mod tree json
+PRETTY_MOD_FUNCTION_COLOR="#4ECDC4" pretty-mod tree json
 ```
 
-## Examples
+available color environment variables:
+- `PRETTY_MOD_MODULE_COLOR` - Modules/packages (default: #8B7355)
+- `PRETTY_MOD_FUNCTION_COLOR` - Functions (default: #6B8E23)
+- `PRETTY_MOD_CLASS_COLOR` - Classes (default: #4682B4)
+- `PRETTY_MOD_CONSTANT_COLOR` - Constants (default: #BC8F8F)
+- `PRETTY_MOD_EXPORTS_COLOR` - __all__ exports (default: #9370DB)
+- `PRETTY_MOD_SIGNATURE_COLOR` - Signatures (default: #5F9EA0)
+- `PRETTY_MOD_TREE_COLOR` - Tree structure lines (default: #696969)
+- `PRETTY_MOD_PARAM_COLOR` - Parameter names (default: #708090)
+- `PRETTY_MOD_TYPE_COLOR` - Type annotations (default: #778899)
+- `PRETTY_MOD_DEFAULT_COLOR` - Default values (default: #8FBC8F)
+- `PRETTY_MOD_WARNING_COLOR` - Warning messages (default: #DAA520)
+
+## examples
 
-See the [`examples/`](examples/) directory for more detailed usage patterns and advanced features.
+see the [`examples/`](examples/) directory for more detailed usage patterns and advanced features.
 
-## Development
+## development
 
 ```bash
 gh repo clone zzstoatzz/pretty-mod && cd pretty-mod

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/RELEASE_NOTES.md

@@ -1,3 +1,104 @@
+# Release Notes - v0.2.1
+
+## 📊 JSON Output Support & Better Type Annotation Handling
+
+This release adds machine-readable JSON output and fixes a critical bug with complex type annotations.
+
+### ✨ New Features
+
+- **📊 JSON Output Support**: Export tree and signature data as JSON for programmatic use
+  - `pretty-mod tree json -o json` - Get module structure as JSON
+  - `pretty-mod sig json:dumps -o json` - Get function signature as JSON
+  - Perfect for piping to `jq` or other JSON processors
+  - Follows the Kubernetes pattern of `-o <format>` for output selection
+  - Example: `pretty-mod tree json -o json | jq '.tree.submodules | keys'`
+
+### 🏗️ Technical Improvements
+
+- **Visitor Pattern**: Implemented output formatters using the Visitor pattern for extensibility
+  - Clean separation between data structure and formatting
+  - Easy to add new output formats in the future
+  - Type-safe implementation using Rust traits
+
+
+---
+
+# Release Notes - v0.2.0
+
+## 🎨 Customizable Display & Colors + Enhanced Signature Support
+
+This release introduces customizable display characters, color output, full type annotation support in signatures, and a new double-colon syntax for handling packages where the PyPI name differs from the module name.
+
+### 🚨 Breaking Changes
+- **Color output by default**: Tree and signature displays now include ANSI color codes
+- **Minor version bump**: Due to visual output changes, this is a minor version release
+
+### ✨ New Features
+
+- **🔗 Double-colon syntax**: Handle packages where PyPI name differs from module name
+  - `pretty-mod tree pydocket::docket` - Download 'pydocket' package, explore 'docket' module
+  - `pretty-mod tree pillow::PIL` - Download 'pillow' package, explore 'PIL' module
+  - Works with version specifiers: `pretty-mod tree pillow::PIL@10.0.0`
+  - Works with signatures: `pretty-mod sig pillow::PIL.Image:open`
+
+- **📝 Full Type Annotation Support**: Signatures now display complete type information
+  - Union types: `str | None`
+  - Generic types: `list[Tool | Callable[..., Any]]`
+  - Literal types: `Literal['protocol', 'path']`
+  - Complex nested types properly rendered from AST
+
+- **🎨 Color Support**: Earth-tone/pastel color scheme
+  - Modules: Saddle brown (#8B7355)
+  - Functions: Olive drab (#6B8E23)
+  - Classes: Steel blue (#4682B4)
+  - Constants: Rosy brown (#BC8F8F)
+  - Warning messages: Goldenrod (#DAA520)
+  - And more subtle colors for parameters, types, and tree structures
+
+- **🔧 Customizable Display Characters**: Configure via environment variables
+  - `PRETTY_MOD_MODULE_ICON`: Icon for modules (default: 📦)
+  - `PRETTY_MOD_FUNCTION_ICON`: Icon for functions (default: ⚡)
+  - `PRETTY_MOD_CLASS_ICON`: Icon for classes (default: 🔷)
+  - `PRETTY_MOD_CONSTANT_ICON`: Icon for constants (default: 📌)
+  - `PRETTY_MOD_EXPORTS_ICON`: Icon for __all__ exports (default: 📜)
+  - `PRETTY_MOD_SIGNATURE_ICON`: Icon for signatures (default: 📎)
+
+- **🖥️ ASCII Mode**: For terminals without Unicode support
+  ```bash
+  PRETTY_MOD_ASCII=1 pretty-mod tree json
+  ```
+
+- **🚫 Disable Colors**: For clean output or piping
+  ```bash
+  PRETTY_MOD_NO_COLOR=1 pretty-mod tree json
+  # or use the standard NO_COLOR environment variable
+  ```
+
+- **🎯 Custom Colors**: Override any color with hex values
+  ```bash
+  PRETTY_MOD_MODULE_COLOR=#FF6B6B pretty-mod tree json
+  ```
+
+### 🏗️ Technical Improvements
+
+- **Configuration system**: Centralized configuration module with environment variable support
+- **Color rendering**: ANSI 24-bit true color support with automatic hex-to-RGB conversion
+- **Consistent styling**: Both tree and signature displays use the same configuration system
+- **Enhanced AST parsing**: Better handling of complex type annotations and expressions
+- **Code organization**: Consolidated signature parsing logic for better maintainability
+
+### 🐛 Bug Fixes
+
+- **Complex type annotations**: Fixed parameter splitting for nested generics
+  - Previously: `Callable[[Any], str]` would split incorrectly on the comma
+  - Now: Properly handles all nested brackets and quotes in type annotations
+  - Affects all complex types like `Dict[str, List[int]]`, `Literal['a', 'b']`, etc.
+- **Stdlib module handling**: Built-in modules no longer trigger PyPI download attempts
+- **Signature discovery**: Improved recursive search for symbols exported in `__all__`
+- **Download messages**: Colored warning messages for better visibility
+
+---
+
 # Release Notes - v0.1.2
 
 ## 🔧 Code Quality Improvements

pretty_mod-0.2.1/python/pretty_mod/__main__.py

@@ -0,0 +1,6 @@
+"""Enable running pretty-mod as a module: python -m pretty_mod"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

{pretty_mod-0.1.2 → pretty_mod-0.2.1}/python/pretty_mod/_pretty_mod.pyi

@@ -14,7 +14,12 @@ class ModuleTreeExplorer:
     def get_tree_string(self) -> str: ...
 
 def display_tree(
-    root_module_path: str, max_depth: int = 2, quiet: bool = False
+    root_module_path: str,
+    max_depth: int = 2,
+    quiet: bool = False,
+    format: str = "pretty",
 ) -> None: ...
-def display_signature(import_path: str, quiet: bool = False) -> str: ...
+def display_signature(
+    import_path: str, quiet: bool = False, format: str = "pretty"
+) -> str: ...
 def import_object(import_path: str) -> Any: ...