{"id":14978915,"url":"https://github.com/ivpel/vigilant-kit","last_synced_at":"2025-12-25T14:02:37.834Z","repository":{"id":133583167,"uuid":"558902595","full_name":"ivpel/vigilant-kit","owner":"ivpel","description":"Testing with Selenium WebDriver - fast and easy.","archived":false,"fork":false,"pushed_at":"2025-12-21T21:22:25.000Z","size":115,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-23T09:29:38.279Z","etag":null,"topics":["python","selenium","selenium-webdriver","tdd","test-automation","testing","webdriver"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivpel.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-10-28T14:56:55.000Z","updated_at":"2025-12-21T21:20:51.000Z","dependencies_parsed_at":"2023-06-11T02:50:52.540Z","dependency_job_id":"f52d5d7d-d978-4486-9d0f-ab05e24b8abc","html_url":"https://github.com/ivpel/vigilant-kit","commit_stats":null,"previous_names":["ivpel/vigilant"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ivpel/vigilant-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivpel%2Fvigilant-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivpel%2Fvigilant-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivpel%2Fvigilant-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivpel%2Fvigilant-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivpel","download_url":"https://codeload.github.com/ivpel/vigilant-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivpel%2Fvigilant-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28030909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","selenium","selenium-webdriver","tdd","test-automation","testing","webdriver"],"created_at":"2024-09-24T13:58:37.663Z","updated_at":"2025-12-25T14:02:37.827Z","avatar_url":"https://github.com/ivpel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vigilant Kit\nMinimal Selenium helpers that stay out of your way. Use any test runner (pytest, unittest, behave, raw scripts), keep full WebDriver control, and get convenience actions/assertions without a framework telling you how to structure tests.\n\n## Why Vigilant?\n* **Minimal \u0026 composable**: Thin wrapper over Selenium; mix our helpers with native WebDriver any time.\n* **Framework-agnostic**: Works with pytest, unittest, behave, custom runners, or plain scripts.\n* **Quick wins**: Smart waits, handy finders, assertions, PDF helpers, and data savers ready to use.\n* **Customizable**: Bring your own browser options, config via env or YAML, extend actions/assertions as needed.\n* **Standards-based**: Built on Selenium WebDriver (W3C).\n\n## Quick start\n```shell\npip install vigilant-kit\nexport SELENIUM_BROWSER=chrome SELENIUM_HOST=local BASE_URL=https://example.com\n```\n\n```python\nfrom vigilant.driver.vigilant_driver import VigilantDriver\n\ndef test_login():\n    browser = VigilantDriver()\n    browser.get_page(\"/login\") \\\n           .fill_form({\"#email\": \"user@example.com\", \"#password\": \"secret\"}) \\\n           .click(\"#submit\")\n    browser.assertions.see_text(\"Welcome\")\n    browser.quit()\n```\nUse your runner of choice: pytest, unittest, behave, or a simple Python script.\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 scraping 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 \u0026 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivpel%2Fvigilant-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivpel%2Fvigilant-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivpel%2Fvigilant-kit/lists"}