https://shaftengine.netlify.app/blog SHAFT User Guide Blog 2026-03-31T00:00:00.000Z https://github.com/jpmonette/feed SHAFT User Guide Blog https://shaftengine.netlify.app/img/shaft.ico <![CDATA[๐Ÿš€ SHAFT 10.1.20260331: What's New and Why You Should Upgrade Today]]> https://shaftengine.netlify.app/blog/release-10.1.20260331 2026-03-31T00:00:00.000Z Hey there, SHAFT community! ๐Ÿ‘‹

A fresh release just dropped and it's packed with improvements you don't want to miss. SHAFT_ENGINE 10.1.20260331 is here, and whether you're a seasoned SHAFT user or just getting started, there's something in this release for you.

โšก What Changed?โ€‹

๐Ÿ‘‰ View the full release on GitHub

๐Ÿ“‹ Changelogโ€‹

What's Changedโ€‹

New Contributorsโ€‹

Full Changelog: https://github.com/ShaftHQ/SHAFT_ENGINE/compare/10.1.20260324...10.1.20260331

๐Ÿ† Community Spotlightโ€‹

This release was made possible by 45 amazing contributors who have poured their time and expertise into making SHAFT better for everyone. Among them, 1 contributed for the very first time!

Open source thrives because of people like these. Every bug fix, every feature, every review โ€” it all counts.

๐ŸŽ‰ A warm welcome to our first-time contributors! @Mochxd โ€” your first contribution is now part of SHAFT's story. We're thrilled to have you on board!

๐Ÿš€ Get Started in Secondsโ€‹

Upgrading is simple โ€” just update your dependency version:

<dependency>
    <groupId>io.github.shafthq</groupId>
    <artifactId>SHAFT_ENGINE</artifactId>
    <version>10.1.20260331</version>
</dependency>

๐Ÿ’ฌ Join the Conversationโ€‹

We'd love to hear what you think! Found a bug? Have an idea? Just want to say hi?

Thanks for being part of the SHAFT journey. Until the next release โ€” happy testing! ๐ŸŽฏ

]]> AutoBot https://github.com/ShaftHQ/SHAFT_ENGINE <![CDATA[๐Ÿš€ SHAFT 10.1.20260324: What's New and Why You Should Upgrade Today]]> https://shaftengine.netlify.app/blog/release-10.1.20260324 2026-03-24T00:00:00.000Z Hey there, SHAFT community! ๐Ÿ‘‹

A fresh release just dropped and it's packed with improvements you don't want to miss. SHAFT_ENGINE 10.1.20260324 is here, and whether you're a seasoned SHAFT user or just getting started, there's something in this release for you.

โšก What Changed?โ€‹

  • Bump jackson-datatype-jdk8 from 2.21.1 to 2.21.2
  • Fix relative path resolution failing on Linux CI
  • Bump browserstack-java-sdk from 1.55.0 to 1.56.0

๐Ÿ‘‰ View the full release on GitHub

๐Ÿ“‹ Changelogโ€‹

What's Changedโ€‹

Full Changelog: https://github.com/ShaftHQ/SHAFT_ENGINE/compare/10.1.20260319...10.1.20260324

๐Ÿ† Community Spotlightโ€‹

This release was made possible by 42 amazing contributors who have poured their time and expertise into making SHAFT better for everyone.

Open source thrives because of people like these. Every bug fix, every feature, every review โ€” it all counts.

๐Ÿš€ Get Started in Secondsโ€‹

Upgrading is simple โ€” just update your dependency version:

<dependency>
    <groupId>io.github.shafthq</groupId>
    <artifactId>SHAFT_ENGINE</artifactId>
    <version>10.1.20260324</version>
</dependency>

๐Ÿ’ฌ Join the Conversationโ€‹

We'd love to hear what you think! Found a bug? Have an idea? Just want to say hi?

Thanks for being part of the SHAFT journey. Until the next release โ€” happy testing! ๐ŸŽฏ

]]> AutoBot https://github.com/ShaftHQ/SHAFT_ENGINE <![CDATA[New Feature Announcement - Swagger Contract Validation]]> https://shaftengine.netlify.app/blog/swagger-contract-validation 2025-03-27T00:00:00.000Z SHAFT_Engine

Say goodbye to manual schema checksโ€”contract testing is now automated and built right into SHAFT!โ€‹

