Hey dev community! With the holidays right around the corner, it feels like the perfect time to talk about one of the best gifts we can give our users: an accessible web. Here at TestZeus, we’ve been hard at work adding Accessibility Testing to our open-source Hercules Agent—and I’m super excited to share the details with you! Why Accessibility Matters Accessibility is about making sure everyone can use your website or app, regardless of ability. That includes users who rely on screen readers, have motor difficulties, or experience color blindness, among many other scenarios. It’s not just a moral responsibility or a legal checkmark—it’s about crafting better user experiences for everyone. Meet Hercules If you haven’t heard of it yet, Hercules is our open-source testing agent that automates various aspects of software testing. By adding Accessibility Testing, we aim to reduce the friction developers often face when trying to meet WCAG (Web Content Accessibility Guidelines). Some highlights: Covers WCAG 2.0, 2.1, and 2.2
Costs less than $1 per scan (so, super accessible for smaller teams too!)
Open-source and easy to integrate into your CI/CD pipeline In other words, we’re focusing on practicality and affordability, so you don’t need a huge budget or specialized skillset to make your site more inclusive. Quick Setup Clone the Repo

Head over to our GitHub repo and clone it.


Install Dependencies

A quick 'pip install testzeus-hercules'


Write Your Test in Gherkin

Hercules uses Gherkin-like .feature files. It’s straightforward and keeps the logic clear.


Run Hercules

A single command to scan for accessibility issues. Reports are automatically generated, so you can jump right into fixing any violations. Sample Test Scenario We’ve included a snippet below to show how a typical .featurefile might look, using the Zerodha brokerage calculator page as an example: Feature: Check accessibility for brokerage calculator on Zerodha website
  # This feature tests the brokerage calculator, and contract notes on Zerodha website

  Scenario Outline: Check calculations on brokerage and SEBI charges
    Given the user is on "https://zerodha.com/brokerage-calculator#tab-equities"
    Then validate the page for accessibility.
    Then there should not be any issues. Here’s the breakdown: Feature: Provides context—testing Zerodha’s brokerage calculator.
Scenario Outline: Explains the specific scenario.
Steps:

Given: Navigate to a specific URL.
Then: Validate accessibility.
Then: Ensure zero issues remain (fingers crossed!). Hercules interprets this scenario, visits the page, scans it, and flags any WCAG non-compliances. Viewing Your Results Once your tests complete, Hercules shows you a report detailing any accessibility issues found: Issue Description: A quick summary of the violation.
WCAG Reference: Which guideline is being broken.
Severity: Ranges from minor to critical.
Location: Points you to the exact DOM element or area in the UI. This immediate feedback loop makes it easy for devs to fix issues before they reach production. Integrating with CI/CD Because Hercules is open-source and script-friendly, you can plug it into your CI pipeline. For example, in GitHub Actions, you can create a workflow that runs Hercules every time you push new code. That way, you’ll catch accessibility regressions early in the development process. Going Beyond Automated Checks While Hercules does a fantastic job with automated scans, keep in mind that accessibility is a multifaceted area. You might still want to: Test with screen readers like NVDA or VoiceOver.
Check color contrasts in real-world scenarios.
Solicit feedback from users with disabilities for real-life insights. Automated testing is a huge help, but manual testing still plays a key role in thorough accessibility coverage. Wrapping Up This holiday season, consider giving the gift of an accessible experience to your users. With Hercules, you can weave accessibility checks right into your development cycle—reducing barriers and making the web a more inclusive place. Here are some helpful links: Repo: TestZeus Hercules GitHub
Latest Release: Version 0.0.16
Demo Video: Check it out on YouTube If you have any questions, feedback, or ideas for improvement, we’d love to hear from you! Let’s work together to make the internet more welcoming for all. Happy Holidays and Happy Testing! Hey dev community! With the holidays right around the corner, it feels like the perfect time to talk about one of the best gifts we can give our users: an accessible web . Here at TestZeus, we’ve been hard at work adding Accessibility Testing to our open-source Hercules Agent —and I’m super excited to share the details with you! an accessible web Accessibility Testing Hercules Agent Why Accessibility Matters Accessibility is about making sure everyone can use your website or app, regardless of ability. That includes users who rely on screen readers, have motor difficulties, or experience color blindness, among many other scenarios. It’s not just a moral responsibility or a legal checkmark—it’s about crafting better user experiences for everyone. Meet Hercules If you haven’t heard of it yet, Hercules is our open-source testing agent that automates various aspects of software testing. By adding Accessibility Testing , we aim to reduce the friction developers often face when trying to meet WCAG (Web Content Accessibility Guidelines) . Some highlights: Hercules Accessibility Testing WCAG (Web Content Accessibility Guidelines) Covers WCAG 2.0, 2.1, and 2.2 Costs less than $1 per scan (so, super accessible for smaller teams too!) Open-source and easy to integrate into your CI/CD pipeline Covers WCAG 2.0, 2.1, and 2.2 Covers WCAG 2.0, 2.1, and 2.2 Costs less than $1 per scan (so, super accessible for smaller teams too!) Costs less than $1 per scan Open-source and easy to integrate into your CI/CD pipeline Open-source In other words, we’re focusing on practicality and affordability, so you don’t need a huge budget or specialized skillset to make your site more inclusive. Quick Setup Clone the Repo

