o )iT @sVUdZddlZddlmZejddkrddlmZndZee d <Gd d d Z dS) zAThis module provides classes to handle C++ objects from nanobind.N)AnyXGRAMMAR_BUILD_DOCS1)xgrammar_bindingszdummy namespace_corec@sDeZdZdZed ddZddZeddZd e de fd d Z d S) XGRObjectaThe 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)clshandleobjrJ/home/ubuntu/veenaModal/venv/lib/python3.10/site-packages/xgrammar/base.py_create_from_handles zXGRObject._create_from_handlecCs ||_dS)zInitialize 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. Nr )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._handleothercCst|tstS|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. ) isinstancerNotImplementedr)rrrrr__eq__Ds  zXGRObject.__eq__N)r r) __name__ __module__ __qualname____doc__ classmethodrrpropertyrobjectboolrrrrrr s   r) rostypingrenvirongetrr__annotations__rrrrrs