semvec/pypi-packages huggingface dataset:
spiel-des-jahres 0.3.1
Spiel des Jahres predictions
License: MIT
Requires Python: <4.0,>=3.10.0

# Spiel des Jahres

[![PyPI](https://img.shields.io/pypi/v/spiel-des-jahres?style=flat-square)](https://pypi.python.org/pypi/spiel-des-jahres/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/spiel-des-jahres?style=flat-square)](https://pypi.python.org/pypi/spiel-des-jahres/)
[![PyPI - License](https://img.shields.io/pypi/l/spiel-des-jahres?style=flat-square)](https://pypi.python.org/pypi/spiel-des-jahres/)
[![Coookiecutter - Wolt](https://img.shields.io/badge/cookiecutter-Wolt-00c2e8?style=flat-square&logo=cookiecutter&logoColor=D4AA00&link=https://github.com/woltapp/wolt-python-package-cookiecutter)](https://github.com/woltapp/wolt-python-package-cookiecutter)


---

**Documentation**: [https://recommend-games.github.io/spiel-des-jahres](https://recommend-games.github.io/spiel-des-jahres)

**Source Code**: [https://github.com/recommend-games/spiel-des-jahres](https://github.com/recommend-games/spiel-des-jahres)

**PyPI**: [https://pypi.org/project/spiel-des-jahres/](https://pypi.org/project/spiel-des-jahres/)

---

Spiel des Jahres predictions

## Installation

```sh
pip install spiel-des-jahres
```

## Development

* Clone this repository
* Requirements:
  * [Poetry](https://python-poetry.org/)
  * Python 3.10+
* Create a virtual environment and install the dependencies

```sh
poetry install
```

* Activate the virtual environment

```sh
poetry shell
```

### Testing

```sh
pytest
```

### Documentation

The documentation is automatically generated from the content of the [docs directory](https://github.com/recommend-games/spiel-des-jahres/tree/master/docs) and from the docstrings
 of the public signatures of the source code. The documentation is updated and published as a [Github Pages page](https://pages.github.com/) automatically as part each release.

### Releasing

Trigger the [Draft release workflow](https://github.com/recommend-games/spiel-des-jahres/actions/workflows/draft_release.yml)
(press _Run workflow_). This will update the changelog & version and create a GitHub release which is in _Draft_ state.

Find the draft release from the
[GitHub releases](https://github.com/recommend-games/spiel-des-jahres/releases) and publish it. When
 a release is published, it'll trigger [release](https://github.com/recommend-games/spiel-des-jahres/blob/master/.github/workflows/release.yml) workflow which creates PyPI
 release and deploys updated documentation.

### Pre-commit

Pre-commit hooks run all the auto-formatting (`ruff format`), linters (e.g. `ruff` and `mypy`), and other quality
 checks to make sure the changeset is in good shape before a commit/push happens.

You can install the hooks with (runs for each commit):

```sh
pre-commit install
```

Or if you want them to run only for each push:

```sh
pre-commit install -t pre-push
```

Or if you want e.g. want to run all checks manually for all files:

```sh
pre-commit run --all-files
```

---

This project was generated using the [wolt-python-package-cookiecutter](https://github.com/woltapp/wolt-python-package-cookiecutter) template.
wordsearch-gen 0.1.3
A customizable word search puzzle generator.
License: MIT
Requires Python: >=3.7

# WordSearch Generator

A simple word search puzzle generator in Python.  
Supports horizontal, vertical, and diagonal word placements.  
Returns a clean 2D array that you can further customize and display however you like.

---

## 🚀 Features

- Automatically fits all words into a square grid
- Supports custom languages (via `alphabets.py`)
- Places words in:
  - Horizontal ↔️
  - Vertical ↕️
  - Diagonal ↘️ directions
- Returns a ready-to-use 2D array (no output to file or console by default)

---

## 🧪 Example

```python
from wordsearch import WordSearch
from alphabets import Alphabets

words = ["painter", "back", "board", "cactus", "reliance"]
ws = WordSearch(words, language=Alphabets.ENGLISH)

for row in ws.grid:
    print(" ".join(row))
```

Output: *(will vary due to randomness)*

```
P A I N T E R S E T
C R A N G E M A I P
...
```

---

## 🧠 Customization

Want to use different alphabets?  
Check out `alphabets.py` to define your own language set.  
You can pass it like so:

```python
ws = WordSearch(words, language=Alphabets.SPANISH)
```

---

## 🤓 Who is this for?

- Educators making worksheets
- Devs wanting to visualize word data
- Puzzle nerds (you know who you are)

---

## 📋 License

MIT — feel free to use, modify, and share.  
If you build something fun with it, let me know! 😄