The sylenium from symonk

sylenium's Introduction

Overview 🎏

docs:
tests:
package:
infra:

What is Sylenium? 🎏

The goal of sylenium is to create a test framework agnostic browser (selenium wrapper) automation library to help development teams write end to end tests for their web applications without all the necessary boilerplate that is required to achieve stability with selenium.

Official Documentation 🎏

https://sylenium.readthedocs.io/

Configuring Sylenium 🎏

Sylenium uses a smart default configuration for most use cases, however the customisation options are endless. Managing the 'global' configuration can be achieved as outlined below:

from sylenium import Configuration
from sylenium import configure
configure(Configuration(headless=False, remote=True, explicit_waiting=15.00))
# Now all drivers will use this 'global configuration'
go("https://www.google.com")

On the fly per driver configurations?

with get_driver(Configuration(headless=True, polling_interval=2.50, default_selector='ID')):
    go('https://www.google.com')

Quick Start 🎏

Here is a simple way to get going for a standalone simple library script that requires some browser interaction:

import sylenium import *

def main():
    # google search => No setup at all, just install sylenium with pip
    with get_driver():
        go("https://www.bing.com")
        find(ById("sb_form_q")).set_text("Hello World").clear().set_text("My Search").press_enter()
        find(ById("b_results")).should_be(Visible).should_contain(Text("My Search"))

Sylenium-pytest 🎏

Plugin (coming soon)

sylenium's People

Contributors

Stargazers

Watchers

sylenium's Issues

Documentation / Sphinx and a standard for going forward

August Sprint => Fully automated deployment to Pypi

Bug: Config type checks for bools return successfully on integers because bool is a subclass of int

>>> bool.__mro__
(<class 'bool'>, <class 'int'>, <class 'object'>)

config type checks fail when ints are passed as True/False for example.

August Sprint => Fix isort and apply other relevent pre-commit hooks

code coverage is not reliable / not working at all

Implement a configuration sub module

How should the config be loaded in dynamically?
Should the library force the client to acknowledge loading before using it, via browzer.initiate() etc?
Decouple the config, it should do only config and do it well
How to handle dynamically loaded options like a EventListener for example
Do not acquire a binary if required during configuration stage
More / widen the options? - Hard to gauge without other parts of the libraries needs

Driver management and thread local drivers?

We need to implement the following 'high level design':

calling open(url) should (if not already yield a new driver)
how do we manage driver tracker if someone closes one, we need some sort of callback to untrack the driver for that thread?
what about the config, its essentially fully 'global' then via open() calls, how do we test that if so?
current concept of sessions, is it fit for purpose?

-- Brain Dump

Can threading.local help?
Can we have a secondary thread for each browser, that is responsible for checking if the browser is destroyed?
Can we proxy .quit() / .close() to remove the browser from tracking?
What happens if a thread runs multiple tests, how do we create a fresh browser there?
Can observer pattern help? (what does that look like in python) for observing some sort of driver or session and notifying