v2.0.0 - Python 3.11+ Modernization

Mentalist v2.0.0

🚀 Major Modernization Release

This is a major version update that modernizes Mentalist for Python 3.11+ with improved packaging, bug fixes, and UX enhancements.

---

⚠️ Breaking Changes

Python 3.11+ is now required.

If you need Python 3.10 or earlier, please continue using Mentalist v1.0 with prebuilt executables.

---

📋 Prerequisites

Mentalist requires tkinter (Python's GUI library). Installation varies by platform:

macOS (Homebrew):

brew install [email protected]  # Match your Python version

Linux (Debian/Ubuntu):

sudo apt-get install python3-tk

Windows:
Included with Python - no additional installation needed.

See the README for complete details.

---

✨ What's New

Build System & Packaging

• Migrated to Poetry for modern Python packaging
• Added pyproject.toml with proper dependency management
• Removed legacy setuptools configuration
• Proper package data inclusion
• No external dependencies (uses Python standard library only)

Python 3.11+ Compatibility

• Fixed inspect.getargspec() → inspect.signature() (removed in Python 3.11)
• Fixed deprecated locale.format() → locale.format_string()
• Added locale error handling with graceful fallbacks
• Fixed all SyntaxWarnings for Python 3.13 compatibility
• Tested and working on Python 3.11, 3.12, and 3.13

User Experience Improvements

• Dialog windows now stay on top of main window
• Enter key support in all dialogs (OK buttons are default)
• Full file browser for save operations (not collapsed/simplified)
• Default filenames provided in save dialogs
• Clean, modern border styling (no more visual artifacts)

Code Quality

• All file operations use context managers (proper resource cleanup)
• No ResourceWarnings or SyntaxWarnings
• Follows modern Python best practices
• All 22 unit tests passing

Documentation

• Updated README with comprehensive installation instructions
• Added Prerequisites section for tkinter installation
• Added local assets (logo and demo GIF) - no more broken external links
• Updated badges to reflect Python 3.11+ requirement
• PyInstaller build instructions for creating your own executables

---

🐛 Issues Fixed

This release fixes 11 critical issues:

• #4, #6, #17, #18, #33, #34, #37, #38, #39, #41, #44

All Python 3.11+ compatibility issues and locale errors are now resolved.

---

📦 Installation

Using Poetry (Recommended)

git clone https://github.com/sc0tfree/mentalist.git
cd mentalist
poetry install
poetry run mentalist

Using pip

git clone https://github.com/sc0tfree/mentalist.git
cd mentalist
pip install .
python -m mentalist

Building Your Own Executable

poetry add --group dev pyinstaller
poetry run pyinstaller mentalist.spec
# Executable will be in dist/

---

🔄 Upgrading from v1.0

Important: You must have Python 3.11 or higher installed.

Simply follow the installation instructions above. Your existing chain files (.mentalist) are compatible with v2.0.

---

📋 Full Changelog

See PR #45 for complete details: #45

---

🙏 Thank You

To everyone who reported issues and contributed to making Mentalist better. This release addresses years of compatibility issues and brings the codebase up to modern Python standards.

Special thanks to the community for patience and detailed bug reports that made these fixes possible!

Mentalist v1.0

v1.0 release of Mentalist!