trsolucoes

Name	trsolucoes JSON
Version	8.0.3 JSON
	download
home_page	None
Summary	Um repositório não oficial de funções de auxilio para Selenium
upload_time	2024-06-26 19:03:30
maintainer	None
docs_url	None
author	Tainan Ramos
requires_python	None
license	MIT License
keywords	trsolucoes
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Selenium Helper

Este pacote fornece um conjunto de utilitários para facilitar a interação com o Selenium WebDriver, incluindo funcionalidades para esperar por elementos, enviar texto, clicar em elementos, selecionar opções e mover o cursor sobre elementos.

## Instalação

Você pode instalar o pacote diretamente do PyPI usando `pip`:

```sh
pip install trsolucoes
```

# Uso

Aqui estão alguns exemplos de como usar as funções fornecidas pelo pacote.

# Funções Principais

### Importar pacotes
```python
from selenium_helper import SeleniumHelper
from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()
sh = SeleniumHelper(driver)
```

### `wait_element`
Aguarda a presença de um elemento na página e retorna o próprio elemento ou um booleano indicando se o elemento foi encontrado.
```python
locator = (By.ID, 'example-id')
element_found = sh.wait_element(locator, return_element=True)
```

### `wait_and_send_keys`
Aguarda a presença de um elemento e envia um texto para ele, com opções para limpar o campo e clicar no elemento antes de enviar o texto.
```python
locator = (By.NAME, 'example-name')
sh.wait_and_send_keys(locator, 'example text', clear_form=True)
```

### `wait_and_click`
Aguarda a presença de um elemento e clica nele.
```python
locator = (By.XPATH, '//button[@class="example-class"]')
sh.wait_and_click(locator)
```

### `wait_and_select`
Aguarda a presença de um elemento select e seleciona uma opção pelo texto visível.
```python
locator = (By.TAG_NAME, 'select')
tag_filter = [('ng-reflect-name', 'labelOption'), ('ngcontent-c2', 'xp789e687')]
sh.wait_and_select(locator, 'Option Text', tag_filter=tag_filter)
```

### `wait_and_click_in_text`
Aguarda um breve período e clica em um elemento cujo texto corresponde ao texto fornecido.
```python
locator = (By.TAG_NAME, 'button')
sh.wait_and_click_in_text(locator, 'Button Text')
```

### `wait_and_hover`
Aguarda a presença de um elemento e passa o cursor do mouse sobre ele.
```python
locator = (By.CLASS_NAME, 'hover-target')
sh.wait_and_hover(locator)
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "trsolucoes",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "trsolucoes",
    "author": "Tainan Ramos",
    "author_email": "tainan@trsolucoes.com.br",
    "download_url": "https://files.pythonhosted.org/packages/c1/9c/90b7fd7481d17651e32396fb0f18c954d1e4f87dc317bd4ead9401df7e52/trsolucoes-8.0.3.tar.gz",
    "platform": null,
    "description": "# Selenium Helper\r\n\r\nEste pacote fornece um conjunto de utilit\u00e1rios para facilitar a intera\u00e7\u00e3o com o Selenium WebDriver, incluindo funcionalidades para esperar por elementos, enviar texto, clicar em elementos, selecionar op\u00e7\u00f5es e mover o cursor sobre elementos.\r\n\r\n## Instala\u00e7\u00e3o\r\n\r\nVoc\u00ea pode instalar o pacote diretamente do PyPI usando `pip`:\r\n\r\n```sh\r\npip install trsolucoes\r\n```\r\n\r\n# Uso\r\n\r\nAqui est\u00e3o alguns exemplos de como usar as fun\u00e7\u00f5es fornecidas pelo pacote.\r\n\r\n# Fun\u00e7\u00f5es Principais\r\n\r\n### Importar pacotes\r\n```python\r\nfrom selenium_helper import SeleniumHelper\r\nfrom selenium import webdriver\r\nfrom selenium.webdriver.common.by import By\r\n\r\ndriver = webdriver.Chrome()\r\nsh = SeleniumHelper(driver)\r\n```\r\n\r\n### `wait_element`\r\nAguarda a presen\u00e7a de um elemento na p\u00e1gina e retorna o pr\u00f3prio elemento ou um booleano indicando se o elemento foi encontrado.\r\n```python\r\nlocator = (By.ID, 'example-id')\r\nelement_found = sh.wait_element(locator, return_element=True)\r\n```\r\n\r\n### `wait_and_send_keys`\r\nAguarda a presen\u00e7a de um elemento e envia um texto para ele, com op\u00e7\u00f5es para limpar o campo e clicar no elemento antes de enviar o texto.\r\n```python\r\nlocator = (By.NAME, 'example-name')\r\nsh.wait_and_send_keys(locator, 'example text', clear_form=True)\r\n```\r\n\r\n### `wait_and_click`\r\nAguarda a presen\u00e7a de um elemento e clica nele.\r\n```python\r\nlocator = (By.XPATH, '//button[@class=\"example-class\"]')\r\nsh.wait_and_click(locator)\r\n```\r\n\r\n### `wait_and_select`\r\nAguarda a presen\u00e7a de um elemento select e seleciona uma op\u00e7\u00e3o pelo texto vis\u00edvel.\r\n```python\r\nlocator = (By.TAG_NAME, 'select')\r\ntag_filter = [('ng-reflect-name', 'labelOption'), ('ngcontent-c2', 'xp789e687')]\r\nsh.wait_and_select(locator, 'Option Text', tag_filter=tag_filter)\r\n```\r\n\r\n### `wait_and_click_in_text`\r\nAguarda um breve per\u00edodo e clica em um elemento cujo texto corresponde ao texto fornecido.\r\n```python\r\nlocator = (By.TAG_NAME, 'button')\r\nsh.wait_and_click_in_text(locator, 'Button Text')\r\n```\r\n\r\n### `wait_and_hover`\r\nAguarda a presen\u00e7a de um elemento e passa o cursor do mouse sobre ele.\r\n```python\r\nlocator = (By.CLASS_NAME, 'hover-target')\r\nsh.wait_and_hover(locator)\r\n```\r\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Um reposit\u00f3rio n\u00e3o oficial de fun\u00e7\u00f5es de auxilio para Selenium",
    "version": "8.0.3",
    "project_urls": null,
    "split_keywords": [
        "trsolucoes"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c19c90b7fd7481d17651e32396fb0f18c954d1e4f87dc317bd4ead9401df7e52",
                "md5": "dd06f4851105f876acb427b7879c3ab2",
                "sha256": "449493dcd92ce49a13b84df559cfa949fa65ab293700402b4e0df730c8278f9d"
            },
            "downloads": -1,
            "filename": "trsolucoes-8.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "dd06f4851105f876acb427b7879c3ab2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4779,
            "upload_time": "2024-06-26T19:03:30",
            "upload_time_iso_8601": "2024-06-26T19:03:30.414261Z",
            "url": "https://files.pythonhosted.org/packages/c1/9c/90b7fd7481d17651e32396fb0f18c954d1e4f87dc317bd4ead9401df7e52/trsolucoes-8.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-26 19:03:30",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "trsolucoes"
}