README.md

Literalura

Descrição • Funcionalidades • Tecnologias • Como Executar o Projeto • Screenshots • Contribuição • Contato

Descrição do Projeto

Literalura consiste em uma aplicação para a construção de um catálogo de livros utilizando Java, Spring, PostgreSQL e a API Gutendex, que possui dados de mais de 70 mil livros.

A interação é feita inteiramente via linha de comando. Esta aplicação permite buscar seus livros favoritos na API Gutendex e registrar os dados obtidos, incluindo dados referentes aos autores, no banco de dados da Literalura. Além disso, é possível listar todos os livros e autores registrados, bem como filtrar os livros por idioma e listar apenas os autores vivos em um determinado ano.

Voltar ao topo

Funcionalidades

1. Buscar livro pelo título: Consulta a API Gutendex para buscar livros pelo título em inglês.
2. Listar livros registrados: Exibe todos os livros registrados no banco de dados.
3. Listar autores registrados: Exibe todos os autores registrados no banco de dados.
4. Listar autores vivos em um determinado ano: Lista os autores vivos em um ano especificado pelo usuário.
5. Listar livros em um determinado idioma: Lista livros registrados no banco de dados em um idioma especificado via código do idioma (Se for informado o código "en", serão listados os livros em inglês registrados no banco de dados).

Voltar ao topo

Tecnologias Utilizadas

• Java 21
• Spring Boot
• Hibernate
• PostgreSQL
• Gutendex API
• Maven

Voltar ao topo

Como executar o projeto

1. Clone o repositório para a sua máquina local.

   git clone https://github.com/KarlaSilvaDev/literalura.git

2. Entre no diretório do projeto

   cd literalura

3. Configure o banco de dados no arquivo application.properties ou cria variáveis de ambiente na sua máquina:

   spring.datasource.url=jdbc:postgresql://localhost:5432/literalura
   spring.datasource.username=seu-usuario
   spring.datasource.password=sua-senha
   spring.jpa.hibernate.ddl-auto=update
   spring.jpa.show-sql=true

4. Execute a aplicação.

   mvn spring-boot:run

Voltar ao topo

Screenshots

Menu da aplicação:

Opção 1: Buscar livro pelo título:

Opção 2: Listar livros registrados

Opção 3: Listar autores registrados

Opção 4: Listar autores vivos em um determinado ano

Opção 5: Listar livros em um determinado idioma

Voltar ao topo

Contribuição

Se deseja contribuir para o projeto, siga os passos abaixo:

1. Faça um fork deste repositório

2. Crie uma branch para sua feature:

    git checkout -b feature/nova-feature

3. Faça commit das suas alterações:

   git commit -m "Adiciona nova feature"

4. Envie as alterações para o seu fork:

   git push origin feature/nova-feature

5. Abra um pull request neste repositório

Voltar ao topo

Contato

Caso tenha alguma dúvida ou sugestão, entre em contato pelo email karlasilvaeng@gmail.com.