MahmudCore 0.0.1__tar.gz

mahmudcore-0.0.1/MahmudCore/api.py

@@ -0,0 +1,127 @@
+
+import os
+import inspect
+
+from parse import parse
+from webob import Request
+from .response import Response
+from whitenoise import WhiteNoise
+from requests import Session as RequestsSession
+from jinja2 import Environment, FileSystemLoader
+from wsgiadapter import WSGIAdapter as RequestsWSGIAdapter
+
+from .middleware import Middleware
+
+
+class API:
+    def __init__(self, templates_dir="templates", static_dir="static"):
+        self.routes = {}
+        self.exception_handler = None
+
+        self.templates_env = Environment(
+            loader=FileSystemLoader(os.path.abspath(templates_dir))
+        )
+
+        self.whitenoise = WhiteNoise(self.wsgi_app, root=static_dir)
+        self.middleware = Middleware(self)  
+
+
+    def __call__(self, environ, start_response):
+        path_info = environ["PATH_INFO"]
+
+        if path_info.startswith("/static"):
+            environ["PATH_INFO"] = path_info[len("/static"):]
+            return self.whitenoise(environ, start_response)
+        
+        return self.middleware(environ, start_response)  
+
+
+    def add_middleware(self, middleware_cls):
+        self.middleware.add(middleware_cls)
+
+    
+    def wsgi_app(self, environ, start_response):
+        request = Request(environ)
+        response = self.handle_request(request)
+        return response(environ, start_response)  
+
+
+    def add_route(self, path, handler, allowed_methods=None):
+        assert path not in self.routes, f"Route '{path}' already exists."
+
+        if allowed_methods is None:
+            allowed_methods = ["get", "post", "put", "patch", "delete", "options"]
+
+        self.routes[path] = {
+            "handler": handler, 
+            "allowed_methods": [method.lower() for method in allowed_methods]
+        }
+
+
+    def route(self, path, allowed_methods=None):
+        def wrapper(handler):
+            self.add_route(path, handler, allowed_methods) # Reuse add_route logic
+            return handler
+        return wrapper
+    
+
+    def find_handler(self, request_path):
+        for path, handler_data in self.routes.items():
+            parse_result = parse(path, request_path)
+            if parse_result is not None:
+                return handler_data, parse_result.named
+        return None, None
+    
+
+    def handle_request(self, request):
+        response = Response()
+        handler_data, kwargs = self.find_handler(request_path=request.path)
+        
+        try:
+            if handler_data is not None:
+                handler = handler_data["handler"]
+                allowed_methods = handler_data["allowed_methods"]
+                
+                if inspect.isclass(handler):
+                    # class-based handler — pick method by HTTP verb
+                    handler = getattr(handler(), request.method.lower(), None)
+                    if handler is None:
+                        raise AttributeError("Method not allowed", request.method)
+                else:
+                    # function-based handler — check allowed methods list
+                    if request.method.lower() not in allowed_methods:
+                        raise AttributeError("Method not allowed", request.method)
+                
+                handler(request, response, **kwargs)
+                
+            else:
+                self.default_response(response)
+
+        except Exception as e:
+            if self.exception_handler is None:
+                raise e
+            else:
+                self.exception_handler(request, response, e)
+        
+        return response
+    
+
+    def default_response(self, response):
+        response.status_code = 404
+        response.text = "Request Not found"
+
+
+    def add_exception_handler(self, exception_handler):
+        self.exception_handler = exception_handler
+
+
+    def template(self, template_name, context=None):
+        if context is None:
+            context = {}    
+        return self.templates_env.get_template(template_name).render(**context)
+    
+
+    def test_session(self, base_url="http://127.0.0.1:8082"):
+        session = RequestsSession()
+        session.mount(prefix=base_url, adapter=RequestsWSGIAdapter(self))
+        return session

mahmudcore-0.0.1/MahmudCore/middleware.py

