Metadata-Version: 2.4
Name: fill-the-blanks-lib
Version: 1.0.0
Summary: A pure Python library for fill-in-the-blank word games.
Author-email: JACOB7870 <jakob-tillmann@gmx.net>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# fill-the-blanks-lib

A lightweight, pure-Python library to easily build and run interactive fill-in-the-blanks (Mad Libs style) word games. It requires no external dependencies.

## Installation

You can install the library directly from PyPI using pip:

pip install fill-the-blanks-lib

## Quick Start / Usage

Since the package name is long, we highly recommend importing it using the shorthand alias ftb in your projects.

### Example for 1 Word Substitution (madlibs_1x):

import fill_the_blanks_lib as ftb

# Define your prompt and the output template containing {entered}
prompt = "Enter a funny noun: "
template = "The quick brown fox jumps over the lazy {entered1}."

# Run the function
ftb.madlibs_1x(prompt, template)


### Supporting Multiple Substitutions (Up to 10x):
The library scales according to your story needs. If you have 3 slots to fill, simply use madlibs_3x:

import fill_the_blanks_lib as ftb

prompt1 = "Enter a name: "
template1 = "Hello {entered1},"

prompt2 = "Enter an adjective: "
template2 = "Today is a {entered2} day."

prompt3 = "Enter a place: "
template3 = "Welcome to {entered3}!"

# Executes all 3 prompts sequentially and prints the results
ftb.madlibs_3x(prompt1, template1, prompt2, template2, prompt3, template3)


## Available Functions
* madlibs_1x(...) up to madlibs_10x(...)
