A lumo based test runner for selenium-webdriver using node-js bindings and clojurescript

I wanted to play with the node-js bindings for selenium-webdriver, and have used lumo with success in the past to leverage npm via clojurescript.

The clojure libraries I've seen that integrate with selenium have focused on providing api functions, either through reflection or direct specification, so that you have access to them in an idiomatic way.

Though this is useful, I didn't want to create a bindings library, and instead wanted to focus on direct interop to discover useful patterns, and then capture those patterns and allow them to be leveraged as interpreted data.

The poe.core/interpret multimethod provides a way to capture these patterns.

The node bindings present an interesting interface for clojure, because most operations are performed by chaining promises together to create the sequence of events to test. This was another area that I thought could be simplified for test specification.

The poe.core/run function captures a way for a vector of operations to be used to define and run a test, handling all of the chaining for you.

This library depends on selenium-webdriver, and is scoped to expect the use of chromedriver to operate with google chrome. Not currently planning to go for more support, unless it becomes important to.

Also, I'm assuming OSX with brew, if you aren't using this, you can get the dependencies some other way.

brew cask install chromedriver
brew install lumo
npm install

There is an example directory that will run out-of-the-box examples to show you how to get started.

NOTE: If you want the email login examples to succeed, you will need to update their text in them to have valid credentials!

lumo --classpath src:examples -m examples.google-search
lumo --classpath src:examples -m examples.gmail-login
lumo --classpath src:examples -m examples.hotmail-login
lumo --classpath src:examples -m examples.table

• TODO: Discuss ability to use arbitrary functions for operations
• TODO: Discuss how to turn arbitrary function into defmethods for interpret
• TODO: Discuss why data format for tests is useful

The following should be sufficient to fill in the gaps that I've left:

• anmonteiro's lumo

• selenium-webdriver, node bindings

• Rafal Spacjer's blogpost on clojurescript interop

• clojurescript cheatsheet, search for interop