iker-python-common 1.0.60__tar.gz → 1.0.62__tar.gz

{iker_python_common-1.0.60 → iker_python_common-1.0.62}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: iker-python-common
-Version: 1.0.60
+Version: 1.0.62
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <3.15,>=3.12
+Requires-Dist: asyncpg>=0.30
 Requires-Dist: docker>=7.1
 Requires-Dist: numpy>=2.3
 Requires-Dist: psycopg>=3.2
@@ -15,6 +16,7 @@ Provides-Extra: all
 Requires-Dist: iker-python-common; extra == "all"
 Provides-Extra: test
 Requires-Dist: ddt>=1.7; extra == "test"
+Requires-Dist: pytest-asyncio>=1.2; extra == "test"
 Requires-Dist: pytest-cov>=5.0; extra == "test"
 Requires-Dist: pytest-mysql>=3.0; extra == "test"
 Requires-Dist: pytest-order>=1.3; extra == "test"

{iker_python_common-1.0.60 → iker_python_common-1.0.62}/pyproject.toml

@@ -8,6 +8,7 @@ build-backend = "setuptools.build_meta"
 
 [dependency-groups]
 dev = [
+    "asyncpg>=0.30",
     "docker>=7.1",
     "numpy>=2.3",
     "psycopg>=3.2",
@@ -16,6 +17,7 @@ dev = [
 ]
 test = [
     "ddt>=1.7",
+    "pytest-asyncio>=1.2",
     "pytest-cov>=5.0",
     "pytest-mysql>=3.0",
     "pytest-order>=1.3",
@@ -34,6 +36,7 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
+    "asyncpg>=0.30",
     "docker>=7.1",
     "numpy>=2.3",
     "psycopg>=3.2",
@@ -47,6 +50,7 @@ all = [
 ]
 test = [
     "ddt>=1.7",
+    "pytest-asyncio>=1.2",
     "pytest-cov>=5.0",
     "pytest-mysql>=3.0",
     "pytest-order>=1.3",

iker_python_common-1.0.62/resources/unittest/shutils/dir.baz/file.bar.baz

@@ -0,0 +1,16 @@
+a8a02100e9c056a268ab37eab24e779e48fede1876b84ed3c7ca8ab85deeaeca
+79e97fdca8f0654e868cc8df06cf6b6cfe9d462c840711dbf42a8607919701a7
+77c3748acb005e2f629a80b8040163365f37804d4b0e174ddb1ecf3a535397ec
+0491153226b97cad16810e00e29af54141390b3778902ca5bf10636f0ceb4517
+4c087fe45d4da13a4098a4d28429d4db44cffd5a1e74712e153528235ea4edae
+a6e92325d196f396e47b2359de8b8f42616dac799c2f902fa65af403b1b5f4da
+20ba5f1f9d22c9b872fe6fac9d1826fb8a25555dbc0c365e627c83413b33ec54
+8c2d17b8fd807064690e467a504e62488f122816dfe6633c12e7e5c602731c1f
+ea71cc5db9bc57291b342c7c57aca7efb0cdb4d483408e624e4784c46b5e6387
+03a9459c9d51a456256496cd5c4b869e9a9938554deab6d00d35757690b0e8eb
+1e3559627ab862dc5c2d484df8de62e5e688be5be6dc153fc6708c1204767c80
+bb59ca780800c5ac88ba97d16df06d655f6378c8e4ed72b0e56035453bb29780
+56d8c93fa7ac72d3609db5b950dac47da6e93c275f5138b32278ddde0c337ee6
+ea69fa60b4b36a8cf4d474e434ace98326f08e7cc0d3875b49c83c250a596ce6
+123607bc959c2db77828d2b42f1b05f53a4a8b7e6a74a496f85d23f7ec743cf5
+6b9aa2ff76e89a810e8ff6371ddf3b72084a03296b75a590b47593d53dec3486

iker_python_common-1.0.62/resources/unittest/shutils/dir.baz/file.foo.bar

@@ -0,0 +1,16 @@
+720d2bd3a25198a16f64ac3d4d1f8df7f557e9b35acc9d5581a8f3af82ce60ed
+79528118740a4d2b64448d079323f4d60b1d388999952971fcb11433bfc7cf13
+f854de5075f0f11bdf7e3169e9b0a4e8cf30debfca55074fb81e6ffd19610290
+ac16db129fca95347325c4a28aceac1b41cca825e817aa15b69bde06305246c4
+186f694795ff0205ce5394ee94158da39166dbb78013476e10044cabc4ae01e1
+26f7b3fa2999bb6f0f43e3deec6f31dbdd3d012136e31993c346ba3f9228318d
+9f6003a457daba22c887e7bacc384096318f9a1b51f7bf54fa73eccf9141e4a1
+4e067207135567f319705905488a4dea20b4190072cc28749508b521467cfd9c
+857e5f626be43bd9ee17d291bfdcbc1b9ec806f6a248c906d11dbeb9727fc540
+9ca0c7711187895faea3d80434b02765bf9734e70d6996c0e85c8bb9cf43997a
+ec3a8d2f8d1d2ad1b6b7df73d5fb0e70cee35e201c05fc601bf2e3646239504f
+4081ca757b01665e5165768db772d1df533232e207352dc22f7dfc1dbbc5177f
+2137c93ef01ea7020cd35c8d23c765618a7df1f68182cd2173b2ef78605b46ea
+0d5f72293e7cfe60d72fd8679b6245ccf9c6a02cf6c3ed22ed8bd4e936cb8b51
+0bad89c9fb578259d11a9a63e33a387bafbe2e77691b4a978e9ebbf0c1ebe9bd
+3ed28d1e72df01fcaf3bec7684f4a4e98e9034a90752e3f56129041a24bf90c9

iker_python_common-1.0.62/resources/unittest/shutils/dir.baz/file.foo.baz

@@ -0,0 +1,16 @@
+5e8cc51ab1aefd7a4e94d9694e520781035da2599e1bc9f8027bdce7ff38e071
+42f3d72ba0ce14e7677cc82f032d83e067988de918be1939ec92fb5345eacea0
+756c2890ee1ad7728a3a37a6152e70395a4175f0875df36c28db779b33a2465d
+5b7ddc909a5222a3104c735aca5fbb9664eff539881df9758ba57ec29eac190e
+38c2ad30436156b4097460462f886c2435aff974a890d8202450316ec1a4ccad
+0adf70c9d2e17a07e3ba5d5de40e2a76b97007da009bf71b07c4f2369e27a340
+053604687953985c938395d4e7a3ae51c4bbebb89c3fa8c62d77ce5b6fad6a74
+88ab13123bbfe44bc0feddac059f8c71ecb2ad43972f45b74c90d48cf1a66b45
+3ff068ee5fcab4e5de968a8effd4d51b051ab90f8998dc5ddaa35539ed31f822
+b875296acfc49ce62e8a26d725a022116c1befc5ad154883d0a8071bf7704a57
+b429b69be4616306dd65c5c4ebdef07a75aa51e9e272fed96175f17419a73e88
+7a00211dc02e8c6f912d3823a4867841a0728495fa290066c843490e746a44ac
+222d0a014c9d8a247e9ffd3386c188d402ed21c3037fad84a72d27e0d55d220a
+c78d7bb8b44bd0c4952f2628670820d2063eab056d089aa5623f06c675eac41a
+16ba9040e748ab4e36a5d66ec59c6a54448cc4e23c75462d2cf10e9443cdb23f
+9ee130f144ae1964f85756b1af88c7971a909c37b42773fee5fa59beab8ae476

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/dir.foo.bar/dir.foo.bar.baz/file.foo.bar.baz

@@ -0,0 +1,16 @@
+d4ea1f50310c6b388dc05225fb144edc2309fcc170578e03d21551d62f6c529b
+d8697d566d84fbe32a6612c9ea7f29d9fbb9580fa94a227985a85127790ab1d5
+56532a34324d071c42d022594b04541591082c1e01eeb7f3117a9b0b0b597dca
+0b3a5a6dd4d29e749070632d0bb6efe21545d03a2a83a56be09263c61e7996b3
+dfa9efd413d8b14bfe5ef2266a9bcc7bcb759366d83b52a47757c7eb3b83305a
+4363131c70131bff160c87d485678a7625ffe84ddf8afe26081f6976bfd9e1de
+4b08b08f541163376b1b6324e898f6e064895dfb577f27eb6da51cf72fdda1c1
+2955bdafdb1e25911d18d46b299dc2d1bb758864b12b0f994e8edb7413989152
+084b742162bd2be14cdec84a1c4d066777258ada62013614d0e35285c299ed20
+3091bc434a9db50a33d3e40c517fb1eefa206fb4fd6a049541391d80f6d292ac
+20aaf8f7c29a4dd3395da27a4d389edd3907c6e30808be383bc5b1836e18887b
+721c980d5dc32db0af11bb834e7e1bebd7f1cf43fbd328cc2c06c71e6a629bd9
+ce0ffb63bc50c92eb33f2e90412820d06ba87ffab6b99b6090a96cf25ec8400c
+c5371b421e9037d5c2f9ec492cf50c624dc2b364a55f3532285d966f777957ed
+773325da337c54ff631d578b56f961992cb199208a08e02ab0bd7e18acd9cddc
+dfec79db0381280f712129945e2f1f1c1b6d8af4f97363d9786b71a4ec0ba3e7

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/dir.foo.bar/file.bar.baz

@@ -0,0 +1,16 @@
+21f8bb48cae63d93c007ce3c01867c05d98b6f54dcb1271dbfa868928dd908d1
+f0a95b295397d5c5179ffb6db6768c78071468e03f3b28ae050f4ba71c1fb573
+b8b32ffaff720fc59abb293e444668efd2cba500f9718b899992a4bedbda9ca2
+564c5f8c6ffaeeacc11648f7081e313d220058b7bc4e224f4ae3665de61b3407
+f1b494e6a9e51787e75551e5eab78b65267921dbac0612425cd56e6fb5160541
+d00833db2ead9c2e0959f7d4df3d721eca01a5378c6b5be427427c9ccfddda3c
+2345e4cde221e719df5a98c5cddcd226c1955eaaa381a790a9ed31bdccc31561
+9079a1071adae4bb5d92a6b14fcc31f30295843eb05a76d097f83b3e5a91bdfd
+08c0c7bdeb84b14aa61fa197ee2e1d3ca587380956f9d78e9cb54063328d1db2
+dce9a86dee30cf11516a520e000f962a4285400cfb3534815b7ffaf570021ddb
+558b83ae432c6d84c3ff41682cabcd009405a6eed44fad326b19b4449f12dc2f
+994735e737cf223b5c35bf91ddf615f9ede92866861ebf00c5adc99f85e281be
+3d2fb05abf258f7086df1adaa9b1153dcbd97421afddc1840f236146d4a061d6
+9045c587beb27ec7e0bdccdb01c322943c6c3f41dc3e64b73c4ce087e6cdbf71
+2bcde27e4a4c3c353de550dd05221b2739c076b11230fc1e28d7b4ea5781308a
+1cd0ed94e53172dcad4350801b1bdb2a9eb1906661c803f62adce0b60a040918

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/dir.foo.bar/file.foo.bar

@@ -0,0 +1,16 @@
+da047c10deb537fc9054e886d0caca5ddbd92b50e4addb7aeb1671a59672082d
+77084de68a0d90919280ec6783ab81766f492a88b1389252431f2583c0eefaf5
+e6748050831576d0af305351847a746f4db843bd8b86dd16d376ebffd45af99e
+33bf4bc21ce7f6325d16495742bb0387a872deb16944ec91d59cf3c2509ffa27
+7f28f5bb1b8bcaf10419ee1b153ba5f10f45fd6ea033ce73a5e79c22398c6431
+81de68c34767beb3a569dcfbd6da6299a23048734f9ef6f4b90c8a7f7f796a38
+4aa0531b7c4ccabf176a62db435d2481a60cce01b8bc2b34c9d93200c105ba01
+317300d8fe7fc932eddc2e92530979021a429daf17e3506f9e8d2c8317d21c7d
+0ec23d1c56a22737be5a1f41741b1fa4e6c17964d262b53eb4a87bd8bda46f06
+3b57ae7bddcc2ea032fdef3584f1784996005517d86852a1a8552694360ae4c3
+adf1a0526704165a4ed38697b40bba6b934fa0c4fcd184554eee9b60dc5e6dc9
+6a811e36305b8c5f6dd643b3475834eb4c01ef8eda4996d766652479c1064d9c
+1cf2fc65c25841156b9b40d37137c1d8be316ae656263e5bb80c78a5bd99e50e
+63298b9ebbd015a76dd4569cfed1c79d300fdec01b642301c05b43299114bd18
+db0778ab7ce627f304206b0cb2b0084ea5de89a7e1076dbe003d311b293d3367
+1cef389f7e94e5b4fdb49bf34049acbe1409c4542a8a2002c082bcbcf00c2228

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/dir.foo.bar/file.foo.baz

@@ -0,0 +1,16 @@
+edc463c935e9c4cf8cff3ad1e825ab90a63019daa233aebd248074556f219e77
+e27cab488b83b915437a6d485b59d6902c5136a1da816515c463bc1dc1574b10
+7f3df81ebebc9f14998395f6075c55d34cd17f5c8df18b59d036b52e007c5ecf
+532bce7d2486aec458c94227c0564eebf18b726a67572c98efb812362e539798
+a2dc7c9a3c2500d9b025a3c2f43ec0a540d0f8c9292a31876f3d8dc7a9bf4768
+d1fee3fc1335a8f4e0ffd788ceca90991e0a08a01ab8bc8e59d4e0517a1ed239
+6ea15f2d28cb31b9d163eb46431ea5600b779eda1843ebc8f640058382b8a96f
+0007192199c1bd90af17b4fcab5997930e442b2f96a0d274a6c838c07508a2d0
+4a06289b76f6ea0cf3207864fe727b06e44fffc4584f82c334b4f427471dedbb
+8aadced49b1d8c565c55892e4fa8134295b41ce24da100d0884b2586f66a5a37
+a241d8c926cbbb2c2edcf216c6fe4fb8c8510ddedf6a21720abf27f448b9acd3
+f788780fd9290f471d03503a75442a53824a73d44c810b39eee7e9cb1d7f6b8b
+3afe9173afd8541f243070250b07fc9188c30fae04fc6ca1ab10ceb45fafa39a
+cc290a6a790d85371c05a13700e1cf59bec66e2707b94647983d4f0ef8dd8fb6
+54caa6a8178c01d79a8dda3bf98cb3c9b1a2394e483bfa4451627beb4b79cb5e
+a710a46c3fd1857352c15b9cf65dba498ea8de14e21db09d8a1c9db9ac8591ea

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/file.bar

@@ -0,0 +1,16 @@
+e03b7b0d2dd60cd95fe7da8340ef3ebc6ed61921c0eb78a622113fa92b741378
+8cc77d74e7f266431bd5d938a3f595fddce4ff0bba40c73ad01162ce713c441d
+c4e1e6b47236b80933fa20dd6d4036a72e961bdfee48fe1662a13f7c6d8e4d5b
+88bd23e9985c981a15bdb5e9046f518df2fba2fc3dd31761e69d987055e48892
+6a64664ab144a1404bbae297a13d376af4c36bd9b54fda06a18b5f5c1fe50d29
+5b8a2faf3e8b4c84af5bfbeb00c2f0ff0d460fd85e95064025b41cfafe72a980
+291ee31de42225c131ac95fdeae55c27e9eddd955465f015f3bcfb7344f6cdbc
+9175db19869c296308cacd445bbe6cf86143a0f3507b107ffd92762aa315bd3d
+0db30480b8f6b71562c00be807c0f79beab1cda8b460677e6cc228d69d0fc314
+9168239614522f5935235834af42fbee5f05ad2211f59942a0a53e0c6629257c
+3455fa92f90751bb8a42a826e4de9a2c829c24f7e15422b9b78724c2d4d0f46f
+7bde7a79971d85d2834fcf5856c89360f1958415aa61cd4030db39a66209b5f2
+fb47ac2282808dea1990d681a9e3f60f18b9c792fcc13b28d43d874c5ddf02c1
+2255496fdcc29fc436edd156922bbd03e5222166e33596d74238fca8a57325a7
+a2a5799e7d22f58030de160af13bab3a8b6f108c224324fec6140f955b99a0e1
+6653ed7f620088a543073fbacb59b9caf046550a82b8c0bd9e9d5c3275e23b39

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/file.baz

@@ -0,0 +1,16 @@
+9beca0b569e100daa77bc0cae2f8274b8b0b55b035819d8b8d854661ebccb1ba
+c05f336e81ff83a6ef099ea4a7b70dd7d6ea036568cab1304bd91d2d31d0bfe3
+63032207106e4a1bf4b14c44b8988899af7d0dea5892ac7d5091942c99cbe1c8
+940c24c7bdf89581810fe923469ce2b29eff0a74451e6e6520d3a4eb2a3bc09a
+d787e660a5660e6875060f1dcae1182fd40f40bf447edd5cf58f91463739bee9
+16f586fc70ff9b902f67c65b2d4860208d8c1acbdd476b90ca878eb7908f9e6c
+272a8fe74f5a5a6bc7a7e552b4ab4828a9cdf056024ad7c1713a41795239d81d
+51d6ed24dd74595ce9156a54fa7f7bd31007a37f4610b1e605d44f07f14edf93
+0e249567e7a95e75b98e6beee50f19fe9a4050fe2288e94a8bd87bf9efd47710
+fe042e8c3f8c9b5f86d891161bd5809f572f614edbb934a59fffea4c3cabb622
+20c2bbc4795d97eb816c84f0ad34301d5b30591c8528f11d8d8913d5327d1fad
+057a718799b4b651922530650f0da7136dcc4dd048647348db3af2bcd1d1fc1a
+461f64b586fceb204c997223131fa130c1d74195cebdb01232188cf9ff68c4fd
+64274b236d925d20b6e13942b0aef4446f828d10e36857692ba257a5768ca44d
+cdcf261900d316a5ff7d75bf5660c7e1678bf6cda3334a175274090aac75614c
+78e96c2fd083dd1f59941db04d9855a970e650b54d4c54b745af5fd323edf5d7

iker_python_common-1.0.62/resources/unittest/shutils/dir.foo/file.foo

@@ -0,0 +1,16 @@
+752cf8410dd84a5a1053536f4fe5416009bd4dd6f4db0311bdce88235d336b97
+2484eb97d5ba977a0b7334aa73e04ca89e6b1d4d73513c94fc19194f23428031
+a3e0e11e7512787b34eb8660072141f187a8771027d32d089a7416411982adce
+b43298b903a704473b94f54efb47f3b6e56a6a269d4564e725dbe47457be7d09
+906eff7e1d72e3684d34640f6017f16e46ffbee0d1c49f96119d5c83f578a6bf
+c5bd3c9ad6ca34f3a61272efe101560b293a1e653fc2e95b00cb6a036216b393
+73467c804507f63ddaa29f39de94588de2d0c06c2763a013129f5a662a0d9b5d
+8fe6f436bbb92066671ab74ba509076be3ee4ca32074962e9eef9c5b34efe7f3
+c0088c630e9b44e0a2c0164320d911be08c157d843d31e540e080fc62f542b34
+c87a737c9f366ef260711a77534a85196e7b16ad6408076411b4e8261b73c0cd
+0a5549819110866ef00e09e8da148bde5b2163475b048f5021698e95379b65d0
+daca621db335a79aefe95374d2234d28484916990a0b8247e50982a4e5050708
+b67c6cd33e79c8a73acc17072ead0915a25b6a5c42269ef142e90451073776fb
+2d4e962d84a7917ba699adaa737eb5b4def9608928e2babe4eb0da1cf02d9c33
+640cf148bafbf8fe3742ee0e1a68b58f2987379488c45a7980660cb1064e4865
+959a2707348202fd7c20a53d303acd0c4babc35fe39adade5c186b7b31dcffff

{iker_python_common-1.0.60 → iker_python_common-1.0.62}/src/iker/common/utils/dbutils.py

@@ -1,11 +1,13 @@
 import contextlib
 import dataclasses
-from typing import Any, Sequence
+from typing import Any, Self, Sequence
 
+import asyncpg
 import packaging.version
 import psycopg
 import pymysql
 import sqlalchemy
+import sqlalchemy.ext.asyncio
 import sqlalchemy.ext.compiler
 import sqlalchemy.orm
 
@@ -16,6 +18,7 @@ __all__ = [
     "Drivers",
     "make_scheme",
     "ConnectionMaker",
+    "AsyncConnectionMaker",
     "orm_to_dict",
     "orm_clone",
     "mysql_insert_ignore",
@@ -31,6 +34,7 @@ class Dialects:
 class Drivers:
     pymysql = pymysql.__name__
     psycopg = psycopg.__name__
+    asyncpg = asyncpg.__name__
 
 
 def make_scheme(dialect: str, driver: str | None = None) -> str:
@@ -65,9 +69,10 @@ class ConnectionMaker(object):
         self.engine_opts = engine_opts or {}
         self.session_opts = session_opts or {}
 
-    @staticmethod
+    @classmethod
     def create(
-        driver: str | None = None,
+        cls,
+        scheme: str | None = None,
         host: str | None = None,
         port: int | None = None,
         username: str | None = None,
@@ -76,11 +81,11 @@ class ConnectionMaker(object):
         *,
         engine_opts: dict[str, JsonType] | None = None,
         session_opts: dict[str, JsonType] | None = None,
-    ):
+    ) -> Self:
         """
         Creates a new instance of ``ConnectionMaker`` using the provided parameters to construct a SQLAlchemy URL.
 
-        :param driver: Optional database driver.
+        :param scheme: The database scheme (e.g., 'mysql+pymysql', 'postgresql+psycopg').
         :param host: The database host (e.g., 'localhost').
         :param port: The database port.
         :param username: The database username.
@@ -89,22 +94,23 @@ class ConnectionMaker(object):
         :param engine_opts: Optional dictionary of SQLAlchemy engine options.
         :param session_opts: Optional dictionary of SQLAlchemy session options.
         """
-        return ConnectionMaker(sqlalchemy.URL.create(drivername=driver,
-                                                     host=host,
-                                                     port=port,
-                                                     username=username,
-                                                     password=password,
-                                                     database=database),
-                               engine_opts=engine_opts,
-                               session_opts=session_opts)
-
-    @staticmethod
+        return cls(sqlalchemy.URL.create(drivername=scheme,
+                                         host=host,
+                                         port=port,
+                                         username=username,
+                                         password=password,
+                                         database=database),
+                   engine_opts=engine_opts,
+                   session_opts=session_opts)
+
+    @classmethod
     def from_url(
+        cls,
         url: str | sqlalchemy.URL,
         *,
         engine_opts: dict[str, JsonType] | None = None,
         session_opts: dict[str, JsonType] | None = None,
-    ) -> "ConnectionMaker":
+    ) -> Self:
         """
         Creates a new instance of ``ConnectionMaker`` from a SQLAlchemy URL string or object.
 
@@ -113,7 +119,7 @@ class ConnectionMaker(object):
         :param session_opts: Optional dictionary of SQLAlchemy session options.
         :return: A new instance of ``ConnectionMaker`` configured with the provided URL and options.
         """
-        return ConnectionMaker(sqlalchemy.make_url(url), engine_opts=engine_opts, session_opts=session_opts)
+        return cls(sqlalchemy.make_url(url), engine_opts=engine_opts, session_opts=session_opts)
 
     @property
     def connection_string(self) -> str:
@@ -155,7 +161,6 @@ class ConnectionMaker(object):
         Creates all tables defined in the given ORM base using the current engine.
 
         :param orm_base: The SQLAlchemy ORM base class.
-        :return: None.
         """
         if packaging.version.parse(sqlalchemy.__version__) >= packaging.version.parse("2"):
             if not isinstance(orm_base, type) or not issubclass(orm_base, sqlalchemy.orm.DeclarativeBase):
@@ -168,7 +173,6 @@ class ConnectionMaker(object):
         Drops all tables defined in the given ORM base using the current engine.
 
         :param orm_base: The SQLAlchemy ORM base class.
-        :return: None.
         """
         if packaging.version.parse(sqlalchemy.__version__) >= packaging.version.parse("2"):
             if not isinstance(orm_base, type) or not issubclass(orm_base, sqlalchemy.orm.DeclarativeBase):
@@ -182,7 +186,6 @@ class ConnectionMaker(object):
 
         :param sql: The SQL statement to execute.
         :param params: The parameters dictionary for the SQL statement.
-        :return: None.
         """
         with self.make_session() as session:
             session.execute(sqlalchemy.text(sql), params)
@@ -214,6 +217,104 @@ class ConnectionMaker(object):
             return result.first()
 
 
+class AsyncConnectionMaker(ConnectionMaker):
+    """
+    Provides utilities to simplify establishing asynchronous database connections and sessions, including connection
+    string construction, async engine and session creation, and model management.
+    """
+
+    @property
+    def engine(self) -> sqlalchemy.ext.asyncio.AsyncEngine:
+        """
+        Returns a SQLAlchemy ``AsyncEngine`` instance for the configured connection string and engine options.
+
+        :return: The SQLAlchemy ``AsyncEngine``.
+        """
+        return sqlalchemy.ext.asyncio.create_async_engine(self.connection_string, **self.engine_opts)
+
+    async def make_connection(self) -> sqlalchemy.ext.asyncio.AsyncConnection:
+        """
+        Asynchronously establishes and returns a new database connection using the SQLAlchemy async engine.
+
+        :return: A database connection object.
+        """
+        return await self.engine.connect()
+
+    def make_session(self, **kwargs) -> contextlib.AbstractAsyncContextManager[
+        sqlalchemy.ext.asyncio.AsyncSession
+    ]:
+        """
+        Creates a context-managed asynchronous SQLAlchemy session with the configured async engine and session options.
+
+        :param kwargs: Additional keyword arguments for session creation.
+        :return: A context manager yielding a SQLAlchemy ``AsyncSession``.
+        """
+        return contextlib.aclosing(
+            sqlalchemy.ext.asyncio.async_sessionmaker(self.engine, **{**self.session_opts, **kwargs})())
+
+    async def create_model(self, orm_base):
+        """
+        Asynchronously creates all tables defined in the given ORM base using the current async engine.
+
+        :param orm_base: The SQLAlchemy ORM base class.
+        """
+        if packaging.version.parse(sqlalchemy.__version__) >= packaging.version.parse("2"):
+            if not isinstance(orm_base, type) or not issubclass(orm_base, sqlalchemy.orm.DeclarativeBase):
+                raise TypeError("not a subclass of 'sqlalchemy.orm.DeclarativeBase'")
+
+        async with self.engine.begin() as conn:
+            await conn.run_sync(orm_base.metadata.create_all)
+
+    async def drop_model(self, orm_base):
+        """
+        Asynchronously drops all tables defined in the given ORM base using the current async engine.
+
+        :param orm_base: The SQLAlchemy ORM base class.
+        """
+        if packaging.version.parse(sqlalchemy.__version__) >= packaging.version.parse("2"):
+            if not isinstance(orm_base, type) or not issubclass(orm_base, sqlalchemy.orm.DeclarativeBase):
+                raise TypeError("not a subclass of 'sqlalchemy.orm.DeclarativeBase'")
+
+        async with self.engine.begin() as conn:
+            await conn.run_sync(orm_base.metadata.drop_all)
+
+    async def execute(self, sql: str, **params):
+        """
+        Executes the given SQL statement with the specified parameters.
+
+        :param sql: The SQL statement to execute.
+        :param params: The parameters dictionary for the SQL statement.
+        """
+        async with self.make_session() as session:
+            await session.execute(sqlalchemy.text(sql), params)
+            await session.commit()
+
+    async def query_all(self, sql: str, **params) -> Sequence[sqlalchemy.Row[tuple[Any, ...]]]:
+        """
+        Executes the given SQL query with the specified parameters and returns all result tuples.
+
+        :param sql: The SQL query to execute.
+        :param params: The parameters dictionary for the SQL query.
+        :return: A list of result tuples.
+        """
+        async with self.make_session() as session:
+            query = await session.execute(sqlalchemy.text(sql), params)
+            return query.all()
+
+    async def query_first(self, sql: str, **params) -> sqlalchemy.Row[tuple[Any, ...]] | None:
+        """
+        Executes the given SQL query with the specified parameters and returns the first result tuple, or ``None``
+        if no results are found.
+
+        :param sql: The SQL query to execute.
+        :param params: The parameters dictionary for the SQL query.
+        :return: The first result tuple, or ``None`` if no results are found.
+        """
+        async with self.make_session() as session:
+            query = await session.execute(sqlalchemy.text(sql), params)
+            return query.first()
+
+
 def orm_to_dict(orm, exclude: set[str] = None) -> dict[str, Any]:
     """
     Converts an ORM object to a dictionary, optionally excluding specified fields.

{iker_python_common-1.0.60 → iker_python_common-1.0.62}/src/iker_python_common.egg-info/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: iker-python-common
-Version: 1.0.60
+Version: 1.0.62
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: <3.15,>=3.12
+Requires-Dist: asyncpg>=0.30
 Requires-Dist: docker>=7.1
 Requires-Dist: numpy>=2.3
 Requires-Dist: psycopg>=3.2
@@ -15,6 +16,7 @@ Provides-Extra: all
 Requires-Dist: iker-python-common; extra == "all"
 Provides-Extra: test
 Requires-Dist: ddt>=1.7; extra == "test"
+Requires-Dist: pytest-asyncio>=1.2; extra == "test"
 Requires-Dist: pytest-cov>=5.0; extra == "test"
 Requires-Dist: pytest-mysql>=3.0; extra == "test"
 Requires-Dist: pytest-order>=1.3; extra == "test"

{iker_python_common-1.0.60 → iker_python_common-1.0.62}/src/iker_python_common.egg-info/requires.txt

@@ -1,3 +1,4 @@
+asyncpg>=0.30
 docker>=7.1
 numpy>=2.3
 psycopg>=3.2
@@ -9,6 +10,7 @@ iker-python-common
 
 [test]
 ddt>=1.7
+pytest-asyncio>=1.2
 pytest-cov>=5.0
 pytest-mysql>=3.0
 pytest-order>=1.3