HTML, JavaScript e Python FastAPI

Exemplo de integração entre Frontend (HTML/JavaScript) e Backend (Python FastAPI).

📋 Descrição

Projeto demonstrando comunicação entre uma aplicação web (HTML/JS) e uma API REST desenvolvida com FastAPI em Python. O servidor FastAPI serve tanto a interface web quanto os arquivos estáticos (CSS/JS) e disponibiliza endpoints de API.

🚀 Início Rápido

Pré-requisitos

• Python 3.8+
• pip

Instalação

1. Clone o repositório

git clone <seu-repositorio>
cd html-js-python/src

2. Crie o ambiente virtual

python -m venv .venv

3. Ative o ambiente virtual

# Windows
.venv\Scripts\activate

# Linux/Mac
source .venv/bin/activate

4. Instale as dependências

pip install -r requirements.txt

5. Inicie o servidor

uvicorn main:app --reload

6. Abra no navegador

http://localhost:8000

📁 Estrutura do Projeto

src/
├── main.py                 # API FastAPI e servidor web
├── index.html              # Interface web principal
├── requirements.txt        # Dependências Python
└── assets/                 # Arquivos estáticos
    ├── css/
    │   └── default.css     # Estilos CSS
    └── js/
        └── default.js      # Lógica JavaScript

🔧 Funcionalidades

• Servidor Web Integrado: FastAPI serve o index.html na rota raiz (/)
• Arquivos Estáticos: CSS e JS servidos através de /assets/*
• API REST: Endpoints JSON para comunicação com o frontend
• CORS Habilitado: Permite desenvolvimento com diferentes portas/domínios
• Hot Reload: Servidor reinicia automaticamente ao detectar mudanças no código

📡 Endpoints da API

• GET / - Retorna a interface web (index.html)
• GET /hello-world - Endpoint de exemplo que retorna {"message": "Hello World!"}
• GET /assets/* - Serve arquivos estáticos (CSS, JS, imagens, etc.)

🎨 Personalização

Para adicionar novos arquivos CSS ou JavaScript:

1. Crie os arquivos em src/assets/css/ ou src/assets/js/
2. Referencie no index.html:

<link rel="stylesheet" href="/assets/css/seu-arquivo.css">
<script src="/assets/js/seu-arquivo.js"></script>

📝 Licença

MIT