System tests for the joplin desktop application in python.

Main motivation is to learn how an electron app can be tested with selenium.

Example for ubuntu 20.04:

sudo apt install ffmpeg xvfb
pip install -r requirements.txt

All tests of the following table are successfully executed, except of the tests marked with ☒.

Except of the marked tests in the table above, there are some other untested features:

• Searching: https://github.com/laurent22/joplin#searching
• Attachments: https://github.com/laurent22/joplin#attachments
• External editor: https://github.com/laurent22/joplin#external-text-editor
• Note history: https://github.com/laurent22/joplin#note-history
• Encryption: https://github.com/laurent22/joplin#encryption
• Synchronisation: https://github.com/laurent22/joplin#synchronisation
• Importing: https://github.com/laurent22/joplin#importing
• https://github.com/laurent22/joplin#features:
  • Sorting notes
  • Alarms
  • Inline display of PDF, video and audio files
  • Geo-location
  • Multiple languages
  • Custom keyboard shortcuts

Don't run with your normal joplin profile, since the tests are modifying and deleting the content!

python run_tests.py

The tests are usually structured in the following way:

1. set the preconditions via API
2. do the UI action
3. check the results via API

Single tests are not independent. Only test classes are mostly independent, since that saves much time. The webdriver and xvfb session are shared through all tests.

• Don't use language dependent locators. There were several problems, because my system language is german, but at the reference, I used english.
• Recording the full testsuite can be very valuable. For example at the frame by frame playback, it was visible that the top menu did lose focus, because the label count was updated one frame after focussing.
• find_elements* is time consuming, since it has to search the full tree. In contrast find_element* returns the first found item.