ASCII Art Text Generator in Golang

Description

This project is a local web server that receives a text input from the user and displays an ASCII Art representation of the text. The project is implemented in Golang and uses the net/http package to handle HTTP requests.

Authors

This web app was designed by Ahmed Abdeen & Ahmed Alali as part of the Reboot01 program.

Getting Started

To get started with the project, follow these steps:

Clone the repository to your local machine:

    git clone https://learn.reboot01.com/git/aabdeen/ascii-art-web

Install Golang on your machine if you haven't already done so. You can download it from the official website ↗.
Navigate to the project directory:

    cd ascii-art-web/webprogram

Start the web server:

    go run main.go

The server will start listening for HTTP requests on port 8080. You can access the web interface by navigating to http://localhost:8080 in your browser.

Usage

To generate ASCII Art from text, you can enter the requested text into the text field:

Textfield input:

Hello

Choose one of the available banner types e.g.

Standard

The server will respond with an ASCII Art representation of the text in the choosen banner type:

     _    _          _   _          
    | |  | |        | | | |         
    | |__| |   ___  | | | |   ___   
    |  __  |  / _ \ | | | |  / _ \  
    | |  | | |  __/ | | | | | (_) | 
    |_|  |_|  \___| |_| |_|  \___/

Testing

The project comes with an HTTP methods test file that can be run using Postman. The file is located in the tests directory and can be imported into Postman.

To run the test file:

Open Postman and import the test file by clicking Import > Upload Files and selecting the ascii-art-generator.postman_collection.json file.

Run the collection by clicking the Run button.

The test file will send a few HTTP requests to the server and verify the responses.

Docker image

To create a docker image for this project, download and install the latest version of docker.

To build and run the image for the first time (using bash terminal):

bash dockerize.sh

To stop running:

docker stop dx

To remove existing image:

docker rmi ascii-art-web-dockerize

To remove existing image:

docker rm dx

if you're lazy:

bash stop-docker.sh

License

This project is licensed under the 01 Schools License - see the LICENSE file for details.

A-Abdeen/ascii-art-web-export-file