mango-framework 1.1.0

A lightweight and highly customizable Python framework for building web applications

Mango Framework

Introduction

Mango is a lightweight Python framework for building web applications. It provides a simple and intuitive way to handle routing, render HTML templates, and serve files. With Mango, you can quickly set up a web server and define routes to handle different HTTP requests. It is made to be accessible and highly modifiable even by beginners to learn and eventually move on to more mature frameworks such as Flask or Bottle. You only need python3 to run Mango and nothing else.

Features

• Easy routing configuration
• Rendering HTML templates
• Serving static files
• Handling JSON data
• Handling of basic form data
• Lightweight and minimal dependencies
• Suitable for small to medium-sized web applications
• Human readible code even beginners could modify
• Integrated basic ORM for DB functions
• Integrated basic Template engine Shake
• Handling of file uploads
• Setting custom 404 error pages
• Handling static files

Installation

Mango can be easily installed via pip:

pip install mango-framework

Usage

1. Import the necessary modules and functions from Mango:

from mango import route, run, render, send_json, send_file, get_json, save_file, set_404, set_static_url, enable_static

2. Define your routes using the @route() decorator:

@route('/')
def index():
    return "Hello, Mango!"

3. Get JSON data:

@route('/post')
def post(post):
    user = get_json(post)
    return f"Hello, {user['name']}!"

4. Send JSON data:

@route('/send')
def send():
    return send_json({'name':'john'})

5. Send a file for the user to download:

@route('/download')
def download():
    return send_file('image.jpeg')

### as attachment

@route('/download')
def download():
    return send_file('image.jpeg', as_attachment=True)

6. Render the HTML to the user (now supports shake without the class):

@route('/render')
def render():
    return render('index.html')

### New reactive rendering

@route('/render')
def render():
    return render('index.html',{'name':'john'})

7. Get form data:

@route('/form')
def form(form_data):
    name = form_data.get('name')
    return f"Hello, {name}!"

8. Get file upload with data:

@route('/get')
def upload(form_fields, files):
    input1 = form_fields.get("input1")  
    input2 = form_fields.get("input2")

    file_item1 = files[0]  
    if file_item1.filename:  
        file_path1 = save_file(data=file_item1.file.read(), name=file_item1.filename, path='upload')

    file_item2 = files[1]
    if file_item2.filename:
        file_path2 = save_file(data=file_item2.file.read(), name=file_item2.filename, path='upload')

        #returns files in a list, forms in a dict

    return "files saved successfully"

9. Change the default 404 Page:

set_404("<h1> not here ! </h1>")

## or pass an HTML or any file directly

set_404("404.html")

10. Send static files to HTML:

<link rel="stylesheet" type="text/css" href="/static/style.css">

11. Change the default Static URL

set_static_url("/images")

Default URL is /static. the new link MUST start with / !

12. Enable or disable Static serving

enable_static(True)

13. Run the Mango server:

run()