Metadata-Version: 2.4
Name: naipes
Version: 0.1.0
Summary: Spanish card games on the command line. v0.1.0 ships brisca.
Project-URL: Homepage, https://github.com/naipes-com/naipes
Project-URL: Issues, https://github.com/naipes-com/naipes/issues
Project-URL: Specification, https://github.com/naipes-com/naipes/blob/main/spec/SPEC.md
Author: Manuel Harguindey
License-Expression: MIT
License-File: LICENSE
Keywords: brisca,cards,cli,game,spanish-cards
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Spanish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment :: Board Games
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# naipes

Juegos de cartas españolas en línea de comandos. La versión 0.1.0 incluye **brisca**. Futuras versiones añadirán tute, mus y más, bajo el mismo paquete.

## Instalación

```bash
pip install naipes
```

## Uso

```bash
naipes                       # ayuda
naipes list                  # lista juegos disponibles
naipes rules brisca          # reglas resumidas
naipes play brisca           # jugar contra la IA
naipes play brisca --seed 42 --ai-level easy
```

Comandos durante la partida: `1`, `2`, `3` para jugar una carta de tu mano; `q` para salir; `?` para ver ayuda.

## Determinismo

`naipes` usa un PRNG `xorshift64*` con valores idénticos en todas las implementaciones del proyecto (Python, JavaScript, Ruby, Rust, etc.). Misma semilla = misma partida exacta, en cualquier lenguaje.

```bash
naipes play brisca --seed 42 --ai-level normal
```

Esta partida produce exactamente el mismo resultado en cualquier port del proyecto. Esto permite reproducir bugs y compartir partidas memorables.

## Especificación

Las reglas exactas, el protocolo CLI y los vectores de prueba están en [`spec/SPEC.md`](https://github.com/naipes-com/naipes/blob/main/spec/SPEC.md). Todos los ports deben pasar el mismo conjunto de vectores.

## Licencia

MIT.
