diff --git a/README.md b/README.md index af1a4a0..133375e 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,11 @@ This is a TUI (Text User Interface) image editor, inspired by MS Paint, built wi ## Usage -Python 3.10 or later is required. See [Compatibility](#compatibility) for details on terminals supported. +Textual Paint requires a Python version between 3.10 and 3.12 to run. + +See [Compatibility](#compatibility) for details on terminals supported. + +Python 3.13 is not yet supported, so please use Python 3.12 for now. ### Installation @@ -208,7 +212,7 @@ To preview ANSI art files in file managers like Nautilus, Thunar, Nemo, or Caja, -Python 3.10 or later is required. +A Python version between 3.10 and 3.12 is required. ### Linux @@ -344,6 +348,13 @@ Often it's useful to exclude events with `textual console -x EVENT`. - Make sure to run the program from the root directory of the repository. +> `pip install -r requirements.txt` fails with `KeyError: '__version__'` or other errors + +- `KeyError: '__version__'` is due to an [incompatibility](https://github.com/python-pillow/Pillow/issues/8075) between Pillow 9.5.0 and Python 3.13. Please use Python 3.12 for now, until I can update Pillow and other dependencies for compatibility with the latest Python version. +- A VS Code launch configuration is included to debug the installation process. + - This allows pausing on exceptions and setting breakpoints in pip source code and `setup.py` files. + - If you want to set breakpoints in package source code, or test out modifications to a `setup.py` file, since packages are extracted to temporary folders, you need to pause early and find the newest temporary folder for the package. + ### Quality Assurance ```bash diff --git a/setup.cfg b/setup.cfg index 6725d9a..aad21a5 100644 --- a/setup.cfg +++ b/setup.cfg @@ -55,6 +55,7 @@ classifiers = Natural Language :: Turkish [options] +python_requires = >=3.10,<3.13 install_requires = textual==0.38.1 rich==13.4.2