Metadata-Version: 2.4
Name: py-wordsearch-gen
Version: 2025.6.1
Summary: Command line tool to generate fun to play word searches.
Author: Dan Shernicoff
Author-email: Dan Shernicoff <dan@brassnet.biz>
License-Expression: MIT
License-File: LICENSE.md
Requires-Dist: ruff>=0.9.4
Requires-Python: >=3.10
Project-URL: Repository, https://github.com/brass75/wordsearch
Project-URL: homepage, https://github.com/brass75/wordsearch
Description-Content-Type: text/markdown

# py-wordsearch-gen - Word Search Generator

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![Tests](https://github.com/brass75/wordsearch/actions/workflows/test.yml/badge.svg)](https://github.com/brass75/wordsearch/actions/workflows/test.yml)
[![Mastodon Follow](https://img.shields.io/mastodon/follow/109552736199041636?domain=https%3A%2F%2Ftwit.social&style=flat)](https://twit.social/@brass75)

py-wordsearch-gen is a word search generator, originally written to generate a word search for distribution at the PSF booth
at PyCon US 2025. It is incredibly simple to use and will generate a new word search with every run.

## Installation

Installation is easy:
```shell
pip install py-wordsearch-gen
```

# Usage

To use just run `wordsearch` from the command line.

```shell
usage: wordsearch [-h] [-s SIZE] [-m MIN] [-d] [-r] [-k] words [words ...]

Word Search Generator

positional arguments:
  words             List of words for the search.

options:
  -h, --help        show this help message and exit
  -s, --size SIZE   The size of the word search grid from 5 - 50. (Default: 10)
  -m, --min MIN     The minimum word length. Cannot be larger than the size of the grid. (Default: 4)
  -d, --diagonal    Allow words to be placed diagonally.
  -r, --reverse     Allow words to be placed backwards.
  -k, --answer-key  Print the answer key ahead of the puzzle.
```
