Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yracnet/uagrm-m4-junit-course
JUnit Tutorial
https://github.com/yracnet/uagrm-m4-junit-course
Last synced: 5 days ago
JSON representation
JUnit Tutorial
- Host: GitHub
- URL: https://github.com/yracnet/uagrm-m4-junit-course
- Owner: yracnet
- License: mit
- Created: 2023-09-13T12:31:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-09-18T05:49:52.000Z (about 1 year ago)
- Last Synced: 2024-04-24T12:28:08.715Z (7 months ago)
- Language: Java
- Size: 153 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Módulo : Pruebas de Software
## Grupo 2
## Integrantes
- Alejandra Murillo
- Willyams Yujra
## Tutorial de JUnit
URL del proyecto: [https://github.com/yracnet/uagrm-m4-junit-course](https://github.com/yracnet/uagrm-m4-junit-course)
## Requisitos
Este proyecto requiere la configuración del siguiente entorno en Linux o Windows:
- **NetBeans 16** o superior
- **JDK 11** o superior
- **Maven 3.8.X** o superior
- **GIT 2.39.x** o superior
## Ramas
El proyecto tiene las siguientes ramas:
- **main**: Rama principal
- **p1-init**: Rama inicial, donde se encuentra el proyecto sin pruebas unitarias
- **p2-test**: Rama de pruebas, donde se encuentra el proyecto con pruebas unitarias
## Instalación
Ejecute el siguiente comando para construir el proyecto:
```bash
mvn clean install
```
> **NOTA**
> Este comando instalará las dependencias necesarias del proyecto. Se requiere una conexión a Internet.
## Proyecto Biblioteca
### Objetivo
Este proyecto es una implementación de una biblioteca para la venta de libros nuevos y antiguos. Incluye:
- Un catálogo de libros segun ISBN.
- Precios del libro según la edición y el formato.
- Ventas de libros con promociones (descuentos) aplicados a ejemplares de libros en un rango de fechas.
### Descripción
El proyecto incluye los archivos **libro-store.json**, **libro-precio-store.json** y **libro-promocion-store.json**, que almacenan la información de libros, precios y promociones.
### Diseño
#### Tabla de Libros (**libro-store.json**)
| ISBN | Título | Autor | Descripción |
| ---- | ---------------- | ------------------------ | ------------------------------------------------------------- |
| 1000 | El Principito | Antoine de Saint-Exupéry | Viaje del Principito por asteroides. Lecciones sobre la vida. |
| 1001 | Hábitos Atómicos | Antoine de Saint-Exupéry | Aprenda a desarrollar buenos hábitos y eliminar malos. |
#### Tabla de Precios (**libro-precio-store.json**)
| ISBN | Edición | Formato | Precio Unitario | Moneda |
| ---- | ------- | ----------- | --------------- | ------ |
| 1000 | 2019 | TAPA_DURA | 350.0 | USD |
| 1000 | 2005 | TAPA_DURA | 330.0 | USD |
| 1000 | 2010 | TAPA_BLANDA | 200.0 | USD |
| 1000 | 2010 | TAPA_DURA | 350.0 | USD |
| 1001 | 2023 | TAPA_DURA | 550.0 | USD |
| 1001 | 2005 | TAPA_BLANDA | 330.0 | USD |
| 1001 | 1989 | TAPA_BLANDA | 300.0 | BOB |
| 1001 | 2001 | TAPA_DURA | 300.0 | BOB |
| 1001 | 2001 | TAPA_BLANDA | 300.0 | BOB |
#### Tabla de Promociones (**libro-promocion-store.json**)
| id | tipo | isbn | edicion | formato | fechaDesde | fechaHasta | descuento (%) |
| --- | ------- | ---- | ------- | ----------- | ---------- | ---------- | ------------- |
| 1 | NUEVO | 1000 | 2019 | TAPA_DURA | 2023-01-17 | 2023-06-17 | 0.01 |
| 2 | ANTIGUO | 1000 | 2005 | TAPA_DURA | 2023-06-18 | 2023-12-31 | 0.10 |
| 3 | NUEVO | 1000 | 2010 | TAPA_BLANDA | 2023-01-01 | 2023-03-30 | 0.01 |
| 4 | NUEVO | 1000 | 2010 | TAPA_DURA | 2023-01-01 | 2023-12-30 | 0.5 |
| 5 | ANTIGUO | 1000 | 2019 | TAPA_DURA | 2023-06-17 | 2023-12-31 | 0.10 |
| 6 | ANTIGUO | 1001 | 2003 | TAPA_DURA | 2023-01-01 | 2023-12-31 | 0.25 |
| 7 | NUEVO | 1001 | 2022 | TAPA_BLANDA | 2023-01-01 | 2023-12-31 | 0.15 |
| 8 | ANTIGUO | 1001 | 1989 | TAPA_BLANDA | 2023-06-05 | 2023-12-15 | 0.30 |
| 9 | NUEVO | 1001 | 1989 | TAPA_BLANDA | 2023-06-05 | 2023-12-15 | 0.05 |
| 10 | ANTIGUO | 1001 | 2001 | TAPA_DURA | 2023-06-05 | 2023-12-15 | 0.10 |
| 11 | ANTIGUO | 1001 | 2001 | TAPA_BLANDA | 2023-06-05 | 2023-12-15 | 0.15 |
### Metodo Principal: Calcular Descuento
El proyecto incluye una clase llamada `CarritoVentaManager`, que permite calcular descuentos (**calcularDecuento**) en un libro según el **ISBN**, **EDICIÓN**, **FORMATO** y **TIPO**. Realiza lo siguiente:
- Busca el libro por el ISBN.
- Busca el precio por el ISBN, EDICIÓN y FORMATO.
- Busca el descuento por la ISBN, EDICIÓN, FORMATO, TIPO y FECHA de venta.
- Retorna el **Valor de Descuento** del libro.
## Pruebas Unitarias
Las pruebas unitarias se aplicarán al método **calcularDescuento** para verificar que devuelva el precio de un libro con el descuento válido en los siguientes casos:
- Cuando sea un **Libro Nuevo** (cuando el descuento sea por libro nuevo).
- Cuando sea un **Libro Antiguo** (cuando el descuento sea por una edición antigua).
- Cuando sea por un **Precio Diferente** (cuando el libro tenga un formato diferente).
**Ejemplos**:
- Desde el 01 de septiembre de 2023 hasta el 30 de septiembre de 2023, hay un descuento del 5% en un libro por el mes aniversario de la biblioteca.
- Desde el 01 de enero de 2023 hasta el 29 de febrero de 2024, hay un descuento del 2% en un libro debido a la edición 2023 (Libro nuevo).
- A partir del 01 de marzo de 2024, hay un descuento del 10% en un libro debido a la edición 2023 (Libro antiguo, ya que salió la edición 2024).
### Pseudo-Codigo de las Pruebas
```java
// Pseudo-Codigo para un Libro Nuevo
BEGIN testCalcularDescuentoLibroNuevo
// Crear instancia de la clase CarritoVentaManager
var instancia = new CarritoVentaManager();
// definir fecha de Venta para la venta de libros
instancia.setFechaVenta("2023-02-07");
//definimos los valores a utilizar en la prueba
var edicion = 2019;
var formato = "TAPA_DURA";
var isbn = "1000";
var tipoPromo = "NUEVO";
//definimos el valor esperado
var expResult = 346.50;
//invocamos al metodo calcularDescuento
var respValorDescuento = instancia.calcularDescuento(isbn, edicion, formato, tipo);
//obtenemos el valor total a pagar (valor obtenido)
var result = respValorDescuento.getTotal();
//evaluamos la igualdad entre el valor obtenido contra el valor esperado
verificarIgualdad(expResult, result);
//imprimimos los valores para visualizar
print("Valor esperado = ", expResult);
print("valor obtenido = ", result);
END
```
### Configuraciones
#### Dependencias
Añade las siguientes dependencias a tu proyecto en el archivo `pom.xml`:
```xml
org.junit.jupiter
junit-jupiter-api
5.6.0
test
org.junit.jupiter
junit-jupiter-params
5.6.0
test
org.junit.jupiter
junit-jupiter-engine
5.6.0
test
```
> **NOTA**: Estas dependencias pertenecen a JUnit 5.
#### Plugins
Añade los siguientes plugins a tu proyecto en el archivo `pom.xml`:
```xml
org.apache.maven.plugins
maven-surefire-plugin
3.0.0
com.hiskasoft.maven
hiska-maven-plugin
1.0.3
process-resources
process
false
false
false
```
> **NOTA**:
>
> - `maven-surefire-plugin`: Ejecuta y genera las pruebas unitarias.
> - `hiska-maven-plugin`: Formatea, agrega licencia y analiza el código del proyecto.
### Ejecución
Para ejecutar las pruebas unitarias, utiliza el siguiente comando:
```bash
mvn clean test
```
> **NOTA**: Este comando ejecuta las pruebas unitarias en todo el proyecto.
Para generar un informe de pruebas unitarias en formato HTML, ejecuta el siguiente comando:
```bash
mvn surefire-report:report
```
> **NOTA**: Este comando genera un informe de pruebas unitarias en formato HTML.
### Screenshots
## Definiciones
- **ISBN**: Número de identificación internacional asignado a los libros.
- **EDICIÓN**: Una publicación periódica/anual del libro original, con cambios y actualizaciones.
- **FORMATO**: Presentación del libro, considerando solo los formatos TAPA DURA y TAPA BLANDA.
- **TIPO**: Tipo de Promocion, libro NUEVO o libro ANTIGUO.
- **PROMOCIONES**: Descuentos válidos entre fechas para un determinado libro.