# Vigilant Kit
**Vigilant** is a library designed to help write and run robust functional tests using Selenium WebDriver. With
**Vigilant**, you can start writing complex test cases in a minute.
## Why Vigilant?
* **Easy to start & Fast To Write**: All methods for interaction, waiting different conditions and asserting the results
are already here.
* **No limits**: You are not limited to a single testing framework, use Vigilant with **unittest**,
**pytest**, or for **scrapping data**.
* **Stability**: We use Selenium WebDriver. **W3C standard**.
## What included?
_Wait, Act, Assert_
### **Actions**
- `click()`
- `scroll_to()`
- `fill_form()`
- `switch_to_window()`
- ...
### **Waiters for condition**
- `wait_for_element_to_be_visible()`
- `wait_for_element_to_be_clickable()`
- `wait_for_text_to_be_present_in_element()`
- `wait_for_element_to_disappear()`
- ...
### **Assertions**
- `see()`
- `dont_see()`
- `see_text()`
- `see_in_title()`
- ...
### **Scrappers**
Minimal required methods for scrapping some data:
- `get_text_from_element()`
- `get_attribute_from_element()`
- `get_cookie()`
- `save_data_to_txt()`
### **Test PDF**
You're testing some eCommerce project, and you need to check your PDF invoice file? No problem!
- `find_pdf_file()`,
- `assert_strings_in_pdf()`,
- `assert_strings_not_in_pdf()`,
- `find_file_and_assert_strings_are_in()`,
- ...
And much more! Check list of all available - [Actions](docs/actions.md)
## Extending Functionality
If you need something that is not covered in this library, you still have access to all native `Selenium WebDriver`
methods. You can create your own methods or use native `WebDriver` methods and share them on one browser session.
## Install
```shell
pip install vigilant-kit
```
## Docs
### Configuration
- [Vigilant configuration](docs/configuration.md)
- [Adding custom browser options](docs/browser_options.md)
- [Using native selenium methods](docs/native_selenium.md)
### Examples & tutorials
- [Quick start example using `unittest` library](docs/vigilant_unittest.md)
- [Quick start example using `pytest`](docs/vigilant_pytest.md)
- [Testing ecommerce project using `vigilant-kit` and `pytest`](docs/tutorial_pytest.md)
### Actions
- [List of actions](docs/actions.md)
Raw data
{
"_id": null,
"home_page": null,
"name": "vigilant-kit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "bdd, functional, functional-testing, pytest, selenium, tdd, testing, unittest, webdriver",
"author": null,
"author_email": "Pelykh Ivan <ivan.pelykh@protonmail.com>",
"download_url": "https://files.pythonhosted.org/packages/fc/f9/bd07deed327c8ced8bccb97f2a34ec12bad68261e2aa0dea9a3bd8478148/vigilant_kit-1.5.0.tar.gz",
"platform": null,
"description": "# Vigilant Kit\n**Vigilant** is a library designed to help write and run robust functional tests using Selenium WebDriver. With \n**Vigilant**, you can start writing complex test cases in a minute.\n\n## Why Vigilant?\n* **Easy to start & Fast To Write**: All methods for interaction, waiting different conditions and asserting the results\nare already here.\n* **No limits**: You are not limited to a single testing framework, use Vigilant with **unittest**,\n **pytest**, or for **scrapping data**. \n* **Stability**: We use Selenium WebDriver. **W3C standard**.\n\n## What included?\n_Wait, Act, Assert_\n\n\n### **Actions** \n - `click()`\n - `scroll_to()`\n - `fill_form()`\n - `switch_to_window()`\n - ...\n\n### **Waiters for condition** \n\n - `wait_for_element_to_be_visible()`\n - `wait_for_element_to_be_clickable()`\n - `wait_for_text_to_be_present_in_element()`\n - `wait_for_element_to_disappear()`\n - ...\n\n### **Assertions** \n\n - `see()`\n - `dont_see()`\n - `see_text()`\n - `see_in_title()`\n - ...\n\n\n\n\n### **Scrappers**\nMinimal required methods for scrapping some data:\n - `get_text_from_element()`\n - `get_attribute_from_element()`\n - `get_cookie()`\n - `save_data_to_txt()`\n\n### **Test PDF**\nYou're testing some eCommerce project, and you need to check your PDF invoice file? No problem!\n - `find_pdf_file()`,\n - `assert_strings_in_pdf()`,\n - `assert_strings_not_in_pdf()`,\n - `find_file_and_assert_strings_are_in()`,\n - ...\n\nAnd much more! Check list of all available - [Actions](docs/actions.md)\n\n\n## Extending Functionality\nIf you need something that is not covered in this library, you still have access to all native `Selenium WebDriver` \nmethods. You can create your own methods or use native `WebDriver` methods and share them on one browser session.\n\n## Install\n```shell\npip install vigilant-kit\n```\n\n## Docs\n\n### Configuration\n- [Vigilant configuration](docs/configuration.md)\n- [Adding custom browser options](docs/browser_options.md)\n- [Using native selenium methods](docs/native_selenium.md)\n\n### Examples & tutorials\n- [Quick start example using `unittest` library](docs/vigilant_unittest.md) \n- [Quick start example using `pytest`](docs/vigilant_pytest.md) \n- [Testing ecommerce project using `vigilant-kit` and `pytest`](docs/tutorial_pytest.md)\n\n### Actions\n- [List of actions](docs/actions.md)\n",
"bugtrack_url": null,
"license": null,
"summary": "Library that makes functional testing with Selenium WebDriver fast and easy.",
"version": "1.5.0",
"project_urls": {
"Bug Tracker": "https://github.com/ivpel/vigilant/issues",
"Homepage": "https://github.com/ivpel/vigilant"
},
"split_keywords": [
"bdd",
" functional",
" functional-testing",
" pytest",
" selenium",
" tdd",
" testing",
" unittest",
" webdriver"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3607247da33ccd5fc078b78d77d8dcd090a2481d50e7585f88571a020f9d64f0",
"md5": "1332ad2b43108a0616846444b6abd029",
"sha256": "66ae1408d66f0055cff87eadf66d8691069adf5e1c44444b81e13345613b5efe"
},
"downloads": -1,
"filename": "vigilant_kit-1.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1332ad2b43108a0616846444b6abd029",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 24630,
"upload_time": "2024-12-27T18:12:07",
"upload_time_iso_8601": "2024-12-27T18:12:07.464497Z",
"url": "https://files.pythonhosted.org/packages/36/07/247da33ccd5fc078b78d77d8dcd090a2481d50e7585f88571a020f9d64f0/vigilant_kit-1.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fcf9bd07deed327c8ced8bccb97f2a34ec12bad68261e2aa0dea9a3bd8478148",
"md5": "2bdb29089788c72c952245aa0ce3888d",
"sha256": "2491db388e26fe5042c558fc6568d326ea17b978fb7fa510e72f08e84f109be5"
},
"downloads": -1,
"filename": "vigilant_kit-1.5.0.tar.gz",
"has_sig": false,
"md5_digest": "2bdb29089788c72c952245aa0ce3888d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 37023,
"upload_time": "2024-12-27T18:12:08",
"upload_time_iso_8601": "2024-12-27T18:12:08.875223Z",
"url": "https://files.pythonhosted.org/packages/fc/f9/bd07deed327c8ced8bccb97f2a34ec12bad68261e2aa0dea9a3bd8478148/vigilant_kit-1.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-27 18:12:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ivpel",
"github_project": "vigilant",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "vigilant-kit"
}
JSON
