vigilant-kit 1.2.0__py3-none-any.whl → 1.2.1__py3-none-any.whl

vigilant_kit-1.2.1.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.1
+Name: vigilant_kit
+Version: 1.2.1
+Summary: Library that makes functional testing with Selenium WebDriver fast and easy. 
+Project-URL: Homepage, https://github.com/ivpel/vigilant
+Project-URL: Bug Tracker, https://github.com/ivpel/vigilant/issues
+Author-email: Pelykh Ivan <ivan.pelykh@protonmail.com>
+License-File: LICENSE
+Keywords: bdd,functional,functional-testing,pytest,selenium,tdd,testing,unittest,webdriver
+Requires-Python: >=3.7
+Requires-Dist: click
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: selenium
+Description-Content-Type: text/markdown
+
+# Vigilant Kit
+Vigilant is a set of tools designed to help write and run robust functional tests using Selenium WebDriver. It provides
+methods for interacting with the WebBrowser, assertions, and waiting. With Vigilant, you can start writing complex test
+cases in a minute.
+
+## Why Vigilant?
+- **Easy to start & Fast To Write**: Easy configuration process, straightforward way to writing your tests.
+Vigilant provides you with methods that help you write functional tests quickly without spending time on writing 
+boilerplate code every time you start a new project. 
+- **Flexible Framework Usage**: Usage is not limited to a single testing framework; you can use Vigilant with unittest,
+  pytest, or anything else.
+
+## What it includes?
+Methods for **interacting** with WebBrowser (`click`, `scroll_to`,  etc.), **assertions** (`see`, `dont_see`, `see_text`
+, etc.) **waiters** (`wait_for_element_to_be_visible`, `wait_for_element_to_be_clickable`, etc.)
+It is already there, ready to use.
+
+Also, a bunch of CLI scripts, to make your life easier!
+
+Use `vgl --help` to see all available commands.
+
+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
+ - [How to install Selenium server & browser drivers](docs/selenium_install.md)
+ - [Quick start example using `unittest` library](docs/vigilant_unittest.md) 
+ - [Quick start example using `pytest`](docs/vigilant_pytest.md) 
+ - [How to add custom browser options](docs/browser_options.md)
+ - [Access native Selenium WebDriver methods](docs/native_selenium.md)
+ - [List of actions](docs/actions.md).
+
+## Tutorials
+ - [Testing ecommerce project using `vigilant-kit` and `pytest`](docs/tutorial_pytest.md)
+ 

{vigilant_kit-1.2.0.dist-info → vigilant_kit-1.2.1.dist-info}/RECORD

@@ -12,8 +12,8 @@ vigilant/actions/vigilant_actions.py,sha256=2OwnuKJHU4MUq4atLq49FbRQPUeE0mCXs0ps
 vigilant/actions/waiter.py,sha256=_sgL-R-Kp3I-DP27Sd_OAL8erjvhLvHLWFURXNX3V2w,3298
 vigilant/driver/__init__.py,sha256=brf9Jk8uq_TNomOKu2k_0u9mAuimLf9bxF0XHafaZGs,207
 vigilant/driver/vigilant_driver.py,sha256=rw5CfWfBWOIFPgnkmxTi7cSbrrxLtDtRlxg2FMfyEVw,3398
