xhtm 0.6__tar.gz → 0.8__tar.gz

{xhtm-0.6 → xhtm-0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: xhtm
-Version: 0.6
+Version: 0.8
 Summary: Rendering HTML Text
 Home-page: https://github.com/bondbox/xhtm
 Author: Mingzhe Zou
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: xkits-lib>=0.2
 Requires-Dist: xlc>=1.0
 Requires-Dist: jinja2
 

{xhtm-0.6 → xhtm-0.8}/xhtm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: xhtm
-Version: 0.6
+Version: 0.8
 Summary: Rendering HTML Text
 Home-page: https://github.com/bondbox/xhtm
 Author: Mingzhe Zou
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: xkits-lib>=0.2
 Requires-Dist: xlc>=1.0
 Requires-Dist: jinja2
 

{xhtm-0.6 → xhtm-0.8}/xhtm.egg-info/requires.txt

@@ -1,2 +1,3 @@
+xkits-lib>=0.2
 xlc>=1.0
 jinja2

{xhtm-0.6 → xhtm-0.8}/xhtml/attribute.py

@@ -1,7 +1,7 @@
 # coding:utf-8
 
 __project__ = "xhtm"
-__version__ = "0.6"
+__version__ = "0.8"
 __urlhome__ = "https://github.com/bondbox/xhtm"
 __description__ = "Rendering HTML Text"
 

{xhtm-0.6 → xhtm-0.8}/xhtml/header/headers.py

@@ -5,6 +5,58 @@ from typing import Dict
 from typing import Iterator
 
 
+class RequestLine():
+    """HTTP requests
+
+    Reference:
+        https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Messages#http_requests
+    """
+
+    def __init__(self, request_line: str):
+        method, target, protocol = request_line.split()
+        self.__protocol: str = protocol.strip()
+        self.__method: str = method.strip()
+        self.__target: str = target.strip()
+
+    @property
+    def protocol(self) -> str:
+        return self.__protocol
+
+    @property
+    def method(self) -> str:
+        return self.__method
+
+    @property
+    def target(self) -> str:
+        return self.__target
+
+
+class StatusLine():
+    """HTTP responses
+
+    Reference:
+        https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Messages#http_responses
+    """
+
+    def __init__(self, status_line: str):
+        protocol, status_code, status_text = status_line.split(maxsplit=2)
+        self.__status_code: int = int(status_code.strip())
+        self.__status_text: str = status_text.strip()
+        self.__protocol: str = protocol.strip()
+
+    @property
+    def protocol(self) -> str:
+        return self.__protocol
+
+    @property
+    def status_code(self) -> int:
+        return self.__status_code
+
+    @property
+    def status_text(self) -> str:
+        return self.__status_text
+
+
 class Headers(Enum):
     """HTTP headers
 

{xhtm-0.6 → xhtm-0.8}/xhtml/locale/template.py

@@ -2,6 +2,7 @@
 
 from os.path import join
 
+from xkits_lib import TimeUnit
 from xlc.language.message import Message
 from xlc.language.segment import Section
 
@@ -10,9 +11,9 @@ from xhtml.template import Template
 
 
 class LocaleTemplate(Template):
-    def __init__(self, base: str):
+    def __init__(self, base: str, lifetime: TimeUnit = 0):
         self.__message: Message = Message(join(base, "locale"))
-        super().__init__(base)
+        super().__init__(base=base, lifetime=lifetime)
 
     def search(self, accept_language: str, section: str) -> Section:
         language: AcceptLanguage = AcceptLanguage(accept_language)

{xhtm-0.6 → xhtm-0.8}/xhtml/resource/__init__.py

@@ -9,6 +9,9 @@ from os.path import splitext
 from typing import Optional
 
 from jinja2 import Environment
+from xkits_lib import CacheMiss
+from xkits_lib import CachePool
+from xkits_lib import TimeUnit
 
 BASE_DIR = dirname(abspath(__file__))
 
@@ -19,6 +22,7 @@ class FileResource():
             message = f"No such file: {path}"
             raise FileNotFoundError(message)
         self.__ext: str = splitext(path)[1]
+        self.__data: Optional[bytes] = None
         self.__path: str = path
 
     @property
@@ -29,13 +33,14 @@ class FileResource():
     def path(self) -> str:
         return self.__path
 
-    def loads(self) -> str:
-        with open(self.path, "r", encoding="utf-8") as rhdl:
-            return rhdl.read()
-
     def loadb(self) -> bytes:
-        with open(self.path, "rb") as rhdl:
-            return rhdl.read()
+        if self.__data is None:
+            with open(self.path, "rb") as rhdl:
+                self.__data = rhdl.read()
+        return self.__data
+
+    def loads(self, encoding: str = "utf-8") -> str:
+        return self.loadb().decode(encoding=encoding)
 
     def render(self, **context: str) -> str:
         """render html template"""
@@ -45,7 +50,8 @@ class FileResource():
 class Resource():
     FAVICON: str = "favicon.ico"
 
-    def __init__(self, base: Optional[str] = None):
+    def __init__(self, base: Optional[str] = None, lifetime: TimeUnit = 0):
+        self.__cache: CachePool[str, FileResource] = CachePool(lifetime)
         self.__base: str = base if base and isdir(base) else BASE_DIR
 
     @property
@@ -56,13 +62,23 @@ class Resource():
     def favicon(self) -> FileResource:
         return self.seek(self.FAVICON)
 
-    def find(self, *args: str) -> Optional[str]:
+    def find(self, *args: str) -> Optional[FileResource]:
         def check(base: str, real: str) -> Optional[str]:
             return path if isfile(path := join(base, real)) else check(BASE_DIR, real) if base != BASE_DIR else None  # noqa:E501
-        return check(self.base, join(*args))
+
+        if (real := join(*args)) in self.__cache:
+            try:
+                return self.__cache.get(real)
+            except CacheMiss:
+                pass
+
+        resource: Optional[FileResource] = None
+        if isinstance(path := check(self.base, real), str):
+            resource = FileResource(path)
+            self.__cache.put(real, resource)
+        return resource
 
     def seek(self, *args: str) -> FileResource:
-        path: Optional[str] = self.find(*args)
-        if not isinstance(path, str):
+        if not isinstance(resource := self.find(*args), FileResource):
             raise FileNotFoundError(f"No such file: {join(*args)}")
-        return FileResource(path)
+        return resource

{xhtm-0.6 → xhtm-0.8}/xhtml/template/__init__.py

@@ -5,6 +5,8 @@ from os.path import dirname
 from os.path import isdir
 from typing import Optional
 
+from xkits_lib import TimeUnit
+
 from xhtml.resource import Resource
 
 BASE_DIR = dirname(abspath(__file__))
@@ -13,5 +15,5 @@ BASE_DIR = dirname(abspath(__file__))
 class Template(Resource):
     FAVICON: str = "favicon.ico"
 
-    def __init__(self, base: Optional[str] = None):
-        super().__init__(base if base and isdir(base) else BASE_DIR)
+    def __init__(self, base: Optional[str] = None, lifetime: TimeUnit = 0):
+        super().__init__(base if base and isdir(base) else BASE_DIR, lifetime)