U zhQ @sUddlmZddlmZmZmZmZmZmZm Z m Z m Z ddl m Z ddlZddlZddlZddlZddlZddlZddlZddlZddlmZmZmZmZddlmZddd d d d d dgZeaee e!d<eZ"ee e!d<dgZ#dd Z$GdddZ%ddZ&ej'ddZ(gZ)ee%e!d<e*dZ+ej,ddddd Z-e-j.dAe%ddd Z/ej,dBddd!dZ0e e d"d#d$Z1e0j.dCe%dd%d Z/e d&e2d'dDddd(d)d Z3ee d*d+fZ4dEdde4eeeee%d,d-d.Z5dFddd(e4eeee%e6d/d0d Z7ddd1e4eeedd2d3d4Z8d5d6Z9d7d8d9d Z:d:Z;dGe;d;d<eejjejjd?d@Z>dS)H) OpOverload) AnyOptionalSetListUnionCallableTupleDictSequence) deprecatedN) custom_op_maybe_get_opdefdevice_types_t CustomOpDefLibraryimpldefinefallthrough_kernel impl_abstract register_fakeget_ctxr_impls_defsZprimcCs tddS)zZ A dummy function to pass to ``Library.impl`` in order to register a fallthrough. z,fallthrough_kernel() should never be called.N)NotImplementedErrorrr?/var/www/html/venv/lib/python3.8/site-packages/torch/library.pyr&sc@s^eZdZdZdddZddZdddd d Zdd d ZdddZdddddZ ddZ dS)raC A class to create libraries that can be used to register new operators or override operators in existing libraries from Python. A user can optionally pass in a dispatch keyname if they only want to register kernels corresponding to only one specific dispatch key. To create a library to override operators in an existing library (with name ns), set the kind to "IMPL". To create a new library (with name ns) to register new operators, set the kind to "DEF". To create a fragment of a possibly existing library to register operators (and bypass the limitation that there is only one library for a given namespace), set the kind to "FRAGMENT". Args: ns: library name kind: "DEF", "IMPL" (default: "IMPL"), "FRAGMENT" dispatch_key: PyTorch dispatch key (default: "") c Cs|dkrtd||tkr4|dks*|dkr4t|dtjddd}|j|j}}tj||||||_ ||_ t |_ t |_ g|_||_||_t|tt|j t|j |jdS) N)ZIMPLDEFFRAGMENTzUnsupported kind: rr zJ is a reserved namespace. Please try creating a library with another name.)limitr) ValueError_reserved_namespaces traceback extract_stackfilenamelinenotorch_CZ_dispatch_librarymnsset_op_defs _op_impls_registration_handleskind dispatch_keyweakreffinalize _del_libraryrr)selfr,r1r2framer'r(rrr__init__>s  zLibrary.__init__cCsd|jd|jd|jdS)Nz Library(kind=z, ns=z, dispatch_key=z)>)r1r,r2)r6rrr__repr__TszLibrary.__repr__r)tagsc Cs|dkrtd||jdk s$tt|tjr6|f}|dd}d|krZ|ddn|}ttj|j o~tt tj|j |}|j ||t |}|dd}|j d|}|rt tj|j } t | |} tj | |j|t||S)aDefines a new operator and its semantics in the ns namespace. Args: schema: function schema to define a new operator. alias_analysis (optional): Indicates if the aliasing properties of the operator arguments can be inferred from the schema (default behavior) or not ("CONSERVATIVE"). tags (Tag | Sequence[Tag]): one or more torch.Tag to apply to this operator. Tagging an operator changes the operator's behavior under various PyTorch subsystems; please read the docs for the torch.Tag carefully before applying it. Returns: name of the operator as inferred from the schema. Example:: >>> my_lib = Library("mylib", "DEF") >>> my_lib.define("sum(Tensor self) -> Tensor") )rZ FROM_SCHEMAZ CONSERVATIVEzInvalid alias_analysis type N(r.::) RuntimeErrorr+AssertionError isinstancer)Tagsplithasattropsr,getattrrtuple_opsZ_refresh_packetr.addr) r6schemaalias_analysisr:nameZ packet_nameZhas_preexisting_packetresultqualnamer,packetrrrrWs$ "    zLibrary.definerc Cstjj|d}t|}t|}|dkr2dn|j}|dk rN| drNd}|j d|}tjj j |} |dk rt|||} n|} | j| |} |j| dS)z?Registers the fake impl for an operator defined in the library.rNz torchvision.r=)r)_libraryutils get_sourcesys _getframeinspect getmodule__name__ startswithr,Zsimple_registryZ singletonfind_check_pystubs_once abstract_implregisterr0append) r6op_namefn _stacklevelsourcer7Z caller_moduleZcaller_module_namerMentryZfunc_to_registerhandlerrr_register_fakes  zLibrary._register_fakecCs|dkr|j}t|tjjjs(tt|t r8|}n8t|t rh|j j }|j j }|dkrp|d|}ntd|jd|ddd|}|tkrtd|dd||j|jdk st|jj}||j|dd|t||j|dS) aRegister the operator to use the AOTI-compiled implementation. Args: op_name: operator name (along with the overload) or OpOverload object. dispatch_key: dispatch key that the input function should be registered for. By default, it uses the dispatch key that the library was created with. Example:: >>> my_lib = Library("aten", "IMPL") >>> my_lib._impl_with_aoti_compile("div.Tensor", "CPU") rr<zd_impl_with_aoti_compile should be passed either a name or an OpOverload object as the first argument/r=This is not allowed since there's already a kernel registered from python overriding {}'s behavior for {} dispatch key and {} namespace.N)r2r)ZDispatchKeySethasr*Z DispatchKeyZDenser?r@strr_schemarK overload_namer>r,rBrformatr+Zimpl_with_aoti_compilerHr/)r6r]r2rKrjkeyZimpl_fnrrr_impl_with_aoti_compiles.      zLibrary._impl_with_aoti_compileF with_keysetc CsBt|stdt||dkr(|j}t|tr8|}n8t|trh|jj}|jj }|dkrp|d|}nt d|j d| ddd|}|t krt d| dd||j |d kr|}d|kr|j d|}tj|d rt d |d |jd k st|j||dkr|nd ||t ||j|d S)aRegisters the function implementation for an operator defined in the library. Args: op_name: operator name (along with the overload) or OpOverload object. fn: function that's the operator implementation for the input dispatch key or :func:`~fallthrough_kernel` to register a fallthrough. dispatch_key: dispatch key that the input function should be registered for. By default, it uses the dispatch key that the library was created with. Example:: >>> my_lib = Library("aten", "IMPL") >>> def div_cpu(self, other): >>> return self * (1 / other) >>> my_lib.impl("div.Tensor", div_cpu, "CPU") z;Input function is required to be a callable but found type rr<zQimpl should be passed either a name or an OpOverload object as the first argumentrdr=rerfZMetaZCompositeImplicitAutogradz?We should not register a meta kernel directly to the operator 'z', because it has a CompositeImplicitAutograd kernel in core. Instead we should let the operator decompose, and ensure that we have meta kernels for the base ops that it decomposes into.N)callable TypeErrortyper2r@rhrrirKrjr>r,rBrrkr)r*Z%_dispatch_has_kernel_for_dispatch_keyr+r?rrHr/) r6r]r^r2rorKrjrlZdispatcher_op_namerrrrs>       z Library.implcCs|jdk r|jd|_|jD] }|q |jt|j8a|jD]P}|d\}}|dd}t t j |svqHt t j |}t ||sqHt ||qHdS)Nr=r<r)r+resetr0destroyclearrr/r.rBrCr)rDrEdelattr)r6rbrKr,Zname_with_overload namespacerrr_destroys           zLibrary._destroyN)r)r)r)r)r) rV __module__ __qualname____doc__r8r9rrcrmrrxrrrrr,s .  *=cCs&||8}||8}|D] }|qdSN)rt)Zcaptured_implsZop_implsZ captured_defsZop_defsZregistration_handlesrbrrrr5sr5cos$zt||}|VW5|XdSr|)rxr)argskwargslibrrr_scoped_library%s  r _keep_alivez \(.*\) -> .*r)rr:cCs|t|tstdt|tjj|\}}|dkrJt|d}t |t |sdtd|d|j ||d|ddS)aDefines a new operator. In PyTorch, defining an op (short for "operator") is a two step-process: - we need to define the op (by providing an operator name and schema) - we need to implement behavior for how the operator interacts with various PyTorch subsystems, like CPU/CUDA Tensors, Autograd, etc. This entrypoint defines the custom operator (the first step) you must then perform the second step by calling various ``impl_*`` APIs, like :func:`torch.library.impl` or :func:`torch.library.register_fake`. Args: qualname (str): The qualified name for the operator. Should be a string that looks like "namespace::name", e.g. "aten::sin". Operators in PyTorch need a namespace to avoid name collisions; a given operator may only be created once. If you are writing a Python library, we recommend the namespace to be the name of your top-level module. schema (str): The schema of the operator. E.g. "(Tensor x) -> Tensor" for an op that accepts one Tensor and returns one Tensor. It does not contain the operator name (that is passed in ``qualname``). lib (Optional[Library]): If provided, the lifetime of this operator will be tied to the lifetime of the Library object. tags (Tag | Sequence[Tag]): one or more torch.Tag to apply to this operator. Tagging an operator changes the operator's behavior under various PyTorch subsystems; please read the docs for the torch.Tag carefully before applying it. Example:: >>> import torch >>> import numpy as np >>> >>> # Define the operator >>> torch.library.define("mylib::sin", "(Tensor x) -> Tensor") >>> >>> # Add implementations for the operator >>> @torch.library.impl("mylib::sin", "cpu") >>> def f(x): >>> return torch.from_numpy(np.sin(x.numpy())) >>> >>> # Call the new operator from torch.ops. >>> x = torch.randn(3) >>> y = torch.ops.mylib.sin(x) >>> assert torch.allclose(y, x.sin()) zGdefine(qualname, schema): expected qualname to be instance of str, got Nr zadefine(qualname, schema, ...): expected schema to look like e.g. "(Tensor x) -> Tensor" but got ""r)rJr:)r@rhr#rrr)rOrPparse_namespacerrr\NAMELESS_SCHEMA fullmatchr)rMrIrr:rwrKrrrr4s1      rrcsfdd}|S)zOThe old torch.library.define. We're keeping this around for BC reasons cs}|||Sr|)rr)frKrJrrIrrwrapzs  _..wrapr)rrIrJrrrr_usrcstt|tr|f}ti|D].}tj|}|r<|qt|qfdd}|dkrh|S||dS)aRegister an implementation for a device type for this operator. You may pass "default" for ``types`` to register this implementation as the default implementation for ALL device types. Please only use this if the implementation truly supports all device types; for example, this is true if it is a composition of built-in PyTorch operators. Some valid types are: "cpu", "cuda", "xla", "mps", "ipu", "xpu". Args: qualname (str): Should be a string that looks like "namespace::operator_name". types (str | Sequence[str]): The device types to register an impl to. lib (Optional[Library]): If provided, the lifetime of this registration will be tied to the lifetime of the Library object. Examples: >>> import torch >>> import numpy as np >>> >>> # Define the operator >>> torch.library.define("mylib::mysin", "(Tensor x) -> Tensor") >>> >>> # Add implementations for the cpu device >>> @torch.library.impl("mylib::mysin", "cpu") >>> def f(x): >>> return torch.from_numpy(np.sin(x.numpy())) >>> >>> x = torch.randn(3) >>> y = torch.ops.mylib.mysin(x) >>> assert torch.allclose(y, x.sin()) csPtjj\}}dkr0t|d}t|n}D]}|||q8dS)Nr )r)rOrPrrrr\r)funcrwruse_librlkeysrrMrrr[s  zimpl..registerN)r@rhr-r)r*Z_parse_dispatch_keyrH_device_type_to_key)rMtypesrrtypZis_dispatch_keyr[rrrrs!    ) device_typereturncCs|dkr dStj|S)NdefaultCompositeExplicitAutograd)r)r*Z_dispatch_key_for_device)rrrrrsrcsfdd}|S)z1Legacy torch.library.impl API. Kept around for BCcs||Sr|)r)rr2rrKrrrsrr)rrKr2rrrrrsz`torch.library.impl_abstract` was renamed to `torch.library.register_fake`. Please use that instead; we will remove `torch.library.impl_abstract` in a future version of PyTorch.)categoryrr_cCs |dk r|d}t||||dS)zmThis API was renamed to :func:`torch.library.register_fake` in PyTorch 2.4. Please use that instead. Nrr)r)rMrrr_rrrrs ztorch._ops.OpOverloadz%torch._library.custom_ops.CustomOpDef)op device_typesrrcCs|t|ttjjtjjjfs"tdt|tjjr6|j }t |}|dk rR| ||St|ts`t |dkrld}t ||||dS)a5Register an implementation for a device type for this operator. Some valid device_types are: "cpu", "cuda", "xla", "mps", "ipu", "xpu". This API may be used as a decorator. Args: fn (Callable): The function to register as the implementation for the given device types. device_types (None | str | Sequence[str]): The device_types to register an impl to. If None, we will register to all device types -- please only use this option if your implementation is truly device-type-agnostic. Examples:: >>> # xdoctest: +REQUIRES(env:TORCH_DOCTEST_CUDA) >>> import torch >>> from torch import Tensor >>> from torch.library import custom_op >>> import numpy as np >>> >>> # Create a custom op that works on cpu >>> @custom_op("mylib::numpy_sin", mutates_args=(), device_types="cpu") >>> def numpy_sin(x: Tensor) -> Tensor: >>> x_np = x.numpy() >>> y_np = np.sin(x_np) >>> return torch.from_numpy(y_np) >>> >>> # Add implementations for the cuda device >>> @torch.library.register_kernel("mylib::numpy_sin", "cuda") >>> def _(x): >>> x_np = x.cpu().numpy() >>> y_np = np.sin(x_np) >>> return torch.from_numpy(y_np).to(device=x.device) >>> >>> x_cpu = torch.randn(3) >>> x_cuda = x_cpu.cuda() >>> assert torch.allclose(numpy_sin(x_cpu), x_cpu.sin()) >>> assert torch.allclose(numpy_sin(x_cuda), x_cuda.sin()) z;register_kernel(op): got unexpected type for op: {type(op)}Nrr)r@rhr)rGrrO custom_opsrr#_namerregister_kernelr?r)rrrropdefrrrrs/ r)rrrr_cstttjjtjjjfs"tdttjjr6j t }|dk r^|dkrT|j S| |Sttslt |fdd}|dkr|Sd7||SdS)aRegister a FakeTensor implementation ("fake impl") for this operator. Also sometimes known as a "meta kernel", "abstract impl". An "FakeTensor implementation" specifies the behavior of this operator on Tensors that carry no data ("FakeTensor"). Given some input Tensors with certain properties (sizes/strides/storage_offset/device), it specifies what the properties of the output Tensors are. The FakeTensor implementation has the same signature as the operator. It is run for both FakeTensors and meta tensors. To write a FakeTensor implementation, assume that all Tensor inputs to the operator are regular CPU/CUDA/Meta tensors, but they do not have storage, and you are trying to return regular CPU/CUDA/Meta tensor(s) as output. The FakeTensor implementation must consist of only PyTorch operations (and may not directly access the storage or data of any input or intermediate Tensors). This API may be used as a decorator (see examples). For a detailed guide on custom ops, please see https://pytorch.org/tutorials/advanced/custom_ops_landing_page.html Examples: >>> import torch >>> import numpy as np >>> from torch import Tensor >>> >>> # Example 1: an operator without data-dependent output shape >>> @torch.library.custom_op("mylib::custom_linear", mutates_args=()) >>> def custom_linear(x: Tensor, weight: Tensor, bias: Tensor) -> Tensor: >>> raise NotImplementedError("Implementation goes here") >>> >>> @torch.library.register_fake("mylib::custom_linear") >>> def _(x, weight, bias): >>> assert x.dim() == 2 >>> assert weight.dim() == 2 >>> assert bias.dim() == 1 >>> assert x.shape[1] == weight.shape[1] >>> assert weight.shape[0] == bias.shape[0] >>> assert x.device == weight.device >>> >>> return (x @ weight.t()) + bias >>> >>> with torch._subclasses.fake_tensor.FakeTensorMode(): >>> x = torch.randn(2, 3) >>> w = torch.randn(3, 3) >>> b = torch.randn(3) >>> y = torch.ops.mylib.custom_linear(x, w, b) >>> >>> assert y.shape == (2, 3) >>> >>> # Example 2: an operator with data-dependent output shape >>> @torch.library.custom_op("mylib::custom_nonzero", mutates_args=()) >>> def custom_nonzero(x: Tensor) -> Tensor: >>> x_np = x.numpy(force=True) >>> res = np.stack(np.nonzero(x_np), axis=1) >>> return torch.tensor(res, device=x.device) >>> >>> @torch.library.register_fake("mylib::custom_nonzero") >>> def _(x): >>> # Number of nonzero-elements is data-dependent. >>> # Since we cannot peek at the data in an fake impl, >>> # we use the ctx object to construct a new symint that >>> # represents the data-dependent size. >>> ctx = torch.library.get_ctx() >>> nnz = ctx.new_dynamic_size() >>> shape = [nnz, x.dim()] >>> result = x.new_empty(shape, dtype=torch.int64) >>> return result >>> >>> from torch.fx.experimental.proxy_tensor import make_fx >>> >>> x = torch.tensor([0, 1, 2, 3, 4, 0]) >>> trace = make_fx(torch.ops.mylib.custom_nonzero, tracing_mode="symbolic")(x) >>> trace.print_readable() >>> >>> assert torch.allclose(trace(x), torch.ops.mylib.custom_nonzero(x)) z9register_fake(op): got unexpected type for op: {type(op)}NcsLtjj\}}dkr0t|d}t|n}|j||dd|S)Nr r)r_)r)rOrPrrrr\rc)rrwr]rrr stacklevelrrr[s  zregister_fake..registerr) r@rhr)rGrrOrrr#rrrr?)rrrr_rr[rrrr"s W  ) setup_contextr)rbackwardrrc Cs&t|ttjjtjjjfs,tdt |t|tjjr@|j }t |}|dk rb|j ||ddSt|tspt |}tjj|}|j}tj|std|d|dtj|rtd|tj||}tj||}tjj|\} } |dkrt| d}t||j| |d d d dS) a Register a backward formula for this custom op. In order for an operator to work with autograd, you need to register a backward formula: 1. You must tell us how to compute gradients during the backward pass by providing us a "backward" function. 2. If you need any values from the forward to compute gradients, you can use `setup_context` to save values for backward. ``backward`` runs during the backward pass. It accepts ``(ctx, *grads)``: - ``grads`` is one or more gradients. The number of gradients matches the number of outputs of the operator. The ``ctx`` object is `the same ctx object `_ used by :class:`torch.autograd.Function`. The semantics of ``backward_fn`` are the same as :meth:`torch.autograd.Function.backward`. ``setup_context(ctx, inputs, output)`` runs during the forward pass. Please save quantities needed for backward onto the ``ctx`` object via either :meth:`torch.autograd.function.FunctionCtx.save_for_backward` or assigning them as attributes of ``ctx``. If your custom op has kwarg-only arguments, we expect the signature of ``setup_context`` to be ``setup_context(ctx, inputs, keyword_only_inputs, output)``. Both ``setup_context_fn`` and ``backward_fn`` must be traceable. That is, they may not directly access :meth:`torch.Tensor.data_ptr` and they must not depend on or mutate global state. If you need a non-traceable backward, you can make it a separate custom_op that you call inside ``backward_fn``. Examples: >>> import torch >>> import numpy as np >>> from torch import Tensor >>> >>> @torch.library.custom_op("mylib::numpy_sin", mutates_args=()) >>> def numpy_sin(x: Tensor) -> Tensor: >>> x_np = x.cpu().numpy() >>> y_np = np.sin(x_np) >>> return torch.from_numpy(y_np).to(device=x.device) >>> >>> def setup_context(ctx, inputs, output) -> Tensor: >>> x, = inputs >>> ctx.save_for_backward(x) >>> >>> def backward(ctx, grad): >>> x, = ctx.saved_tensors >>> return grad * x.cos() >>> >>> torch.library.register_autograd("mylib::numpy_sin", backward, setup_context=setup_context) >>> >>> x = torch.randn(3, requires_grad=True) >>> y = numpy_sin(x) >>> grad_x, = torch.autograd.grad(y, x, torch.ones_like(y)) >>> assert torch.allclose(grad_x, x.cos()) >>> >>> # Example with a keyword-only arg >>> @torch.library.custom_op("mylib::numpy_mul", mutates_args=()) >>> def numpy_mul(x: Tensor, *, val: float) -> Tensor: >>> x_np = x.cpu().numpy() >>> y_np = x_np * val >>> return torch.from_numpy(y_np).to(device=x.device) >>> >>> def setup_context(ctx, inputs, keyword_only_inputs, output) -> Tensor: >>> ctx.val = keyword_only_inputs["val"] >>> >>> def backward(ctx, grad): >>> return grad * ctx.val >>> >>> torch.library.register_autograd("mylib::numpy_mul", backward, setup_context=setup_context) >>> >>> x = torch.randn(3, requires_grad=True) >>> y = numpy_mul(x, val=3.14) >>> grad_x, = torch.autograd.grad(y, x, torch.ones_like(y)) >>> assert torch.allclose(grad_x, torch.full_like(x, 3.14)) z3register_autograd(op): got unexpected type for op: N)rz=Cannot register autograd formula for non-functional operator z with schema zP. Please create a functional operator and register an autograd formula for that.zregister_autograd with kwarg-only Tensor args. In the original definition of the op, please make your tensors not kwarg-only. Got: r ZAutogradTrn)r@rhr)rGrrOrrr#rrrrregister_autogradr?rP lookup_opriZis_functional_schemar>Zhas_kwarg_only_tensorsrZautogradZInfoZmake_autograd_implrrrr\r) rrrrrrMrIinfoZautograd_kernelrwopnamerrrrs6L     rcsdfdd}|S)NFc sr||Stjj}|jr0d||Stj|jj|jj }|dkrtjj r|j }|j }tddd|d|d n<|d}|kr|j }tdd|d d |d d||S) NTz Operator 'z' was defined in C++ and has a Python fake impl. In this situation, we require there to also be a companion C++ `m.set_python_module("z\")` call, but we could not find one. Please add that to to the top of the C++ TORCH_LIBRARY(z-, ...) block the operator was registered in ()rz?' specified that its python fake impl is in the Python module 'z ' but it was actually found in 'zM'. Please either move the fake impl or correct the m.set_python_module call ()r)rOrPrZ_defined_in_pythonr*Z_dispatch_pystubrirKrjZrequires_set_python_modulerwZ_handledebugr>)r}r~rZ maybe_pystubrwZ cpp_filenameZ pystub_moduleactual_module_namecheckedrrMrrinner s2     z"_check_pystubs_once..innerr)rrMrrrrrrY s#rYz,torch._library.abstract_impl.AbstractImplCtx)rcCs tjjS)zget_ctx() returns the current AbstractImplCtx object. Calling ``get_ctx()`` is only valid inside of an fake impl (see :func:`torch.library.register_fake` for more usage details. )r)rOrZZglobal_ctx_getterrrrrr9s)Z test_schemaZtest_autograd_registrationZtest_faketensorZtest_aot_dispatch_dynamicT test_utilsraise_exception.)rr}r~rrrcCs,ddlmmm}|j|||||dS)aAGiven an operator and some sample arguments, tests if the operator is registered correctly. That is, when you use the torch.library/TORCH_LIBRARY APIs to create a custom op, you specified metadata (e.g. mutability info) about the custom op and these APIs require that the functions you pass them satisfy certain properties (e.g. no data pointer access in the fake/meta/abstract kernel) ``opcheck`` tests these metadata and properties. Concretely, we test the following: - test_schema: if the operator's schema is correct. - test_autograd_registration: if autograd was registered correctly. - test_faketensor: If the operator has a FakeTensor kernel (and if it is correct). The FakeTensor kernel is necessary ( but not sufficient) for the operator to work with PyTorch compilation APIs (torch.compile/export/FX). - test_aot_dispatch_dynamic: If the operator has correct behavior with PyTorch compilation APIs (torch.compile/export/FX). This checks that the outputs (and gradients, if applicable) are the same under eager-mode PyTorch and torch.compile. This test is a superset of ``test_faketensor``. For best results, please call ``opcheck`` multiple times with a representative set of inputs. If your operator supports autograd, please use ``opcheck`` with inputs with ``requires_grad = True``; if your operator supports multiple devices (e.g. CPU and CUDA), please use ``opcheck`` with inputs on all supported devices. Args: op: The operator. Must either be a function decorated with :func:`torch.library.custom_op` or an OpOverload/OpOverloadPacket found in torch.ops.* (e.g. torch.ops.aten.sin, torch.ops.mylib.foo) args: The args to the operator kwargs: The kwargs to the operator test_utils: Tests that we should run. Default: all of them. Example: ("test_schema", "test_faketensor") raise_exception: If we should raise an exception on the first error. If False, we will return a dict with information on if each test passed or not. .. warning:: opcheck and :func:`torch.autograd.gradcheck` test different things; opcheck tests if your usage of torch.library APIs is correct while :func:`torch.autograd.gradcheck` tests if your autograd formula is mathematically correct. Use both to test custom ops that support gradient computation. Example: >>> # xdoctest: +REQUIRES(env:TORCH_DOCTEST_CUDA) >>> @torch.library.custom_op("mylib::numpy_mul", mutates_args=()) >>> def numpy_add(x: Tensor, y: float) -> Tensor: >>> x_np = x.numpy(force=True) >>> z_np = x_np + y >>> return torch.from_numpy(z_np).to(x.device) >>> >>> @numpy_sin.register_fake >>> def _(x, y): >>> return torch.empty_like(x) >>> >>> def setup_context(ctx, inputs, output): >>> y, = inputs >>> ctx.y = y >>> >>> def backward(ctx, grad): >>> return grad * ctx.y, None >>> >>> numpy_sin.register_autograd(backward, setup_context=setup_context) >>> >>> sample_inputs = [ >>> (torch.randn(3), 3.14), >>> (torch.randn(2, 3, device='cuda'), 2.718), >>> (torch.randn(1, 10, requires_grad=True), 1.234), >>> (torch.randn(64, 64, device='cuda', requires_grad=True), 90.18), >>> ] >>> >>> for args in sample_inputs: >>> torch.library.opcheck(foo, args) rNr)Ztorch.testing._internal.optestsZtesting _internaloptestsopcheck)rr}r~rrrrrrrJsYr)r)N)r)N)N)N)N)?rGrtypingrrrrrr r r r typing_extensionsr r%r)r3 functoolsrTre contextlibrRZtorch._library.custom_opsrrrrZtorch._libraryrO__all__r-rrh__annotations__rr$rrr5contextmanagerrrcompilersingledispatchrr[rrr FutureWarningrZ_op_identifierrintrrrYrZ_OPCHECK_DEFAULT_UTILSZOpOverloadPacketboolrrrrrs ,  s  @ @   > v q0