Constantin017/puppetry

Web testing solution for non-developers on top of Puppeteer and Jest

Puppetry

CODELESS END-TO-END AUTOMATED TESTING

Puppetry is an open-source cross-platform desktop application that gives non-developers the ability to create, manage, and integrate automated tests for Web

📺 Watch introduction video

Key Features

• Can be used by QA engineers with no programming background
• Features Headless Chrome (Puppeteer) and Jest
• Tests can run within the application as well as to be exported e.g. for CI-server
• Exporting
  • as Jest.js project, ready to plugin in in CI/CD pipeline
  • as human-readable test specification provided with screenshots per test step.
• Staging, template variables and expressions
• Reusable and configurable test scenarios
• Built-in automation recorder
• Interactive mode, where one can navigate test steps similar to Cypress
• Version control (GIT integration)
• Support Allure test reports
• Support of distinct testing types:
  • Functional testing
  • Testing Dynamic Content
  • Exhaustive Testing
  • Performance Testing
  • CSS Regression Testing
  • Testing Google Analytics tracking code
  • Testing Chrome Extensions
  • Testing Shadow DOM
  • Testing Transactional Emails.

Welcome Puppetry

Puppetry offers you an easy-to-use UI where you choose browser methods and assertions from a predefined list, with predefined settings, guided by extensive tips. Namely you can do the following:

• record user flow
• declare element targets as pairs variable = locator, where locator can be either CSS selector or Xpath.
• manage your test structure in BDD style (project, suite, test context, test case)
• manage page/element methods and assertions
• run the tests
• export the project as Jest/Puppeteer bundle ready to run in CLI (e.g. by a continuous integration server)

Download

You can download latest installers for your platform from the releases page

Current only the following OS are supported:

• Windows 7 and greater (64 bit)
• Ubuntu 14.04 and greater (64 bit)
• MacOS X 10.10 (Yosemite) and greater (64 bit)

On Linux also can be insalled with Snapcraft:

sudo snap install puppetry

Feedback

• Join Puppetry on Slack ☕
• Chat
• Facebook
• Feature requests
• Problem reports

Contributing

• get acquainted with guides
  • the great document about first contributions
• examine the Backlog, suggest new features
• look into existing Issues, come up with a fix (master branch)
• implement new features (dev branch)

Please adhere the coding style. We have one based on jQuery's JavaScript Style Guide. You can find the validation rules in .eslintrc and lint the code by running npm run lint

Thanks

A special thanks to Monika Rao, vteixeira19, Gernot Messow, Carlos Mantilla, kkmuffme, Ravindra Jadhav for the ideas and support

Credits

• Electron
• Puppeteer
• Jest

License

MIT