Practicador de Obras de Teatro

Sistema para practicar líneas de personajes de obras teatrales a partir de documentos Word.

Descripción

El sistema procesa un documento Word (.docx) con el guion de una obra de teatro, extrae las escenas y diálogos, y proporciona un modo de práctica donde el usuario puede ensayar las líneas de un personaje específico.

Requisitos

• Python 3.7 o superior

Instalación

1. Clona o descarga el repositorio:

   cd practicador

2. Crea un entorno virtual (opcional pero recomendado):

   python -m venv .venv
   source .venv/bin/activate  # En Linux/Mac
   # o
   .venv\Scripts\activate  # En Windows

3. Instala las dependencias:

   pip install -r requirements.txt

Uso

1. Parsear un documento Word

Primero, procesa el documento .docx para extraer las escenas:

python practicador.py parse <archivo.docx>

Esto generará:

• Una carpeta con el nombre del documento (sin extensión)
• Un archivo .txt por cada escena
• Un archivo characters.txt con índice de personajes y escenas

2. Modo de práctica

Una vez procesado el documento, puedes iniciar la práctica:

python practicador.py practice [[PERSONAJE] [ESCENA]]

En caso de no escribir un personaje, el sistema muestra la lista completa de personajes para seleccionar. Si se elije un personaje pero no una escena, se muestran las escenas disponibles para ese personaje.

Durante la práctica, lee las líneas de otros personajes pulsando Enter cuando no te toque o escribiendo tu línea cuando sí. Si tu introducción es correcta continúas, en caso contrario, puedes reintentarlo.

La validación es flexible: ignora mayúsculas, espacios extras, acentos y permite variantes configuradas.

Formato del Documento Word

El documento debe seguir estas convenciones:

1. Marcadores de escena: Líneas que comienzan con "ESCENA" seguido de número y el nombre de la escena.

2. Diálogos: Formato Personaje: texto

3. Acotaciones: Entre paréntesis (se eliminan automáticamente)

Variantes de Palabras

Puedes configurar excepciones para ciertas palabras creando un archivo word_variants.json en la raíz del proyecto:

{
  "palabra1": ["variante1", "variante2"],
  "palabra2": ["variante"]
}