seleniumUts 1.0.0__tar.gz

seleniumuts-1.0.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.1
+Name: seleniumUts
+Version: 1.0.0
+Summary: Zdek Util libraries for Pythom coding
+Home-page: https://github.com/SymplaAutomate/selenium-lib
+Author: Zdek Development team
+License: MIT
+Keywords: seleniumUts
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: undetected-chromedriver>=3.5.5
+Requires-Dist: selenium>=4.15.2
+
+# SeleniumUts
+
+Uma biblioteca Python que encapsula algumas funcionalidades do Selenium WebDriver, facilitando a automação de navegadores para testes e raspagem de dados. A biblioteca suporta o uso do `undetected_chromedriver` e integra-se facilmente com o Selenoid para execução de testes em ambientes distribuídos.
+
+## Uso
+
+### Importando a Biblioteca
+
+```python
+from seleniumUts import SeleniumUts
+```
+
+### Criando uma Instância de `SeleniumUts`
+
+```python
+selenium_lib = SeleniumUts()
+```
+
+### Exemplos de Uso
+
+#### Configurando o Selenium com ChromeDriver
+
+```python
+# Configure o Selenium sem usar o Selenoid
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Configurando o Selenium com Selenoid
+
+```python
+# Configure o Selenium usando o Selenoid
+selenoid_host = 'http://your-selenoid-server.com/wd/hub'
+selenium_lib.setupSelenium(host=selenoid_host, use_selenoid=True)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Aguardando a Visibilidade de um Elemento
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Esperar até que o elemento esteja visível
+element = selenium_lib.wait_xpath('//button[@id="submit"]', time=10)
+element.click()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Envio de Texto com Atraso entre Caracteres
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Encontrar o campo de texto e enviar texto com atraso
+element = selenium_lib.wait_xpath('//input[@id="search-box"]')
+element.delayed_send('Python Selenium', delay=0.2)
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Rolagem até o Fim da Página
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Rolagem até o fim da página
+selenium_lib.scroll_end()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+## Métodos Disponíveis
+
+- **`setupSelenium(host, name="default", use_selenoid=False, cust_opt=[], remove_default_options=False, download_path=None, selenoid_browser=("chrome","110.0"))`**: Configura o WebDriver do Selenium com opções personalizadas e preferências para o ChromeDriver. Suporta configuração para Selenoid.
+- **`open_page(page)`**: Abre uma página web e espera até que ela seja totalmente carregada.
+- **`wait_xpath(path, time=20, throw=True)`**: Aguarda até que um elemento, identificado por um caminho XPath, esteja visível no DOM.
+- **`<el>.delayed_send(word, delay)`**: Envia texto para um elemento, inserindo um atraso especificado entre cada caractere.
+- **`scroll_end()`**: Rola até o final da página atual.
+- **`close()`**: Fecha o navegador e encerra a sessão do WebDriver.
+
+## Contribuição
+
+Contribuições são bem-vindas! Por favor, envie um pull request ou abra uma issue para quaisquer problemas ou melhorias.
+
+## Licença
+
+Este projeto está licenciado sob a licença MIT.
+
+
+Change Log
+==========
+
+1.0.0 (2025-12-09)
+------------------
+- First Release

seleniumuts-1.0.0/README.md

