duckframework 1.0.1__tar.gz

duckframework-1.0.1/AUTHORS.md

@@ -0,0 +1,12 @@
+# Authors
+
+Brian Musakwa <digreatbrian@gmail.com>
+
+## Sole Developer and Owner
+Brian Musakwa is the sole developer and owner of this software.
+
+## Acknowledgements
+Special thanks to Guido van Rossum for creating Python, which made this project possible.
+
+## Project History
+Duck was created in the early days of March 2024.

duckframework-1.0.1/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2024 Brian Musakwa
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of Duck nor the names of its contributors may be used
+       to endorse or promote products derived from this software without
+       specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

duckframework-1.0.1/MANIFEST.in

@@ -0,0 +1,15 @@
+include LICENSE
+include AUTHORS.md
+include README.md
+recursive-include duck *
+exclude duck/**/__pycache__
+exclude duck/**/__pycache__/*.pyc
+exclude duck/**/.logs
+exclude duck/**/.logs/*.log
+exclude duck/**/.cache/
+exclude duck/**/.cache/*
+exclude duck/**/testing/assets
+exclude duck/**/testing/.ducksight
+exclude duck/**/testing/.processes.json
+exclude duck/**/testing/.ipc
+exclude duck/**/testing/**/.ipc

duckframework-1.0.1/PKG-INFO

