Word Combination Generator

Table of Contents

• Introduction
• Tech Stack
• Prerequisites
• Run Application
• Docker
  • Build Command
  • Run Command
• Run Unit Tests

---

Introduction

This Flask application can take user input of random letters and generate all the possible combinations of words which can be made using those letters and also it displays the amount of words generated. Unit tests are provided in the tests directory, the command to run them can be found below in the documentation.

Tech Stack

Flask | Python | JavaScript | HTML/CSS | Docker

Prerequisites

Please make sure you have the following installed on your machine:

pip install -r requirements.txt

Run Application

flask --app main run

Run App in Debug Mode

python main.py

Docker

Download Docker Desktop for Mac or Windows. This solution uses Python3 and Flask.

Build Command

Build the image, this may take some time. After your image is built, you can view your image in the Images tab in Docker Desktop.

docker build -t word-combination-generator .

The -t flag tags your image with a name, word-combination-generator in this case. And the . lets Docker know where it can find the Dockerfile.

Run Command

To run the docker image type this command:

docker run -p 5000:5000 word-combination-generator

Run Unit Tests

cd tests 

python -m unittest test_wordMaker.py