@@ -0,0 +1,113 @@
+# SeleniumUts
+
+Uma biblioteca Python que encapsula algumas funcionalidades do Selenium WebDriver, facilitando a automação de navegadores para testes e raspagem de dados. A biblioteca suporta o uso do `undetected_chromedriver` e integra-se facilmente com o Selenoid para execução de testes em ambientes distribuídos.
+
+## Uso
+
+### Importando a Biblioteca
+
+```python
+from seleniumUts import SeleniumUts
+```
+
+### Criando uma Instância de `SeleniumUts`
+
+```python
+selenium_lib = SeleniumUts()
+```
+
+### Exemplos de Uso
+
+#### Configurando o Selenium com ChromeDriver
+
+```python
+# Configure o Selenium sem usar o Selenoid
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Configurando o Selenium com Selenoid
+
+```python
+# Configure o Selenium usando o Selenoid
+selenoid_host = 'http://your-selenoid-server.com/wd/hub'
+selenium_lib.setupSelenium(host=selenoid_host, use_selenoid=True)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Aguardando a Visibilidade de um Elemento
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Esperar até que o elemento esteja visível
+element = selenium_lib.wait_xpath('//button[@id="submit"]', time=10)
+element.click()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Envio de Texto com Atraso entre Caracteres
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Encontrar o campo de texto e enviar texto com atraso
+element = selenium_lib.wait_xpath('//input[@id="search-box"]')
+element.delayed_send('Python Selenium', delay=0.2)
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Rolagem até o Fim da Página
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Rolagem até o fim da página
+selenium_lib.scroll_end()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+## Métodos Disponíveis
+
+- **`setupSelenium(host, name="default", use_selenoid=False, cust_opt=[], remove_default_options=False, download_path=None, selenoid_browser=("chrome","110.0"))`**: Configura o WebDriver do Selenium com opções personalizadas e preferências para o ChromeDriver. Suporta configuração para Selenoid.
+- **`open_page(page)`**: Abre uma página web e espera até que ela seja totalmente carregada.
+- **`wait_xpath(path, time=20, throw=True)`**: Aguarda até que um elemento, identificado por um caminho XPath, esteja visível no DOM.
+- **`<el>.delayed_send(word, delay)`**: Envia texto para um elemento, inserindo um atraso especificado entre cada caractere.
+- **`scroll_end()`**: Rola até o final da página atual.
+- **`close()`**: Fecha o navegador e encerra a sessão do WebDriver.
+
+## Contribuição
+
+Contribuições são bem-vindas! Por favor, envie um pull request ou abra uma issue para quaisquer problemas ou melhorias.
+
+## Licença
+
+Este projeto está licenciado sob a licença MIT.

seleniumuts-1.0.0/seleniumUts/__init__.py