๐Ÿ›ก๏ธ What is Contract Validation?โ€‹

Contract testing ensures your API requests and responses follow the defined structure (contract), helping prevent:

  • Unexpected field changes
  • Data type mismatches
  • Missing or extra fields
  • Runtime errors in API consumers

With the latest release, SHAFT now integrates Swagger/OpenAPI schema validation for all API tests. It will fail your test automatically if the request or response doesnโ€™t match the OpenAPI spec you provide. ๐Ÿ”ฅ

๐Ÿ”ง How to Enable Itโ€‹

๐Ÿ“‚ Via custom.propertiesโ€‹

src/main/resources/properties/custom.properties
swagger.validation.enabled=true
swagger.validation.url=https://petstore.swagger.io/v2/swagger.json

๐Ÿงช Or via Codeโ€‹

SHAFT.Properties.api.set().swaggerValidationEnabled(true);
SHAFT.Properties.api.set().swaggerValidationUrl("https://petstore.swagger.io/v2/swagger.json");

You can toggle validation dynamically per test or test class.

โœ… What Gets Validated?โ€‹

  • Request structure (body, headers, parameters)
  • Response structure (status, body schema)
  • Alignment with your OpenAPI/Swagger definition

๐Ÿ“„ Sample Testโ€‹

@Test
public void testCreateUserWithContractValidation() {
    SHAFT.API api = new SHAFT.API("https://petstore.swagger.io/v2");

    String invalidPayload = "[{\"id\":\"INVALID_ID\"}]";

    api.post("/user/createWithList")
       .setRequestBody(invalidPayload)
       .setContentType("application/json")
       .perform();

    api.assertThatResponse().statusCode().isEqualTo(400).perform();
}

SHAFT will automatically validate the above request and response against the Swagger schema. โŒ If anything is off, your test will fail and report the contract violation.

๐Ÿง Why It Mattersโ€‹

BenefitDescription
๐Ÿงช Test reliabilityEnsure tests align with backend changes
๐Ÿ” Catch regressionsCI/CD-ready contract enforcement
โŒ Reduce flakinessEliminate schema mismatch failures
๐Ÿ” API governanceHold your APIs to their contract
]]> Kyrillos Nageh https://github.com/KyrillosNageh <![CDATA[New Feature Announcement - Virtual Threads]]> https://shaftengine.netlify.app/blog/virtual-threads 2024-01-27T00:00:00.000Z We're starting off 2024 with a huge announcement!

SHAFT_Engine

๐Ÿค

Oracle

- The future of automation frameworks is here, and it's all about working smarter, not harder.โ€‹

- SHAFT_ENGINE, your trusty automation solution, just got a major upgrade with virtual threads, a clever trick that makes it more efficient and helpful than ever.โ€‹

- What is a Virtual Thread?โ€‹

  • Virtual-Threads, introduced with Java 21 are a new way to handle multiple tasks concurrently within a single program or application. They're the new java way for asynchronous operations.
  • Think of it like hiring a whole crew of tiny helpers. While one tractor's plowing, another can check the soil, and another can keep an eye on the weather.
  • These lightweight assistants don't need fancy equipment or guzzle up resources, meaning SHAFT_ENGINE can now handle a ton more tasks without breaking a sweat.

Now let's think of test automation. In automating a registration form, envision employing a crew of virtual threads as tiny helpers :โ€‹

  • Rather than idly waiting for the entire site to load, each virtual thread can be assigned specific tasks as soon as the relevant elements become available. For instance, one thread focuses on inputting the username, another simultaneously handles the email input, and yet another sets the password. This parallel execution optimizes efficiency, ensures prompt responsiveness to dynamically changing elements, and efficiently utilizes resources.
  • As the crew of virtual threads collaborates seamlessly, the registration form is filled and submitted swiftly, providing a more agile and responsive automation process compared to traditional sequential approaches.

- Save your execution Time :โ€‹

  • That's not all, SHAFT_ENGINE utilities the Virtual Threads for Engine launch and configuration which will make your overall experience a lot faster and swifter.
]]> Mustafa Agamy https://github.com/MustafaAgamy <![CDATA[Bing AI framework comparison]]> https://shaftengine.netlify.app/blog/bingAI 2023-04-27T00:00:00.000Z We asked Bing AI to compare SHAFT against some of the well known test automation options, here's what it had to say:

