pydpm_xl 0.2.6__py3-none-any.whl → 0.2.7__py3-none-any.whl

py_dpm/__init__.py

@@ -41,7 +41,7 @@ Available packages:
 - pydpm.api: Main APIs for migration, syntax, and semantic analysis
 """
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"
 __author__ = "MeaningfulData S.L."
 __email__ = "info@meaningfuldata.eu"
 __license__ = "GPL-3.0-or-later"

py_dpm/api/dpm/data_dictionary.py

@@ -50,7 +50,10 @@ class DataDictionaryAPI:
     """
 
     def __init__(
-        self, database_path: Optional[str] = None, connection_url: Optional[str] = None
+        self,
+        database_path: Optional[str] = None,
+        connection_url: Optional[str] = None,
+        pool_config: Optional[Dict[str, Any]] = None,
     ):
         """
         Initialize the Data Dictionary API.
@@ -58,8 +61,14 @@ class DataDictionaryAPI:
         Args:
             database_path: Path to SQLite database (optional)
             connection_url: SQLAlchemy connection URL for PostgreSQL (optional)
+            pool_config: Connection pool configuration for PostgreSQL/MySQL (optional)
+                Supported keys: pool_size, max_overflow, pool_timeout, pool_recycle, pool_pre_ping.
         """
-        engine = get_engine(database_path=database_path, connection_url=connection_url)
+        engine = get_engine(
+            database_path=database_path,
+            connection_url=connection_url,
+            pool_config=pool_config
+        )
         self.session = get_session()
 
     # ==================== Release Query Methods ====================

py_dpm/api/dpm_xl/ast_generator.py

@@ -48,6 +48,7 @@ class ASTGeneratorAPI:
 
     def __init__(self, database_path: Optional[str] = None,
                  connection_url: Optional[str] = None,
+                 pool_config: Optional[Dict[str, Any]] = None,
                  compatibility_mode: str = "auto",
                  enable_semantic_validation: bool = False):
         """
@@ -56,13 +57,19 @@ class ASTGeneratorAPI:
         Args:
             database_path: Optional path to SQLite data dictionary database
             connection_url: Optional SQLAlchemy connection URL for PostgreSQL
+            pool_config: Connection pool configuration for PostgreSQL/MySQL
             compatibility_mode: "auto", "3.1.0", "4.0.0", or "current"
             enable_semantic_validation: Enable semantic validation (requires database)
         """
         self.syntax_api = SyntaxAPI()
-        self.semantic_api = SemanticAPI(database_path=database_path, connection_url=connection_url) if enable_semantic_validation else None
+        self.semantic_api = SemanticAPI(
+            database_path=database_path,
+            connection_url=connection_url,
+            pool_config=pool_config
+        ) if enable_semantic_validation else None
         self.database_path = database_path
         self.connection_url = connection_url
+        self.pool_config = pool_config
         self.compatibility_mode = compatibility_mode
         self.enable_semantic = enable_semantic_validation
 

py_dpm/api/dpm_xl/operation_scopes.py

@@ -100,7 +100,10 @@ class OperationScopesAPI:
     """
 
     def __init__(
-        self, database_path: Optional[str] = None, connection_url: Optional[str] = None
+        self,
+        database_path: Optional[str] = None,
+        connection_url: Optional[str] = None,
+        pool_config: Optional[Dict[str, Any]] = None,
     ):
         """
         Initialize the Operation Scopes API.