@@ -0,0 +1,184 @@
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.common.by import By
+import undetected_chromedriver as uc
+from selenium import webdriver
+from selenium.webdriver.remote.webelement import WebElement
+from selenium.webdriver.remote.webdriver import WebDriver as RemoteWebDriver
+import time
+
+CAPABILITIES = {
+    "browserName": "chrome",
+    "version":     "110.0",
+    "name":        "default",
+    "enableVNC"  : True,
+    "enableVideo": False,
+    "sessionTimeout": "30m"
+}
+
+DEFAULT_OPTIONS = [
+    #"--disable-web-security",
+    "--verbose",
+    #"--no-sandbox",
+    "--disable-infobars",
+    "--disable-extensions",
+    "--disable-notifications",
+    "--disable-gpu",
+    '--start-maximized',
+    '--disable-blink-features=AutomationControlled',
+    'user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36'
+]
+
+
+class CWebElement(WebElement):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+    
+    def delayed_send(self, word, delay=0.5):
+        """
+        Desc:
+            Send keys to the element with a delay between each character.\n
+        Args:
+         - ``word`` - The string to be sent to the element.
+         - ``delay`` - The delay between each character in seconds.
+            Default: 0.5 seconds.
+        """
+        for c in word:
+            self.send_keys(c)
+            time.sleep(delay)
+
+class CustomRemoteDriver(RemoteWebDriver):
+    def create_web_element(self, element_id):
+        return CWebElement(self, element_id)
+
+
+class SeleniumUts:
+    driver = None
+
+    def close(self):
+        """
+        Desc:
+            Close the browser.\n
+        Args: None
+        """
+        if self.driver:
+            self.driver.quit()
+            self.driver = None
+
+    def wait_loads(self, tm=5):
+        wait = WebDriverWait(self.driver, 60)
+        wt = lambda a: self.driver.execute_script("return document.readyState==\"complete\";")
+        wait.until(wt)
+        time.sleep(tm)
+
+    def open_page(self,page):
+        """
+        Desc:
+            Open a page in the browser.\n
+            and wait for it to load.\n
+        Args:
+            - ``page`` - The URL of the page to be opened.
+        Returns:
+            - The WebDriver instance.
+        """
+        self.driver.get(page)
+        self.driver.implicitly_wait(2)
+        self.wait_loads()
+
+        return self.driver
+
+    def wait_xpath(self,path,time=20,throw=True):
+        """
+        Desc:
+            Wait for an element to be visible using its XPATH.\n
+        Args:
+            - ``path`` - The XPATH of the element to be waited for.
+            - ``time`` - Maximum time to wait for the element in seconds. Default is 20 seconds.
+            - ``throw`` - If True, raises an exception if the element is not found within the time limit.
+        Returns:
+            - The WebElement if found, otherwise None.
+        """
+        try:
+            element = WebDriverWait(self.driver, time).until(
+            EC.visibility_of_element_located((By.XPATH, path)))
+            return element
+        except:
+            if throw: raise
+            return None
+
+    def scroll_end(self):
+        """
+        Desc:
+            Scroll to the end of the page.\n
+        Args: None
+        """
+
+        get_pos = lambda:self.driver.execute_script("return document.documentElement.scrollTop")
+
+        while True:
+            atual_pos = get_pos()
+            self.driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
+            time.sleep(2)
+            future_pos = get_pos()
+            if  future_pos == atual_pos:
+                break
+
+    def setupSelenium(
+            self,
+            host,
+            name="default",
+            use_selenoid=False,
+            cust_opt = [],
+            remove_default_options=False,
+            download_path=None,
+            selenoid_browser=("chrome","128.0")
+        ) -> webdriver:
+        
+        
+        #===================== OPTIONS ==============================
+        options = []
+        if not remove_default_options:
+            options = DEFAULT_OPTIONS
+        options += cust_opt
+
+        web_options = uc.ChromeOptions() if not use_selenoid else webdriver.ChromeOptions()
+        for op in options: 
+            web_options.add_argument(op)
+
+        web_options.headless = False
+
+        #==================== PREFERENCES ===========================
+        prefs = {
+            "download.default_directory"             : download_path,
+            "download.directory_upgrade"             : True,
+            "download.prompt_for_download"           : False,
+            "safebrowsing.enabled"                   : False,
+            "credentials_enable_service"             : False,
+            "profile.password_manager_enabled"       : False,
+            "autofill.profile_enabled"               : False,
+            "plugins.always_open_pdf_externally"     : True,
+            "profile.password_manager_leak_detection": False,
+        }
+        web_options.add_experimental_option("prefs", prefs)
+    
+
+        #================== START BROWSER ===========================
+
+        if use_selenoid:
+            web_options.add_experimental_option("useAutomationExtension", False)
+            web_options.add_experimental_option("excludeSwitches", ["enable-automation"])
+
+            CAPABILITIES["name"]        = name
+            CAPABILITIES["browserName"] = selenoid_browser[0]
+            CAPABILITIES["version"]     = selenoid_browser[1]
+            web_options.set_capability(name="selenoid:options", value=CAPABILITIES)
+            web_options.set_capability(name="browserName",      value=CAPABILITIES["browserName"])
+
+            self.driver = CustomRemoteDriver(command_executor=host, options=web_options)
+        else:
+            self.driver = uc.Chrome(options=web_options)
+
+        self.driver.maximize_window()
+        self.driver.implicitly_wait(10)
+
+        return self.driver

