MasterQA

MasterQA combines SeleniumBase automation with manual verification to greatly improve the productivity and sanity of QA teams.

(NOTE: MasterQA is now part of SeleniumBase!)

Run the example test:

pip install masterqa

git clone https://github.com/masterqa/MasterQA.git

cd MasterQA/examples

pytest masterqa_test.py  # (Default browser: Chrome)

Follow the example to write your own tests:

from seleniumbase import MasterQA

class MasterQATests(MasterQA):
    def test_xkcd(self):
        self.open("https://xkcd.com/1512/")
        for i in range(4):
            self.click('a[rel="next"]')
        for i in range(3):
            self.click('a[rel="prev"]')
        self.verify()

        self.open("https://xkcd.com/1520/")
        for i in range(2):
            self.click('a[rel="next"]')
        self.verify("Can you find the moon?")

        self.click('a[rel="next"]')
        self.verify("Do the drones look safe?")

        self.open("https://seleniumbase.io/devices/")
        self.type("input#urlInput", "seleniumbase.io/error_page\n")
        self.verify("Do you see Octocat in a Jedi knight robe?")

        self.open("https://xkcd.com/213/")
        for i in range(5):
            self.click('a[rel="prev"]')
        self.verify("Does the page say 'Abnormal Expressions'?")

You'll notice that tests are written based on SeleniumBase, with the key difference of using a different import: from masterqa import MasterQA rather than from seleniumbase import BaseCase. Now the test class will import MasterQA instead of BaseCase.

To add a manual verification step, use self.verify() in the code after each part of the script that needs manual verification. If you want to include a custom question, add text inside that call (in quotes). Example:

self.verify()

self.verify("Can you find the moon?")

MasterQA is powered by SeleniumBase, the most advanced open-source automation platform on the Planet.

Metadata

Release files for masterqa 1.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for masterqa 1.10.1
File	Size	Uploaded
masterqa-1.10.1.tar.gz	12.3 kB	Jun 12, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for masterqa 1.10.1
File	Interpreter	ABI	Platform	Reset
masterqa-1.10.1-py3-none-any.whl 8.7 kB Jun 12, 2025	Python 3	none	any	Details

Total release size: 21.0 kB

Release files / masterqa-1.10.1.tar.gz

Download URL	masterqa-1.10.1.tar.gz
Size	12.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`a7c03795b52c0c6de6286b40294782f0ac17637e945bb23be20c3fe17da5e9e9`
BLAKE2b-256 checksum How to use checksums	`12606e1b5b7ce4ed650a63f6836589b9c02682109b3c6aa4b9c5d5b357d13269`
Upload date	Jun 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.9`

Release files / masterqa-1.10.1-py3-none-any.whl

Download URL	masterqa-1.10.1-py3-none-any.whl
Size	8.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8bd8ddf62f28c8ab220ea6e69aaa1d361c0e8f6d2b1f2aad8a9e1379afad09a5`
BLAKE2b-256 checksum How to use checksums	`2446e3baa24c22e74a5d85ac3298632b18671aa8263af0e1059105fa095bf74c`
Upload date	Jun 12, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.9`