zelium 0.1.0__tar.gz

zelium-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

zelium-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: zelium
+Version: 0.1.0
+Summary: Intelligent abstraction layer over Selenium
+Author-email: Iván <yupivangh@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yup-Ivan/Zelium
+Project-URL: Repository, https://github.com/yup-Ivan/Zelium
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: selenium>=4.0
+
+# ZELIUM
+
+**ZELIUM** is a web automation framework based on **Selenium**, written in **Python**, designed to **simplify, standardize, and accelerate** the creation of web automation scripts.
+
+It is designed to:
+- Reduce repetitive code
+- Centralize common patterns (waits, scrolls, JS fallbacks…)
+- Provide a clear and expressive API (in Spanish and English)
+- Make maintenance of complex automation scripts easier
+
+---
+
+## 👤 Author
+
+- 💻 GitHub: https://github.com/yup-Ivan
+
+---
+
+## 🎯 Main Goals
+
+- 🧠 Intelligent abstraction over Selenium  
+- 🔁 Reuse of common logic via helpers  
+- 🛡️ Robustness against dynamic elements (React, Vue, etc.)  
+- 🧩 Clean, readable, and consistent API  
+- 🌍 Multilanguage support (aliases in Spanish / English)
+
+---
+
+## 📁 Project Structure
+
+```text
+Zelium/
+├── __init__.py   # Public API of the framework (exports and aliases)
+├── alarm.py      # Handling browser alerts, confirms, and prompts
+├── config.py     # Global initialization and configuration (driver, options…)
+├── helpers.py    # Internal helpers (wait, find, scroll, js_click, etc.)
+├── js.py         # JavaScript utilities (scroll, set_value, remove readonly…)
+├── tools.py      # Reusable helper functions
+└── xpath.py      # XPath element actions (click, send_keys, select…)

zelium-0.1.0/README.md

@@ -0,0 +1,39 @@
+# ZELIUM
+
+**ZELIUM** is a web automation framework based on **Selenium**, written in **Python**, designed to **simplify, standardize, and accelerate** the creation of web automation scripts.
+
+It is designed to:
+- Reduce repetitive code
+- Centralize common patterns (waits, scrolls, JS fallbacks…)
+- Provide a clear and expressive API (in Spanish and English)
+- Make maintenance of complex automation scripts easier
+
+---
+
+## 👤 Author
+
+- 💻 GitHub: https://github.com/yup-Ivan
+
+---
+
+## 🎯 Main Goals
+
+- 🧠 Intelligent abstraction over Selenium  
+- 🔁 Reuse of common logic via helpers  
+- 🛡️ Robustness against dynamic elements (React, Vue, etc.)  
+- 🧩 Clean, readable, and consistent API  
+- 🌍 Multilanguage support (aliases in Spanish / English)
+
+---
+
+## 📁 Project Structure
+
+```text
+Zelium/
+├── __init__.py   # Public API of the framework (exports and aliases)
+├── alarm.py      # Handling browser alerts, confirms, and prompts
+├── config.py     # Global initialization and configuration (driver, options…)
+├── helpers.py    # Internal helpers (wait, find, scroll, js_click, etc.)
+├── js.py         # JavaScript utilities (scroll, set_value, remove readonly…)
+├── tools.py      # Reusable helper functions
+└── xpath.py      # XPath element actions (click, send_keys, select…)