@@ -0,0 +1,263 @@
+Metadata-Version: 2.4
+Name: duckframework
+Version: 1.0.1
+Summary: **Duck** is a powerful, open-source, full-fledged Python-based **web server**, **framework**, and **reverse proxy** designed for building modern, customizable web applications — from small sites to large-scale platforms.
+Author-email: Brian Musakwa <digreatbrian@gmail.com>
+Maintainer-email: Brian Musakwa <digreatbrian@gmail.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://duckframework.xyz
+Project-URL: Source, https://github.com/duckframework/duck
+Project-URL: Issues, https://github.com/duckframework/duck/issues
+Project-URL: Documentation, https://docs.duckframework.xyz
+Project-URL: Funding, https://duckframework.xyz/contribute
+Keywords: Python,web framework,web server,reverse proxy,HTTP/2,WSGI,ASGI,Django integration,Flask,Tornado,FastAPI,microservices,middleware,high-performance,async,Duck framework,routing,load balancing,HTTP proxy,web application
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: Django>=5.1.5
+Requires-Dist: Jinja2>=3.1.5
+Requires-Dist: watchdog>=4.0.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: h2>=4.2.0
+Requires-Dist: msgpack>=1.1.1
+Requires-Dist: diskcache
+Requires-Dist: colorama
+Requires-Dist: tzdata
+Requires-Dist: click
+Requires-Dist: asgiref>=3.8.1
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: rich>=14.1.0
+Requires-Dist: setproctitle
+Dynamic: license-file
+
+# Duck Framework
+![Duck image](./images/duck-icon.png)
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/release/python-3100/)
+[![GitHub stars](https://img.shields.io/github/stars/duckframework/duck?style=social)](https://github.com/duckframework/duck/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/duckframework/duck?style=social)](https://github.com/duckframework/duck/network/members)
+[![License](https://img.shields.io/github/license/duckframework/duck)](https://github.com/duckframework/duck/blob/main/LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/duckframework/duck/docs.yml?branch=main)](https://github.com/duckframework/duck/actions)
+[![Open Issues](https://img.shields.io/github/issues/duckframework/duck)](https://github.com/duckframework/duck/issues)
+[![Contributors](https://img.shields.io/github/contributors/duckframework/duck)](https://github.com/duckframework/duck/graphs/contributors)
+[![HTTPS](https://img.shields.io/badge/HTTPS-supported-brightgreen.svg)](#)
+[![HTTP/2](https://img.shields.io/badge/HTTP--2-supported-brightgreen.svg)](#)
+[![WebSocket](https://img.shields.io/badge/WebSocket-supported-brightgreen.svg)](#)
+[![Async Views](https://img.shields.io/badge/Async-WSGI%2FASGI-blue.svg)](#)
+[![Task Automation](https://img.shields.io/badge/Task-Automation-blueviolet.svg)](#)
+[![Content Compression](https://img.shields.io/badge/Compression-gzip%2C%20brotli%2C%20deflate-blue.svg)](#)
+[![SSL Auto-Renewal](https://img.shields.io/badge/SSL-Auto%20Renewal-brightgreen.svg)](#)
+[![Resumable Downloads](https://img.shields.io/badge/Downloads-Resumable-orange.svg)](#)
+[![Security](https://img.shields.io/badge/Security-DoS%2C%20SQLi%2C%20CmdInj-red.svg)](#)
+[![DuckSight Hot Reload](https://img.shields.io/badge/HotReload-DuckSight-yellow.svg)](#)
+[![Django Integration](https://img.shields.io/badge/Django-Integration-blue.svg)](#)
+[![Monitoring](https://img.shields.io/badge/Monitoring-CPU%2FRAM%2FDisk%2FI%2FO-brightgreen.svg)](#)
+
+**Duck** is a powerful, open-source, full-fledged Python-based **web server**, **framework**, and **reverse proxy** designed for building modern, customizable web applications — from small sites to large-scale platforms.  
+
+**It simplifies web development with:**
+
+1. **Built-in HTTPS support** for secure connections  
+2. **Native HTTP/2 support** with **HTTP/1** backward compatibility [link](https://docs.duckframework.xyz/main/https-and-http2.html)  
+3. Hassle-free **free SSL certificate generation** with **automatic renewal** [link](https://docs.duckframework.xyz/main/free-ssl-certificate.html)  
+4. **Lively Component System** — with `VDom Diffing` (support for fast UI's) 
+5. **WebSocket support** — modern websocket implementation with `per-message compression`.
+6. Built-in [task automation](/automations.html) — no need for [cron jobs](https://en.m.wikipedia.org/wiki/Cron)  
+7. Automatic **content compression** using `gzip`, `deflate` or `brotli`
+8. Support for **chunked transfer encoding**  
+9. Easy integration with existing **Django** projects using `django-add`  
+10. Organized routing with **Duck** [`Blueprints`](https://docs.duckframework.xyz/main/blueprint.html)
+11. Full support for **async views** or asynchronous code even in `WSGI` environment
+12. Dynamic project generation with `makeproject` (`mini`, `normal`, or `full`)  
+13. Runs on both `WSGI` and `ASGI` environments, can even run `async` protocols like `HTTP/2` or `WebSockets` on `WSGI`.  
+14. High-performance with low-latency response times  
+15. **Resumable downloads** for large files  
+16. Protection against **DoS**, **SQL Injection**, **Command Injection**, and other threats  
+17. **Auto-reload** in debug mode for rapid development  
+18. **Free production SSL** — no certificate costs  
+19. **Automatic SSL renewal** using `certbot` plus Duck automation system
+20. Comes with built-in web development tools and helpers  
+21. Log management with `duck logs` and file-based logging by default  
+22. Real-time system monitoring for CPU, RAM, Disk usage, and I/O activity with `duck monitor`
+23. Easily generate app sitemap using command [`duck sitemap`](https://docs.duckframework.xyz/main/sitemap.html) or just use 
+       the builtin blueprint [`duck.etc.apps.essentials.blueprint.Sitemap`](https://docs.duckframework.xyz/main/sitemap.html) for dynamic cached sitemap serving.
+24. Highly **customizable** to fit any use case  
+
+And more — see [feature list](https://duckframework.xyz/features)
+
+## Upcoming Features
+
+1. **HTTP/3 with QUIC** – Faster, modern transport for improved performance.  
+2. **QUIC WebTransport** – A next-gen alternative to WebSockets for real-time communication.  
+3. **Component Pre-rendering System** – A system to preload components in the background thread to reduce initial load times of component trees.
+4. **Customizable Dashboards** – Tailor interfaces to your workflow and preferences.  
+5. **MQTT (Message Queuing Telementry Transport) Integration** – Run your own broker and manage IoT devices with ease.  
+6. **Duck WebApp to APK** – Easily convert a Duck web application to APK.
+7. **DuckSight Hot Reload** – Instead of full reload on file changes, implement **hot reload** for the **DuckSight Reloader**. This is faster and efficient than full reload.
+8. **Internal Updates** – Implement logic for listing and securely applying updates when available, utilizing cryptographic code signing (using standards like TUF) to verify GitHub-sourced updates, protecting against rollbacks, and man-in-the-middle exploits.
+9. ~~**Worker Processes** – Use of worker processes to utilize all available CPU cores for improved request handling.~~
+10. **Complete Reverse Proxy Server** – **Duck** only acts as reverse proxy for  Django only. Need to make Duck a full-fledged reverse proxy server with optional sticky sessions.
+11. ~~**Component Mutation Observer** – Need to build an optional component mutation observer for keeping track of child changes for fastest re-render (approx. 75x fast on unchanged children).~~
+12. **MCP (Model Context Protocol) Server** – Need to make it easy for creating MCP servers for easy AI communication. 
+13. **...and more** – [Request a feature](./feature_request.md)
+
+---
+
+## TODO:
+- Need to cythonize some of the project parts for improved speed esp., components.
+- Need to make **Duck** fully async, especially in component & templates (currently at 89% async compatible, need to enable strictness for component rendering in async mode).
+
+---
+
+## 🦆 Fun Facts
+
+- The **Duck** official website is powered by the **Duck** framework itself—showcasing a true "dogfooding" approach!
+- **Duck's Lively components** bring you a **Lively UI** that's exceptionally fast and responsive, eliminating slow page re-rendering for a seamless user experience.
+- Also, **Duck** official site is hosted directly with `Duck` itself, no NGINX or a reverse proxy is behind it. **Duck** handles everything including renewing expired `SSL` certificate & handle `HTTP/2` protocol!
+
+---
+
+## Getting Started
+
+It is recommended to use **uv** for installing **Duck**.
+
+**Install Duck using `uv`:**
+
+```sh
+uv pip install git+https://github.com/duckframework/duck.git
+```
+
+**Or using original `pip`:**
+
+```sh
+pip install git+https://github.com/duckframework/duck.git
+```
+
+---
+
+## Project Creation
+
+```sh
+duck makeproject myproject
+```
+
+This creates a `normal` project named `myproject`. You can also create other project types using:
+
+- `--full` for a full-featured project  
+- `--mini` for a simplified starter project
+
+### Full Project
+
+The full version includes everything **Duck** offers. Recommended for experienced developers.
+
+```sh
+duck makeproject myproject --full
+```
+
+### Mini Project
+
+Beginner-friendly. Lightweight version with essential functionality.
+
+```sh
+duck makeproject myproject --mini
+```
+
+---
+
+## Simple Startup
+
+```sh
+duck makeproject myproject
+cd myproject
+duck runserver   # or: python3 web/main.py
+```
+
+This starts the server at **http://localhost:8000**   
+
+**Duck** serves a basic site by default — explore more at [Documentation](https://docs.duckframework.xyz/main)
+
+> By default, Duck compresses streaming responses (like large downloads or video).  
+> To disable this behavior, set `compress_streaming_responses` to `False`.
+
+---
+
+## Django Integration
+
+If you have an existing **Django** project and want production features like **HTTPS**, **HTTP/2**, and **resumable downloads**, Duck makes it easy.  
+
+Unlike `nginx` setups, **Duck** simplifies this with a few commands.
+
+### Benefits
+
+- Native HTTP/2 & HTTPS implementation. 
+- Extra built-in security middleware (DoS, SQLi, etc.)  
+- Duck and Django run in the same Python environment (faster communication)  
+- Auto-compressed responses  
+- Resumable large downloads  
+- Fast and Reactive Lively components - for beautiful & responsive UI.
+- [Free SSL with renewal](https://docs.duckframework.xyz/main/free-ssl-certificate.html)
+- and more
+
+### Usage
+
+```sh
+duck makeproject myproject
+cd myproject
+duck django-add "path/to/your/django_project"
+duck runserver -dj
+```
+
+### Notes:
+
+- Follow instructions provided by `django-add` command carefully  
+- Make sure your Django project defines at least one `urlpattern`
+- Once setup, you’re good to go!
+
+---
+
+## Duck Official Site
+
+Visit: [https://duckframework.xyz](https://duckframework.xyz)    
+Docs: [https://docs.duckframework.xyz](https://docs.duckframework.xyz)
+
+---
+
+## 🚀 Premium Duck Components Coming Soon!
+>  
+> All our UI components are currently free and open source. Stay tuned for upcoming Pro Packs featuring advanced dashboards, e-commerce, and integrations!
+>
+> ⭐ Star this repo to get notified on release!
+
+
+## Contributing & Issues
+
+**Duck** is open to all forms of contribution — financial or technical.
+
+### Sponsorship/Donations:  
+
+Support development at [Open Collective](https://opencollective.com/duckframework/contribute)  
+
+### Report issues:  
+
+Use the [GitHub Issues page](https://github.com/duckframework/duck/issues)
+
+---
+
+> **Duck is updated regularly** — check the repo for improvements and bug fixes.

duckframework-1.0.1/README.md

@@ -0,0 +1,214 @@
+# Duck Framework
+![Duck image](./images/duck-icon.png)
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/release/python-3100/)
+[![GitHub stars](https://img.shields.io/github/stars/duckframework/duck?style=social)](https://github.com/duckframework/duck/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/duckframework/duck?style=social)](https://github.com/duckframework/duck/network/members)
+[![License](https://img.shields.io/github/license/duckframework/duck)](https://github.com/duckframework/duck/blob/main/LICENSE)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/duckframework/duck/docs.yml?branch=main)](https://github.com/duckframework/duck/actions)
+[![Open Issues](https://img.shields.io/github/issues/duckframework/duck)](https://github.com/duckframework/duck/issues)
+[![Contributors](https://img.shields.io/github/contributors/duckframework/duck)](https://github.com/duckframework/duck/graphs/contributors)
+[![HTTPS](https://img.shields.io/badge/HTTPS-supported-brightgreen.svg)](#)
+[![HTTP/2](https://img.shields.io/badge/HTTP--2-supported-brightgreen.svg)](#)
+[![WebSocket](https://img.shields.io/badge/WebSocket-supported-brightgreen.svg)](#)
+[![Async Views](https://img.shields.io/badge/Async-WSGI%2FASGI-blue.svg)](#)
+[![Task Automation](https://img.shields.io/badge/Task-Automation-blueviolet.svg)](#)
+[![Content Compression](https://img.shields.io/badge/Compression-gzip%2C%20brotli%2C%20deflate-blue.svg)](#)
+[![SSL Auto-Renewal](https://img.shields.io/badge/SSL-Auto%20Renewal-brightgreen.svg)](#)
+[![Resumable Downloads](https://img.shields.io/badge/Downloads-Resumable-orange.svg)](#)
+[![Security](https://img.shields.io/badge/Security-DoS%2C%20SQLi%2C%20CmdInj-red.svg)](#)
+[![DuckSight Hot Reload](https://img.shields.io/badge/HotReload-DuckSight-yellow.svg)](#)
+[![Django Integration](https://img.shields.io/badge/Django-Integration-blue.svg)](#)
+[![Monitoring](https://img.shields.io/badge/Monitoring-CPU%2FRAM%2FDisk%2FI%2FO-brightgreen.svg)](#)
+
+**Duck** is a powerful, open-source, full-fledged Python-based **web server**, **framework**, and **reverse proxy** designed for building modern, customizable web applications — from small sites to large-scale platforms.  
+
+**It simplifies web development with:**
+
+1. **Built-in HTTPS support** for secure connections  
+2. **Native HTTP/2 support** with **HTTP/1** backward compatibility [link](https://docs.duckframework.xyz/main/https-and-http2.html)  
+3. Hassle-free **free SSL certificate generation** with **automatic renewal** [link](https://docs.duckframework.xyz/main/free-ssl-certificate.html)  
+4. **Lively Component System** — with `VDom Diffing` (support for fast UI's) 
+5. **WebSocket support** — modern websocket implementation with `per-message compression`.
+6. Built-in [task automation](/automations.html) — no need for [cron jobs](https://en.m.wikipedia.org/wiki/Cron)  
+7. Automatic **content compression** using `gzip`, `deflate` or `brotli`
+8. Support for **chunked transfer encoding**  
+9. Easy integration with existing **Django** projects using `django-add`  
+10. Organized routing with **Duck** [`Blueprints`](https://docs.duckframework.xyz/main/blueprint.html)
+11. Full support for **async views** or asynchronous code even in `WSGI` environment
+12. Dynamic project generation with `makeproject` (`mini`, `normal`, or `full`)  
+13. Runs on both `WSGI` and `ASGI` environments, can even run `async` protocols like `HTTP/2` or `WebSockets` on `WSGI`.  
+14. High-performance with low-latency response times  
+15. **Resumable downloads** for large files  
+16. Protection against **DoS**, **SQL Injection**, **Command Injection**, and other threats  
+17. **Auto-reload** in debug mode for rapid development  
+18. **Free production SSL** — no certificate costs  
+19. **Automatic SSL renewal** using `certbot` plus Duck automation system
+20. Comes with built-in web development tools and helpers  
+21. Log management with `duck logs` and file-based logging by default  
+22. Real-time system monitoring for CPU, RAM, Disk usage, and I/O activity with `duck monitor`
+23. Easily generate app sitemap using command [`duck sitemap`](https://docs.duckframework.xyz/main/sitemap.html) or just use 
+       the builtin blueprint [`duck.etc.apps.essentials.blueprint.Sitemap`](https://docs.duckframework.xyz/main/sitemap.html) for dynamic cached sitemap serving.
+24. Highly **customizable** to fit any use case  
+
+And more — see [feature list](https://duckframework.xyz/features)
+
+## Upcoming Features
+
+1. **HTTP/3 with QUIC** – Faster, modern transport for improved performance.  
+2. **QUIC WebTransport** – A next-gen alternative to WebSockets for real-time communication.  
+3. **Component Pre-rendering System** – A system to preload components in the background thread to reduce initial load times of component trees.
+4. **Customizable Dashboards** – Tailor interfaces to your workflow and preferences.  
+5. **MQTT (Message Queuing Telementry Transport) Integration** – Run your own broker and manage IoT devices with ease.  
+6. **Duck WebApp to APK** – Easily convert a Duck web application to APK.
+7. **DuckSight Hot Reload** – Instead of full reload on file changes, implement **hot reload** for the **DuckSight Reloader**. This is faster and efficient than full reload.
+8. **Internal Updates** – Implement logic for listing and securely applying updates when available, utilizing cryptographic code signing (using standards like TUF) to verify GitHub-sourced updates, protecting against rollbacks, and man-in-the-middle exploits.
+9. ~~**Worker Processes** – Use of worker processes to utilize all available CPU cores for improved request handling.~~
+10. **Complete Reverse Proxy Server** – **Duck** only acts as reverse proxy for  Django only. Need to make Duck a full-fledged reverse proxy server with optional sticky sessions.
+11. ~~**Component Mutation Observer** – Need to build an optional component mutation observer for keeping track of child changes for fastest re-render (approx. 75x fast on unchanged children).~~
+12. **MCP (Model Context Protocol) Server** – Need to make it easy for creating MCP servers for easy AI communication. 
+13. **...and more** – [Request a feature](./feature_request.md)
+
+---
+
+## TODO:
+- Need to cythonize some of the project parts for improved speed esp., components.
+- Need to make **Duck** fully async, especially in component & templates (currently at 89% async compatible, need to enable strictness for component rendering in async mode).
+
+---
+
+## 🦆 Fun Facts
+
+- The **Duck** official website is powered by the **Duck** framework itself—showcasing a true "dogfooding" approach!
+- **Duck's Lively components** bring you a **Lively UI** that's exceptionally fast and responsive, eliminating slow page re-rendering for a seamless user experience.
+- Also, **Duck** official site is hosted directly with `Duck` itself, no NGINX or a reverse proxy is behind it. **Duck** handles everything including renewing expired `SSL` certificate & handle `HTTP/2` protocol!
+
+---
+
+## Getting Started
+
+It is recommended to use **uv** for installing **Duck**.
+
+**Install Duck using `uv`:**
+
+```sh
+uv pip install git+https://github.com/duckframework/duck.git
+```
+
+**Or using original `pip`:**
+
+```sh
+pip install git+https://github.com/duckframework/duck.git
+```
+
+---
+
+## Project Creation
+
+```sh
+duck makeproject myproject
+```
+
+This creates a `normal` project named `myproject`. You can also create other project types using:
+
+- `--full` for a full-featured project  
+- `--mini` for a simplified starter project
+
+### Full Project
+
+The full version includes everything **Duck** offers. Recommended for experienced developers.
+
+```sh
+duck makeproject myproject --full
+```
+
+### Mini Project
+
+Beginner-friendly. Lightweight version with essential functionality.
+
+```sh
+duck makeproject myproject --mini
+```
+
+---
+
+## Simple Startup
+
+```sh
+duck makeproject myproject
+cd myproject
+duck runserver   # or: python3 web/main.py
+```
+
+This starts the server at **http://localhost:8000**   
+
+**Duck** serves a basic site by default — explore more at [Documentation](https://docs.duckframework.xyz/main)
+
+> By default, Duck compresses streaming responses (like large downloads or video).  
+> To disable this behavior, set `compress_streaming_responses` to `False`.
+
+---
+
+## Django Integration
+
+If you have an existing **Django** project and want production features like **HTTPS**, **HTTP/2**, and **resumable downloads**, Duck makes it easy.  
+
+Unlike `nginx` setups, **Duck** simplifies this with a few commands.
+
+### Benefits
+
+- Native HTTP/2 & HTTPS implementation. 
+- Extra built-in security middleware (DoS, SQLi, etc.)  
+- Duck and Django run in the same Python environment (faster communication)  
+- Auto-compressed responses  
+- Resumable large downloads  
+- Fast and Reactive Lively components - for beautiful & responsive UI.
+- [Free SSL with renewal](https://docs.duckframework.xyz/main/free-ssl-certificate.html)
+- and more
+
+### Usage
+
+```sh
+duck makeproject myproject
+cd myproject
+duck django-add "path/to/your/django_project"
+duck runserver -dj
+```
+
+### Notes:
+
+- Follow instructions provided by `django-add` command carefully  
+- Make sure your Django project defines at least one `urlpattern`
+- Once setup, you’re good to go!
+
+---
+
+## Duck Official Site
+
+Visit: [https://duckframework.xyz](https://duckframework.xyz)    
+Docs: [https://docs.duckframework.xyz](https://docs.duckframework.xyz)
+
+---
+
+## 🚀 Premium Duck Components Coming Soon!
+>  
+> All our UI components are currently free and open source. Stay tuned for upcoming Pro Packs featuring advanced dashboards, e-commerce, and integrations!
+>
+> ⭐ Star this repo to get notified on release!
+
+
+## Contributing & Issues
+
+**Duck** is open to all forms of contribution — financial or technical.
+
+### Sponsorship/Donations:  
+
+Support development at [Open Collective](https://opencollective.com/duckframework/contribute)  
+
+### Report issues:  
+
+Use the [GitHub Issues page](https://github.com/duckframework/duck/issues)
+
+---
+
+> **Duck is updated regularly** — check the repo for improvements and bug fixes.

duckframework-1.0.1/duck/__init__.py

@@ -0,0 +1,61 @@
+"""
+**Duck** is a powerful, open-source, full-fledged Python-based **web server**, **framework**, and **reverse proxy** designed for building modern, customizable web applications — from small sites to large-scale platforms.
+
+With **Duck**, developers can quickly deploy secure, high-performance applications with minimal 
+configuration. Ideal for creating scalable, secure, and customizable **web solutions**, **Duck** 
+streamlines the development process while ensuring top-notch security and performance.  
+
+> **Duck is not a small or mini web framework, it is a full-fledged framework which makes you do almost everything!**
+
+## Quick Start Example
+
+To start using Duck, initialize an ``App`` instance with your desired port and address, 
+then run the application:
+
+```py
+from duck.app import App
+
+app = App(port=5000, addr='127.0.0.1', domain='localhost')
+
+if __name__ == '__main__':
+    app.run()
+```
+"""
+import sys
+import pathlib
+
+from duck.version import version
+from duck.compat import apply_backward_compatibility
+from duck.utils.threading.patch import patch_threading
+
+
+__author__ = "Brian Musakwa"
+__email__ = "digreatbrian@gmail.com"
+__version__ = version
+
+
+# Patch threading module to add more functionality like getting parent threads
+patch_threading()
+
+# Apply backward compatibility (if applicable)
+apply_backward_compatibility()
+
+# Add current directory or parent directory to pythonpath
+# This is critical for resolving modules inside the project.
+original_curdir = curdir = pathlib.Path(".").resolve()
+original_curdir = str(original_curdir)
+curdir_endswith_web = False
+
+if curdir.parts[-1] == "web":
+    # Maybe we are inside `web` directory e.g. someapp/web so 
+    # lets add the basedir/parent instead
+    curdir = curdir.parent
+    curdir_endswith_web = True
+
+if curdir not in sys.path:
+    sys.path.insert(0, str(curdir))
+    
+    if curdir_endswith_web and original_curdir not in sys.path:
+        # Also add the original directory as second to the stripped curdir
+        if original_curdir not in sys.path:
+            sys.path.insert(1, original_curdir)