Unable to install on USS

[DavidGahringTXCPA]

Describe the bug

Attempted to install the SDK on my USS environment, but the install fails.

Expected and actual results

Expected a clean installation, but ended up with an error during the build process.

An excerpt from the install messages. Appears to report "Unsupported platform: 314". See below..

Installing build dependencies ... error
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> [30 lines of output]
Collecting maturin<2.0,>=1.9
Downloading maturin-1.12.6.tar.gz (269 kB)
Installing build dependencies: started
Installing build dependencies: finished with status 'done'
Getting requirements to build wheel: started
Getting requirements to build wheel: finished with status 'done'
Installing backend dependencies: started
Installing backend dependencies: finished with status 'done'
Preparing metadata (pyproject.toml): started
Preparing metadata (pyproject.toml): finished with status 'error'
error: subprocess-exited-with-error

    × Preparing metadata (pyproject.toml) did not run successfully.
    │ exit code: 1
    ╰─> [5 lines of output]
        /SYSTEM/tmp/pip-build-env-7cr3cghv/overlay/lib/python3.14/site-packages/setuptools/_vendor/wheel/bdist_wheel.py:4: FutureWarning: The 'wheel' package is no longer the canonical location of the 'bdist_wheel' command, and will be removed in a future release. Please update to setuptools v70.1 or later which contains an integrated version of this command.
          warn(
        Python reports SOABI: cpython-314
        Unsupported platform: 314
        Rust not found, installing into a temporary directory
        [end of output]

    note: This error originates from a subprocess, and is likely not a problem with pip.
  error: metadata-generation-failed

  × Encountered error while generating package metadata.
  ╰─> See above for output.

  note: This is an issue with the package mentioned above, not pip.
  hint: See above for details.
  [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.

[notice] A new release of pip is available: 25.2 -> 26.0.1
[notice] To update, run: pip install --upgrade pip
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

Describe your environment

IBM Open Enterprise SDK for Python 3.14.0.1
pip 25.2 from /usr/local

z/OS 2.5 USS
Bash shell

Additional context

[github-actions]

Thank you for creating a bug report.
We will investigate the bug and evaluate its impact on the product.
If you haven't already, please ensure you have provided steps to reproduce the bug and as much context as possible.

[t1m0thyj]

Are you able to install with an older version of Python (3.12 or 3.13)?

Also please list the names of the SDK packages that you're trying to install. If installing on z/OS, it should be possible to skip installing the Secrets SDK that requires maturin native dependency.

[DavidGahringTXCPA]

t1m0thyj,

I've now tried under Python 3.12 with the same results.

I'm not sure how to answer your question about package names..?

I'm running the following command to install:
pip install -U --pre zowe-python-sdk-bundle

[t1m0thyj]

One of our dependencies jsonschema replaced a pure C dep with a Rust-based one that is uninstallable on z/OS - see python-jsonschema/jsonschema#1117.

Downgrading jsonschema to 4.17.3 resolves the dependency issue, but is not supported in Python 3.14 and newer versions.

As a short-term fix, we plan to downgrade jsonschema. After #390 is merged and published, the Python SDK should be installable on USS for Python 3.12 or 3.13, but 3.14 will remain unsupported on USS for the time being.

In the future, we'll need to investigate a long-term fix that removes or replaces jsonschema in order to support Python 3.14 on USS.

[DavidGahringTXCPA]

Thanks for the update! Great news that we may have a workable solution in the meantime.

Please let me know if there's anything I can assist with regarding testing, etc.

Thanks again!