o
    XJ@h/                     @   s   d Z ddlZddlmZ ddlmZ ddlmZ ddlm	Z	 dd	l
mZ dd
l
mZ ddlmZ ddlmZ ddlmZ G dd dZG dd deZG dd deZG dd deZG dd dZG dd deZG dd de	ZeZdS )a	  

.. dialect:: sqlite+aiosqlite
    :name: aiosqlite
    :dbapi: aiosqlite
    :connectstring: sqlite+aiosqlite:///file_path
    :url: https://pypi.org/project/aiosqlite/

The aiosqlite dialect provides support for the SQLAlchemy asyncio interface
running on top of pysqlite.

aiosqlite is a wrapper around pysqlite that uses a background thread for
each connection.   It does not actually use non-blocking IO, as SQLite
databases are not socket-based.  However it does provide a working asyncio
interface that's useful for testing and prototyping purposes.

Using a special asyncio mediation layer, the aiosqlite dialect is usable
as the backend for the :ref:`SQLAlchemy asyncio <asyncio_toplevel>`
extension package.

This dialect should normally be used only with the
:func:`_asyncio.create_async_engine` engine creation function::

    from sqlalchemy.ext.asyncio import create_async_engine

    engine = create_async_engine("sqlite+aiosqlite:///filename")

The URL passes through all arguments to the ``pysqlite`` driver, so all
connection arguments are the same as they are for that of :ref:`pysqlite`.

.. _aiosqlite_udfs:

User-Defined Functions
----------------------

aiosqlite extends pysqlite to support async, so we can create our own user-defined functions (UDFs)
in Python and use them directly in SQLite queries as described here: :ref:`pysqlite_udfs`.

.. _aiosqlite_serializable:

Serializable isolation / Savepoints / Transactional DDL (asyncio version)
-------------------------------------------------------------------------

A newly revised version of this important section is now available
at the top level of the SQLAlchemy SQLite documentation, in the section
:ref:`sqlite_transactions`.


.. _aiosqlite_pooling:

Pooling Behavior
----------------

The SQLAlchemy ``aiosqlite`` DBAPI establishes the connection pool differently
based on the kind of SQLite database that's requested:

* When a ``:memory:`` SQLite database is specified, the dialect by default
  will use :class:`.StaticPool`. This pool maintains a single
  connection, so that all access to the engine
  use the same ``:memory:`` database.
* When a file-based database is specified, the dialect will use
  :class:`.AsyncAdaptedQueuePool` as the source of connections.

  .. versionchanged:: 2.0.38

    SQLite file database engines now use :class:`.AsyncAdaptedQueuePool` by default.
    Previously, :class:`.NullPool` were used.  The :class:`.NullPool` class
    may be used by specifying it via the
    :paramref:`_sa.create_engine.poolclass` parameter.

    N)deque)partial   )SQLiteExecutionContext)SQLiteDialect_pysqlite   )pool)util)AdaptedConnection)await_fallback)
