etlx-wrapper 0.1.0__tar.gz

etlx_wrapper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 realdatadriven
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

etlx_wrapper-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: etlx-wrapper
+Version: 0.1.0
+Summary: Python wrapper for ETLX CLI to run ETL workflows from Python
+Author-email: realdatadriven <real.datadriven@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 realdatadriven
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/realdatadriven/etlx
+Project-URL: Repository, https://github.com/realdatadriven/etlx
+Keywords: ETL,duckdb,cli,data-pipeline,wrapper
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ETLX Python Wrapper
+
+**ETLX** is a modern and highly configurable ETL and reporting tool powered by DuckDB.  
+This Python package provides a simple interface to run ETLX workflows directly from Python.
+
+---
+
+## 📦 Installation
+
+Install the wrapper from PyPI:
+
+```bash
+pip install etlx
+```
+
+### 🧩 Requirements
+
+You also need the ETLX binary:
+
+1. Download the latest binary for your platform from  
+   [ETLX Releases](https://github.com/realdatadriven/etlx/releases)
+2. Place it in your system `PATH`, or provide the binary path manually when using the wrapper.
+
+---
+
+## 🚀 Quick Start
+
+```python
+from etlx import ETLX
+import datetime
+
+_etxl = ETLX()\
+    .config = "/path/to/config.md"\
+    .only = "keyX"\
+    .date = datetime.date.today()\
+    .file = "data.csv"\
+    .execute()
+```
+
+You can also pass the path to the ETLX binary if it's not in `PATH`:
+
+```python
+runner = ETLX(config="config.md", bin="/path/to/etlx-linux-amd64")
+```
+
+---
+
+## 🔧 Features
+
+- Runs full ETLX workflows from Python  
+- Supports `.env` configuration  
+- Automatically formats Python `date` objects  
+- Compatible with advanced CLI options: `--only`, `--skip`, `--steps`, `--clean`, `--drop`, etc.
+
+---
+
+## 🧱 Learn More
+
+Visit the [main project](https://github.com/realdatadriven/etlx) for full documentation, use cases, and advanced config examples.
+
+---
+
+## 🪪 License
+
+MIT

etlx_wrapper-0.1.0/README.md

@@ -0,0 +1,65 @@
+# ETLX Python Wrapper
+
+**ETLX** is a modern and highly configurable ETL and reporting tool powered by DuckDB.  
+This Python package provides a simple interface to run ETLX workflows directly from Python.
+
+---
+
+## 📦 Installation
+
+Install the wrapper from PyPI:
+
+```bash
+pip install etlx
+```
+
+### 🧩 Requirements
+
+You also need the ETLX binary:
+
+1. Download the latest binary for your platform from  
+   [ETLX Releases](https://github.com/realdatadriven/etlx/releases)
+2. Place it in your system `PATH`, or provide the binary path manually when using the wrapper.
+
+---
+
+## 🚀 Quick Start
+
+```python
+from etlx import ETLX
+import datetime
+
+_etxl = ETLX()\
+    .config = "/path/to/config.md"\
+    .only = "keyX"\
+    .date = datetime.date.today()\
+    .file = "data.csv"\
+    .execute()
+```
+
+You can also pass the path to the ETLX binary if it's not in `PATH`:
+
+```python
+runner = ETLX(config="config.md", bin="/path/to/etlx-linux-amd64")
+```
+
+---
+
+## 🔧 Features
+
+- Runs full ETLX workflows from Python  
+- Supports `.env` configuration  
+- Automatically formats Python `date` objects  
+- Compatible with advanced CLI options: `--only`, `--skip`, `--steps`, `--clean`, `--drop`, etc.
+
+---
+
+## 🧱 Learn More
+
+Visit the [main project](https://github.com/realdatadriven/etlx) for full documentation, use cases, and advanced config examples.
+
+---
+
+## 🪪 License
+
+MIT

etlx_wrapper-0.1.0/etlx_wrapper.egg-info/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: etlx-wrapper
+Version: 0.1.0
+Summary: Python wrapper for ETLX CLI to run ETL workflows from Python
+Author-email: realdatadriven <real.datadriven@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 realdatadriven
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/realdatadriven/etlx
+Project-URL: Repository, https://github.com/realdatadriven/etlx
+Keywords: ETL,duckdb,cli,data-pipeline,wrapper
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ETLX Python Wrapper
+
+**ETLX** is a modern and highly configurable ETL and reporting tool powered by DuckDB.  
+This Python package provides a simple interface to run ETLX workflows directly from Python.
+
+---
+
+## 📦 Installation
+
+Install the wrapper from PyPI:
+
+```bash
+pip install etlx
+```
+
+### 🧩 Requirements
+
+You also need the ETLX binary:
+
+1. Download the latest binary for your platform from  
+   [ETLX Releases](https://github.com/realdatadriven/etlx/releases)
+2. Place it in your system `PATH`, or provide the binary path manually when using the wrapper.
+
+---
+
+## 🚀 Quick Start
+
+```python
+from etlx import ETLX
+import datetime
+
+_etxl = ETLX()\
+    .config = "/path/to/config.md"\
+    .only = "keyX"\
+    .date = datetime.date.today()\
+    .file = "data.csv"\
+    .execute()
+```
+
+You can also pass the path to the ETLX binary if it's not in `PATH`:
+
+```python
+runner = ETLX(config="config.md", bin="/path/to/etlx-linux-amd64")
+```
+
+---
+
+## 🔧 Features
+
+- Runs full ETLX workflows from Python  
+- Supports `.env` configuration  
+- Automatically formats Python `date` objects  
+- Compatible with advanced CLI options: `--only`, `--skip`, `--steps`, `--clean`, `--drop`, etc.
+
+---
+
+## 🧱 Learn More
+
+Visit the [main project](https://github.com/realdatadriven/etlx) for full documentation, use cases, and advanced config examples.
+
+---
+
+## 🪪 License
+
+MIT

etlx_wrapper-0.1.0/etlx_wrapper.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+etlx_wrapper.egg-info/PKG-INFO
+etlx_wrapper.egg-info/SOURCES.txt
+etlx_wrapper.egg-info/dependency_links.txt
+etlx_wrapper.egg-info/top_level.txt
+src/__init__.py

etlx_wrapper-0.1.0/etlx_wrapper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

etlx_wrapper-0.1.0/etlx_wrapper.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

etlx_wrapper-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "etlx-wrapper"
+version = "0.1.0"
+description = "Python wrapper for ETLX CLI to run ETL workflows from Python"
+authors = [
+    { name="realdatadriven", email="real.datadriven@gmail.com" }
+]
+license = { file = "LICENSE" }
+readme = "README.md"
+requires-python = ">=3.7"
+keywords = ["ETL", "duckdb", "cli", "data-pipeline", "wrapper"]
+
+[project.urls]
+Homepage = "https://github.com/realdatadriven/etlx"
+Repository = "https://github.com/realdatadriven/etlx"
+
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["src"]
+include-package-data = true

etlx_wrapper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

etlx_wrapper-0.1.0/src/__init__.py

@@ -0,0 +1,69 @@
+'''**ETLX** is a modern and highly configurable ETL and reporting tool powered by DuckDB.  
+This Python package provides a simple interface to run ETLX workflows directly from Python.'''
+import os
+import subprocess
+from pathlib import Path
+from datetime import date, datetime
+from typing import Optional, Union, List
+
+class ETLX:
+    '''main class'''
+    def __init__(
+        self,
+        bin: str = "etlx",
+        config: str = "config.md",
+        date_ref: Union[str, date, datetime] = None,
+        only: Optional[Union[str, List[str]]] = None,
+        skip: Optional[Union[str, List[str]]] = None,
+        steps: Optional[str] = None,
+        file: Optional[str] = None,
+        clean: bool = False,
+        drop: bool = False,
+        rows: bool = False,
+        cwd: Union[str, Path] = ".",
+    ):
+        self.bin = bin
+        self.config = config
+        self.date_ref = self._format_date(date_ref)
+        self.only = only
+        self.skip = skip
+        self.steps = steps
+        self.file = file
+        self.clean = clean
+        self.drop = drop
+        self.rows = rows
+        self.cwd = Path(cwd)
+
+    def _format_date(self, dt):
+        if dt is None:
+            return datetime.now().strftime("%Y-%m-%d")
+        if isinstance(dt, (datetime, date)):
+            return dt.strftime("%Y-%m-%d")
+        return str(dt)
+
+    def _to_flag(self, key: str, value: Optional[Union[str, bool, List[str]]]) -> List[str]:
+        if value is None or value is False:
+            return []
+        if isinstance(value, list):
+            value = ",".join(value)
+        if isinstance(value, bool):
+            return [f"-{key}"]
+        return [f"-{key}", str(value)]
+
+    def execute(self) -> int:
+        '''Execute ETLX'''
+        args = [
+            self.bin,
+            *self._to_flag("config", self.config),
+            *self._to_flag("date", self.date_ref),
+            *self._to_flag("only", self.only),
+            *self._to_flag("skip", self.skip),
+            *self._to_flag("steps", self.steps),
+            *self._to_flag("file", self.file),
+            *self._to_flag("clean", self.clean),
+            *self._to_flag("drop", self.drop),
+            *self._to_flag("rows", self.rows),
+        ]
+        print(f"[ETLX] Executing: {' '.join(args)} in {self.cwd.resolve()}")
+        result = subprocess.run(args, cwd = self.cwd, check = False) #, env=env)
+        return result.returncode