zelium-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=77.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zelium"
+version = "0.1.0"
+description = "Intelligent abstraction layer over Selenium"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+
+authors = [
+  { name = "Iván", email = "yupivangh@gmail.com" }
+]
+
+dependencies = [
+  "selenium>=4.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/yup-Ivan/Zelium"
+Repository = "https://github.com/yup-Ivan/Zelium"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

zelium-0.1.0/setup.cfg

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

zelium-0.1.0/src/zelium/__init__.py

@@ -0,0 +1,55 @@
+# Zelium/__init__.py
+from .js import JS
+from .alarm import Alarm
+from .tools import open
+from .config import start
+from .xpath import (
+    exist, get_text, click, send_keys,
+    select, force_select_combobox, clear,
+    delDisable,
+)
+
+__version__ = "0.1.0"
+
+# ─────────────────────────────
+# Alias (multi-idioma / semánticos)
+# ─────────────────────────────
+JavaScript = JS
+Alarma = Alarm
+
+empezar = start
+abrir = open
+
+existe = exist
+obtener_texto = get_text
+pulsar = click
+enviar = send_keys
+seleccionar = select
+forzar_combobox = force_select_combobox
+limpiar = clear
+quitar_disable = delDisable
+
+# ─────────────────────────────
+# API
+# ─────────────────────────────
+__all__ = [
+    "JS", "JavaScript",
+    "Alarm", "Alarma",
+    "start", "empezar",
+    "open", "abrir",
+    "exist", "existe",
+    "get_text", "obtener_texto",
+    "click", "pulsar",
+    "send_keys", "enviar",
+    "select", "seleccionar",
+    "force_select_combobox", "forzar_combobox",
+    "clear", "limpiar",
+    "noDisable", "quitar_disable",
+    "alarm", "js",
+]
+
+# ─────────────────────────────
+# Instancias
+# ─────────────────────────────
+alarm = Alarm
+js = JS

zelium-0.1.0/src/zelium/alarm.py

@@ -0,0 +1,51 @@
+# Zelium/alarm.py
+from selenium.common.exceptions import NoAlertPresentException
+from selenium.webdriver.remote.webdriver import WebDriver
+
+class Alarm:
+    _driver: WebDriver = None
+
+    @classmethod
+    def set_driver(cls, driver: WebDriver):
+        cls._driver = driver
+
+    @classmethod
+    def _get_alert(cls):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa Zelium.alarm.set_driver(driver)")
+        try:
+            return cls._driver.switch_to.alert
+        except NoAlertPresentException:
+            return None
+
+    @classmethod
+    def accept(cls):
+        alert = cls._get_alert()
+        if alert:
+            alert.accept()
+            return True
+        return False
+
+    @classmethod
+    def deny(cls):
+        alert = cls._get_alert()
+        if alert:
+            alert.dismiss()
+            return True
+        return False
+
+    @classmethod
+    def delete(cls):
+        alert = cls._get_alert()
+        if alert:
+            text = alert.text
+            alert.accept()
+            return text
+        return None
+
+    @classmethod
+    def text(cls):
+        alert = cls._get_alert()
+        if alert:
+            return alert.text
+        return None

zelium-0.1.0/src/zelium/config.py

@@ -0,0 +1,98 @@
+# Zelium/config.py
+import os
+from seleniumwire import webdriver as sw_webdriver
+from selenium import webdriver as selenium_normal
+from selenium.webdriver.chrome.options import Options
+
+from .alarm import Alarm
+from .js import JS
+
+
+def start(modo="normal", proxy=None, headless=False, usar_seleniumwire=True, perfil=None,):
+    """
+    Inicia un navegador Chrome con distintas opciones.
+
+    Args:
+        modo (str): "normal", "limpio" o "extension"
+        proxy (str | None): proxy en formato host:puerto
+        headless (bool): ejecutar Chrome en modo headless
+        usar_seleniumwire (bool): usar Selenium Wire (necesario si hay proxy)
+        perfil (str | None): ruta a perfil de Chrome (modo extension)
+
+    Returns:
+        webdriver.Chrome: instancia del driver
+    """
+
+    chrome_options = Options()
+    chrome_options.add_argument("--start-maximized")
+    chrome_options.add_argument("--disable-notifications")
+    chrome_options.add_argument("--ignore-certificate-errors")
+    chrome_options.add_argument("--disable-infobars")
+    chrome_options.add_argument("--log-level=3")
+    chrome_options.add_argument("--remote-debugging-port=0")
+    chrome_options.add_argument("--disable-extensions")
+    chrome_options.add_argument("--blink-settings=imagesEnabled=false")
+    chrome_options.add_experimental_option(
+        "excludeSwitches", ["enable-logging"]
+    )
+
+    chrome_options.add_argument(
+        "--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+        "AppleWebKit/537.36 (KHTML, like Gecko) "
+        "Chrome/115.0.0.0 Safari/537.36"
+    )
+
+    if headless:
+        chrome_options.add_argument("--headless=new")
+
+    # ─────────────────────────────
+    # Modo de ejecución
+    # ─────────────────────────────
+    if modo == "extension":
+        perfil_path = perfil or r"C:\SeleniumProfile"
+        os.makedirs(perfil_path, exist_ok=True)
+        chrome_options.add_argument(
+            f"--user-data-dir={os.path.abspath(perfil_path)}"
+        )
+
+    elif modo == "limpio":
+        chrome_options.add_argument("--incognito")
+
+    # ─────────────────────────────
+    # Proxy
+    # ─────────────────────────────
+    seleniumwire_options = {}
+
+    if proxy:
+        if usar_seleniumwire:
+            seleniumwire_options = {
+                "proxy": {
+                    "http": f"http://{proxy}",
+                    "https": f"http://{proxy}",
+                    "no_proxy": "localhost,127.0.0.1",
+                },
+                "verify_ssl": False,
+            }
+        else:
+            chrome_options.add_argument(
+                f"--proxy-server=http://{proxy}"
+            )
+
+    # ─────────────────────────────
+    # Inicializar driver
+    # ─────────────────────────────
+    if usar_seleniumwire and proxy:
+        driver = sw_webdriver.Chrome(
+            options=chrome_options,
+            seleniumwire_options=seleniumwire_options,
+        )
+    else:
+        driver = selenium_normal.Chrome(options=chrome_options)
+
+    # ─────────────────────────────
+    # Inyectar driver en módulos
+    # ─────────────────────────────
+    Alarm.set_driver(driver)
+    JS.set_driver(driver)
+
+    return driver

zelium-0.1.0/src/zelium/helpers.py

@@ -0,0 +1,26 @@
+# Zelium/helpers.py
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+
+def wait(driver, condition, timeout=5):
+    return WebDriverWait(driver, timeout).until(condition)
+
+
+def find(xpath, driver, timeout=5, visible=False):
+    condition = (
+        EC.visibility_of_element_located
+        if visible else EC.presence_of_element_located
+    )
+    return wait(driver, condition((By.XPATH, xpath)), timeout)
+
+
+def scroll(elem, driver):
+    driver.execute_script(
+        "arguments[0].scrollIntoView({block:'center'});", elem
+    )
+
+
+def js_click(elem, driver):
+    driver.execute_script("arguments[0].click();", elem)

zelium-0.1.0/src/zelium/js.py

@@ -0,0 +1,115 @@
+# Zelium/js.py
+from selenium.common.exceptions import JavascriptException, NoSuchElementException
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.common.exceptions import JavascriptException, TimeoutException
+
+class JS:    
+    _driver: WebDriver = None
+
+    @classmethod
+    def set_driver(cls, driver: WebDriver):
+        cls._driver = driver
+
+    @classmethod
+    def execute(cls, script: str, *args):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+        try:
+            return cls._driver.execute_script(script, *args)
+        except JavascriptException as e:
+            print(f"[Error JS] {e}")
+            return None
+
+    # ─────────────────────────────
+    # Sub funciones predeterminadas
+    # ─────────────────────────────
+    @classmethod
+    def quitar_readonly(cls, xpath: str):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+        try:
+            elemento = cls._driver.find_element(By.XPATH, xpath)
+            cls._driver.execute_script("arguments[0].removeAttribute('readonly')", elemento)
+        except NoSuchElementException:
+            print(f"[Advertencia] No se encontró el elemento con XPath: {xpath}")
+        except JavascriptException as e:
+            print(f"[Error] No se pudo eliminar el atributo 'readonly': {e}")
+    
+    @classmethod
+    def set_value(cls, xpath: str, value):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+        try:
+            elemento = cls._driver.find_element(By.XPATH, xpath)
+            cls._driver.execute_script("arguments[0].value = arguments[1];", elemento, value)
+        except NoSuchElementException:
+            print(f"[Advertencia] No se encontró el elemento con XPath: {xpath}")
+        except JavascriptException as e:
+            print(f"[Error] No se pudo establecer el valor: {e}")
+
+    @classmethod
+    def establecer_fecha(cls, xpath: str, valor: str):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+        try:
+            elemento = cls._driver.find_element(By.XPATH, xpath)
+            cls._driver.execute_script("arguments[0].removeAttribute('readonly')", elemento)
+            cls._driver.execute_script("arguments[0].value = arguments[1];", elemento, valor)
+            cls._driver.execute_script(
+                "arguments[0].dispatchEvent(new Event('change', { bubbles: true }));", elemento
+            )
+        except NoSuchElementException:
+            print(f"[Advertencia] No se encontró el elemento con XPath: {xpath}")
+        except JavascriptException as e:
+            print(f"[Error] No se pudo establecer la fecha: {e}")
+
+    @classmethod
+    def agregar_clase_valid(cls, xpath=None, xpaths=None, timeout=5):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+
+        if not xpaths and not xpath:
+            print("[Error] agregar_clase_valid: No se proporcionó ni 'xpath' ni 'xpaths'.")
+            return 0
+
+        if xpaths is None:
+            xpaths = [xpath]
+
+        if not isinstance(xpaths, (list, tuple)):
+            print(f"[Error] agregar_clase_valid: 'xpaths' no es iterable ({type(xpaths)})")
+            return 0
+
+        modificados = 0
+        js = "if (arguments[0]) { arguments[0].classList.add('valid'); return true; } return false;"
+
+        for xp in xpaths:
+            try:
+                elemento = WebDriverWait(cls._driver, timeout).until(
+                    EC.presence_of_element_located((By.XPATH, xp))
+                )
+                result = cls._driver.execute_script(js, elemento)
+                if result:
+                    modificados += 1
+            except TimeoutException:
+                print(f"[Advertencia] No se encontró el elemento con XPath (timeout {timeout}s): {xp}")
+            except JavascriptException as e:
+                print(f"[Error JS en {xp}] {e}")
+            except Exception as e:
+                print(f"[Error inesperado en {xp}] {type(e).__name__}: {e}")
+
+        return modificados
+    
+    @classmethod
+    def scroll(cls, valor):
+        if cls._driver is None:
+            raise RuntimeError("Driver no asignado. Usa JS.set_driver(driver)")
+        try:
+            cls._driver.execute_script(f"window.scrollBy(0, {valor});")
+
+        except Exception as e:
+            print(e)
+        except JavascriptException as e:
+            print(f"[Error JS] No se pudo hacer scroll: {e}")

zelium-0.1.0/src/zelium/tools.py

@@ -0,0 +1,10 @@
+# Zelium/tools.py
+from selenium.common.exceptions import WebDriverException
+
+def open(url, driver):
+    try:
+        driver.get(url)
+    except WebDriverException as e:
+        print(f"[WebDriverError] No se pudo abrir {url}: {e}")
+    except Exception as e:
+        print(f"[Error inesperado] No se pudo abrir {url}: {type(e).__name__}: {e}")

zelium-0.1.0/src/zelium/xpath.py

@@ -0,0 +1,149 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import Select
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.common.exceptions import (
+    JavascriptException,
+    TimeoutException,
+    ElementNotInteractableException,
+)
+from .helpers import wait, find, scroll, js_click
+import time
+
+
+def exist(xpath, driver, timeout=5):
+    try:
+        find(xpath, driver, timeout)
+        return True
+    except TimeoutException:
+        return False
+
+
+def get_text(xpath, driver, timeout=5):
+    try:
+        elem = find(xpath, driver, timeout)
+        return elem.text
+    except TimeoutException:
+        return None
+
+
+def click(xpath, driver, timeout=5):
+    try:
+        elem = wait(
+            driver,
+            EC.element_to_be_clickable((By.XPATH, xpath)),
+            timeout,
+        )
+        scroll(elem, driver)
+        elem.click()
+        return True
+
+    except (TimeoutException, ElementNotInteractableException):
+        try:
+            elem = find(xpath, driver, timeout)
+            scroll(elem, driver)
+            js_click(elem, driver)
+            return True
+        except Exception:
+            return False
+
+
+def send_keys(xpath, value, driver, timeout=5):
+    if value is None:
+        return False
+
+    try:
+        elem = find(xpath, driver, timeout, visible=True)
+        scroll(elem, driver)
+        elem.clear()
+        elem.send_keys(value)
+        return True
+
+    except (TimeoutException, ElementNotInteractableException):
+        try:
+            elem = find(xpath, driver, timeout)
+            driver.execute_script(
+                """
+                arguments[0].value = arguments[1];
+                arguments[0].dispatchEvent(new Event('input', {bubbles:true}));
+                arguments[0].dispatchEvent(new Event('change', {bubbles:true}));
+                """,
+                elem,
+                value,
+            )
+            return True
+        except Exception:
+            return False
+
+
+def select(xpath, buscar, driver, attr="value", timeout=5):
+    try:
+        elem = find(xpath, driver, timeout)
+        scroll(elem, driver)
+
+        sel = Select(elem)
+        buscar = str(buscar)
+
+        if attr == "value":
+            sel.select_by_value(buscar)
+        elif attr == "text":
+            sel.select_by_visible_text(buscar)
+        else:
+            for option in sel.options:
+                if option.get_attribute(attr) == buscar:
+                    option.click()
+                    break
+            else:
+                return False
+
+        return True
+
+    except Exception:
+        return False
+
+
+def force_select_combobox(input_xpath, option_text, driver, timeout=5):
+    try:
+        input_elem = find(input_xpath, driver, timeout)
+        scroll(input_elem, driver)
+        input_elem.click()
+
+        option_xpath = (
+            f"//li[@role='option' and normalize-space(text())='{option_text}']"
+        )
+        option_elem = find(option_xpath, driver, timeout)
+
+        scroll(option_elem, driver)
+        js_click(option_elem, driver)
+
+        return True
+
+    except Exception:
+        return False
+
+
+def clear(xpath, driver, timeout=5):
+    try:
+        elem = find(xpath, driver, timeout)
+        elem.clear()
+        return True
+    except Exception:
+        return False
+
+
+def delDisable(xpath, driver, timeout=5):
+    try:
+        elem = find(xpath, driver, timeout)
+        driver.execute_script(
+            """
+            arguments[0].removeAttribute('readonly');
+            arguments[0].removeAttribute('disabled');
+            try { arguments[0].readOnly = false; } catch(e) {}
+            """,
+            elem,
+        )
+        time.sleep(0.3)
+        elem.click()
+        return True
+
+    except (TimeoutException, JavascriptException):
+        return False

zelium-0.1.0/src/zelium.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: zelium
+Version: 0.1.0
+Summary: Intelligent abstraction layer over Selenium
+Author-email: Iván <yupivangh@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yup-Ivan/Zelium
+Project-URL: Repository, https://github.com/yup-Ivan/Zelium
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: selenium>=4.0
+
+# ZELIUM
+
+**ZELIUM** is a web automation framework based on **Selenium**, written in **Python**, designed to **simplify, standardize, and accelerate** the creation of web automation scripts.
+
+It is designed to:
+- Reduce repetitive code
+- Centralize common patterns (waits, scrolls, JS fallbacks…)
+- Provide a clear and expressive API (in Spanish and English)
+- Make maintenance of complex automation scripts easier
+
+---
+
+## 👤 Author
+
+- 💻 GitHub: https://github.com/yup-Ivan
+
+---
+
+## 🎯 Main Goals
+
+- 🧠 Intelligent abstraction over Selenium  
+- 🔁 Reuse of common logic via helpers  
+- 🛡️ Robustness against dynamic elements (React, Vue, etc.)  
+- 🧩 Clean, readable, and consistent API  
+- 🌍 Multilanguage support (aliases in Spanish / English)
+
+---
+
+## 📁 Project Structure
+
+```text
+Zelium/
+├── __init__.py   # Public API of the framework (exports and aliases)
+├── alarm.py      # Handling browser alerts, confirms, and prompts
+├── config.py     # Global initialization and configuration (driver, options…)
+├── helpers.py    # Internal helpers (wait, find, scroll, js_click, etc.)
+├── js.py         # JavaScript utilities (scroll, set_value, remove readonly…)
+├── tools.py      # Reusable helper functions
+└── xpath.py      # XPath element actions (click, send_keys, select…)

zelium-0.1.0/src/zelium.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+MANIFEST.in
+README.md
+pyproject.toml
+src/zelium/__init__.py
+src/zelium/alarm.py
+src/zelium/config.py
+src/zelium/helpers.py
+src/zelium/js.py
+src/zelium/tools.py
+src/zelium/xpath.py
+src/zelium.egg-info/PKG-INFO
+src/zelium.egg-info/SOURCES.txt
+src/zelium.egg-info/dependency_links.txt
+src/zelium.egg-info/requires.txt
+src/zelium.egg-info/top_level.txt
+tests/test.py

zelium-0.1.0/src/zelium.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zelium-0.1.0/src/zelium.egg-info/requires.txt

@@ -0,0 +1 @@
+selenium>=4.0

zelium-0.1.0/src/zelium.egg-info/top_level.txt

@@ -0,0 +1 @@
+zelium

zelium-0.1.0/tests/test.py

@@ -0,0 +1,21 @@
+import Zelium
+import time
+
+driver = Zelium.start()
+
+Zelium.open("http://127.0.0.1:5000", driver)
+time.sleep(2)
+
+Zelium.alarm.accept()
+time.sleep(2)
+
+Zelium.js.quitar_readonly("//input[@id='fecha']")
+time.sleep(2)
+
+Zelium.js.set_value("//input[@id='nombre']", "Iván")
+
+Zelium.js.scroll(300)
+
+time.sleep(5)
+
+driver.quit()