Nexom 0.1.3__py3-none-any.whl

nexom/web/request.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+from typing import Any, Mapping
+from http.cookies import SimpleCookie
+
+from .cookie import RequestCookies
+
+
+WSGIEnviron = Mapping[str, Any]
+
+
+class Request:
+    """
+    Represents an HTTP request constructed from a WSGI environ.
+    """
+
+    def __init__(self, environ: WSGIEnviron) -> None:
+        self.environ: WSGIEnviron = environ
+
+        self.method: str = environ.get("REQUEST_METHOD", "GET")
+        self.path: str = environ.get("PATH_INFO", "").lstrip("/")
+        self.query: str = environ.get("QUERY_STRING", "")
+        self.headers: dict[str, str] = {
+            k[5:].replace("_", "-"): v
+            for k, v in environ.items()
+            if k.startswith("HTTP_")
+        }
+
+        self.cookie: RequestCookies | None = self._parse_cookies()
+        self._body: bytes | None = None
+
+    def _parse_cookies(self) -> RequestCookies | None:
+        cookie_header = self.environ.get("HTTP_COOKIE")
+        if not cookie_header:
+            return None
+
+        simple_cookie = SimpleCookie()
+        simple_cookie.load(cookie_header)
+
+        cookies = {
+            key: morsel.value
+            for key, morsel in simple_cookie.items()
+        }
+
+        rc = RequestCookies(**cookies)
+        rc.default = None
+        return rc
+
+    def read_body(self) -> bytes:
+        """
+        Read and cache the request body.
+        """
+        if self._body is not None:
+            return self._body
+
+        length = int(self.environ.get("CONTENT_LENGTH") or 0)
+        if length <= 0:
+            self._body = b""
+            return self._body
+
+        self._body = self.environ["wsgi.input"].read(length)
+        return self._body

nexom/web/response.py

@@ -0,0 +1,146 @@
+from __future__ import annotations
+
+from typing import Iterable, Optional
+from importlib import resources
+import json
+
+from .http_status_codes import http_status_codes
+
+
+Header = tuple[str, str]
+
+
+class Response:
+    """
+    Represents an HTTP response.
+    """
+
+    def __init__(
+        self,
+        body: str | bytes = b"",
+        status: int = 200,
+        headers: Iterable[Header] | None = None,
+        cookie: str | None = None,
+        content_type: str = "text/html",
+        charset: str = "utf-8",
+        include_charset: bool = False
+    ) -> None:
+        self.charset: str = charset
+        self.include_charset: bool = include_charset
+
+        if isinstance(body, str):
+            self.body: bytes = body.encode(charset)
+            self.is_text: bool = True
+        else:
+            self.body = body
+            self.is_text = False
+
+        self.status_code: int = status
+
+        from .http_status_codes import http_status_codes
+        self.status_text: str = f"{status} {http_status_codes.get(status, '')}".strip()
+
+        ct = content_type
+        if include_charset and (ct.startswith("text/") or ct == "application/json"):
+            ct = f"{ct}; charset={charset}"
+
+        self.headers: list[Header] = list(headers) if headers else [("Content-Type", ct)]
+
+        if cookie:
+            self.headers.append(("Set-Cookie", cookie))
+
+    def __iter__(self):
+        """
+        Allow Response to be returned directly from WSGI apps.
+        """
+        yield self.body
+
+class HtmlResponse(Response):
+    def __init__(
+        self,
+        body: str | bytes = b"",
+        status: int = 200,
+        headers: Iterable[Header] | None = None,
+        cookie: str | None = None,
+        *,
+        charset: str = "utf-8",
+        include_charset: bool = True,
+    ) -> None:
+        super().__init__(
+            body=body,
+            status=status,
+            headers=headers,
+            cookie=cookie,
+            content_type="text/html",
+            charset=charset,
+            include_charset=include_charset,
+        )
+
+
+class JsonResponse(Response):
+    def __init__(
+        self,
+        body: Optional[dict] = None,
+        status: int = 200,
+        headers: Iterable[Header] | None = None,
+        cookie: str | None = None,
+        *,
+        charset: str = "utf-8",
+        include_charset: bool = True,
+    ) -> None:
+        if body is None:
+            body = {}
+
+        content_type = "application/json"
+        if include_charset:
+            content_type = f"{content_type}; charset={charset}"
+
+        jb = json.dumps(body, ensure_ascii=False).encode(charset)
+
+        super().__init__(
+            body=jb,
+            status=status,
+            headers=headers,
+            cookie=cookie,
+            content_type=content_type,
+            charset=charset,
+            include_charset=False,  # ここは自前で付けたからFalse
+        )
+
+class Redirect(Response):
+    """
+    HTTP redirect response (302).
+    """
+
+    def __init__(self, location: str) -> None:
+        super().__init__(
+            body=b"",
+            status=302,
+            headers=[("Location", location)],
+        )
+
+
+class ErrorResponse(Response):
+    """
+    HTML error response rendered from template.
+    """
+
+    def __init__(self, status: int, message: str) -> None:
+        html = self._render(status, message)
+        super().__init__(html, status=status)
+
+    @staticmethod
+    def _render(status: int, message: str) -> str:
+        status_text = f"{status} {http_status_codes.get(status, '')}".strip()
+
+        template = (
+            resources.files("nexom.assets.error_page")
+            .joinpath("error.html")
+            .read_text(encoding="utf-8")
+        )
+
+        return (
+            template
+            .replace("__STATUS__", status_text)
+            .replace("__MESSAGE__", message)
+        )

