Ë hË5jv ãóT—ddlmZddlmZddlmZddlmZd d„Zd d„Z ed„«Z y) é)Ú annotations)Úcontextmanager)ÚLiteral)Ú_corecó4—tj|dk(«y)ažSet global object conversion mode. This controls how PDF scalar values (integers, booleans, reals) are returned when accessing PDF objects. Args: mode: Conversion mode. - ``'implicit'`` (default): Automatically convert PDF integers to Python ``int``, booleans to ``bool``, and reals to ``Decimal``. This is the legacy behavior. - ``'explicit'``: Return PDF scalars as ``pikepdf.Integer``, ``pikepdf.Boolean``, and ``pikepdf.Real`` objects. This enables better type safety and static type checking. Example: >>> pikepdf.set_object_conversion_mode('explicit') >>> pdf = pikepdf.open('test.pdf') >>> count = pdf.Root.Count >>> isinstance(count, pikepdf.Integer) # True in explicit mode True >>> int(count) # Convert to Python int 5 .. versionadded:: 10.1 ÚexplicitN)rÚ_set_explicit_conversion_mode)Úmodes úL/var/www/html/qr/venv/lib/python3.12/site-packages/pikepdf/_explicit_conv.pyÚset_object_conversion_moder s€ô4 ×'Ñ'¨° Ñ(:Õ;ócó2—tj«rdSdS)aáGet current effective object conversion mode. This returns the mode that is currently in effect for the calling thread, taking into account both the global setting and any active :func:`explicit_conversion` context managers. Returns: The current effective conversion mode: ``'implicit'`` or ``'explicit'``. .. versionadded:: 10.1 .. versionchanged:: 10.2 Now returns the effective mode, including thread-local context manager state. rÚimplicit)rÚ_get_effective_explicit_mode©r r Úget_object_conversion_moder+s€ô×;Ñ;Ô=ˆ:ÐMÀ:ÐMr c#ó˜K—tj« d–—tj«y#tj«wxYw­w)a&Context manager for explicit conversion mode. Within this context, PDF scalar values will be returned as ``pikepdf.Integer``, ``pikepdf.Boolean``, and ``pikepdf.Real`` objects instead of being automatically converted to Python native types. This context manager is thread-local: it only affects the current thread and takes precedence over the global setting from :func:`set_object_conversion_mode`. Nested context managers are supported. Example: >>> with pikepdf.explicit_conversion(): ... pdf = pikepdf.open('test.pdf') ... count = pdf.Root.Count ... isinstance(count, pikepdf.Integer) True .. versionadded:: 10.1 .. versionchanged:: 10.2 Now thread-local and takes precedence over global setting. N)rÚ_enter_thread_explicit_modeÚ_exit_thread_explicit_moderr r Úexplicit_conversionr=s4èø€ô0 ×%Ñ%Ô'ð+Û ä ×(Ñ(Õ*øŒ×(Ñ(Õ*üs‚A ˜1œA ±AÁA N)r úLiteral['implicit', 'explicit']ÚreturnÚNone)rr) Ú __future__rÚ contextlibrÚtypingrÚpikepdfrr rrrr r úrs4ðõ #õ&Ýåó<ó:Nð$ñ+óñ+r