Sure! Here is an expanded comparison between SHAFT_Engine, native Selenium WebDriver, Cypress and Microsoft Playwright in a tabular format:

FeatureSHAFT_EngineSelenium WebDriverCypressMicrosoft Playwright
Web GUI testingYesYesYesYes
Mobile testingYesNo (Appium required)NoNo
API testingYesNoYesNo
CLI testingYesNoNoNo
Database testingYesNoNoNo
Built-in test synchronizationYesNoYesYes
Built-in logging and reportingYesNoYesYes
Integration with third-party tools (e.g. Jira, Xray, Browserstack)YesNoLimitedLimited
Unlimited access to underlying frameworks (e.g. Selenium, Appium, RestAssured)YesN/AN/AN/A
Cross-browser testing supportYes (via Selenium)YesLimited (Chrome, Firefox, Edge)Yes (Chromium, Webkit, Firefox)
Parallel test execution supportYes (via TestNG)Yes (via TestNG or JUnit)YesYes
Language supportJava onlyMultiple languages (Java, Python, C#, Ruby, JavaScript)JavaScript onlyMultiple languages (JavaScript, Java, Python, .NET C#)
Open-sourceYesYesYesYes
Community support and resourcesLimited compared to Selenium WebDriver and CypressExtensiveExtensiveGrowing
User guideAvailableAvailableAvailableAvailable

What do you think? Is SHAFT the better option?

]]> Mohab Mohie https://github.com/MohabMohie <![CDATA[New release announcement (7.1.20230309)]]> https://shaftengine.netlify.app/blog/release_announcement_7.1.20230309 2023-03-10T00:00:00.000Z Release highlights:โ€‹

Technical Details:โ€‹

  • SHAFT has always boasted top-notch reliability, but this sometimes comes at the cost of performance. In this release we made a major change to the way we handle "Type" which is one of the most commonly used and also one of the slowest actions.
  • Previously SHAFT would perform the following Selenium WebDriver calls:
    • Get Element Accessible Name (for reporting)
    • Get Current Element Text (to learn how this element stores its text and to learn the initial text if any)
    • Get Current Element textContent (to learn how this element stores its text and to learn the initial text if any)
    • Get Current Element Value (to learn how this element stores its text and to learn the initial text if any)
    • Clear (in case the element text wasn't empty)
    • Send Keys (to do the actual typing)
    • Get text using the successful text identification strategy (to validate that the text was typed correctly. if SHAFT ws able to find out which method out of the above three to use it will use it, else it will do all three calls again)
  • And inside each call, SHAFT would go into a fluent wait where it calls:
    • findElement
    • findElements
  • This means that SHAFT did 21+ webdriver calls!
  • Starting this version SHAFT will cut that number down to just 3 webdriver calls while maintaining the full functionality.
  • Using jsoup SHAFT will capture the entire HTML of the target webelement, and will then be able to uery it for the text/textContent/Value as need to clear and validate successfully typing.
  • SHAFT will also grab all element information (including the WebElement object) once, and will use the WebElement object directly (which is much faster than finding the element again each time) but if the engine faces a WebDriverException (like StaleElementException) the engine will go into a fluent wait to find and update the element reference.
  • We tested this major change thoroughly by running around 1700 E2E Test scenarios across different platforms, so we're confident it's stable.
  • In following releases we will rollout this approach to all our element actions, and next on the list we have "Click()" which is the second most used action per our analysis.
]]> Mohab Mohie https://github.com/MohabMohie <![CDATA[Dear SHAFT users, we need your support!]]> https://shaftengine.netlify.app/blog/we-need-your-support 2023-02-28T00:00:00.000Z SHAFT is undergoing some major changes in its steering committee and we want to ensure that we align our strategies to what you guys really need!

SHAFT_Engine has always been (and will continue to be) a community driven project, made by Testers for Testers, and our mission was always to add value, remove redundancy, and help Software Engineers in Test focus on the exciting and non-repetitive parts of their work. For that we need your support to pinpoint and prioritize the features that you're using, and the features that you'd like to see in the near future.

Join us, become an honorary member of the new SHAFT_Engine Technical Leadership Committee by filling out this short survey, and watch your name shine as an honorary member on the dedicated page that we'll create on our official user guide!