await_onlyc                   @   s`   e Zd ZdZdZdd Zdd Zddd	Zd
d Zdd Z	dd Z
dd ZdddZdd ZdS )AsyncAdapt_aiosqlite_cursor)_adapt_connection_connectiondescriptionawait__rows	arraysizerowcount	lastrowidFc                 C   s4   || _ |j| _|j| _d| _d| _d | _t | _d S )Nr   )r   r   r   r   r   r   r   r   )selfZadapt_connection r   W/var/www/html/venv/lib/python3.10/site-packages/sqlalchemy/dialects/sqlite/aiosqlite.py__init__p   s   z$AsyncAdapt_aiosqlite_cursor.__init__c                 C   s   | j   d S N)r   clearr   r   r   r   closey      z!AsyncAdapt_aiosqlite_cursor.closeNc              
   C   s   zW|  | j }|d u r|  || n	|  ||| |jr:|j| _d | _| _| js9t|  |	 | _
nd | _|j| _|j| _| jsR|  |  W d S || _W d S  typ } z| j| W Y d }~d S d }~ww )Nr   )r   r   cursorexecuter   r   r   server_sider   fetchallr   r   _cursor	Exceptionr   _handle_exception)r   	operation
parametersr$   errorr   r   r   r!   |   s*   z#AsyncAdapt_aiosqlite_cursor.executec              
   C   s   z&|  | j }|  ||| d | _|j| _|j| _|  |  W d S  ty? } z| j	
| W Y d }~d S d }~ww r   )r   r   r    executemanyr   r   r   r   r%   r   r&   )r   r'   Zseq_of_parametersr$   r)   r   r   r   r*      s   z'AsyncAdapt_aiosqlite_cursor.executemanyc                 G   s   d S r   r   )r   Z
inputsizesr   r   r   setinputsizes   s   z)AsyncAdapt_aiosqlite_cursor.setinputsizesc                 c   s"    | j r| j  V  | j sd S d S r   r   popleftr   r   r   r   __iter__   s   z$AsyncAdapt_aiosqlite_cursor.__iter__c                 C   s   | j r| j  S d S r   r,   r   r   r   r   fetchone   s   
z$AsyncAdapt_aiosqlite_cursor.fetchonec                    s4   |d u r| j }| j  fddtt|t D S )Nc                    s   g | ]}   qS r   )r-   ).0_Zrrr   r   
<listcomp>   s    z9AsyncAdapt_aiosqlite_cursor.fetchmany.<locals>.<listcomp>)r   r   rangeminlenr   sizer   r2   r   	fetchmany   s    z%AsyncAdapt_aiosqlite_cursor.fetchmanyc                 C   s   t | j}| j  |S r   )listr   r   )r   retvalr   r   r   r#      s   

z$AsyncAdapt_aiosqlite_cursor.fetchallr   )__name__
__module____qualname__	__slots__r"   r   r   r!   r*   r+   r.   r/   r9   r#   r   r   r   r   r   _   s    	

r   c                       sF   e Zd ZdZdZ fddZdd Zdd Zdd
dZdd Z	  Z
S )AsyncAdapt_aiosqlite_ss_cursorr$   Tc                    s   t  j|i | d | _d S r   )superr   r$   )r   argkw	__class__r   r   r      s   
z'AsyncAdapt_aiosqlite_ss_cursor.__init__c                 C   s(   | j d ur| | j   d | _ d S d S r   )r$   r   r   r   r   r   r   r      s   

z$AsyncAdapt_aiosqlite_ss_cursor.closec                 C      |  | j S r   )r   r$   r/   r   r   r   r   r/         z'AsyncAdapt_aiosqlite_ss_cursor.fetchoneNc                 C   s"   |d u r| j }| | jj|dS )N)r8   )r   r   r$   r9   r7   r   r   r   r9      s   z(AsyncAdapt_aiosqlite_ss_cursor.fetchmanyc                 C   rF   r   )r   r$   r#   r   r   r   r   r#      rG   z'AsyncAdapt_aiosqlite_ss_cursor.fetchallr   )r<   r=   r>   r?   r"   r   r   r/   r9   r#   __classcell__r   r   rD   r   r@      s    
r@   c                   @   st   e Zd ZeeZdZdd Zedd Z	e	j
dd Z	dd Zdd
dZdd Zdd Zdd Zdd Zdd ZdS )AsyncAdapt_aiosqlite_connection)dbapic                 C   s   || _ || _d S r   )rJ   r   )r   rJ   
connectionr   r   r   r      s   
z(AsyncAdapt_aiosqlite_connection.__init__c                 C   s   | j jS r   )r   isolation_levelr   r   r   r   rL      s   z/AsyncAdapt_aiosqlite_connection.isolation_levelc              
   C   st   dd }t || jj|}t  }| jj||f z| |W S  t	y9 } z| 
| W Y d }~d S d }~ww )Nc                 S   s
   || _ d S r   )rL   )rK   valuer   r   r   set_iso   s   
z@AsyncAdapt_aiosqlite_connection.isolation_level.<locals>.set_iso)r   r   Z_connasyncioZget_event_loopZcreate_futureZ_tx
put_nowaitr   r%   r&   )r   rM   rN   functionfuturer)   r   r   r   rL      s   c              
   O   sP   z|  | jj|i | W d S  ty' } z| | W Y d }~d S d }~ww r   )r   r   create_functionr%   r&   )r   argsrC   r)   r   r   r   rS      s   z/AsyncAdapt_aiosqlite_connection.create_functionFc                 C   s   |rt | S t| S r   )r@   r   )r   r"   r   r   r   r       s   z&AsyncAdapt_aiosqlite_connection.cursorc                 O   s   |  | jj|i |S r   )r   r   r!   )r   rT   rC   r   r   r   r!     s   z'AsyncAdapt_aiosqlite_connection.executec              
   C   H   z|  | j  W d S  ty# } z| | W Y d }~d S d }~ww r   )r   r   rollbackr%   r&   r   r)   r   r   r   rV        z(AsyncAdapt_aiosqlite_connection.rollbackc              
   C   rU   r   )r   r   commitr%   r&   rW   r   r   r   rY     rX   z&AsyncAdapt_aiosqlite_connection.commitc              
   C   sZ   z|  | j  W d S  ty   Y d S  ty, } z| | W Y d }~d S d }~ww r   )r   r   r   
ValueErrorr%   r&   rW   r   r   r   r     s   	z%AsyncAdapt_aiosqlite_connection.closec                 C   s,   t |tr|jd dkr| jjd||)Nr   no active connection)
isinstancerZ   rT   rJ   sqliteOperationalErrorrW   r   r   r   r&   #  s   z1AsyncAdapt_aiosqlite_connection._handle_exceptionN)F)r<   r=   r>   staticmethodr   r   r?   r   propertyrL   setterrS   r    r!   rV   rY   r   r&   r   r   r   r   rI      s    


rI   c                   @   s   e Zd ZdZeeZdS )'AsyncAdaptFallback_aiosqlite_connectionr   N)r<   r=   r>   r?   r_   r   r   r   r   r   r   rb   /  s    rb   c                   @   s$   e Zd Zdd Zdd Zdd ZdS )AsyncAdapt_aiosqlite_dbapic                 C   s   || _ || _d| _|   d S )NZqmark)	aiosqliter]   Z
paramstyle_init_dbapi_attributes)r   rd   r]   r   r   r   r   6  s   z#AsyncAdapt_aiosqlite_dbapi.__init__c                 C   s^   dD ]}t | |t| j| qdD ]}t | |t| j| qdD ]}t | |t| j| q d S )N)ZDatabaseErrorErrorZIntegrityErrorZNotSupportedErrorr^   ZProgrammingErrorZsqlite_versionZsqlite_version_info)ZPARSE_COLNAMESZPARSE_DECLTYPES)Binary)setattrgetattrrd   r]   )r   namer   r   r   re   <  s   
z1AsyncAdapt_aiosqlite_dbapi._init_dbapi_attributesc                 O   sj   | dd}| dd }|r||i |}n| jj|i |}d|_t|r.t| t|S t| t	|S )Nasync_fallbackFZasync_creator_fnT)
poprd   connectdaemonr	   Zasboolrb   r   rI   r   )r   rB   rC   rk   Z
creator_fnrK   r   r   r   rm   O  s   
z"AsyncAdapt_aiosqlite_dbapi.connectN)r<   r=   r>   r   re   rm   r   r   r   r   rc   5  s    rc   c                   @   s   e Zd Zdd ZdS ) SQLiteExecutionContext_aiosqlitec                 C   s   | j jddS )NT)r"   )Z_dbapi_connectionr    r   r   r   r   create_server_side_cursorg  r   z:SQLiteExecutionContext_aiosqlite.create_server_side_cursorN)r<   r=   r>   rp   r   r   r   r   ro   f  s    ro   c                       sP   e Zd ZdZdZdZdZeZe	dd Z
e	dd Z fddZd	d
 Z  ZS )SQLiteDialect_aiosqliterd   Tc                 C   s   t tdtdS )Nrd   sqlite3)rc   
__import__)clsr   r   r   import_dbapiu  s   z$SQLiteDialect_aiosqlite.import_dbapic                 C   s   |  |rtjS tjS r   )Z_is_url_file_dbr   ZAsyncAdaptedQueuePoolZ
StaticPool)rt   urlr   r   r   get_pool_class{  s   
z&SQLiteDialect_aiosqlite.get_pool_classc                    s.   t || jjrdt|v rdS t |||S )Nr[   T)r\   rJ   r^   strrA   is_disconnect)r   erK   r    rD   r   r   ry     s   z%SQLiteDialect_aiosqlite.is_disconnectc                 C   s   |j S r   )r   )r   rK   r   r   r   get_driver_connection  s   z-SQLiteDialect_aiosqlite.get_driver_connection)r<   r=   r>   ZdriverZsupports_statement_cacheis_asyncZsupports_server_side_cursorsro   Zexecution_ctx_clsclassmethodru   rw   ry   r{   rH   r   r   rD   r   rq   k  s    

rq   )__doc__rO   collectionsr   	functoolsr   baser   Zpysqliter    r   r	   Zenginer
   Zutil.concurrencyr   r   r   r@   rI   rb   rc   ro   rq   dialectr   r   r   r   <module>   s&   	H]W1#