nexom/web/template.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+from ..engine.object_html_render import HTMLDoc, HTMLDocLib, ObjectHTML
+from ..core.error import TemplateNotFoundError, TemplateInvalidNameError, TemplatesNotDirError
+
+_SEG_RE = re.compile(r"^[A-Za-z0-9_]+$")
+
+
+@dataclass(frozen=True)
+class TemplateEntry:
+    name: str
+    path: Path
+
+
+class _TemplateAccessor:
+    """
+    Callable attribute-chain proxy.
+
+    Examples:
+        templates.default(title="x")        -> templates.render("default", title="x")
+        templates.layout.base(title="x")    -> templates.render("layout.base", title="x")
+    """
+
+    def __init__(self, templates: ObjectHTMLTemplates, name: str) -> None:  # type: ignore[name-defined]
+        self._templates = templates
+        self._name = name
+
+    def __getattr__(self, part: str) -> _TemplateAccessor:
+        if not _SEG_RE.match(part):
+            # Attribute access only supports valid segments by design.
+            raise AttributeError(part)
+        return _TemplateAccessor(self._templates, f"{self._name}.{part}")
+
+    def __call__(self, **kwargs: str) -> str:
+        return self._templates.render(self._name, **kwargs)
+
+    def __repr__(self) -> str:
+        return f"<TemplateAccessor name='{self._name}'>"
+
+
+class ObjectHTMLTemplates:
+    """
+    Loads all *.html templates under base_dir and renders them using ObjectHTML.
+
+    Public API:
+        render("a.b", **kwargs) -> str
+
+    Sugar:
+        templates.a.b(**kwargs) -> render("a.b", **kwargs)
+    """
+
+    def __init__(self, base_dir: str) -> None:
+        self.base_dir = str(base_dir)
+        self._base_path = Path(self.base_dir).resolve()
+
+        if not self._base_path.exists() or not self._base_path.is_dir():
+            raise TemplatesNotDirError(self.base_dir)
+
+        lib = HTMLDocLib()
+        for entry in self._scan_templates(self._base_path):
+            html_text = entry.path.read_text(encoding="utf-8")
+            lib.append(HTMLDoc(entry.name, html_text))
+
+        self._engine = ObjectHTML(lib=lib)
+
+    def __getattr__(self, name: str) -> _TemplateAccessor:
+        # Called only when normal attribute lookup fails.
+        if not _SEG_RE.match(name):
+            raise AttributeError(name)
+        return _TemplateAccessor(self, name)
+
+    def render(self, name: str, **kwargs: str) -> str:
+        doc = self._engine.lib.get(name)
+        if not doc:
+            raise TemplateNotFoundError(name)
+        return self._engine.render(name, **kwargs)
+
+    def _scan_templates(self, root: Path) -> list[TemplateEntry]:
+        entries: list[TemplateEntry] = []
+
+        for path in root.rglob("*.html"):
+            if not path.is_file():
+                continue
+
+            rel = path.relative_to(root)
+            name = self._path_to_template_name(rel)
+            entries.append(TemplateEntry(name=name, path=path))
+
+        return entries
+
+    def _path_to_template_name(self, rel_path: Path) -> str:
+        parts = list(rel_path.parts)
+        if not parts:
+            raise TemplateInvalidNameError(str(rel_path))
+
+        filename = parts[-1]
+        if not filename.endswith(".html"):
+            raise TemplateInvalidNameError(str(rel_path))
+
+        stem = filename[:-5]
+        dir_parts = parts[:-1]
+
+        for seg in dir_parts:
+            if not _SEG_RE.match(seg):
+                raise TemplateInvalidNameError(str(rel_path))
+
+        if not _SEG_RE.match(stem):
+            raise TemplateInvalidNameError(str(rel_path))
+
+        return ".".join([*dir_parts, stem])

