Metadata-Version: 2.4
Name: zaim-zsl
Version: 0.1.2
Summary: A simple web server that serves a single HTML file.
Author: Zaim Maalim Sheali
Description-Content-Type: text/markdown
Requires-Dist: Flask
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: summary

# zaim-zsl 🚀

[![PyPI version](https://img.shields.io/pypi/v/zaim-zsl.svg)](https://pypi.org/project/zaim-zsl/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Support](https://img.shields.io/pypi/pyversions/zaim-zsl.svg)](https://pypi.org/project/zaim-zsl/)

A lightweight, developer-focused Python library that strips away the boilerplate of web server configuration. Built as an intuitive wrapper around Flask, `zaim-zsl` allows you to spin up a local development server to serve a specific, single HTML file instantly with minimal code.

Whether you are testing an isolated frontend component, building an internal utility UI, or introducing students to backend web routing, `zaim-zsl` provides a clean, zero-configuration solution.

---

## 📖 Table of Contents
1. [Core Features](#-core-features)
2. [How it Works Under the Hood](#-how-it-works-under-the-hood)
3. [Installation](#-installation)
4. [Step-by-Step Quick Start Tutorial](#-step-by-step-quick-start-tutorial)
5. [Complete Working Examples](#-complete-working-examples)
6. [Advanced Usage Patterns](#-advanced-usage-patterns)
7. [API Reference Documentation](#-api-reference-documentation)
8. [Troubleshooting Common Issues](#-troubleshooting-common-issues)
9. [Development and Contribution](#-development-and-contribution)
10. [License](#-license)

---

## ✨ Core Features

* **Zero Flask Boilerplate:** Forget configuring application context, setting up routing rules, or managing layout file trees. One object creation manages it all.
* **Smart Context Resolution:** Standard Flask looks inside a fixed, internal `/templates` folder. `zaim-zsl` dynamically maps directly to your active terminal working directory (`os.getcwd()`), instantly finding your local asset folder.
* **Granular URL Customization:** Easily control both the binding network port and the specific URL slug endpoints.
* **Native Hot Reloading:** Comes packaged with debugging features enabled by default, ensuring immediate server refreshes whenever your source code or templates change.

---

## 🛠️ How it Works Under the Hood

Standard microframeworks require absolute structure synchronization. For instance, when installing a traditional library via `pip`, the runtime execution anchor shifts into a global directory tree like `site-packages/`. 

```text
❌ STANDARD FLASK COMPILATION:
your_project/
  └── app.py (Looks internally for /templates folder here)

✔️ THE ZAIM-ZSL INTERFACE:
your_project/
  ├── app.py          <- Your execution script
  └── index.html      <- Located seamlessly via root working context (os.getcwd())
