Class AbstractSessionPool (3.7.0)

AbstractSessionPool(labels=None)

Specifies required API for concrete session pool implementations.

Parameter
Name	Description
`labels`	`dict (str -> str) or None` (Optional) user-assigned labels for sessions created by the pool.

Properties

User-assigned labels for sessions created by the pool.

Returns
Type	Description
`dict (str -> str)`	labels assigned by the user

bind(database)

Associate the pool with a database.

Parameter
Name	Description
`database`	`Database` database used by the pool to create sessions when needed. Concrete implementations of this method may pre-fill the pool using the database.

Exceptions
Type	Description
`NotImplementedError`	abstract method

clear()

Delete all sessions in the pool.

Concrete implementations of this method are allowed to raise an error to signal that the pool is full, or to block until it is not full.

Exceptions
Type	Description
`NotImplementedError`	abstract method

get()

Check a session out from the pool.

Concrete implementations of this method are allowed to raise an error to signal that the pool is exhausted, or to block until a session is available.

Exceptions
Type	Description
`NotImplementedError`	abstract method

put(session)

Return a session to the pool.

Parameter
Name	Description
`session`	`Session` the session being returned. Concrete implementations of this method are allowed to raise an error to signal that the pool is full, or to block until it is not full.

Exceptions
Type	Description
`NotImplementedError`	abstract method

session(**kwargs)

Check out a session from the pool.

Returns
Type	Description
`SessionCheckout`	a checkout instance, to be used as a context manager for accessing the session and returning it to the pool.