o
     h                     @   s\   d dl mZ G dd dejZG dd dZG dd deejjZG dd	 d	eejjZd
S )   )typesc                   @   s   e Zd ZdZdS )JSONa	  MSSQL JSON type.

    MSSQL supports JSON-formatted data as of SQL Server 2016.

    The :class:`_mssql.JSON` datatype at the DDL level will represent the
    datatype as ``NVARCHAR(max)``, but provides for JSON-level comparison
    functions as well as Python coercion behavior.

    :class:`_mssql.JSON` is used automatically whenever the base
    :class:`_types.JSON` datatype is used against a SQL Server backend.

    .. seealso::

        :class:`_types.JSON` - main documentation for the generic
        cross-platform JSON datatype.

    The :class:`_mssql.JSON` type supports persistence of JSON values
    as well as the core index operations provided by :class:`_types.JSON`
    datatype, by adapting the operations to render the ``JSON_VALUE``
    or ``JSON_QUERY`` functions at the database level.

    The SQL Server :class:`_mssql.JSON` type necessarily makes use of the
    ``JSON_QUERY`` and ``JSON_VALUE`` functions when querying for elements
    of a JSON object.   These two functions have a major restriction in that
    they are **mutually exclusive** based on the type of object to be returned.
    The ``JSON_QUERY`` function **only** returns a JSON dictionary or list,
    but not an individual string, numeric, or boolean element; the
    ``JSON_VALUE`` function **only** returns an individual string, numeric,
    or boolean element.   **both functions either return NULL or raise
    an error if they are not used against the correct expected value**.

    To handle this awkward requirement, indexed access rules are as follows:

    1. When extracting a sub element from a JSON that is itself a JSON
       dictionary or list, the :meth:`_types.JSON.Comparator.as_json` accessor
       should be used::

            stmt = select(data_table.c.data["some key"].as_json()).where(
                data_table.c.data["some key"].as_json() == {"sub": "structure"}
            )

    2. When extracting a sub element from a JSON that is a plain boolean,
       string, integer, or float, use the appropriate method among
       :meth:`_types.JSON.Comparator.as_boolean`,
       :meth:`_types.JSON.Comparator.as_string`,
       :meth:`_types.JSON.Comparator.as_integer`,
       :meth:`_types.JSON.Comparator.as_float`::

            stmt = select(data_table.c.data["some key"].as_string()).where(
                data_table.c.data["some key"].as_string() == "some string"
            )

    .. versionadded:: 1.4


    N)__name__
__module____qualname____doc__ r   r   Q/var/www/html/venv/lib/python3.10/site-packages/sqlalchemy/dialects/mssql/json.pyr      s    r   c                   @   s$   e Zd Zdd Zdd Zdd ZdS )_FormatTypeMixinc                 C   s   t  N)NotImplementedErrorselfvaluer   r   r	   _format_valueU   s   z_FormatTypeMixin._format_valuec                         | fdd}|S )Nc                         | } r| } | S r   r   r   r   
super_procr   r	   process[      
z0_FormatTypeMixin.bind_processor.<locals>.process)string_bind_processorr   dialectr   r   r   r	   bind_processorX      
z_FormatTypeMixin.bind_processorc                    r   )Nc                    r   r   r   r   r   r   r	   r   f   r   z3_FormatTypeMixin.literal_processor.<locals>.process)string_literal_processorr   r   r   r	   literal_processorc   r   z"_FormatTypeMixin.literal_processorN)r   r   r   r   r   r   r   r   r   r	   r
   T   s    r
   c                   @      e Zd Zdd ZdS )JSONIndexTypec                 C   s"   t |trd| }|S d| }|S )Nz$[%s]z$."%s"
isinstanceintr   r   r   r	   r   p   s
   
zJSONIndexType._format_valueNr   r   r   r   r   r   r   r	   r!   o       r!   c                   @   r    )JSONPathTypec                 C   s   dd dd |D  S )Nz$%s c                 S   s&   g | ]}t |trd | nd| qS )z[%s]z."%s"r"   ).0elemr   r   r	   
<listcomp>|   s    z.JSONPathType._format_value.<locals>.<listcomp>)joinr   r   r   r	   r   y   s   zJSONPathType._format_valueNr%   r   r   r   r	   r'   x   r&   r'   N)r(   r   sqltypesr   r
   r!   r'   r   r   r   r	   <module>   s
   
A	