datengaertnerei / test-data-service

Test data service to create random persons with valid address, phone number, bank account, credit card and avatar image for software tests

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

test data service

Website Monitor codecov Quality Gate Status Maven Build CII Best Practices License Badge

A Spring Boot REST service to generate test data for german persons incl. address, phone, mobile and current account IBAN to provide GDPR compliant test data. It is adaptable to other countries based on OpenStreetMap and other public data sources.

Another test data generator? Really?

At first I needed valid postal addresses within Germany. I did not find anything usable to meet that requirement. So I chose Open Street Map as a source of valid postal addresses. And as you usually do not want to include a dozen different generators in your test, I kept adding things I needed in my projects.

We are just using a copy of our production database

You should meet a german data protection official. And most of the time this contains either too much data and/or not the data you need for your test.

How to use it

The easy way to setup the test data service is to use Docker. Just run the latest docker image

docker run --name test-data -p 80:8080 datengaertner/test-data-service

After startup you can navigate to http://localhost/ in your browser. It will show a random generated person. There is a link on that page to the included Swagger UI.

For more details please proceed to the docs or the project pages with CI/CD info. If you encounter any problems or identify an error please submit an issue in GitHub.

Disclaimer

DO NOT USE generated data, especially IBAN or credit card number, anywhere else than in your confined test environment. Someone might prosecute you for fraud.

About

Test data service to create random persons with valid address, phone number, bank account, credit card and avatar image for software tests

License:MIT License


Languages

Language:Java 86.9%Language:Python 5.1%Language:JavaScript 4.4%Language:HTML 2.0%Language:Dockerfile 0.7%Language:CSS 0.7%Language:Gherkin 0.4%