nexom-0.1.3.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: Nexom
+Version: 0.1.3
+Summary: Lightweight Python Web Framework (WSGI)
+Author: TouriAida
+License: MIT License
+        
+        Copyright (c) 2026 TouriAida
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://nexom.ceez7.com
+Project-URL: Repository, https://github.com/ait913/Nexom
+Project-URL: Issues, https://github.com/ait913/Nexom/issues
+Keywords: wsgi,web,framework
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+
+# Nexom
+Lightweight Python Web Framework (WSGI)
+
+Nexomは短いコードで最低限動作し、シンプルで理解のしやすい設計・構造を目指しています。
+また細かい仕様も変更でき、多様な処理に対応します。
+
+## はじめる
+最初のサーバーを起動するには、3つの手順が必要です。
+
+1. ディレクトリを作成
+2. nexomをpipでインストール、サーバーのビルド
+3. 起動
+
+### 1.ディレクトリの作成
+**準備**
+用意していない場合はディレクトリを作成し、仮想環境も準備てください
+```
+mkdir sample
+cd sample
+
+python -m venv venv
+source venv/bin/activate
+```
+### 2.npipでインストール、サーバーのビルド
+**インストール**
+nexomをインストールします。
+※まだベータ版のため、最新のバージョンを確認してください。
+```
+pip install nexom==0.1.4
+```
+**テンプレートサーバーのビルド**
+サーバーを置きたいディレクトリ上で、以下のコマンドを実行してください(sampleは自由)
+```
+python -m nexom build-server sample
+```
+
+### 3.起動
+以下のコマンドを起動します。
+```
+gunicorn wsgi:app
+```
+ブラウザからアクセスできるようになります。
+デフォルトのポートは8080です。
+[httpls://localhost:8080](httpls://localhost:8080)
+ポートなどの設定は `config.py` から変更してください。
+
+## Nginx等使用して外部公開する
+`config.py` で指定したポートにプロキシしてください。
+```
+server {
+    listen 443 ssl;
+        server_name nexom.ceez7.com;
+
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+        location / {
+                proxy_pass http://localhost:8080;
+        }
+}
+```
+
+## Systemdに登録して自動起動する
+**Ubuntuの場合**
+1. `/etc/systemd/system` に、 `your_server_name.service` を作成します。
+2. `your_server_name.service` に以下を書き込みます。(これは一例です。環境に合わせて設定してください。)
+
+サーバーのディレクトリが `/home/ubuntu/nexom` にある場合
+```
+[Unit]
+Description=Nexom Web Freamework
+After=network.target
+
+[Service]
+User=www-data
+Group=www-data
+WorkingDirectory=/home/ubuntu/nexom
+Environment="/home/ubuntu/nexom/venv/bin"
+ExecStart=/home/ubuntu/nexom/venv/bin/gunicorn wsgi:app
+[Install]
+WantedBy=multi-user.target
+```
+
+以下のコマンドを実行します
+```
+sudo systemd daemon-reload
+sudo systemd enable your_server_name
+sudo systemd start your_server_name
+```
+
+### テンプレートユニットを活用して複数のサーバーを効率的に管理
+以下の構成でサーバーが建てられていたとします。
+```
+/home/ubuntu/BananaProject/
+└─ web/
+   ├─ banana1 (Nexomサーバー)/
+   │  └─ wsgi.py
+   ├─ banana2 (Nexomサーバー)/
+   │  └─ wsgi.py
+   └─ banana3 (Nexomサーバー)/
+      └─ wsgi.py
+```
+この構成の場合、テンプレートユニットを活用し .service ファイルを一枚にまとめられます。
+
+`/etc/systemd/system/banana-project@.service`
+```
+[Unit]
+Description=Nexom Web Server (%i)
+After=network.target
+
+[Service]
+User=www-data
+Group=www-data
+WorkingDirectory=/home/ubuntu/BananaProject/web/%i
+Environment="/home/ubuntu/BananaProject/web/%i/venv/bin"
+ExecStart=/home/ubuntu/BananaProject/web/%i/venv/bin/gunicorn wsgi:app
+[Install]
+WantedBy=multi-user.target
+```
+```
+sudo systemd daemon-reload
+
+sudo systemd enable banana-project@banana1
+sudo systemd enable banana-project@banana2
+sudo systemd enable banana-project@banana3
+
+sudo systemd start banana-project@banana1
+sudo systemd start banana-project@banana2
+sudo systemd start banana-project@banana3
+```
+
+2026 1/24

nexom-0.1.3.dist-info/RECORD

@@ -0,0 +1,39 @@
+nexom/__init__.py,sha256=tkqlHy7lHeCM4OuTb0GJZO3zopx6RcnpdMZE9E6g0_4,367
+nexom/__main__.py,sha256=3W07j3zeXDxh8nmsAN0THLb9tVEB3Gjc2CNA1uYSB4Y,1949
+nexom/assets/error_page/error.html,sha256=KlNyr-57wCEkp9ICSHTAmq4-6mQ0idbI2zgsmBx3MRw,1224
+nexom/assets/server/config.py,sha256=3bWgwlS394JwFSDHfuZasgXPdtJVzSvT99kqCMT_2Zs,509
+nexom/assets/server/gunicorn.conf.py,sha256=NedfqQFONa_p53zevgfRHrypu7aBCc6nCMeiEN1_BtM,377
+nexom/assets/server/router.py,sha256=AxkoOJRE1lRmsA8Xve8RbvCZs6UleEQ4cbP2DzimGrQ,416
+nexom/assets/server/wsgi.py,sha256=CiJJDWibh73a1wkCSuALoWDJ3u8fDDbbrR1bkurNgWE,743
+nexom/assets/server/pages/__init__.py,sha256=DlX9iwM39JaMKfzK4mbgjE2uVMX3ax0wd2mCVnpg0b4,61
+nexom/assets/server/pages/_templates.py,sha256=g77QjqMS9--Pw1P4mNCC2KMyiQI0kKo02ENwgIdE8dU,320
+nexom/assets/server/pages/default.py,sha256=_XCNtj7Z57volVIS4KBhps9TQPYiflPBTv8v3GH2SYM,257
+nexom/assets/server/pages/document.py,sha256=R7r8zBDBfv0vtr82TFcGb60MesKVqDihdGFt03eppVc,245
+nexom/assets/server/pages/__pycache__/__init__.cpython-313.pyc,sha256=O03yzGGSKHVUeAqQVULe0-He2mBqkcVb_UwFF_esNUw,276
+nexom/assets/server/static/dog.jpeg,sha256=qGEhcg48FxRLRISzbmXvw1qvfbdluC_ukM8ZrHg7_XE,6559
+nexom/assets/server/static/style.css,sha256=mDKNWue0uRLdWB0w1RsMSn6h3tHsuTVLuk3xOOJl7X8,566
+nexom/assets/server/templates/base.html,sha256=RVW_63gA1sr7pqNkfB6Djk5an_VFpowahDIHGjfV-Wk,349
+nexom/assets/server/templates/default.html,sha256=EKG9NTYkXngdCiDodSI1Kuic_ZwVwdeRc3VLq6fX5UI,167
+nexom/assets/server/templates/document.html,sha256=16ClimpeqhLnXFNa8nMdMOlXUu8JOw7XxfpjU9DdIFs,6243
+nexom/assets/server/templates/footer.html,sha256=1NZbbarU-CQhs1OPs2MTzhnWu0h7YYiEKDIP_cgIl9I,98
+nexom/assets/server/templates/header.html,sha256=VgkCtCVE1J-eGEYvbBgWSUU-QauEf6xuvweOE-84U9c,75
+nexom/buildTools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nexom/buildTools/build.py,sha256=q4_4seJSH8fmRruDb1LkKAaQTBDtBKqInIJk46i_LMg,3317
+nexom/core/__init__.py,sha256=EsfVI7jSjLWUhwMIWasUDIOdlSHtOsFSJ6WfzkrtY5o,19
+nexom/core/error.py,sha256=YXMYQ-rgMXpId_d7_uxRVNFm-YMu99LjQBImTSTftTY,4148
+nexom/engine/__init__.py,sha256=yorquMUk_CF949j-Tw2hkavz5VpbeQhAQ1pYZbMLIcw,32
+nexom/engine/object_html_render.py,sha256=-99gxYv2m2emv7JvTVuKJCx9V8UpKRpFjmx8Qw5e_8A,6928
+nexom/web/__init__.py,sha256=5Ox2txlSe4M4y353Xi7PymC_bCsFtgP0tjEI6wQfai8,107
+nexom/web/cookie.py,sha256=Ad7TamzkUOGR7VMq4LTSAKATS43ycP7o6KRKOSLhyu4,1940
+nexom/web/http_status_codes.py,sha256=R4ka3n4rijqvfahF5n5kS-Qrg8bZSsrvF8lGnpKWAgY,1934
+nexom/web/middleware.py,sha256=7bHGtEem92QhgULOvTFDFlZ4K719CQgu9RKj1g7XOW8,1429
+nexom/web/path.py,sha256=VcNhPOpVURn5G26iNgI_qU30RnpxUSXceYGLj-yASwA,4299
+nexom/web/request.py,sha256=jNYdEbYCOKmgm_2iPVmB_IwCSCyLWgODBIl1974hSVY,1680
+nexom/web/response.py,sha256=Z94-qXq2mlzhY1QkHPTTNlewac79gBOoV0ClP3h-YRE,3854
+nexom/web/template.py,sha256=qPH0bGSzwn8tNIsPdxVoFZDL5NSO2Yxd6gPXShL2mXg,3589
+nexom-0.1.3.dist-info/licenses/LICENSE,sha256=YbcHyxYLJ5jePeMS_NXpR9yiZjP5skhn32LvcKeknJw,1066
+nexom-0.1.3.dist-info/METADATA,sha256=fX40TNjFNKHmp4wupKEAnKdCrV4ZTQiCBjjhf8bL7tc,5406
+nexom-0.1.3.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+nexom-0.1.3.dist-info/entry_points.txt,sha256=0r1egKZmF1MUo25AKPt-2d55sk5Q_EIBOQwD3JC8RgI,46
+nexom-0.1.3.dist-info/top_level.txt,sha256=mTyUruscL3rqXvYJRo8KGwDM6PWXRzgf4CamLr8LSX4,6
+nexom-0.1.3.dist-info/RECORD,,

nexom-0.1.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nexom-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nexom = nexom.__main__:main

nexom-0.1.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TouriAida
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nexom-0.1.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+nexom