python(3) check.py doesn’t work

[meyerweb]

System: Apple M2 Max, macOS 15.7.1 (Sequoia)

When I run python check.py in the cloned SuperTinyIcons repository’s top directory, after some time — around 25 seconds, if I’m reading the Python correctly — I get back:

Traceback (most recent call last):
  File "/Users/emeyer/repos/SuperTinyIcons/check.py", line 66, in <module>
    raise RuntimeError("Validator did not start in time")
RuntimeError: Validator did not start in time

Running python --version yields Python 3.10.10.

If I instead run python3 check.py I immediately get:

Traceback (most recent call last):
  File "/Users/emeyer/repos/SuperTinyIcons/check.py", line 15, in <module>
    import requests
ModuleNotFoundError: No module named 'requests'

Running python3 --version yields Python 3.14.4.

I tried pip3 install requests --upgrade, but it doesn’t seem to have helped. The results of that were:

Collecting requests
  Using cached requests-2.33.1-py3-none-any.whl.metadata (4.8 kB)
Collecting charset_normalizer<4,>=2 (from requests)
  Using cached charset_normalizer-3.4.7-cp314-cp314-macosx_10_15_universal2.whl.metadata (40 kB)
Collecting idna<4,>=2.5 (from requests)
  Using cached idna-3.13-py3-none-any.whl.metadata (8.0 kB)
Collecting urllib3<3,>=1.26 (from requests)
  Using cached urllib3-2.7.0-py3-none-any.whl.metadata (6.9 kB)
Collecting certifi>=2023.5.7 (from requests)
  Using cached certifi-2026.4.22-py3-none-any.whl.metadata (2.5 kB)
Using cached requests-2.33.1-py3-none-any.whl (64 kB)
Using cached charset_normalizer-3.4.7-cp314-cp314-macosx_10_15_universal2.whl (309 kB)
Using cached idna-3.13-py3-none-any.whl (68 kB)
Using cached urllib3-2.7.0-py3-none-any.whl (131 kB)
Using cached certifi-2026.4.22-py3-none-any.whl (135 kB)
Installing collected packages: urllib3, idna, charset_normalizer, certifi, requests
Successfully installed certifi-2026.4.22 charset_normalizer-3.4.7 idna-3.13 requests-2.33.1 urllib3-2.7.0

But when I run python3 check.py, I get the same No module named 'requests' as before.

So, I’m stuck. Any ideas? Happy to supply any requested information!

[edent]

Please can you try running:

java -cp test/vnu.jar nu.validator.servlet.Main 8888

That should tell us if the Validator runs on your machine.

[meyerweb]

Ah ha! That is in fact the problem.

The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

Apologies if I should have seen that as a dependency in the documentation, and missed it.

Edited to add: it’s weird, I could have sworn I installed Java at some point.

[edent]

Three billion devices run Java - except for your machine ;-)

I've updated the check.py to be more explicit about needing Java to run.

For context, we used to POST the SVG to an online validator, but that often caused issues. Hence swapping to a local validator.

[meyerweb]

What can I say? I’m a rebel!

Anyway, I installed Java 8 Update 491 for macOS, which is what https://java.com handed me. Now when I run java -cp test/vnu.jar nu.validator.servlet.Main 8888 I get:

Exception in thread "main" java.lang.UnsupportedClassVersionError: nu/validator/servlet/Main has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

It’s progress, of a sort. Write once, crash anywhere! 🫠

[Eiim]

java.com is, unfortunately, not great in this regard. Java 8 is quite old, and the validator program requires at least Java 11. I recommend getting a more recent version of Java from https://adoptium.net/temurin/releases (I believe the smaller JREs will be fine) or https://jdk.java.net/26/.

[romain-dartigues]

There are many Java distributions now, confer https://endoflife.date/tags/java-distribution; I can suggest Amazon Corretto (for your case on Apple MacOS this will probably be https://docs.aws.amazon.com/corretto/latest/corretto-26-ug/macos-install.html).

For the Python dependencies, I suggest you use uv.