@@ -0,0 +1,27 @@
+
+from webob import Request
+
+class Middleware:
+    def __init__(self, app):
+        self.app = app
+
+    def __call__(self, environ, start_response):
+        request = Request(environ)
+        response = self.handle_request(request)
+        return response(environ, start_response)
+
+    def add(self, middleware_cls):
+        self.app = middleware_cls(self.app)
+
+    def process_request(self, req):
+        pass
+
+    def process_response(self, req, resp):
+        pass
+
+    def handle_request(self, request):
+        self.process_request(request)
+        response = self.app.handle_request(request)
+        self.process_response(request, response)
+        
+        return response

mahmudcore-0.0.1/MahmudCore/response.py

@@ -0,0 +1,40 @@
+
+import json
+from webob import Response as WebObResponse
+
+
+class Response:
+    def __init__(self):
+        self.json = None
+        self.html = None
+        self.text = None
+        self.content_type = None
+        self.body = b''
+        self.status_code = 200
+        self.headers = {} 
+
+    def __call__(self, environ, start_response):
+        self.set_body_and_content_type()
+        
+        response = WebObResponse(
+            body=self.body, content_type=self.content_type, status=self.status_code
+        )
+
+        # Apply any custom headers
+        for key, value in self.headers.items():
+            response.headers[key] = value
+            
+        return response(environ, start_response)
+
+    def set_body_and_content_type(self):
+        if self.json is not None:
+            self.body = json.dumps(self.json).encode("UTF-8")
+            self.content_type = "application/json"
+
+        if self.html is not None:
+            self.body = self.html.encode()
+            self.content_type = "text/html"
+
+        if self.text is not None:
+            self.body = self.text.encode()
+            self.content_type = "text/plain"

mahmudcore-0.0.1/MahmudCore.egg-info/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: MahmudCore
+Version: 0.0.1
+Summary: MahmudCore — a Python web framework built from scratch for learning core web framework concepts
+Home-page: https://github.com/dear-mahmud-bd/python-framework-from-scratch
+Author: Md. Mahmudul Hasan
+Author-email: dearmahmud.bd@gmail.com
+License: MIT
+Keywords: wsgi web framework python learning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+Requires-Dist: webob==1.8.9
+Requires-Dist: parse==1.21.1
+Requires-Dist: requests==2.33.1
+Requires-Dist: requests-wsgi-adapter==0.4.1
+Requires-Dist: Jinja2==3.1.6
+Requires-Dist: whitenoise==6.12.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: gunicorn; extra == "dev"
+Requires-Dist: waitress; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+MahmudCore — a Python web framework built from scratch for learning core web framework concepts

mahmudcore-0.0.1/MahmudCore.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+setup.py
+MahmudCore/__init__.py
+MahmudCore/api.py
+MahmudCore/middleware.py
+MahmudCore/response.py
+MahmudCore.egg-info/PKG-INFO
+MahmudCore.egg-info/SOURCES.txt
+MahmudCore.egg-info/dependency_links.txt
+MahmudCore.egg-info/requires.txt
+MahmudCore.egg-info/top_level.txt

mahmudcore-0.0.1/MahmudCore.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mahmudcore-0.0.1/MahmudCore.egg-info/requires.txt

@@ -0,0 +1,12 @@
+webob==1.8.9
+parse==1.21.1
+requests==2.33.1
+requests-wsgi-adapter==0.4.1
+Jinja2==3.1.6
+whitenoise==6.12.0
+
+[dev]
+pytest
+pytest-cov
+gunicorn
+waitress

mahmudcore-0.0.1/MahmudCore.egg-info/top_level.txt

@@ -0,0 +1 @@
+MahmudCore