Join us now!โ€‹

]]> Mohab Mohie https://github.com/MohabMohie <![CDATA[New Feature Announcement - Self-managed Appium Execution]]> https://shaftengine.netlify.app/blog/self-managed-appium-execution 2023-02-12T00:00:00.000Z A new Major feature approaches!

Selenium WebDriver ๐Ÿค Appium

What is self-managed appium execution?โ€‹

  • One of the common challenges for mobile application test automation is achieving and maintaining a proper testing environment.
  • A Testing environment consists of several elements; Android SDK CLI tools, Android System Image, Android Emulator, Support for Hardware acceleration, NPM, Appium 2.x server, drivers and plugins.
  • SHAFT will now download, and setup your testing environment.
  • SHAFT will also maintain everything in your environment to ensure that it's all up-to-date.
  • SHAFT will then initialize the Emulator, initialize the Appium server, and synchronize everything before starting test execution.

Watch the demo and explore the code โฎŠโ€‹

]]> Mohab Mohie https://github.com/MohabMohie <![CDATA[Selenium Ecosystem]]> https://shaftengine.netlify.app/blog/selenium-ecosystem 2023-01-24T00:00:00.000Z We're starting off 2023 with a huge announcement!

SHAFT_Engine ๐Ÿค Selenium WebDriver

What is the Selenium Ecosystem?โ€‹

  • Over the last decade, a large ecosystem of Open Source projects have sprouted up around Selenium.
  • The Selenium Ecosystem attempts to capture some of those projects that make use of Selenium WebDriver as a central part of what they do.
  • It consists of a number of drivers, bindings, plugins, and frameworks created and maintained by third parties.

What are some other members of the Selenium Ecosystem?โ€‹

Why use a framework that's part of the Selenium Ecosystem?โ€‹

  • These projects are developed, and maintained by third parties who dedicate their time and efforts to complement the solid infrastructure provided by Selenium WebDriver; the undisputed market leader for test automation since its inception.
  • They are very mature with many contributors and many users.
  • They are powered by Selenium WebDriver, which guarantees the widest and most mature user-base versus other competitors.

Why use SHAFT_Engine?โ€‹

  • In its seventh year of development now and has accumulated 20 more contributors over the years.
  • One of the largest open source projects in the MEA region.
  • Has several tens of thousands downloads, and is being used by 18+ organizations (that we know of) to drive their automation efforts.
  • Powered by Selenium, Appium, RestAssured, and other best-in-class automation frameworks, SHAFT supports Web/Mobile/API/CLI/DB/Desktop test automation.
  • Offers excellent business-centric reporting with automated evidences (screenshots, videos, attachments) and logs.
  • Out-of-the-box simple test data management with secure encryption support.
  • Supports Local, remote, unattended, sequential, parallel, and containerized test execution.
  • Built-in test synchronization and error handling.
  • Built-in third party integrations with Jira, Xray, BrowserStack, and Applitools Eyes.
  • AI-powered Element Identification, visual checkpoints, and self-healing tests.
  • Element Locator Builder with full support for Selenium 4 Relative Locators.
  • Fluent actions and validations library.
  • And the list goes on...

What does being a member of the Selenium Ecosystem mean for SHAFT_Engine?โ€‹

  • It means that SHAFT_Engine is now one of 13 high-level frameworks that are built on top of Selenium WebDriver and have officially joined the ecosystem.
  • It will gain more visibility and more community support.
  • And our core maintainers will continue to remain close to the Selenium Technical Leadership committee, ensuring that SHAFT remains ahead of the curve and always aligned to the latest Selenium WebDriver has to offer.

In summary, we thank you for your support over the past 6 years, and we promise to continue to offer you a fully-featured best-in-class reliabie, consistent, secure, and fast Test Automation Solution.

]]> Mohab Mohie https://github.com/MohabMohie <![CDATA[Welcome]]> https://shaftengine.netlify.app/blog/welcome 2023-01-21T00:00:00.000Z SHAFT Engine

Why start a blog?โ€‹

SHAFT_Engine has been long running for over 7 years with thousands of users across hundreds of projects.

Our intention is to start using Blog Posts like this one, to communicate for new releases, announcements and other important updates!

So Stay Tuned ๐Ÿ˜‰

]]> Mohab Mohie https://github.com/MohabMohie