Revise setup.py to test Python version at install time.

Author: rocky

README.rst

@@ -61,7 +61,7 @@ Installation
 
     pip install xdis
 
-*For Python releases before 3.11*, do not install using PyPI, but instead install using a file in the [GitHub Releases section](https://github.com/rocky/python-xdis/releases). Older Python used to use `easy_install <https://python101.pythonlibrary.org/chapter29_pip.html#using-easy-install>`_. But this is no longer supported in PyPi.
+*For Python releases before 3.11*, do not install using PyPI, but instead install using a file in the [GitHub Releases section](https://github.com/rocky/python-xdis/releases). Older Python used to use `easy_install <https://python101.pythonlibrary.org/chapter29_pip.html#using-easy-install>`_. But this is no longer supported in PyPi or newer Python versions. And vice versa, *poetry* nor *pip*, (the newer ways) are not supported on older Pythons.
 
 If the Python version you are running xdis is between Python 2.4 through 2.7, use a tarball called xdis_24-*x.y.z*.tar.gz.
 
@@ -75,31 +75,28 @@ If the Python version you are running xdis is 3.11 or later, use a called xdis-*
 
 You can also try eggs or wheels that have the same version designation, e.g., xdis-*x.y.z*-py39-none-any.whl for a Python 3.9 installation. *However, note that *the version without the designation means Python 3.11 or greater*.
 
+You can also try eggs or wheels that have the same version designation, e.g., xdis-*x.y.z*-py39-none-any.whl for a Python 3.9 installation. *However, note that *the version without the designation means Python 3.11 or greater*.
+
 Similarly a tarball with without `_`*xx* works only from Python 3.11 or greater.
 
+Rationale for using Git Branches
+++++++++++++++++++++++++++++++++
+
+It is currently impossible (if not impractical) to have one Python source code of this complexity and with this many features that can run both Python 2.7 and Python 3.13+. The languages have drifted so much, and Packing is vastly different. In fact, the packaging practice for Python 3.11+ is incompatible with Python 2.7 (and before back to Python 2.4), which favored "easy_install".
+
+
 Installation from source text
 ++++++++++++++++++++++++++++++
 
-The standard Python routine:
+To install from source code, make sure you have the right Git
+branch. See the Requirements section for the Git branch names.
 
-::
+After setting the right branch::
 
    $ pip install -e .  # or pip install -e .[dev] to include testing package
 
 A GNU makefile is also provided so ``make install`` (possibly as root or sudo) will do the steps above.
 
-To install older versions from source in git, use the branch
-``python-2.4-to-2.7`` for Python versions from 2.4 to 2.7,
-``python-3.1-to-3.2`` for Python versions from 3.1 to 3.2,
-``python-3.3-to-3.5`` for Python versions from 3.3 to 3.5. The master
-``python-3.6-to-3.10`` for Python versions from 3.6 to 3.10. The master
-branch handles Python 3.11 and later.
-
-Rationale for using Git Branches
-++++++++++++++++++++++++++++++++
-
-It is currently impossible (if not impractical) to have one Python source code of this complexity and with this many features that can run both Python 2.7 and Python 3.13+. The languages have drifted so much, and Packing is vastly different. In fact, the packaging practice for Python 3.11+ is incompatible with Python 2.7 (and before back to Python 2.4), which favored "easy_install".
-
 
 Disassembler Example
 --------------------

__pkginfo__.py

@@ -22,7 +22,7 @@
 
 # Things that change more often go here.
 copyright = """
-Copyright (C) 2015-2020, 2023-204 Rocky Bernstein <[email protected]>.
+Copyright (C) 2015-2020, 2023-2025 Rocky Bernstein <[email protected]>.
 """
 
 classifiers = [

pyproject.toml

@@ -61,3 +61,6 @@ pydisasm = "xdis.bin.pydisasm:main"
 
 [tool.setuptools.dynamic]
 version = {attr = "xdis.version.__version__"}
+
+[tool.setuptools.packages.find]
+include = ["xdis*"]  # Include all subpackages

setup.py

@@ -1,6 +1,31 @@
 #!/usr/bin/env python
-"""Setup script for the 'xdis' distribution."""
+"""
+  Check that the Python version running this is compatible with this installation medium.
+  Note: that we use 2.x compatible Python code here.
+"""
+
+import sys
 
 from setuptools import setup
 
+major = sys.version_info[0]
+minor = sys.version_info[1]
+
+if major != 3 or not minor >= 11:
+    sys.stderr.write("This installation medium is only for Python 3.11 and later. You are running Python %s.%s.\n" % (major, minor))
+
+if major == 3 and 6 <= minor <= 10:
+    sys.stderr.write("Please install using xdis_36-x.y.z.tar.gz from https://github.com/rocky/python-xdis/releases\n")
+    sys.exit(1)
+elif major == 3 and 3 <= minor <= 5:
+    sys.stderr.write("Please install using xdis_33-x.y.z.tar.gz from https://github.com/rocky/python-xdis/releases\n")
+    sys.exit(1)
+if major == 3 and 0 <= minor <= 2:
+    sys.stderr.write("Please install using xdis_30-x.y.z.tar.gz from https://github.com/rocky/python-xdis/releases\n")
+    sys.exit(1)
+elif major == 2:
+    sys.stderr.write("Please install using xdis_24-x.y.z.tar.gz from https://github.com/rocky/python-xdis/releases\n")
+    sys.exit(1)
+
+
 setup(packages=["xdis"])