@@ -109,9 +112,12 @@ class OperationScopesAPI:
             database_path (Optional[str]): Path to SQLite database. If None, uses default from environment.
             connection_url (Optional[str]): Full SQLAlchemy connection URL (e.g., postgresql://user:pass@host:port/db).
                                           Takes precedence over database_path.
+            pool_config (Optional[Dict[str, Any]]): Connection pool configuration for PostgreSQL/MySQL.
+                Supported keys: pool_size, max_overflow, pool_timeout, pool_recycle, pool_pre_ping.
         """
         self.database_path = database_path
         self.connection_url = connection_url
+        self.pool_config = pool_config
 
         if connection_url:
             # Create isolated engine and session for the provided connection URL
@@ -119,7 +125,7 @@ class OperationScopesAPI:
             from py_dpm.dpm.utils import create_engine_from_url
 
             # Create engine for the connection URL (supports SQLite, PostgreSQL, MySQL, etc.)
-            self.engine = create_engine_from_url(connection_url)
+            self.engine = create_engine_from_url(connection_url, pool_config=pool_config)
             session_maker = sessionmaker(bind=self.engine)
             self.session = session_maker()
 

py_dpm/api/dpm_xl/semantic.py

@@ -44,7 +44,10 @@ class SemanticAPI:
     """
 
     def __init__(
-        self, database_path: Optional[str] = None, connection_url: Optional[str] = None
+        self,
+        database_path: Optional[str] = None,
+        connection_url: Optional[str] = None,
+        pool_config: Optional[Dict[str, Any]] = None,
     ):
         """
         Initialize the Semantic API.
@@ -53,9 +56,12 @@ class SemanticAPI:
             database_path (Optional[str]): Path to SQLite database. If None, uses default from environment.
             connection_url (Optional[str]): Full SQLAlchemy connection URL (e.g., postgresql://user:pass@host:port/db).
                                           Takes precedence over database_path.
+            pool_config (Optional[Dict[str, Any]]): Connection pool configuration for PostgreSQL/MySQL.
+                Supported keys: pool_size, max_overflow, pool_timeout, pool_recycle, pool_pre_ping.
         """
         self.database_path = database_path
         self.connection_url = connection_url
+        self.pool_config = pool_config
         # Store last parsed AST for consumers that need it (e.g. complete AST generation)
         self.ast = None
 
@@ -65,7 +71,7 @@ class SemanticAPI:
             from py_dpm.dpm.utils import create_engine_from_url
 
             # Create engine for the connection URL (supports SQLite, PostgreSQL, MySQL, etc.)
-            self.engine = create_engine_from_url(connection_url)
+            self.engine = create_engine_from_url(connection_url, pool_config=pool_config)
             session_maker = sessionmaker(bind=self.engine)
             self.session = session_maker()
 

py_dpm/dpm/utils.py

@@ -84,7 +84,7 @@ sessionMakerObject = None
 _current_engine_url = None
 
 
-def create_engine_from_url(connection_url):
+def create_engine_from_url(connection_url, pool_config=None):
     """
     Create SQLAlchemy engine from a connection URL with appropriate pooling parameters.
 
@@ -96,6 +96,12 @@ def create_engine_from_url(connection_url):
 
     Args:
         connection_url (str): SQLAlchemy connection URL (e.g., 'sqlite:///path.db', 'postgresql://user:pass@host/db')
+        pool_config (dict, optional): Custom pool configuration. Supported keys:
+            - pool_size (int): Maximum number of connections to maintain in the pool (default: 20)
+            - max_overflow (int): Maximum overflow connections beyond pool_size (default: 10)
+            - pool_timeout (int): Seconds to wait before giving up on getting a connection (default: 30)
+            - pool_recycle (int): Seconds before recycling connections (default: 180)
+            - pool_pre_ping (bool): Health check connections before using from pool (default: True)
 
     Returns:
         sqlalchemy.engine.Engine: Configured database engine
@@ -103,6 +109,8 @@ def create_engine_from_url(connection_url):
     Examples:
         >>> engine = create_engine_from_url('sqlite:///database.db')
         >>> engine = create_engine_from_url('postgresql://user:pass@localhost/mydb')
+        >>> engine = create_engine_from_url('postgresql://user:pass@localhost/mydb',
+        ...                                   pool_config={'pool_size': 5, 'max_overflow': 10})
     """
     global engine, sessionMakerObject, _current_engine_url
 
@@ -123,12 +131,22 @@ def create_engine_from_url(connection_url):
         engine = create_engine(connection_url, pool_pre_ping=True)
     else:
         # Server-based databases (PostgreSQL, MySQL, etc.) with connection pooling
+        # Default pool configuration
+        default_pool_config = {
+            'pool_size': 20,
+            'max_overflow': 10,
+            'pool_timeout': 30,
+            'pool_recycle': 180,
+            'pool_pre_ping': True,
+        }
+
+        # Merge custom pool_config with defaults
+        if pool_config:
+            default_pool_config.update(pool_config)
+
         engine = create_engine(
             connection_url,
-            pool_size=20,
-            max_overflow=10,
-            pool_recycle=180,
-            pool_pre_ping=True,
+            **default_pool_config
         )
 
     # Initialize global sessionMakerObject
@@ -170,7 +188,7 @@ def create_engine_object(url):
     return engine
 
 
-def get_engine(owner=None, database_path=None, connection_url=None):
+def get_engine(owner=None, database_path=None, connection_url=None, pool_config=None):
     """
     Get database engine based on configuration or explicit parameters.
 
@@ -184,13 +202,14 @@ def get_engine(owner=None, database_path=None, connection_url=None):
         owner: Owner for SQL Server databases (EBA/EIOPA) - legacy support
         database_path: Explicit SQLite database path
         connection_url: Explicit SQLAlchemy connection URL (e.g., for PostgreSQL)
+        pool_config: Connection pool configuration dict (for PostgreSQL/MySQL)
 
     Returns:
         SQLAlchemy Engine
     """
     # Priority 1: If explicit connection URL is provided, use it directly
     if connection_url:
-        return create_engine_from_url(connection_url)
+        return create_engine_from_url(connection_url, pool_config=pool_config)
 
     # Priority 2: If explicit database_path is provided, use SQLite with that path
     if database_path:

{pydpm_xl-0.2.6.dist-info → pydpm_xl-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydpm_xl
-Version: 0.2.6
+Version: 0.2.7
 Summary: Python library for DPM-XL data processing and analysis
 Author-email: "MeaningfulData S.L." <info@meaningfuldata.eu>
 License: GPL-3.0-or-later

{pydpm_xl-0.2.6.dist-info → pydpm_xl-0.2.7.dist-info}/RECORD

@@ -1,16 +1,16 @@
-py_dpm/__init__.py,sha256=EoSVcX1P4pvEC2vpV8uwhWNcq-jFuDPoUho2_yygUkA,1858
+py_dpm/__init__.py,sha256=a2pLEJ-WUNGj-wIL9gxgvcBpavgpyCKq-DbzJMC2dbA,1858
 py_dpm/api/__init__.py,sha256=6ElO0NKEjuqiHNxK7pxkzLNlaUOrYKnY3N0fUDDobik,1021
 py_dpm/api/dpm/__init__.py,sha256=HQflgiRbs1eDi3KTadNhxS1NoaG6PGQDVMvFnuIEfXo,506
-py_dpm/api/dpm/data_dictionary.py,sha256=zLkHrprXMgdoUqhf-TWDg4FEdlkvefc7fMtkENh0s7c,29564
+py_dpm/api/dpm/data_dictionary.py,sha256=q6w_5bFdc6WPd5Z601PpDaCcnIw39CnI4wdby3GJmFU,29893
 py_dpm/api/dpm/explorer.py,sha256=xgrSdh2D83RivypF26WWo20rbQifYBEH7PXvINoi07Y,10861
 py_dpm/api/dpm/hierarchical_queries.py,sha256=X4AbpsWy3iItOTVIdVbtaTmRgOHPf0Y64Ig-_377uns,4054
 py_dpm/api/dpm/instance.py,sha256=v3DWzdaM5gPCecLjwjZ49FGfqZzUR3dPC0U8zGwdttk,3795
 py_dpm/api/dpm/migration.py,sha256=9FT7zzz4QdUIRR6MD01gMODBtfq9HH_RF4hRgZqMcZc,2404
 py_dpm/api/dpm_xl/__init__.py,sha256=cwqeYgmowGH6MK8kQMQkjQaTL9qKEnC8-M5rueqhrPI,850
-py_dpm/api/dpm_xl/ast_generator.py,sha256=KblAXTRhRuzNHIAaXbDj6uCNwepNDo1BaM-Ir1oAjGc,94680
+py_dpm/api/dpm_xl/ast_generator.py,sha256=7EEUEmXMwck7obL3rnBjHeDnsM0F-LHnpUZNd3rVjHI,94929
 py_dpm/api/dpm_xl/complete_ast.py,sha256=_FSxA0FmNXuW0OLS3c8yzp14yjkmdR0rTebBAs1pg-E,8141
-py_dpm/api/dpm_xl/operation_scopes.py,sha256=7AyOFAn9h012JPF9H5EtZ3sPzv6DOxkoinpj5ArzVOc,48492
-py_dpm/api/dpm_xl/semantic.py,sha256=Buo_t-sEv65r6RmYDy1xkCWGlU2pB2WQsDM-X-FX4cc,13629
+py_dpm/api/dpm_xl/operation_scopes.py,sha256=v2t3f2-AiF39hspNtpf_PA94T69JqbymFK9a5hpckRs,48831
+py_dpm/api/dpm_xl/semantic.py,sha256=Ddmh2Wj_iXIpQZ4jCjqOI-6ddFCquaO9RTu6W9i1Rts,13968
 py_dpm/api/dpm_xl/syntax.py,sha256=Ke_kKd9ModoJ6siL3GPT9j9QClmopryCRcdDAT3M5-E,5954
 py_dpm/cli/__init__.py,sha256=UrfGHoQ0sZLjWfA0hoOoI4iTrn-bjr2f9Q8wDWd5nMo,133
 py_dpm/cli/main.py,sha256=LJ7JBk7lyWXe7ZYxnbxmohM1Dbha4sIdQzSTYKd9ZNo,22457
@@ -18,7 +18,7 @@ py_dpm/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSu
 py_dpm/dpm/__init__.py,sha256=moagUo5Gxf24-Tl9FL_3n2wmVoD_oXtpC-YIGktH_rc,212
 py_dpm/dpm/migration.py,sha256=ivO_ObvKzVomTns6qfo-o5FuciWxkXbMd_gJ4_tu7Xc,14110
 py_dpm/dpm/models.py,sha256=Rt1b8zOSayXd9KhwyfkGJVhCai3YxUakmLYgwaiICWA,135660
-py_dpm/dpm/utils.py,sha256=JNdAeOXjzQtye94jLPRHHGUMcvkGtTsjA5HFl92rWig,12783
+py_dpm/dpm/utils.py,sha256=lyAZjMVrvVXXNw4e-3J0W6Q6o4YeZTgBtgn6BkPFTfI,13953
 py_dpm/dpm/queries/base.py,sha256=EddMeJMwtp63DyyIFO7_XxGvdlCtJQWWpeOVImlKp4I,3648
 py_dpm/dpm/queries/basic_objects.py,sha256=JOXC235lMDfVENrFAhZAl7_nqePJ4RrwJhFF0WDyk0M,955
 py_dpm/dpm/queries/explorer_queries.py,sha256=HcLfwpdGWX-q-i1L-7W0nwTxL_0OiDliqPUeoZ9zHZ4,17453
@@ -76,9 +76,9 @@ py_dpm/exceptions/exceptions.py,sha256=6S3p-_i5O1oStvSMixt_JQG0xwTeSfBcdzrwL8yBy
 py_dpm/exceptions/messages.py,sha256=UwY6QIK8c-POcDCc9HYbZFGArCIYAanUGNh2LNKPx3U,7534
 py_dpm/instance/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 py_dpm/instance/instance.py,sha256=gRSg2dh1nEa0Srx9yKcN3bxiYidvZyRU_jsTNaKkP5I,10882
-pydpm_xl-0.2.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pydpm_xl-0.2.6.dist-info/METADATA,sha256=PaoWC3ApUcFBwRTcvr4TyMhdH3BAdt618N-EOou8cnk,9302
-pydpm_xl-0.2.6.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-pydpm_xl-0.2.6.dist-info/entry_points.txt,sha256=6DDmBfw-AjtgvMHgq_I730i_LAAs_7-N3C95HD_bRr4,47
-pydpm_xl-0.2.6.dist-info/top_level.txt,sha256=495PvWZRoKl2NvbQU25W7dqWIBHqY-mFMPt83uxPpcM,7
-pydpm_xl-0.2.6.dist-info/RECORD,,
+pydpm_xl-0.2.7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pydpm_xl-0.2.7.dist-info/METADATA,sha256=Tg3xyWRxhUd3w1pKuv5iNBYTRq_VkZzIH533JzyaBYQ,9302
+pydpm_xl-0.2.7.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+pydpm_xl-0.2.7.dist-info/entry_points.txt,sha256=6DDmBfw-AjtgvMHgq_I730i_LAAs_7-N3C95HD_bRr4,47
+pydpm_xl-0.2.7.dist-info/top_level.txt,sha256=495PvWZRoKl2NvbQU25W7dqWIBHqY-mFMPt83uxPpcM,7
+pydpm_xl-0.2.7.dist-info/RECORD,,