Handle error when java -version returns error

[gayanW]

This PR addresses the following error:

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

% launchable verify                                    

  warnings.warn(
Organization: 'defaulttm'
Workspace: 'my-initial-tests'
Proxy: None
Platform: 'macOS-15.5-arm64-arm-64bit'
Python version: '3.9.6'
Java command: 'java'
launchable version: '1.106.0'
Traceback (most recent call last):
  File "/Users/gweerakutti/Library/Python/3.9/bin/launchable", line 8, in <module>
    sys.exit(main())
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/core.py", line 1161, in __call__
    return self.main(*args, **kwargs)
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/core.py", line 1082, in main
    rv = self.invoke(ctx)
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/core.py", line 1697, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/core.py", line 1443, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/core.py", line 788, in invoke
    return __callback(*args, **kwargs)
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/click/decorators.py", line 33, in new_func
    return f(get_current_context(), *args, **kwargs)
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/launchable/commands/verify.py", line 137, in verify
    if check_java_version(java) < 0:
  File "/Users/gweerakutti/Library/Python/3.9/lib/python/site-packages/launchable/commands/verify.py", line 53, in check_java_version
    v = subprocess.run([javacmd, "-version"], check=True, stderr=subprocess.PIPE, universal_newlines=True)
  File "/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.9/lib/python3.9/subprocess.py", line 528, in run
    raise CalledProcessError(retcode, process.args,
subprocess.CalledProcessError: Command '['java', '-version']' returned non-zero exit status 1.

While /usr/bin/java might exist on users macOS system, when no JDK or JRE is installed, it typically act as a placeholder or symlink meant to guide users toward installing Java. So in such case, when we call java -version in our code, as the command returns an non-zero error code instead of the version, we need to handle it.

New behavior:

% java -version; echo "Exit code: $?"
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

Exit code: 1

% launchable verify        
/Users/gweerakutti/.local/share/virtualenvs/cli-JevRS2r6/lib/python3.9/site-packages/launchable/version.py:1: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.
  from pkg_resources import DistributionNotFound, get_distribution
Organization: 'defaulttm'
Workspace: 'my-initial-tests'
Proxy: None
Platform: 'macOS-15.5-arm64-arm-64bit'
Python version: '3.9.6'
Java command: 'java'
launchable version: '1.106.2.dev1+ge25829f3.d20250718'
Usage: launchable verify [OPTIONS]
Try 'launchable verify --help' for help.

Error: Java 8 or later is required

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[ono-max]

Nice work! Thanks