o Û¾iT ã@sVUdZddlZddlmZej d¡dkrddlmZndZee d <Gd d „d ƒZ dS) zAThis module provides classes to handle C++ objects from nanobind.éN)ÚAnyÚXGRAMMAR_BUILD_DOCSÚ1é)Úxgrammar_bindingszdummy namespaceÚ_corec@sDeZdZdZed dd„ƒZdd„Zedd„ƒZd e de fd d „Z d S)Ú XGRObjectaŽThe base class for all objects in XGrammar. This class provides methods to handle the C++ handle from nanobind. In subclasses, the handle should be initialized via the the _create_from_handle, or via the _init_handle method called within the __init__ method, and should not be modified afterwards. Subclasses should use the _handle property to access the handle. When comparing two objects, the equality is checked by comparing the C++ handles. For performance considerations, objects in XGrammar should be lightweight and only maintain a handle to the C++ objects. Heavy operations should be performed on the C++ side. ÚreturncCs| |¡}||_|S)aConstruct an object of the class from a C++ handle. Parameters ---------- cls The class of the object. handle The C++ handle. Returns ------- obj : XGRObject An object of type cls. )Ú__new__Ú_XGRObject__handle)ÚclsÚhandleÚobj©rúA/home/ubuntu/.local/lib/python3.10/site-packages/xgrammar/base.pyÚ_create_from_handles zXGRObject._create_from_handlecCs ||_dS)z÷Initialize an object with a handle. This method should be called in the __init__ method of the subclasses of XGRObject to initialize the C++ handle. Parameters ---------- handle The C++ handle. N©r )Úselfr rrrÚ _init_handle.s zXGRObject._init_handlecCs|jS)zvGet the C++ handle of the object. Returns ------- handle The C++ handle. r)rrrrÚ_handle9s zXGRObject._handleÚothercCst|tƒstS|j|jkS)a%Compare two XGrammar objects by comparing their C++ handles. Parameters ---------- other : object The other object to compare with. Returns ------- equal : bool Whether the two objects have the same C++ handle. )Ú isinstancerÚNotImplementedr)rrrrrÚ__eq__Ds  zXGRObject.__eq__N)r r) Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú classmethodrrÚpropertyrÚobjectÚboolrrrrrr s   r) rÚosÚtypingrÚenvironÚgetÚrrÚ__annotations__rrrrrÚs