py-wordsearch-gen 2025.6.1

Command line tool to generate fun to play word searches.

py-wordsearch-gen - Word Search Generator

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:

pip install py-wordsearch-gen

Usage

To use just run wordsearch from the command line.

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.