mahmudcore-0.0.1/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: MahmudCore
+Version: 0.0.1
+Summary: MahmudCore — a Python web framework built from scratch for learning core web framework concepts
+Home-page: https://github.com/dear-mahmud-bd/python-framework-from-scratch
+Author: Md. Mahmudul Hasan
+Author-email: dearmahmud.bd@gmail.com
+License: MIT
+Keywords: wsgi web framework python learning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+Requires-Dist: webob==1.8.9
+Requires-Dist: parse==1.21.1
+Requires-Dist: requests==2.33.1
+Requires-Dist: requests-wsgi-adapter==0.4.1
+Requires-Dist: Jinja2==3.1.6
+Requires-Dist: whitenoise==6.12.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: gunicorn; extra == "dev"
+Requires-Dist: waitress; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+MahmudCore — a Python web framework built from scratch for learning core web framework concepts

mahmudcore-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mahmudcore-0.0.1/setup.py

@@ -0,0 +1,104 @@
+import io
+import os
+
+from setuptools import find_packages, setup
+
+# ─── Package metadata ─────────────────────────────────────────────────────────
+
+NAME = "MahmudCore"
+DESCRIPTION = "MahmudCore — a Python web framework built from scratch for learning core web framework concepts"
+URL = "https://github.com/dear-mahmud-bd/python-framework-from-scratch"   
+EMAIL = "dearmahmud.bd@gmail.com"
+AUTHOR = "Md. Mahmudul Hasan"
+REQUIRES_PYTHON = ">=3.8.0"    # 3.6 and 3.7 are end-of-life, no point supporting them
+VERSION = "0.0.1"
+
+# ─── Runtime dependencies ─────────────────────────────────────────────────────
+# These get installed automatically when someone does: pip install mahmudcore
+
+REQUIRED = [
+    "webob==1.8.9",
+    "parse==1.21.1",
+    "requests==2.33.1",
+    "requests-wsgi-adapter==0.4.1",
+    "Jinja2==3.1.6",
+    "whitenoise==6.12.0",
+]
+
+# ─── Optional / development dependencies ──────────────────────────────────────
+# Install with: pip install mahmudcore[dev]
+
+EXTRAS = {
+    "dev": [
+        "pytest",
+        "pytest-cov",
+        "gunicorn",
+        "waitress",
+    ]
+}
+
+# ─── Read long description from README ────────────────────────────────────────
+
+here = os.path.abspath(os.path.dirname(__file__))
+
+try:
+    with io.open(os.path.join(here, "README.md"), encoding="utf-8") as f:
+        long_description = "\n" + f.read()
+except FileNotFoundError:
+    long_description = DESCRIPTION
+
+# ─── Version resolution ───────────────────────────────────────────────────────
+
+about = {}
+if not VERSION:
+    # read version from mahmudcore/__version__.py if VERSION not set above
+    project_slug = NAME.lower().replace("-", "_").replace(" ", "_")
+    with open(os.path.join(here, project_slug, "__version__.py")) as f:
+        exec(f.read(), about)
+else:
+    about["__version__"] = VERSION
+
+# ─── Setup ────────────────────────────────────────────────────────────────────
+
+setup(
+    name=NAME,
+    version=about["__version__"],
+    description=DESCRIPTION,
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author=AUTHOR,
+    author_email=EMAIL,
+    url=URL,                          # ← added
+    python_requires=REQUIRES_PYTHON,
+    packages=find_packages(exclude=["test_*", "tests*"]),
+    install_requires=REQUIRED,
+    extras_require=EXTRAS,            # ← added dev dependencies
+    include_package_data=True,
+    license="MIT",
+    classifiers=[
+        # project maturity
+        "Development Status :: 3 - Alpha",
+
+        # who it's for
+        "Intended Audience :: Developers",
+        "Intended Audience :: Education",     # ← added, since this is a learning framework
+
+        # license
+        "License :: OSI Approved :: MIT License",
+
+        # python versions supported
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+
+        # what it does
+        "Topic :: Internet :: WWW/HTTP :: WSGI",
+        "Topic :: Internet :: WWW/HTTP :: WSGI :: Application",
+        "Topic :: Software Development :: Libraries :: Application Frameworks",  # ← added
+    ],
+    setup_requires=["wheel"],
+    keywords="wsgi web framework python learning",   # ← added, helps PyPI search
+)