o
    Df0                     @   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 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 )aZ
  

.. 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)
-------------------------------------------------------------------------

Similarly to pysqlite, aiosqlite does not support SAVEPOINT feature.

The solution is similar to :ref:`pysqlite_serializable`. This is achieved by the event listeners in async::

    from sqlalchemy import create_engine, event
    from sqlalchemy.ext.asyncio import create_async_engine

    engine = create_async_engine("sqlite+aiosqlite:///myfile.db")

    @event.listens_for(engine.sync_engine, "connect")
    def do_connect(dbapi_connection, connection_record):
        # disable aiosqlite's emitting of the BEGIN statement entirely.
        # also stops it from emitting COMMIT before any DDL.
        dbapi_connection.isolation_level = None

    @event.listens_for(engine.sync_engine, "begin")
    def do_begin(conn):
        # emit our own BEGIN
        conn.exec_driver_sql("BEGIN")

.. warning:: When using the above recipe, it is advised to not use the
   :paramref:`.Connection.execution_options.isolation_level` setting on
   :class:`_engine.Connection` and :func:`_sa.create_engine`
   with the SQLite driver,
   as this function necessarily will also alter the ".isolation_level" setting.

    N)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   s2   || _ |j| _|j| _d| _d| _d | _g | _d S )Nr   )r   r   r   r   r   r   r   )selfadapt_connection r   ]/home/ubuntu/webapp/venv/lib/python3.10/site-packages/sqlalchemy/dialects/sqlite/aiosqlite.py__init__m   s   
z$AsyncAdapt_aiosqlite_cursor.__init__c                 C   s   g | j d d < d S Nr   r   r   r   r   closev   s   z!AsyncAdapt_aiosqlite_cursor.closeNc              
   C   s   zU|  | j }|d u r|  || n	|  ||| |jr8|j| _d | _| _| js7|  | | _	nd | _|j| _|j| _| jsP|  |
  W d S || _W d S  tyn } z| j| W Y d }~d S d }~ww )Nr   )r   r   cursorexecuter   r   r   server_sidefetchallr   r   _cursor	Exceptionr   _handle_exception)r   	operation
parametersr#   errorr   r   r   r    y   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&   seq_of_parametersr#   r(   r   r   r   r)      s   z'AsyncAdapt_aiosqlite_cursor.executemanyc                 G   s   d S r   r   )r   
inputsizesr   r   r   setinputsizes   s   z)AsyncAdapt_aiosqlite_cursor.setinputsizesc                 c   s$    | j r| j dV  | j sd S d S Nr   r   popr   r   r   r   __iter__   s   z$AsyncAdapt_aiosqlite_cursor.__iter__c                 C   s   | j r	| j dS d S r-   r.   r   r   r   r   fetchone   s   z$AsyncAdapt_aiosqlite_cursor.fetchonec                 C   s8   |d u r| j }| jd| }| j|d  | jd d < |S r-   )r   r   )r   sizeretvalr   r   r   	fetchmany   s
   z%AsyncAdapt_aiosqlite_cursor.fetchmanyc                 C   s    | j d d  }g | j d d < |S r   r   )r   r3   r   r   r   r"      s   z$AsyncAdapt_aiosqlite_cursor.fetchallr   )__name__