seleniumuts-1.0.0/seleniumUts.egg-info/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.1
+Name: seleniumUts
+Version: 1.0.0
+Summary: Zdek Util libraries for Pythom coding
+Home-page: https://github.com/SymplaAutomate/selenium-lib
+Author: Zdek Development team
+License: MIT
+Keywords: seleniumUts
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: undetected-chromedriver>=3.5.5
+Requires-Dist: selenium>=4.15.2
+
+# SeleniumUts
+
+Uma biblioteca Python que encapsula algumas funcionalidades do Selenium WebDriver, facilitando a automação de navegadores para testes e raspagem de dados. A biblioteca suporta o uso do `undetected_chromedriver` e integra-se facilmente com o Selenoid para execução de testes em ambientes distribuídos.
+
+## Uso
+
+### Importando a Biblioteca
+
+```python
+from seleniumUts import SeleniumUts
+```
+
+### Criando uma Instância de `SeleniumUts`
+
+```python
+selenium_lib = SeleniumUts()
+```
+
+### Exemplos de Uso
+
+#### Configurando o Selenium com ChromeDriver
+
+```python
+# Configure o Selenium sem usar o Selenoid
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Configurando o Selenium com Selenoid
+
+```python
+# Configure o Selenium usando o Selenoid
+selenoid_host = 'http://your-selenoid-server.com/wd/hub'
+selenium_lib.setupSelenium(host=selenoid_host, use_selenoid=True)
+
+# Abrir uma página web
+driver = selenium_lib.open_page('https://www.example.com')
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Aguardando a Visibilidade de um Elemento
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Esperar até que o elemento esteja visível
+element = selenium_lib.wait_xpath('//button[@id="submit"]', time=10)
+element.click()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Envio de Texto com Atraso entre Caracteres
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Encontrar o campo de texto e enviar texto com atraso
+element = selenium_lib.wait_xpath('//input[@id="search-box"]')
+element.delayed_send('Python Selenium', delay=0.2)
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+#### Rolagem até o Fim da Página
+
+```python
+# Configure o Selenium
+selenium_lib.setupSelenium(host=None, use_selenoid=False)
+
+# Abrir uma página web
+selenium_lib.open_page('https://www.example.com')
+
+# Rolagem até o fim da página
+selenium_lib.scroll_end()
+
+# Fechar o navegador
+selenium_lib.close()
+```
+
+## Métodos Disponíveis
+
+- **`setupSelenium(host, name="default", use_selenoid=False, cust_opt=[], remove_default_options=False, download_path=None, selenoid_browser=("chrome","110.0"))`**: Configura o WebDriver do Selenium com opções personalizadas e preferências para o ChromeDriver. Suporta configuração para Selenoid.
+- **`open_page(page)`**: Abre uma página web e espera até que ela seja totalmente carregada.
+- **`wait_xpath(path, time=20, throw=True)`**: Aguarda até que um elemento, identificado por um caminho XPath, esteja visível no DOM.
+- **`<el>.delayed_send(word, delay)`**: Envia texto para um elemento, inserindo um atraso especificado entre cada caractere.
+- **`scroll_end()`**: Rola até o final da página atual.
+- **`close()`**: Fecha o navegador e encerra a sessão do WebDriver.
+
+## Contribuição
+
+Contribuições são bem-vindas! Por favor, envie um pull request ou abra uma issue para quaisquer problemas ou melhorias.
+
+## Licença
+
+Este projeto está licenciado sob a licença MIT.
+
+
+Change Log
+==========
+
+1.0.0 (2025-12-09)
+------------------
+- First Release

seleniumuts-1.0.0/seleniumUts.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+seleniumUts/__init__.py
+seleniumUts.egg-info/PKG-INFO
+seleniumUts.egg-info/SOURCES.txt
+seleniumUts.egg-info/dependency_links.txt
+seleniumUts.egg-info/requires.txt
+seleniumUts.egg-info/top_level.txt

seleniumuts-1.0.0/seleniumUts.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

seleniumuts-1.0.0/seleniumUts.egg-info/requires.txt

@@ -0,0 +1,2 @@
+undetected-chromedriver>=3.5.5
+selenium>=4.15.2

seleniumuts-1.0.0/seleniumUts.egg-info/top_level.txt

@@ -0,0 +1 @@
+seleniumUts

seleniumuts-1.0.0/setup.cfg

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

seleniumuts-1.0.0/setup.py

@@ -0,0 +1,28 @@
+from setuptools import setup, find_packages
+
+classifiers = [
+  'Development Status :: 5 - Production/Stable',
+  'Intended Audience :: Education',
+  'Operating System :: Microsoft :: Windows :: Windows 10',
+  'License :: OSI Approved :: MIT License',
+  'Programming Language :: Python :: 3'
+]
+
+setup(
+    name                          = 'seleniumUts',
+    version                       = '1.0.0',
+    packages                      = find_packages(),
+    long_description              = open('README.md').read() + '\n\n' + open('CHANGELOG.txt').read(),
+    long_description_content_type = 'text/markdown',
+    install_requires              = [
+        "undetected-chromedriver>=3.5.5",
+        "selenium>=4.15.2"
+    ],
+   author      = 'Zdek Development team',
+   description = 'Zdek Util libraries for Pythom coding',
+   url         = 'https://github.com/SymplaAutomate/selenium-lib',
+   license     = 'MIT',
+   keywords    = 'seleniumUts',
+   classifiers = classifiers,
+    python_requires = '>=3.10',
+)