Head over to our GitHub repo and clone it. Install Dependencies

A quick 'pip install testzeus-hercules' Write Your Test in Gherkin

Hercules uses Gherkin-like .feature files. It’s straightforward and keeps the logic clear. Run Hercules

A single command to scan for accessibility issues. Reports are automatically generated, so you can jump right into fixing any violations. Clone the Repo Head over to our GitHub repo and clone it. Clone the Repo Head over to our GitHub repo and clone it. Head over to our GitHub repo and clone it. GitHub repo GitHub repo Install Dependencies A quick 'pip install testzeus-hercules' Install Dependencies A quick 'pip install testzeus-hercules' A quick 'pip install testzeus-hercules' Write Your Test in Gherkin Hercules uses Gherkin-like .feature files. It’s straightforward and keeps the logic clear. Write Your Test in Gherkin Hercules uses Gherkin-like .feature files. It’s straightforward and keeps the logic clear. Hercules uses Gherkin-like .feature files. It’s straightforward and keeps the logic clear. .feature Run Hercules A single command to scan for accessibility issues. Reports are automatically generated, so you can jump right into fixing any violations. Run Hercules A single command to scan for accessibility issues. Reports are automatically generated, so you can jump right into fixing any violations. A single command to scan for accessibility issues. Reports are automatically generated, so you can jump right into fixing any violations. Sample Test Scenario We’ve included a snippet below to show how a typical .feature file might look, using the Zerodha brokerage calculator page as an example: .feature Feature: Check accessibility for brokerage calculator on Zerodha website
  # This feature tests the brokerage calculator, and contract notes on Zerodha website

  Scenario Outline: Check calculations on brokerage and SEBI charges
    Given the user is on "https://zerodha.com/brokerage-calculator#tab-equities"
    Then validate the page for accessibility.
    Then there should not be any issues. Feature: Check accessibility for brokerage calculator on Zerodha website
  # This feature tests the brokerage calculator, and contract notes on Zerodha website

  Scenario Outline: Check calculations on brokerage and SEBI charges
    Given the user is on "https://zerodha.com/brokerage-calculator#tab-equities"
    Then validate the page for accessibility.
    Then there should not be any issues. Here’s the breakdown: Feature: Provides context—testing Zerodha’s brokerage calculator. Scenario Outline: Explains the specific scenario. Steps:

