mango-framework 1.2

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 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()

What's New in 1.2

Dynamic Route Configuration via JSON

Mango 1.2 introduces the ability to configure routes dynamically using a JSON file. This feature significantly simplifies route management by allowing developers to define routes, handlers, and their responses in a JSON format, making your web application easily configurable and adaptable without the need to directly modify the Python code, the included ORM has been removed in favor of third party more robust alternatives such as tinyDB.

How to Use JSON Route Configuration

1. Define Routes in JSON: Create a routing.json file within your project directory. This file will contain all your route definitions in a structured format.

2. Load Routes: Utilize the load_from_json function at the start of your application to load the routes defined in the routing.json file.

3. Run Your Server: With the routes dynamically loaded, start your Mango server as usual.

JSON Configuration Example

Below is an example of how to structure your routing.json to define various routes:

{
    "GET": {
        "/": {
            "handler": "index",
            "return": {
                "type": "template",
                "name": "index.html",
                "context": {
                    "name": "test",
                    "time": "11AM"
                }
            }
        },
        "/json": {
            "handler": "send_json",
            "return": {
                "type": "json",
                "data": {
                    "name": "test",
                    "time": "11AM"
                }
            }
        },
        "/redirect": {
            "handler": "redirect_func",
            "return": {
                "type": "redirect",
                "url": "/json"
            }
        },
        "/plain": {
            "handler": "send_plain",
            "return": {
                "type": "plain",
                "data": "Hello World"
            }
        },
        "/file": {
            "handler": "send_file_func",
            "return": {
                "type": "file",
                "path": "a.jpg",
                "attachment": false
            }
        },
        "/data": {
            "handler": "send_data",
            "return": {
                "type": "data",
                "data": "Hello World"
            }
        }
    }
}

Loading and Running with JSON Routes

To dynamically load the routes from your routing.json and start the server, include the following code in your application:

data = open("routing.json").read()
json_data_routing = json.loads(data)
load_from_json(json_data_routing)
run()

This enhancement to Mango makes setting up and modifying your server simpler than ever before, promoting rapid development and easier management of web applications through external JSON configurations.