xoverrr 1.1.4__py3-none-any.whl → 1.1.6__py3-none-any.whl

{xoverrr-1.1.4.dist-info → xoverrr-1.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xoverrr
-Version: 1.1.4
+Version: 1.1.6
 Summary: A tool for cross-database and intra-source data comparison with detailed discrepancy analysis and reporting.
 Author-email: Dmitry Ischenko <hotmori@gmail.com>
 License: MIT
@@ -21,7 +21,7 @@ Requires-Dist: clickhouse-sqlalchemy>=0.2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.15.0; extra == "dev"
 Requires-Dist: isort>=5.12.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
@@ -31,7 +31,7 @@ Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: tenacity>=8.2.0; extra == "test"
 Provides-Extra: lint
-Requires-Dist: black>=23.0.0; extra == "lint"
+Requires-Dist: ruff>=0.15.0; extra == "lint"
 Requires-Dist: isort>=5.12.0; extra == "lint"
 Requires-Dist: flake8>=6.0.0; extra == "lint"
 Dynamic: license-file
@@ -40,6 +40,70 @@ Dynamic: license-file
 
 A tool for cross-database and intra-source data comparison with detailed discrepancy analysis and reporting.
 
+## Usage Example
+**Sample comparison** (Greenplum vs Oracle):
+
+```python
+from xoverrr import DataQualityComparator, DataReference, COMPARISON_SUCCESS, COMPARISON_FAILED, COMPARISON_SKIPPED
+import os
+from datetime import date, timedelta
+
+USER_ORA = os.getenv('USER_ORA', '')
+PASSWORD_ORA = os.getenv('PASSWORD_ORA', '')
+
+USER_GP = os.getenv('USER_GP', '')
+PASSWORD_GP = os.getenv('PASSWORD_GP', '')
+
+HOST_ORA = os.getenv('HOST_ORA', '')
+HOST_GP = os.getenv('HOST_GP', '')
+
+def create_src_engine(user, password, host):
+    """Source engine (Oracle)"""
+    os.environ['NLS_LANG'] = '.AL32UTF8'
+    return create_engine(f'oracle+oracledb://{user}:{password}@{host}:1521/?service_name=dwh')
+
+def create_trg_engine(user, password, host):
+    """Target engine (Postgres/Greenplum)"""
+    connection_string = f'postgresql+psycopg2://{user}:{password}@{host}:5432/adb'
+    engine = create_engine(connection_string)
+    return engine
+
+
+src_engine = create_src_engine(USER_ORA, PASSWORD_ORA, HOST_ORA)
+trg_engine = create_trg_engine(USER_GP, PASSWORD_GP, HOST_GP)
+
+comparator = DataQualityComparator(
+    source_engine=src_engine,
+    target_engine=trg_engine,
+    timezone='Europe/Athens'
+)
+
+source = DataReference("users", "schema1")
+target = DataReference("users", "schema2")
+
+FORMAT = '%Y-%m-%d'
+recent_range_end = date.today()
+recent_range_begin = recent_range_end - timedelta(days=1)
+
+status, report, stats, details = comparator.compare_sample(
+    source,
+    target,
+    date_column="created_at",
+    update_column="modified_date",
+    exclude_columns=["audit_timestamp", "internal_id"],
+    exclude_recent_hours=3,
+    date_range=(
+        recent_range_begin.strftime(FORMAT),
+        recent_range_end.strftime(FORMAT)
+    ),
+    tolerance_percentage=0
+)
+
+print(report)
+if status == COMPARISON_FAILED:
+    raise Exception("Sample check failed")
+```
+
 ## Key Features
 - **Multi‑DBMS support**: Oracle, PostgreSQL (+ Greenplum), ClickHouse (extensible via adapter layer) — tables and views.
 - **Universal connections**: Provide SQLAlchemy Engine objects for source and target databases.
@@ -273,71 +337,3 @@ Logs include timing information and structured context:
 - If `final_diff_score ≤ tolerance`: status = `COMPARISON_SUCCESS`
 - Enables configuration of acceptable discrepancy levels.
 
----
-
-## Usage Example
-**Sample comparison** (Greenplum vs Oracle):
-
-```python
-from xoverrr import DataQualityComparator, DataReference, COMPARISON_SUCCESS, COMPARISON_FAILED, COMPARISON_SKIPPED
-import os
-from datetime import date, timedelta
-
-USER_ORA = os.getenv('USER_ORA', '')
-PASSWORD_ORA = os.getenv('PASSWORD_ORA', '')
-
-USER_GP = os.getenv('USER_GP', '')
-PASSWORD_GP = os.getenv('PASSWORD_GP', '')
-
-HOST = os.getenv('HOST', '')
-
-def create_src_engine(user, password, host):
-    """Source engine (Oracle)"""
-    os.environ['NLS_LANG'] = '.AL32UTF8'
-    return create_engine(f'oracle+oracledb://{user}:{password}@{host}:1521/?service_name=dwh')
-
-def create_trg_engine(user, password, host):
-    """Target engine (Postgres/Greenplum)"""
-    connection_string = f'postgresql+psycopg2://{user}:{password}@{host}:5432/adb'
-    engine = create_engine(connection_string)
-    return engine
-
-
-
-src_engine = create_src_engine(USER_ORA, PASSWORD_ORA, HOST)
-trg_engine = create_trg_engine(USER_GP, PASSWORD_GP, HOST)
-
-comparator = DataQualityComparator(
-    source_engine=src_engine,
-    target_engine=trg_engine,
-    timezone='Asia/Yekaterinburg'
-)
-
-source = DataReference("users", "schema1")
-target = DataReference("users", "schema2")
-
-FORMAT = '%Y-%m-%d'
-recent_range_end = date.today()
-recent_range_begin = recent_range_end - timedelta(days=1)
-
-status, report, stats, details = comparator.compare_sample(
-    source,
-    target,
-    date_column="created_at",
-    update_column="modified_date",
-    exclude_columns=["audit_timestamp", "internal_id"],
-    exclude_recent_hours=24,
-    date_range=(
-        recent_range_begin.strftime(FORMAT),
-        recent_range_end.strftime(FORMAT)
-    ),
-    tolerance_percentage=0
-)
-
-print(report)
-if status == COMPARISON_FAILED:
-    raise Exception("Sample check failed")
-```
-
----
-

xoverrr-1.1.6.dist-info/RECORD

@@ -0,0 +1,17 @@
+xoverrr/__init__.py,sha256=Qf-FSLLF6gTMZmY67VOdU9SbQ6xI_Q-udzlbe3joEcU,327
+xoverrr/constants.py,sha256=1YHnBcVC9FSKrPUtM7qpviR1B8MZBbXcMOnekFFqX8E,462
+xoverrr/core.py,sha256=f001o5AANHzEYsc9cGS531mrgaopMzYElisOUWBjQGQ,26974
+xoverrr/exceptions.py,sha256=KZ0MDXJ0A2pUebhac_olpYhR3257VCMPlxLTua9WU_Q,445
+xoverrr/logger.py,sha256=c-D-RQFqjagY2Hq39pp9WhNCtmwwpES9O6wuqr-o-oc,368
+xoverrr/models.py,sha256=44KHAkuKiip55uaEEQz14w_yaiFo3Rg5qe-IN17Bf3g,1598
+xoverrr/utils.py,sha256=6laDs4GCaAxfO88BbKtwxIpWLvqT2OMt85zAWahfWc4,25552
+xoverrr/adapters/__init__.py,sha256=dXNvTuvLHhZdUKZMYmuLdkzg6F6VQJage8d2FJvLyHQ,263
+xoverrr/adapters/base.py,sha256=djyulx6TCvODE2vzQkX_9gvBwUGe9nt9bourklSEJJU,4930
+xoverrr/adapters/clickhouse.py,sha256=KqnKmxCiLBaQO5JOl-J9NjTcTvHdHmZlqCKgfRnYGfk,7116
+xoverrr/adapters/oracle.py,sha256=xlbtWQudBItfPtFtQZ233k0xNaDI6cCjNcMJjRbWRQo,8936
+xoverrr/adapters/postgres.py,sha256=hB6iCZblb06Q0uEbSf6gk1vdk47UYpD2Eteom_pDhlQ,8224
+xoverrr-1.1.6.dist-info/licenses/LICENSE,sha256=ez2uHRKRleWvcvGHEm4ei4qwyfMc1Tf857fZ9zuXsuo,1074
+xoverrr-1.1.6.dist-info/METADATA,sha256=PEXVChdMmB7Ic0Mu605jBXDIZQxwyVk3zGNSk3J63Xw,13896
+xoverrr-1.1.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+xoverrr-1.1.6.dist-info/top_level.txt,sha256=vDgDuhkwThKcnQ_CN76iR4tMljtryLGZiftc0Y6-MYI,8
+xoverrr-1.1.6.dist-info/RECORD,,

{xoverrr-1.1.4.dist-info → xoverrr-1.1.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

xoverrr-1.1.4.dist-info/RECORD

@@ -1,17 +0,0 @@
-xoverrr/__init__.py,sha256=x3OQ1psbjmcYpS1u1MZG9fkRAQ92CqipILQDxJJs8f0,319
-xoverrr/constants.py,sha256=jiZ3PnI3lkkmwucqqs56kBKIBk1xWnU86_d9c-CfiAU,461
-xoverrr/core.py,sha256=wgREeXprpqGnmuzmnckp1Q6t2OagL58G9cinfPQ1Kc0,26242
-xoverrr/exceptions.py,sha256=wLnhWb5blFHeNh7l63tohHlVT7WVhLYSF6Guu79RFRM,437
-xoverrr/logger.py,sha256=qROmezBVEmWT2XhWrhK0HtEMwbVsp-_w2QroeekuuOQ,361
-xoverrr/models.py,sha256=MDeTYQEz4QnZZwJXet16hvkoAUWVayIdgn77g-ZuZ10,1591
-xoverrr/utils.py,sha256=rai75punqHIHWVr4quRwvI9feyzxy11GdtSKEGD90JU,25414
-xoverrr/adapters/__init__.py,sha256=83nYToYrZW_ddyP1VEPZefB-0GrrWXYaVz_0955us5Y,243
-xoverrr/adapters/base.py,sha256=5vCDXhQ2hRXxikDu6ZoVvI_mCC6CRxi9Z_bI_jBbPIA,4934
-xoverrr/adapters/clickhouse.py,sha256=Cn4mXbZ5Fl0ADXW_6nW50LEjcjlf-dLo7zqDPjNCefE,7041
-xoverrr/adapters/oracle.py,sha256=1Jaw15cPmG7odJe-BJ_NRs1oFI1VVOAQBTR6JDwrSdw,8657
-xoverrr/adapters/postgres.py,sha256=TQThA3Np3wo-WdWoUOveQfCUcIDxmuz_RCJDUo5Yph4,7888
-xoverrr-1.1.4.dist-info/licenses/LICENSE,sha256=ez2uHRKRleWvcvGHEm4ei4qwyfMc1Tf857fZ9zuXsuo,1074
-xoverrr-1.1.4.dist-info/METADATA,sha256=m1mBdUEoo0d3xJGWpm9vQpgUrJfCUfTVsDZNia0RMJs,13865
-xoverrr-1.1.4.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-xoverrr-1.1.4.dist-info/top_level.txt,sha256=vDgDuhkwThKcnQ_CN76iR4tMljtryLGZiftc0Y6-MYI,8
-xoverrr-1.1.4.dist-info/RECORD,,