Tianqi Chen
ffea531107
## Summary Lifts 10 host-toolchain / CLI / process / utility modules from `python/tvm/contrib/` to a new `python/tvm/support/` package, and deletes two dead contrib shims. `tvm.support` is the home for Python helpers that integrate TVM with external CLIs and host-side tools — compilers, archivers, subprocess pools, and build-info queries. These are load-bearing internal pieces that TVM's compile/link/run paths depend on. `tvm.contrib` is reserved for optional vendor SDK integrations and experimental features. The distinction is documented in the `tvm.support` package docstring. Moved (one commit each): - `tvm.contrib.cc` → `tvm.support.cc` - `tvm.contrib.nvcc` → `tvm.support.nvcc` - `tvm.contrib.rocm` → `tvm.support.rocm` - `tvm.contrib.ndk` → `tvm.support.ndk` - `tvm.contrib.xcode` → `tvm.support.xcode` - `tvm.contrib.clang` → `tvm.support.clang` - `tvm.contrib.emcc` → `tvm.support.emcc` - `tvm.contrib.popen_pool` → `tvm.support.popen_pool` - `tvm.contrib.utils` → `tvm.support.utils` - `tvm.contrib.tar` → `tvm.support.tar` Deleted: - `tvm.contrib.spirv` — single `optimize()` wrapping `spirv-opt`; zero importers. - `tvm.contrib.rpc` — self-deprecation shim with "removed in 0.5" banner; honoring it. Package conversion: - `python/tvm/support.py` → `python/tvm/support/__init__.py` with inclusion-rule docstring. - `libinfo()` extracted into `python/tvm/support/libinfo.py`. - `FrontendTestModule` dropped (audit confirmed zero callers outside its own definition). ## Compatibility Hard break — no `tvm.contrib.<mod>` re-export shims. All callers updated in this PR. C++-side FFI registry keys (`tvm.contrib.nvcc.*`, etc.) are unchanged — only the Python module path moves. Renaming the FFI keys is a separate follow-up.
55 lines
1.9 KiB
Python
55 lines
1.9 KiB
Python
# Licensed to the Apache Software Foundation (ASF) under one
|
|
# or more contributor license agreements. See the NOTICE file
|
|
# distributed with this work for additional information
|
|
# regarding copyright ownership. The ASF licenses this file
|
|
# to you under the Apache License, Version 2.0 (the
|
|
# "License"); you may not use this file except in compliance
|
|
# with the License. You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing,
|
|
# software distributed under the License is distributed on an
|
|
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
# KIND, either express or implied. See the License for the
|
|
# specific language governing permissions and limitations
|
|
# under the License.
|
|
"""tvm.support — Python helpers that integrate TVM with external CLIs
|
|
and host-side tools (compilers, archivers, subprocess pools, build-info
|
|
queries). Distinct from `tvm.contrib`, which is reserved for optional
|
|
vendor SDK integrations and experimental features."""
|
|
|
|
import json
|
|
import os
|
|
import platform
|
|
import sys
|
|
import textwrap
|
|
|
|
import tvm_ffi
|
|
|
|
import tvm
|
|
|
|
tvm_ffi.init_ffi_api("support", __name__)
|
|
|
|
from .libinfo import libinfo
|
|
|
|
|
|
def describe():
|
|
"""
|
|
Print out information about TVM and the current Python environment
|
|
"""
|
|
info = list((k, v) for k, v in libinfo().items())
|
|
info = dict(sorted(info, key=lambda x: x[0]))
|
|
print("Python Environment")
|
|
sys_version = sys.version.replace("\n", " ")
|
|
uname = platform.uname()
|
|
uname = f"{uname.system} {uname.release} {uname.version} {uname.machine}"
|
|
lines = [
|
|
f"TVM version = {tvm.__version__}",
|
|
f"Python version = {sys_version} ({sys.maxsize.bit_length() + 1} bit)",
|
|
f"uname = {uname}",
|
|
]
|
|
print(textwrap.indent("\n".join(lines), prefix=" "))
|
|
print("CMake Options:")
|
|
print(textwrap.indent(json.dumps(info, indent=2), prefix=" "))
|