[amd-juwillia]

Motivation

amd-smi shipped its Python module by having the system .deb/.rpm postinst call pip install and drop an amdsmi.pth, with a ~200-line ROCm-path-walking loader. This drops all pip/.pth plumbing, installs the module directly into the system interpreter's site-packages, and adds an opt-in SONAME-isolated wheel build so a PyPI wheel can coexist in-process with the system library.

Why loader + wheel build ship together: develop's amdsmi-manylinux-build.yml (from #5725) runs on every projects/amdsmi/** PR and configures -DBUILD_PYTHON_WHEEL=ON. A loader-only PR would either fail that job (no wheel target) or emit a wheel that silently falls back to a system libamd_smi.so. The complete, correct wheel build therefore belongs in this base PR; CI wiring and tests stack on top (#7823, #7824).

Technical Details

Loader (py-interface/amdsmi_wrapper.py, tools/generator.py — regenerated in lockstep):

• Flat 3-case ladder: AMDSMI_LIB_OVERRIDE, a bundled libamd_smi_python.so, then system libamd_smi.so; a _MissingLibrary sentinel keeps import tolerant.

Install layout (py-interface/CMakeLists.txt):

• Query /usr/bin/python3 for its real on-sys.path dir and install(DIRECTORY ...) the module there, excluding libamd_smi*.so.

Packaging (DEBIAN/postinst.in, prerm.in, RPM/post.in, preun.in, CMakeLists.txt):

• Remove pip install/uninstall + .pth; drop the python3-pip/setuptools/wheel deps and setup.py.in.

Wheel build (src/CMakeLists.txt, py-interface/CMakeLists.txt, tools/disable_system_fallback.py, CMakeLists.txt):

• BUILD_PYTHON_WHEEL (default OFF, requires BUILD_SHARED_LIBS): a SONAME-isolated libamd_smi_python.so linked -Bsymbolic-functions, and a python_wheel target that flips _AMDSMI_ALLOW_SYSTEM_FALLBACK to False in the staged wrapper so the wheel never loads a system lib.

CLI / build (amdsmi_cli/amdsmi_cli.py, amdsmi_init.py, src/CMakeLists.txt):

• Pin shebang to /usr/bin/python3; drop a dead guard; strip the system lib in Release.

Split 1 of 3 from #5726. #7823 (CI job) and #7824 (tests) stack on this; all target develop.

JIRA ID

Resolves ROCM-3941

Test Plan

• python3 projects/amdsmi/tools/build_wheel.py --project-dir projects/amdsmi --no-repair (mirrors the manylinux CI).
• Multi-OS Docker build/install/verify.

Test Result

• build_wheel.py builds clean; the wheel bundles only libamd_smi_python.so and ships _AMDSMI_ALLOW_SYSTEM_FALLBACK = False.
• import amdsmi + amdsmi_init() succeed via /usr/bin/python3 with no .pth/pip across the AMD CI images.

Submission Checklist

• Look over the contributing guidelines at https://github.com/ROCm/ROCm/blob/develop/CONTRIBUTING.md#pull-requests.

[therock-pr-bot]

❌ PR Check — Action Required

Check	Status	Details
🌿 Branch Name	❌ Fail	Branch name does not match allowed patterns. Branch: juwillia/py-loader-dist-packages Allowed patterns: - ^users\/[A-Za-z0-9][A-Za-z0-9\-]*\/.+ - ^shared\/.+ - ^[A-Za-z0-9][A-Za-z0-9\-_]*$ - ^dependabot\/.+ - ^revert-[0-9]+-.+
📝 PR Title/Description	❌ Fail	Error: Title is too long (84 characters). Expected: at most 80 characters. Desired format: type(optional-scope): short description ─── Error: Title does not follow Conventional Commits style. Expected: start with a valid type (feat, fix, docs, …). Desired format: type(optional-scope): short description
⛔ Forbidden Files	✅ Pass	—
🧪 Unit Test	❌ Fail	Error: Source/code files changed without an accompanying unit test. Expected: add at least one test file named like test_<name>.py / test_<name>.cpp (or <name>_test.*). Current: code file(s) changed: projects/amdsmi/amdsmi_cli/amdsmi_cli.py, projects/amdsmi/amdsmi_cli/amdsmi_init.py, projects/amdsmi/py-interface/amdsmi_wrapper.py, projects/amdsmi/tools/disable_system_fallback.py, projects/amdsmi/tools/generator.py; no test file found
🔎 pre-commit	⏳ Pending	⏳ Still running…
🚫 Draft PR	🔜 To Be Enabled	—
🚩 Feature Flag	🔜 To Be Enabled	—
📊 Code Coverage	🔜 To Be Enabled	—

⚠️ 3 policy check(s) failed. Please address the issues above before this PR can be Reviewed.

🚫 Please fix the failed policies

• ❌ Branch Name
• ❌ PR Title/Description
• ❌ Unit Test

The Not ready to Review label was added to this PR. Once all policies pass, the label is removed automatically.

📖 Need help? See the Policy FAQ for details on every check and how to fix failures.

[therock-pr-bot]

🚫 Please fix the failed policies before requesting reviews.

The following policy checks failed:

• ❌ Branch Name
• ❌ PR Title/Description
• ❌ Unit Test

The Not ready to Review label has been added to this PR.
Once all policies pass, the label will be removed automatically.