-vigilant_kit-1.2.0.dist-info/METADATA,sha256=QVNLCEV4qm_znoAzcC31E2ETZZgDBgvKwEWogl0bsg8,6233
-vigilant_kit-1.2.0.dist-info/WHEEL,sha256=9MIigYJ7D5sOqAPqr0-o6tSMY_nQ7c6kvtvyeUB99YQ,87
-vigilant_kit-1.2.0.dist-info/entry_points.txt,sha256=c_azSnuBSdtgwdPlioaG0n2gZOEhuPIzL9VQ8DeKTow,40
-vigilant_kit-1.2.0.dist-info/licenses/LICENSE,sha256=VQoL58PKrdEeZx2K4hXS7O6w4O_DMBB0XFE-GjK1CMo,35125
-vigilant_kit-1.2.0.dist-info/RECORD,,
+vigilant_kit-1.2.1.dist-info/METADATA,sha256=sOPWPkskC1HySS4nO2Nh-lPD9s4GlYFPAHaYgWSKvQg,2566
+vigilant_kit-1.2.1.dist-info/WHEEL,sha256=9MIigYJ7D5sOqAPqr0-o6tSMY_nQ7c6kvtvyeUB99YQ,87
+vigilant_kit-1.2.1.dist-info/entry_points.txt,sha256=c_azSnuBSdtgwdPlioaG0n2gZOEhuPIzL9VQ8DeKTow,40
+vigilant_kit-1.2.1.dist-info/licenses/LICENSE,sha256=VQoL58PKrdEeZx2K4hXS7O6w4O_DMBB0XFE-GjK1CMo,35125
+vigilant_kit-1.2.1.dist-info/RECORD,,

vigilant_kit-1.2.0.dist-info/METADATA

