https://github.com/it-at-m/agile-test-automation-framework
The Agile Test Automation Framework (ATAF) is a test automation framework specifically developed for agile projects. It provides a simple and extensible way to create and manage automated tests with Cucumber in Jira.
https://github.com/it-at-m/agile-test-automation-framework
agile cucumber government java jira jira-integration jira-rest-api maven municipalities municipality municipals restassured restassured-framework selenium test-automation testing testing-tools
Last synced: about 3 hours ago
JSON representation
The Agile Test Automation Framework (ATAF) is a test automation framework specifically developed for agile projects. It provides a simple and extensible way to create and manage automated tests with Cucumber in Jira.
- Host: GitHub
- URL: https://github.com/it-at-m/agile-test-automation-framework
- Owner: it-at-m
- License: mit
- Created: 2026-01-07T10:53:40.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-06-30T06:34:52.000Z (9 days ago)
- Last Synced: 2026-06-30T08:22:17.028Z (9 days ago)
- Topics: agile, cucumber, government, java, jira, jira-integration, jira-rest-api, maven, municipalities, municipality, municipals, restassured, restassured-framework, selenium, test-automation, testing, testing-tools
- Language: Java
- Homepage: https://it-at-m.github.io/agile-test-automation-framework/
- Size: 663 KB
- Stars: 4
- Watchers: 0
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[![Made with love by it@M][made-with-love-shield]][itm-opensource]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![Java 21][java-shield]][java-url]
[![Cucumber][cucumber-shield]][cucumber-url]
[![TestNG][testng-shield]][testng-url]
[![JUnit 5][junit-shield]][junit-url]
---
# Agile Test Automation Framework (ATAF)
## Documentation
- Published developer handbook (GitHub Pages root): [https://it-at-m.github.io/agile-test-automation-framework/](https://it-at-m.github.io/agile-test-automation-framework/)
- Releases (used in place of an in-repo changelog): [github.com/it-at-m/agile-test-automation-framework/releases](https://github.com/it-at-m/agile-test-automation-framework/releases)
- Maven coordinates: `de.muenchen.ataf:{core,rest,web}` on Maven Central
## About ATAF
The **Agile Test Automation Framework (ATAF)** is a Java 21 framework for Cucumber-based BDD tests and traditional TestNG/JUnit test suites, with optional Jira/Xray integration. It is designed for agile projects: fast setup, maintainable test automation, and integration into modern development workflows. In addition to browser-based and API testing, it provides hooks for managing test executions in Jira and Xray.
The framework was developed in 2023–2024 to support the first iteration of the **ZMS / eAppointment** project of the Landeshauptstadt München and is today used in the `zmsautomation` test suite as well as other Munich projects. It was built primarily by colleagues from **digital@M** for use at **it@M**.
It provides:
- Support for both BDD testing with Cucumber and traditional test cases with TestNG and JUnit
- Seamless integration with popular testing libraries
- Easy-to-configure runners for TestNG and JUnit
- Integration with Jira and Xray using their existing REST APIs for test management
For prerequisites, installation, writing and running tests, property files, supported webdrivers, reporting, and the full project history see the [handbook](https://it-at-m.github.io/agile-test-automation-framework/).
## Contact
[Overview](https://opensource.muenchen.de/)
Munich contact: it@M – opensource@muenchen.de
ATAF was built primarily by colleagues from **digital@M** for use at **it@M**, the IT service provider of the Landeshauptstadt München.
---
## Über ATAF
Das **Agile Test Automation Framework (ATAF)** ist ein Java-21-Framework für Cucumber-basierte BDD-Tests und klassische TestNG/JUnit-Testsuites mit optionaler Jira-/Xray-Anbindung. Es wurde für agile Projekte entworfen: schnelle Einrichtung, wartbare Testautomatisierung und Integration in moderne Entwicklungs-Workflows. Neben Browser- und API-Tests bietet es Hooks für die Verwaltung von Testausführungen in Jira und Xray.
Das Framework wurde 2023–2024 entwickelt, um die erste Iteration des **ZMS-/eAppointment**-Projekts der Landeshauptstadt München zu unterstützen, und wird heute in der `zmsautomation`-Testsuite sowie weiteren Münchner Projekten eingesetzt. Es wurde überwiegend von Kolleg:innen aus **digital@M** für den Einsatz bei **it@M** entwickelt.
Es bietet:
- Unterstützung sowohl für BDD-Tests mit Cucumber als auch für klassische Testfälle mit TestNG und JUnit
- Nahtlose Integration in verbreitete Test-Bibliotheken
- Einfach konfigurierbare Runner für TestNG und JUnit
- Anbindung an Jira und Xray über deren REST-APIs für das Testmanagement
Voraussetzungen, Installation, Tests schreiben und ausführen, Property-Dateien, unterstützte Webdriver, Reporting und die vollständige Projektgeschichte stehen im [Handbuch](https://it-at-m.github.io/agile-test-automation-framework/de/).
## Kontakt
[Übersicht](https://opensource.muenchen.de/)
Münchner Kontakt: it@M – opensource@muenchen.de
ATAF wurde überwiegend von Kolleg:innen aus **digital@M** für den Einsatz bei **it@M**, dem IT-Dienstleister der Landeshauptstadt München, entwickelt.
## Dokumentation (Deutsch)
- Veröffentlichtes Entwicklerhandbuch (GitHub Pages, deutsche Version): [https://it-at-m.github.io/agile-test-automation-framework/de/](https://it-at-m.github.io/agile-test-automation-framework/de/)
- Releases (ersetzt einen Changelog im Repository): [github.com/it-at-m/agile-test-automation-framework/releases](https://github.com/it-at-m/agile-test-automation-framework/releases)
[contributors-shield]: https://img.shields.io/github/contributors/it-at-m/agile-test-automation-framework.svg?style=for-the-badge
[contributors-url]: https://github.com/it-at-m/agile-test-automation-framework/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/it-at-m/agile-test-automation-framework.svg?style=for-the-badge
[forks-url]: https://github.com/it-at-m/agile-test-automation-framework/network/members
[stars-shield]: https://img.shields.io/github/stars/it-at-m/agile-test-automation-framework.svg?style=for-the-badge
[stars-url]: https://github.com/it-at-m/agile-test-automation-framework/stargazers
[issues-shield]: https://img.shields.io/github/issues/it-at-m/agile-test-automation-framework.svg?style=for-the-badge
[issues-url]: https://github.com/it-at-m/agile-test-automation-framework/issues
[license-shield]: https://img.shields.io/github/license/it-at-m/agile-test-automation-framework.svg?style=for-the-badge
[license-url]: https://github.com/it-at-m/agile-test-automation-framework/blob/main/LICENSE
[made-with-love-shield]: https://img.shields.io/badge/made%20with%20%E2%9D%A4%20by-it%40M-yellow?style=for-the-badge
[itm-opensource]: https://opensource.muenchen.de/
[java-shield]: https://img.shields.io/badge/Java-21-orange?style=for-the-badge
[java-url]: https://www.oracle.com/java/
[cucumber-shield]: https://img.shields.io/badge/Cucumber-BDD-brightgreen?style=for-the-badge
[cucumber-url]: https://cucumber.io/
[testng-shield]: https://img.shields.io/badge/TestNG-supported-red?style=for-the-badge
[testng-url]: https://testng.org/
[junit-shield]: https://img.shields.io/badge/JUnit-5-blue?style=for-the-badge
[junit-url]: https://junit.org/junit5/