elixir-wallaby/wallaby
66.6
Adequate · 13 November 2026
5.8k
lines of production code
Elixir
primary language
8
measurements over time
What this system is
This system is a browser automation library for Elixir that enables integration testing by controlling web browsers via WebDriver protocols. It provides a DSL for interacting with page elements, handling user inputs, and asserting on browser state, while supporting multiple drivers including Chrome and Selenium. The system manages browser sessions, captures logs and screenshots, and offers utilities for keyboard input and query filtering to facilitate robust end-to-end testing.
How it got here
2016 — Elixir 1.17+ rewrite and dependency upgrade
9 changes.
The project underwent a major rewrite to drop support for older Elixir and OTP versions, requiring an upgrade to Elixir 1.17 and OTP 26. This period involved migrating the configuration system, replacing the HTTP client with Hackney 4.x, and introducing new modules for browser automation, event emission, and keyboard input encoding.
2017 — query improvements and integration test expansion
13 changes.
This period focused on enhancing the query engine with better error messages and XPath support, alongside significant expansion of the integration test suite. The team consolidated and added comprehensive tests for browser interactions, driver configurations, and internal utility modules to ensure robustness across different browser drivers.
2020 — test coverage and infrastructure
5 changes.
This period focused on expanding test coverage for Chrome and Selenium driver integrations, including server lifecycle, log parsing, and session configuration. It also introduced integration tests for the Wallaby.Feature macro and added a Docker helper script to streamline local testing environments.
Features
Add EventEmitter and expose JS error/logging configuration
The library now includes an internal EventEmitter module to support telemetry-style event emission during testing, allowing implementation code to emit events and test code to await them. Additionally, the main Wallaby module now explicitly documents and exposes configuration options for JavaScript error handling (:js\_errors) and console logging (:js\_logger), enabling users to control whether JS errors are re-thrown and where console logs are directed.
lib · high confidence
Add KeyCodes helper for keyboard input encoding
A new \Wallaby.Helpers.KeyCodes\ module has been added to provide shortcuts for various keyboard keys. This helper allows users to encode lists of key codes into a JSON representation suitable for browser automation and ensures keys are converted to binary form for local file checks, supporting standard keys like arrows, modifiers, and numeric inputs.
lib/wallaby/helpers · high confidence
Add background process wrapper script
A new shell script (priv/run\_command.sh) has been added to manage running external commands in the background. It captures the process ID, handles stdin closure to terminate the child process, and ensures clean shutdown on termination signals (INT, HUP, TERM).
priv · high confidence
Added docker-run helper script for Wallaby testing
A new executable script, bin/docker-run, has been added to facilitate local development and testing. This script allows users to build and run a Docker container pre-configured with specific versions of Elixir and Erlang, along with Chromium and Chromedriver, which are required for running Wallaby integration tests.
bin · high confidence
New integration test support utilities and helpers
This change introduces three new support modules for integration testing: \Wallaby.Integration.Helpers\ provides a \displayed\_in\_viewport?/2\ function to check if an element is visible within the browser viewport; \Wallaby.Integration.SessionCase\ offers a test case template that automatically injects a test session into the test context with retry logic for session startup; and \Wallaby.Integration.TestServer\ provides utilities to start, stop, and query the port of a local HTTP server for testing purposes.
_integration\test/support · high confidence
Behavioural changes
Improved query error messages and new XPath query support
Users will now see more descriptive and actionable error messages when queries fail, including specific guidance for label mismatches, invalid button types, and text visibility conflicts. Additionally, the query engine now supports finding elements by their attribute name and value pair, expanding the ways users can locate elements in their tests.
lib/wallaby/query · high confidence
Introduces internal driver utility modules
This change adds several new internal modules to the driver layer to support refactoring and new capabilities. It introduces \Wallaby.Driver.ExternalCommand\ to represent executable commands, \Wallaby.Driver.TemporaryPath\ for generating unique temporary directories, and \Wallaby.Driver.Utils\ to find available network ports. Additionally, it adds \Wallaby.Driver.LogStore\ (backed by an Agent) to persist session logs and \Wallaby.Driver.LogChecker\ to execute functions while capturing and storing browser logs, enabling features like capturing JavaScript logs in Chrome.
lib/wallaby/driver · high confidence
Migrate configuration system to Elixir 1.10+ syntax
The application's configuration has been updated to use the modern \import Config\ syntax, replacing the deprecated \Mix.Config\ module. This change introduces environment-specific configuration files (dev, test, prod, docs) that are imported via \import\_config\, allowing for distinct settings per environment. For example, the test environment now explicitly sets Hackney HTTP client timeouts and a temporary directory prefix, while the base configuration defines default values for Wallaby such as max wait time, pool size, and JavaScript logging behavior.
config · high confidence
Wallaby 0.31.0: Requires Elixir 1.17+, OTP 26+, and Hackney 4.x
This release updates the minimum runtime requirements to Elixir 1.17 and OTP 26, and upgrades the HTTP client dependency to Hackney 4.x. These changes constitute a breaking update for users on older Erlang/OTP or Elixir versions, as well as those relying on Hackney versions prior to 4.x.
(repo-wide) · high confidence
Wallaby browser automation library rewritten for Elixir 1.17+ and OTP 26
The \lib/wallaby\ source has been completely rewritten to drop support for Elixir versions prior to 1.17 and OTP prior to 26. This update introduces a new Chrome driver implementation (\Wallaby.Chrome\) that manages Chromedriver instances via a \PartitionSupervisor\ to cap concurrency and improve stability, alongside a new \Wallaby.Browser\ module that serves as the primary entrypoint for user-facing actions like \fill\_in\, \click\, and \find\. The rewrite also includes a new \Wallaby.DSL\ for cleaner test syntax, a \Wallaby.Feature\ macro for ExUnit integration, and a refactored HTTP client (\Wallaby.HTTPClient\) that uses Jason for JSON parsing and adds jitter to HTTP retries to prevent overwhelming WebDriver servers.
lib/wallaby · high confidence
Test coverage
Added Selenium integration test suite; Added integration test support pages for browser interaction scenarios; Added integration tests for Chrome driver configuration and session management; Added integration tests for browser interaction capabilities; Added integration tests for browser interactions, query filtering, and element inspection; Added integration tests for the Wallaby.Feature macro; Added test support module for Chrome and Chromedriver scripts; Added tests for Chrome Chromedriver server lifecycle and log parsing; Added tests for Selenium WebDriver client and session configuration; Added tests for TemporaryPath and Utils modules; Added tests for key code encoding helpers; Added tests for query error messages; Added unit tests for browser, HTTP client, query, Selenium, and session store modules; Consolidated integration test suite; Exclude pending tests and start event emitter in test suite; New test support helpers for Wallaby integration tests.
Dependencies
Upgrade to Elixir 1.17 and update core dependencies
The project now requires Elixir 1.17 and OTP 26, dropping support for older versions. This change upgrades the HTTP client from httpoison 1.x to 3.0 (which relies on hackney 4.x) and updates the JSON library to Jason 1.4.5. Additionally, the lockfile is refreshed with current versions for development tools like Credo (1.7.19) and documentation generator ExDoc (0.34.0), alongside other dependency bumps such as web\_driver\_client to 0.3.0.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 67 → 67 (-0.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 95 → 95 (+0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 50 → 49 (-0.5)
- Readiness 79 → 79 (-0.1)
- Security 80 → 77 (-2.8)
New (9)
- Edited copies of one member (4 members, 1+ corresponding lines) (lib/wallaby/query/xpath.ex)
- Edited copy of a member (10 corresponding lines) (lib/wallaby/browser.ex)
- Edited copy of a member (24 corresponding lines) (lib/wallaby/chrome.ex)
- Edited copy of a member (5 corresponding lines) (lib/wallaby/selenium.ex)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Medium CVE: EEF-[CVE redacted] (mix.lock)
- Orphaned file (lib/wallaby/selenium.ex)
- Outdated: httpoison
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
elixir-wallaby/wallaby was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 5f3a58b300268b39f8f3536687caf58e4516773d — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.57+preprod-8ebfb01cf4c0.