@@ -1,150 +0,0 @@
-Metadata-Version: 2.1
-Name: vigilant_kit
-Version: 1.2.0
-Summary: Library that makes functional testing with Selenium WebDriver fast and easy. 
-Project-URL: Homepage, https://github.com/ivpel/vigilant
-Project-URL: Bug Tracker, https://github.com/ivpel/vigilant/issues
-Author-email: Pelykh Ivan <ivan.pelykh@protonmail.com>
-License-File: LICENSE
-Keywords: bdd,functional,functional-testing,pytest,selenium,tdd,testing,unittest,webdriver
-Requires-Python: >=3.7
-Requires-Dist: click
-Requires-Dist: python-dotenv
-Requires-Dist: requests
-Requires-Dist: selenium
-Description-Content-Type: text/markdown
-
-# Vigilant Kit
-Vigilant is a set of tools made to help writing and running robust functional tests using Selenium WebDriver.
-
-## Why Vigilant?
- - It allows you to start writing complex test cases in a minute.
- - Simple configuration process (just one `.vigilant.env` file to start)
- - Usage is not limited to a single testing framework, it can be used with `unittest`, `pytest` or anything else.
-It is up to you.
-
-**Vigilant** provide you with methods that help write functional tests fast, without spending your time on writing
-boilerplate code every time you start new project.
-
-Methods for **interacting** with WebBrowser (`click`, `scroll_to`,  etc.), **assertions** (`see`, `dont_see`, `see_text`
-, etc.) **waiting** (`wait_for_element_to_be_visible`, `wait_for_element_to_be_clickable`, etc.)
-It is already there, ready to use.
-
-List of all available [actions](docs/actions.md).
-
-### What if you need something that is not covered in this library?
-
-You still have access to all native `Selenium WebDriver` methods. Despite all functional that library provide - 
-you can create your own methods or use native `WebDriver` methods and share them on one browser session.
-
-## Docs
- - [How to install Selenium server & browser drivers](docs/selenium_install.md)
- - [Quick start example using `unittest` library](docs/vigilant_unittest.md) 
- - [Quick start example using `pytest`](docs/vigilant_pytest.md) 
- - [How to add custom browser options](docs/browser_options.md)
- - [Access native Selenium WebDriver methods](docs/native_selenium.md)
- - [List of actions](docs/actions.md).
-
-## Tutorials
- - [Testing ecommerce project using `vigilant-kit` and `pytest`](docs/tutorial_pytest.md)
- 
-## Install
-```shell
-pip install vigilant-kit
-```
-
-## Quick start
-We will write our first test with `unittest` library. Also make sure that you installed
-`vigilant-kit` library.
-
-
-### Configuration
-Configuration can be done through environment variables. Make sure that your Selenium Server is up and running, if not -
-[**Install Selenium server**](docs/selenium_install.md)
-
-Create `.vigilant.env` file with next data:
-```shell
-# Selenium host URL
-SELENIUM_HOST=http://127.0.0.1:4444/wd/hub 
-
-# Browser which will performing the tests
-SELENIUM_BROWSER=firefox 
-
-# The root URL of the application under test.
-BASE_URL=http://www.python.org 
-
-# Amount of time (in seconds) that a test will wait while loading a page or waiting for element
-WAIT_TIMEOUT=10 
-
-# Log level
-LOGGER_LEVEL=INFO 
-```
-
-### Test
-Create file `test_first.py` with same code as below. We will cover 3 simple cases for demo purposes.
-```python
-import unittest
-
-from vigilant.driver.vigilant_driver import VigilantDriver
-
-
-class TestHomePage(unittest.TestCase):
-
-    @classmethod
-    def setUpClass(cls) -> None:
-        cls.act = VigilantDriver()
-
-    @classmethod
-    def tearDownClass(cls) -> None:
-        cls.act.quit()
-
-    def test_home_page(self):
-        # Case 1. Go to some page and assert page title
-        self.act.get_page('/')  # Go to root page
-        self.act.assertions.see_in_title('Python')  # Assert that page title contains 'Python' string
-
-    def test_text_block(self):
-        # Case 2. Scroll to some block and assert visible text
-        self.act.get_page('/')  # Go to root page
-        self.act.scroll_to('//h2[text()="Success Stories"]')  # Scroll to Success Stories block
-        self.act.assertions.see_text('Success Stories')  # Assert that Success Stories string is visible
-
-    def test_search_page(self):
-        # Case 3. Fill in Search field with search key word, assert result in search result page.
-        self.act.get_page('/')  # Go to root page
-        self.act.fill_field('//input[@name="q"]', 'python')  # Fill search field
-        self.act.click('//button[@id="submit"]')  # Click Search button
-        self.act.assertions.see_in_url(
-            '/search/?q=python')  # See in URL that we are redirected to search result page
-        self.act.assertions.see_text('Results')  # Assert visible Results text
-
-
-if __name__ == '__main__':
-    unittest.main()
-
-```
-Now run our script:
-```shell
-python3 test_first.py
-```
-### Results
-If you are running your Selenium Server locally - you can see how script interact with browser in real time. But in any
-case you should have terminal output similar to this, due to LOGGER_LEVEL=INFO:
-```text
-[2022-11-02 16:34:26,452: INFO] Creating remote session.
-Command executor: http://127.0.0.1:4444/wd/hub
-Browser: firefox
-[2022-11-02 16:34:26,452: INFO] Setting default browser options: firefox
-[2022-11-02 16:34:27,890: INFO] Getting page: /
-[2022-11-02 16:34:33,942: INFO] Assert: see string Python in current page title
-[2022-11-02 16:34:33,956: INFO] Scrolling to element: //h2[text()="Success Stories"]
-[2022-11-02 16:34:33,956: INFO] Execute JS script: arguments[0].scrollIntoView({block: "center"}) with arguments: <selenium.webdriver.remote.webelement.WebElement (session="3c63a627-1ffd-40ed-b008-78e671d82085", element="703e049a-3ab4-4bd5-814a-bb38dd64864a")>
-[2022-11-02 16:34:33,980: INFO] Waiting for element with selector: //input[@name="q"] - to be visible.
-[2022-11-02 16:34:33,991: INFO] Filling field: //input[@name="q"] with value: python
-[2022-11-02 16:34:34,012: INFO] Waiting for element with selector: //button[@id="submit"] - to be visible.
-[2022-11-02 16:34:34,026: INFO] Clicking on element: //button[@id="submit"]
-[2022-11-02 16:34:34,411: INFO] Assert: see string /search/?q=python in current page URL
-[2022-11-02 16:34:34,434: INFO] Quits the driver and closes every associated window
-
-```
-Congrats! You successfully created your first testing script using Vigilant Kit :)