__module____qualname__	__slots__r!   r   r   r    r)   r,   r0   r1   r4   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#   r1   r   r   r   r   r1         z'AsyncAdapt_aiosqlite_ss_cursor.fetchoneNc                 C   s"   |d u r| j }| | jj|dS )N)r2   )r   r   r#   r4   )r   r2   r   r   r   r4      s   z(AsyncAdapt_aiosqlite_ss_cursor.fetchmanyc                 C   r?   r   )r   r#   r"   r   r   r   r   r"      r@   z'AsyncAdapt_aiosqlite_ss_cursor.fetchallr   )r5   r6   r7   r8   r!   r   r   r1   r4   r"   __classcell__r   r   r=   r   r9      s    
r9   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   )rC   r   )r   rC   
connectionr   r   r   r      s   
z(AsyncAdapt_aiosqlite_connection.__init__c                 C   s   | j jS r   )r   isolation_levelr   r   r   r   rE      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   )rE   )rD   valuer   r   r   set_iso   s   
z@AsyncAdapt_aiosqlite_connection.isolation_level.<locals>.set_iso)r   r   _connasyncioget_event_loopcreate_future_tx
put_nowaitr   r$   r%   )r   rF   rG   functionfuturer(   r   r   r   rE      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   argsr<   r(   r   r   r   rP      s   z/AsyncAdapt_aiosqlite_connection.create_functionFc                 C   s   |rt | S t| S r   )r9   r   )r   r!   r   r   r   r      s   z&AsyncAdapt_aiosqlite_connection.cursorc                 O   s   |  | jj|i |S r   )r   r   r    )r   rQ   r<   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   rS        z(AsyncAdapt_aiosqlite_connection.rollbackc              
   C   rR   r   )r   r   commitr$   r%   rT   r   r   r   rV     rU   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%   rT   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)
isinstancerW   rQ   rC   sqliteOperationalErrorrT   r   r   r   r%   !  s   z1AsyncAdapt_aiosqlite_connection._handle_exceptionN)F)r5   r6   r7   staticmethodr   r   r8   r   propertyrE   setterrP   r   r    rS   rV   r   r%   r   r   r   r   rB      s    


rB   c                   @   s   e Zd ZdZeeZdS )'AsyncAdaptFallback_aiosqlite_connectionr   N)r5   r6   r7   r8   r\   r
   r   r   r   r   r   r_   -  s    r_   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 )Nqmark)	aiosqliterZ   
paramstyle_init_dbapi_attributes)r   rb   rZ   r   r   r   r   4  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)DatabaseErrorErrorIntegrityErrorNotSupportedErrorr[   ProgrammingErrorsqlite_versionsqlite_version_info)PARSE_COLNAMESPARSE_DECLTYPES)Binary)setattrgetattrrb   rZ   )r   namer   r   r   rd   :  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_fallbackFasync_creator_fnT)
r/   rb   connectdaemonr   asboolr_   r
   rB   r   )r   r;   r<   rr   
creator_fnrD   r   r   r   rt   M  s   
z"AsyncAdapt_aiosqlite_dbapi.connectN)r5   r6   r7   r   rd   rt   r   r   r   r   r`   3  s    r`   c                   @   s   e Zd Zdd ZdS ) SQLiteExecutionContext_aiosqlitec                 C   s   | j jddS )NT)r!   )_dbapi_connectionr   r   r   r   r   create_server_side_cursore  s   z:SQLiteExecutionContext_aiosqlite.create_server_side_cursorN)r5   r6   r7   rz   r   r   r   r   rx   d  s    rx   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_aiosqliterb   Tc                 C   s   t tdtdS )Nrb   sqlite3)r`   
__import__)clsr   r   r   import_dbapis  s   z$SQLiteDialect_aiosqlite.import_dbapic                 C   s   |  |rtjS tjS r   )_is_url_file_dbr   NullPool
StaticPool)r~   urlr   r   r   get_pool_classy  s   
z&SQLiteDialect_aiosqlite.get_pool_classc                    s.   t || jjrdt|v rdS t |||S )NrX   T)rY   rC   r[   strr:   is_disconnect)r   erD   r   r=   r   r   r     s   z%SQLiteDialect_aiosqlite.is_disconnectc                 C   s   |j S r   )r   )r   rD   r   r   r   get_driver_connection  s   z-SQLiteDialect_aiosqlite.get_driver_connection)r5   r6   r7   driversupports_statement_cacheis_asyncsupports_server_side_cursorsrx   execution_ctx_clsclassmethodr   r   r   r   rA   r   r   r=   r   r{   i  s    

r{   )__doc__rI   	functoolsr   baser   pysqliter    r   r   enginer	   util.concurrencyr
   r   r   r9   rB   r_   r`   rx   r{   dialectr   r   r   r   <module>   s$   	F^W1#