Explore Unit Test Universe

Explore Unit Test Universe is a Spring Boot project that introduces developers to container technologies while teaching essential unit testing practices. This project features a fully functional Spring Boot application, providing a practical example for writing and executing unit tests with JUnit, using Testcontainers, Docker Compose, and Datafaker to enhance the testing experience.

Table of Contents

• Features
• Technologies
• Installation
• Usage
• Running Tests
• Contributing
• License

Features

• Fully functional Spring Boot application
• Comprehensive unit tests using JUnit
• Integration with Testcontainers for container-based testing
• Docker Compose support for easy environment setup
• Datafaker for generating realistic test data

Technologies

• Spring Boot
• JUnit
• Testcontainers
• Docker
• Docker Compose
• Datafaker
• Swagger

Installation

1. Clone the repository:

   git clone https://github.com/ermix3/explore-unit-test-universe.git
   cd explore-unit-test-universe

2. Build the project:

3. mvn clean install

4. Run the application:

    mvn spring-boot:run

5. Access the application at swagger-ui:

   http://localhost:8080/api/v1/swagger-ui.html

Usage

The application provides a RESTful API for managing users. You can use the Swagger UI to interact with the API and perform CRUD operations on users.

Running Tests

To run the unit tests, execute the following command:

mvn test

Contributing

Contributions are welcome! Please refer to the contributing guidelines for detailed information.