An open API service indexing awesome lists of open source software.

https://github.com/pknull/rpg-card

Card randomizer for rpg systems
https://github.com/pknull/rpg-card

Last synced: 5 months ago
JSON representation

Card randomizer for rpg systems

Awesome Lists containing this project

README

          

# RPG Card

A small library for creating and dealing cards for various RPG systems.

> This project is partially managed by [Asha](https://github.com/pknull/asha), a Claude Code framework.

## Installation

```bash
pip install -e .
```

## Usage

```python
from card_picker import Deck, StandardCard

# Build a standard 54 card deck
deck = Deck(StandardCard)
deck.create()
deck.shuffle()

# Deal five cards
hand = deck.deal(5)
print(hand)
```

The module also includes `TarotCard`, `ShadowCard`, and `UnoCard` implementations.

## Running tests

The project uses `pytest` for tests:

```bash
pytest
```