*`iT UdZddlZddlmZejddkrddlmZndZee d <Gd d Z dS) zAThis module provides classes to handle C++ objects from nanobind.N)AnyXGRAMMAR_BUILD_DOCS1)xgrammar_bindingszdummy namespace_corecVeZdZdZed dZdZedZde de fdZ dS) 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. returnc>||}||_|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)clshandleobjs a/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/xgrammar/base.py_create_from_handlezXGRObject._create_from_handles!"kk#  c||_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)selfrs r _init_handlezXGRObject._init_handle.s rc|jS)zvGet the C++ handle of the object. Returns ------- handle The C++ handle. r)rs r_handlezXGRObject._handle9s }rothercZt|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. ) isinstancer NotImplementedr)rrs r__eq__zXGRObject.__eq__Ds+%++ "! !|u},,rN)r r ) __name__ __module__ __qualname____doc__ classmethodrrpropertyrobjectboolrrrr r s  [(   X-F-t------rr ) r#ostypingrenvirongetrr__annotations__r r(rrr/sGGG :>>'((C//,,,,,,,"E3"""G-G-G-G-G-G-G-G-G-G-r