https://github.com/ivpel/vigilant-kit

Testing with Selenium WebDriver - fast and easy.
https://github.com/ivpel/vigilant-kit

python selenium selenium-webdriver tdd test-automation testing webdriver

Last synced: 4 months ago
JSON representation

Testing with Selenium WebDriver - fast and easy.

• Host: GitHub
• URL: https://github.com/ivpel/vigilant-kit
• Owner: ivpel
• License: gpl-3.0
• Created: 2022-10-28T14:56:55.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-22T11:16:59.000Z (9 months ago)
• Last Synced: 2024-05-22T11:32:14.284Z (9 months ago)
• Topics: python, selenium, selenium-webdriver, tdd, test-automation, testing, webdriver
• Language: Python
• Homepage:
• Size: 97.7 KB
• Stars: 6
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Vigilant Kit

**Vigilant** is a set of tools 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. It is a **W3C standard**.

## What included?

_Wait for condition, Act by Interaction, Assert the result._

### **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)