Given: Navigate to a specific URL.
Then: Validate accessibility.
Then: Ensure zero issues remain (fingers crossed!). Feature : Provides context—testing Zerodha’s brokerage calculator. Feature Scenario Outline : Explains the specific scenario. Scenario Outline Steps : Given: Navigate to a specific URL.
Then: Validate accessibility.
Then: Ensure zero issues remain (fingers crossed!). Steps Given: Navigate to a specific URL. Then: Validate accessibility. Then: Ensure zero issues remain (fingers crossed!). Given : Navigate to a specific URL. Given Then : Validate accessibility. Then Then : Ensure zero issues remain (fingers crossed!). Then Hercules interprets this scenario, visits the page, scans it, and flags any WCAG non-compliances. Viewing Your Results Once your tests complete, Hercules shows you a report detailing any accessibility issues found: Issue Description: A quick summary of the violation. WCAG Reference: Which guideline is being broken. Severity: Ranges from minor to critical. Location: Points you to the exact DOM element or area in the UI. Issue Description : A quick summary of the violation. Issue Description WCAG Reference : Which guideline is being broken. WCAG Reference Severity : Ranges from minor to critical. Severity Location : Points you to the exact DOM element or area in the UI. Location This immediate feedback loop makes it easy for devs to fix issues before they reach production. Integrating with CI/CD Because Hercules is open-source and script-friendly, you can plug it into your CI pipeline. For example, in GitHub Actions, you can create a workflow that runs Hercules every time you push new code. That way, you’ll catch accessibility regressions early in the development process. Going Beyond Automated Checks While Hercules does a fantastic job with automated scans, keep in mind that accessibility is a multifaceted area. You might still want to: Test with screen readers like NVDA or VoiceOver. Check color contrasts in real-world scenarios. Solicit feedback from users with disabilities for real-life insights. Test with screen readers like NVDA or VoiceOver. Test with screen readers Check color contrasts in real-world scenarios. Check color contrasts Solicit feedback from users with disabilities for real-life insights. Solicit feedback from users with disabilities Automated testing is a huge help, but manual testing still plays a key role in thorough accessibility coverage. Wrapping Up This holiday season, consider giving the gift of an accessible experience to your users. With Hercules, you can weave accessibility checks right into your development cycle—reducing barriers and making the web a more inclusive place. Here are some helpful links: Repo: TestZeus Hercules GitHub Latest Release: Version 0.0.16 Demo Video: Check it out on YouTube Repo : TestZeus Hercules GitHub Repo TestZeus Hercules GitHub TestZeus Hercules GitHub Latest Release : Version 0.0.16 Latest Release Version 0.0.16 Version 0.0.16 Demo Video : Check it out on YouTube Demo Video Check it out on YouTube Check it out on YouTube If you have any questions, feedback, or ideas for improvement, we’d love to hear from you! Let’s work together to make the internet more welcoming for all. Happy Holidays and Happy Testing! Happy Holidays and Happy Testing!

This story contains new, firsthand information uncovered by the writer.

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

The writer is smart, but don't just like, take their word for it. #DoYourOwnResearch before making any investment decisions or decisions regarding your health or security. (Do not regard any of this content as professional investment advice, or health advice)

Making the Web More Inclusive: Accessibility Testing with open source testing agents

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

20 Hours of Work, $258 in Sales — The First Week of Shade

4 Quick and Easy Tips to Make Your WordPress Website ADA Compliant

4 ways CSS :has() can make your HTML forms even better

5 Resources to Measure Website Accessibility

6 Tips to Host a Successful Virtual Networking Event

63 Stories To Learn About Accessibility

20 Hours of Work, $258 in Sales — The First Week of Shade

4 Quick and Easy Tips to Make Your WordPress Website ADA Compliant

4 ways CSS :has() can make your HTML forms even better

5 Resources to Measure Website Accessibility

6 Tips to Host a Successful Virtual Networking Event

63 Stories To Learn About Accessibility

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps