Remove proto2text | chore! (#1193)

Remove proto2text because it is simply an alias of
`onnx.printer.to_text`.

---------

Co-authored-by: Ti-Tai Wang <titaiwang@microsoft.com>

.lintrunner.toml

@@ -8,7 +8,6 @@ include_patterns = [
     '**/*.pyi',
 ]
 exclude_patterns = [
-    'docs/**',
     'onnxscript/tests/models/**',
 ]
 command = [

README.md

@@ -65,9 +65,8 @@ pytest onnxscript
 import onnx
 
 # We use ONNX opset 15 to define the function below.
-from onnxscript import FLOAT
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import script
 
 
 # We use the script decorator to indicate that

docs/examples/01_plot_selu.py

@@ -32,6 +32,6 @@ def Selu(X, alpha: float, gamma: float):
 
 # %%
 # Let's see what the translated function looks like:
-from onnxscript import proto2text  # noqa: E402
+import onnx  # noqa: E402
 
-print(proto2text(onnx_fun))
+print(onnx.printer.to_text(onnx_fun))

docs/examples/02_plot_square_loss.py

@@ -14,9 +14,8 @@
 import onnx
 from onnxruntime import InferenceSession
 
-from onnxscript import FLOAT
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import proto2text, script
 
 
 @script()
@@ -32,7 +31,7 @@ def square_loss(X: FLOAT["N", 1], Y: FLOAT["N", 1]) -> FLOAT[1, 1]:  # noqa: F82
 
 # %%
 # Let's see what the generated model looks like.
-print(proto2text(model))
+print(onnx.printer.to_text(model))
 
 # %%
 # We can run shape-inference and type-check the model using the standard ONNX API.

docs/examples/03_export_lib.py

@@ -8,9 +8,8 @@
 **This is preliminary. Proto extensions are required to fully support LibProto.**
 """
 
-from onnxscript import export_onnx_lib
+from onnxscript import export_onnx_lib, script
 from onnxscript import opset15 as op
-from onnxscript import script
 from onnxscript.values import Opset
 
 # %%

docs/examples/04_plot_eager_mode_evaluation.py

@@ -12,9 +12,8 @@
 """
 import numpy as np
 
-from onnxscript import FLOAT
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import script
 
 
 @script()

docs/examples/05_plot_model_props.py

@@ -15,9 +15,10 @@
 # %%
 # First, we define the implementation of a square-loss function in onnxscript.
 
-from onnxscript import FLOAT
+import onnx
+
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import proto2text, script
 
 
 @script(ir_version=7, producer_name="OnnxScript", producer_version="0.1")
@@ -29,4 +30,4 @@ def square_loss(X: FLOAT["N"], Y: FLOAT["N"]) -> FLOAT[1]:  # noqa: F821
 # %%
 # Let's see what the generated model looks like.
 model = square_loss.to_model_proto()
-print(proto2text(model))
+print(onnx.printer.to_text(model))

docs/examples/06_plot_model_local_funs.py

@@ -14,9 +14,10 @@
 # %%
 # First, let us define an ONNXScript function that calls other ONNXScript functions.
 
-from onnxscript import FLOAT
+import onnx
+
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import proto2text, script
 from onnxscript.values import Opset
 
 # A dummy opset used for model-local functions
@@ -43,17 +44,17 @@ def l2norm(x: FLOAT["N"], y: FLOAT["N"]) -> FLOAT[1]:  # noqa: F821
 # Let's see what the generated model looks like by default:
 
 model = l2norm.to_model_proto()
-print(proto2text(model))
+print(onnx.printer.to_text(model))
 
 # %%
 # Let's now explicitly specify which functions to include.
 # First, generate a model with no model-local functions:
 
 model = l2norm.to_model_proto(functions=[])
-print(proto2text(model))
+print(onnx.printer.to_text(model))
 
 # %%
 # Now, generate a model with one model-local function:
 
 model = l2norm.to_model_proto(functions=[sum])
-print(proto2text(model))
+print(onnx.printer.to_text(model))

docs/tutorial/examples/forloop.py

@@ -6,7 +6,7 @@
 def sumprod(x, N):
     sum = op.Identity(x)
     prod = op.Identity(x)
-    for i in range(N):
+    for _ in range(N):
         sum = sum + x
         prod = prod * x
     return sum, prod

docs/tutorial/examples/forwhileloop.py

@@ -6,7 +6,7 @@
 def sumprod_break(x, N):
     sum = op.Identity(x)
     prod = op.Identity(x)
-    for i in range(N):
+    for _ in range(N):
         sum = sum + x
         prod = prod * x
         cond = op.ReduceSum(prod) > 1e7

docs/tutorial/examples/hardmax_end_to_end.py

@@ -1,9 +1,8 @@
 import onnx
 
 # We use ONNX opset 15 to define the function below.
-from onnxscript import FLOAT
+from onnxscript import FLOAT, script
 from onnxscript import opset15 as op
-from onnxscript import script
 
 
 # We use the script decorator to indicate that

docs/tutorial/examples/outerscope_redef_error.py

@@ -1,5 +1,5 @@
+from onnxscript import graph, script
 from onnxscript import opset15 as op
-from onnxscript import script
 
 try:
 

docs/tutorial/examples/scanloop.py

@@ -1,5 +1,5 @@
+from onnxscript import graph, script
 from onnxscript import opset15 as op
-from onnxscript import script
 
 
 @script()

onnxscript/__init__.py

@@ -58,7 +58,7 @@
 
 # isort: on
 
-from ._internal.utils import external_tensor, proto2text
+from ._internal.utils import external_tensor
 from .values import OnnxFunction, TracedOnnxFunction
 
 try:
@@ -73,7 +73,6 @@
     "OnnxFunction",
     "TracedOnnxFunction",
     "proto2python",
-    "proto2text",
     "external_tensor",
     "graph",
     "BFLOAT16",

onnxscript/_internal/utils.py

@@ -14,16 +14,6 @@
 
 from onnxscript import tensor
 
-# print utility unavailable in ONNX 1.12 or earlier:
-# pylint: disable=unused-import, ungrouped-imports
-try:
-    from onnx.printer import to_text as proto2text
-except ImportError:
-
-    def proto2text(_: Any) -> str:  # type: ignore[misc]
-        return "<print utility unavailable>"
-
-
 # pylint: enable=unused-import, ungrouped-imports
 
 

onnxscript/backend/onnx_export_test.py

@@ -11,6 +11,7 @@
 import unittest
 from typing import Pattern
 
+import onnx
 import onnxruntime as ort
 import parameterized
 from onnxruntime.capi import onnxruntime_pybind11_state
@@ -273,7 +274,7 @@ def test_export2python_produces_correct_onnx_script_model(
         except Exception as e:
             raise AssertionError(
                 f"Unable to load onnx for test {backend_test.name!r}.\n"
-                f"{onnxscript.proto2text(proto)}\n"
+                f"{onnx.printer.to_text(proto)}\n"
                 f"-----\n"
                 f"{backend_test.onnx_model}"
             ) from e
@@ -298,7 +299,7 @@ def _run_function(obj, *inputs):
             except Exception as e:
                 raise AssertionError(
                     f"Unable to run test {backend_test.name!r} after conversion.\n"
-                    f"{onnxscript.proto2text(proto)}"
+                    f"{onnx.printer.to_text(proto)}"
                 ) from e
 
         backend_test.run(_load_function, _run_function)

onnxscript/evaluator.py

@@ -480,7 +480,7 @@ def _call_ort(
         raise EagerModeError(
             f"Unable to create onnxruntime InferenceSession "
             f"for executing {schema.domain}.{schema.name} op "
-            f"with onnx model\n{utils.proto2text(model)}"
+            f"with onnx model\n{onnx.printer.to_text(model)}"
         ) from e
 
     try:

onnxscript/function_libs/torch_lib/graph_building.py

@@ -1029,7 +1029,7 @@ def to_model_proto(
             warnings.warn(f"ONNX model is invalid: {e}", stacklevel=1)
             logging.debug(
                 "ONNX model:\n%s\n\nTorchScript graph:\n%s",
-                onnxscript.proto2text(onnx_model),
+                onnx.printer.to_text(onnx_model),
                 self.torch_graph,
             )
         return onnx_model

onnxscript/tests/function_libs/torch_lib/ops_test_common.py

@@ -359,7 +359,7 @@ def _format_model_and_input_information(onnx_model, inputs):
         f"Inputs:\n"
         f"{pprint.pformat(inputs)}\n"
         f"Model:\n"
-        f"{onnxscript.proto2text(onnx_model)}"
+        f"{onnx.printer.to_text(onnx_model)}"
     )
 
 
@@ -526,7 +526,7 @@ def _capture_graph_and_evaluate_torch_script_evaluator(function: Callable, args,
             onnx.checker.check_model(onnx_model, full_check=True)
         except (onnx.checker.ValidationError, onnx.shape_inference.InferenceError) as e:
             raise AssertionError(
-                f"ONNX model is invalid. Model:\n{onnxscript.proto2text(onnx_model)}"
+                f"ONNX model is invalid. Model:\n{onnx.printer.to_text(onnx_model)}"
             ) from e
 
         try: