zaim-zsl 0.1.2

A simple web server that serves a single HTML file.

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
2. How it Works Under the Hood
3. Installation
4. Step-by-Step Quick Start Tutorial
5. Complete Working Examples
6. Advanced Usage Patterns
7. API Reference Documentation
8. Troubleshooting Common Issues
9. Development and Contribution
10. 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/.

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