/Stylize-Web-AsciiArt

Primary LanguageGoMIT LicenseMIT

Stylize-Web-AsciiArt

Description

This program allows users to input text and select a banner format from a web interface. By clicking the "Convert to ASCII Art" button, the input text is transformed into an ASCII art graphical representation, which is then displayed on a new page.

Documentation

This section illustrates how to make use of this program.

Installation

To run this program, download and install the latest version of Go from here

Usage

  1. Clone this repository on to the terminal by using the following command:
git clone https://github.com/JosephOkumu/Stylize-Web-AsciiArt
  1. Navigate into the ascii-art-web directory by using the command:
cd ascii-art-web
  1. To run the program, execute the command below:
go run .

The following message will be printed out on the terminal:

Starting the Server at port 8080

Once you see the message above on the terminal, open your browser and enter on the address bar the following address:

http://localhost/8080

A form will be displayed, and on the form, enter your input text in the text field, choose banner format and click "Convert to Ascii Art". Example: When you type "hello" and select "standard" as the banner format, then upon clicking "Convert to ASCII Art," the following output will be displayed on a new page.

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

Features

  • This program can write the ascii-art graphical representation to a new page.
  • This program allows you to select a banner file format to display the ascii art.
  • The web pages of this program are styled and are responsive.
  • This program has our own extra customized banner file.

Implementation details: algorithm

Endpoints:

  1. Root ("/)
  2. Ascii-art ("/ascii-art)

Algorithm:

  1. Set up HTTP server using Go's 'net/http' package.
  2. Define route handlers for both endpoints:
  3. In the root handler serve the main page with a form for input text.
  4. In the ascii-art handler:
    • Parse data from the request.
    • Read the appropriate ASCII art file based on user input
    • Process file contents to generate ASCII art.
    • Generate HTML response with the ASCII art.
    • Write HTML to response writer.

Data Flow:

User Input -> Server -> File Read -> ASCII Art Generation -> HTML Response -> Web Browser

Contributions

Pull requests are welcome where users of this program are allowed to contribute to this project in terms of adding features, or fixing bugs.

For major changes, please open an issue first to discuss what you would like to change.

Authors

JosephOKumu

Licence

MIT

Credits

Zone01Kisumu