Skip to content

clj-commons/etaoin

Repository files navigation

pattern small

Etaoin

cljdoc GitHub Actions Tests Clojars project bb compatible Join chat

A pure Clojure implementation of the Webdriver protocol, named after Etaoin Shrdlu — a typing machine that came to life after a mysterious note was produced on it.

Use the Etaoin library to automate a browser, test your frontend behaviour, simulate human actions or whatever you want.

Benefits

  • Selenium-free: no big dependencies, no tons of downloaded jars, etc.

  • Lightweight, fast. Simple, easy to understand.

  • Compact: just one main namespace with a couple of helpers.

Capabilities

  • Currently supports Chrome, Firefox, Safari, and Edge.

  • Can either connect to a remote WebDriver process, or have Etaoin launch one for you.

  • Run your unit tests directly from Emacs by pressing C-t t as usual.

  • Can imitate human-like behaviour (delays, typos, etc).

Documentation

API docs and articles are best viewed on cljdoc:

See also:

Who uses Etaoin?

Some companies:

Some examples usages:

You are most welcome to submit your company or project to this list.

Versioning

Eatoin uses: major.minor.patch-test-qualifier

  • major increments when a non alpha release API has been majorly broken - something, as a rule, we’d like to avoid.

  • minor increments to convey significant new features have been added or minor breakage.

  • patch indicates bug fixes or minor changes - it is the total number of releases to date.

  • test-qualifier is absent for stable releases. Can be alpha, beta, rc1, etc.

People

Current Maintainers

Founder

Etaoin is open for your improvements and ideas. If any of the unit tests fail on your machine, please submit an issue giving your OS version, browser, and console output.

License

Copyright © 2017—2020 Ivan Grishaev.

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.