llvm-project/mlir/examples/standalone/python/StandaloneExtensionNanobind.cpp
Maksim Levental 18fc908566
[mlir][Python] move IRTypes and IRAttributes to MLIRPythonSupport (#174118)
This PR continues the work of
https://github.com/llvm/llvm-project/pull/171775 by moving more useful
types/attributes into MLIRPythonSupport.

You can now do 

```c++
struct PyTestIntegerRankedTensorType
    : mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyConcreteType<
          PyTestIntegerRankedTensorType,
          mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyRankedTensorType>
struct PyTestTensorValue
    : mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyConcreteValue<
          PyTestTensorValue>
```
instead of `mlir_type_subclass` and `mlir_value_subclass`;
**specifically manual registration of the "value caster" via indirection
through the Python interpreter is no longer necessary** . You can also
now freely use all such types at the nanobind API level (e.g., overload
based on `FP*`):

```c++
using mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN;
standaloneM.def("print_fp_type", [](PyF16Type &) { nb::print("this is a fp16 type"); });
standaloneM.def("print_fp_type", [](PyF32Type &) { nb::print("this is a fp32 type"); });
standaloneM.def("print_fp_type", [](PyF64Type &) { nb::print("this is a fp64 type"); });
```

Note, here we only port `PythonTestModuleNanobind` but there is a
follow-up PR that ports **all** in-tree dialect extensions
https://github.com/llvm/llvm-project/pull/174156 to use these. After
that one we can soft deprecate `mlir_pure_subclass`.

Note, depends on https://github.com/llvm/llvm-project/pull/171775
2026-01-05 09:34:58 -08:00

90 lines
3.4 KiB
C++

//===- StandaloneExtension.cpp - Extension module -------------------------===//
//
// This is the nanobind version of the example module. There is also a pybind11
// example in StandaloneExtensionPybind11.cpp.
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#include "Standalone-c/Dialects.h"
#include "mlir-c/Dialect/Arith.h"
#include "mlir/Bindings/Python/IRCore.h"
#include "mlir/Bindings/Python/IRTypes.h"
#include "mlir/Bindings/Python/Nanobind.h"
#include "mlir/Bindings/Python/NanobindAdaptors.h"
namespace nb = nanobind;
struct PyCustomType
: mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyConcreteType<PyCustomType> {
static constexpr IsAFunctionTy isaFunction = mlirStandaloneTypeIsACustomType;
static constexpr GetTypeIDFunctionTy getTypeIdFunction =
mlirStandaloneCustomTypeGetTypeID;
static constexpr const char *pyClassName = "CustomType";
using PyConcreteType::PyConcreteType;
static void bindDerived(ClassTy &c) {
c.def_static(
"get",
[](const std::string &value,
mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::DefaultingPyMlirContext
context) {
return PyCustomType(
context->getRef(),
mlirStandaloneCustomTypeGet(
context.get()->get(),
mlirStringRefCreateFromCString(value.c_str())));
},
nb::arg("value"), nb::arg("context").none() = nb::none());
}
};
NB_MODULE(_standaloneDialectsNanobind, m) {
//===--------------------------------------------------------------------===//
// standalone dialect
//===--------------------------------------------------------------------===//
auto standaloneM = m.def_submodule("standalone");
PyCustomType::bind(standaloneM);
standaloneM.def(
"register_dialects",
[](mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::DefaultingPyMlirContext
context,
bool load) {
MlirDialectHandle arithHandle = mlirGetDialectHandle__arith__();
MlirDialectHandle standaloneHandle =
mlirGetDialectHandle__standalone__();
MlirContext context_ = context.get()->get();
mlirDialectHandleRegisterDialect(arithHandle, context_);
mlirDialectHandleRegisterDialect(standaloneHandle, context_);
if (load) {
mlirDialectHandleLoadDialect(arithHandle, context_);
mlirDialectHandleRegisterDialect(standaloneHandle, context_);
}
},
nb::arg("context").none() = nb::none(), nb::arg("load") = true);
standaloneM.def(
"print_fp_type",
[](const mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyF16Type &,
nb::handle stderr_obj) {
nb::print("this is a fp16 type", /*end=*/nb::handle(), stderr_obj);
});
standaloneM.def(
"print_fp_type",
[](const mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyF32Type &,
nb::handle stderr_obj) {
nb::print("this is a fp32 type", /*end=*/nb::handle(), stderr_obj);
});
standaloneM.def(
"print_fp_type",
[](const mlir::python::MLIR_BINDINGS_PYTHON_DOMAIN::PyF64Type &,
nb::handle stderr_obj) {
nb::print("this is a fp64 type", /*end=*/nb::handle(), stderr_obj);
});
}