Release Notes¶

appcore 1.5 (2025-09-26)¶

CLI: Add comprehensive CLI application framework with Command and Application base classes, supporting JSON, Plain, Rich, and TOML output formats, file and stream routing, and built-in introspection commands for configuration, environment, and directories.
CLI: Add graceful handling for Git Bash/Mintty terminals with Unicode limitations, displaying user-friendly guidance instead of crashing on help requests.
Compatibility: Improve PyPy support with enhanced exception handling patterns.
Dependencies: Add compatible version constraints to all production dependencies for more predictable and reproducible installations.
Documentation: Add comprehensive CLI applications guide, complete API documentation for all modules, architecture overview with ADRs, and enhanced README with practical usage examples.

New helper functions with proper type guards on generics used with gather_async when return_exceptions = True: is_error and is_value. Also, Result is now a protocol.

Proper function signature overloads for gather_async to use with type narrowing when return_exceptions is True.

Support logfile paths, in addition to log streams, for logger preparation. A TargetDescriptor includes a location, an optional open mode (append or truncate; truncate by default), and an optional codec (utf-8, by default).

Application: Require name if constructing application information object directly. During preparation, construct absent application information object using the distribution name as the application name.

Documentation: Cover all modules in the public API. (Forgot to do this during initial release.)

Distribution: Improve package detection to properly handle namespace packages and installed packages using __name__ attribute and sys.modules boundary detection instead of ineffective __module__ checking.

Distribution: Do not skip packages in Python site packages directories when detecting the caller.

Fix configuration system to gracefully handle missing templates by returning empty dictionary instead of crashing.
Fix distribution detection to auto-detect calling package instead of incorrectly using appcore package location for configuration files.

No significant changes.