PyWSGIRef 1.1.1__tar.gz → 1.1.3__tar.gz

{pywsgiref-1.1.1/src/PyWSGIRef.egg-info → pywsgiref-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyWSGIRef
-Version: 1.1.1
+Version: 1.1.3
 Summary: easy server-setup
 Author-email: Leander Kafemann <leander@kafemann.berlin>
 Project-URL: Homepage, https://github.com/LeanderKafemann/PyWSGIRef
@@ -13,6 +13,7 @@ License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: typing
 Requires-Dist: legacy-cgi
+Requires-Dist: naturalsize
 Dynamic: license-file
 
 # PyWSGIRef
@@ -51,10 +52,10 @@ from PyWSGIRef import *
 # Create a WSGI application object
 def simple_app(path: str) -> str:
 	return f"Hello, you visited {path}!"
-application = makeWSGIApp(simple_app)
+application = makeApplicationObject(simple_app)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 The <code>makeWSGIApp</code> function requires a callable that takes a single argument (the path) and returns a string response.<br/>
@@ -77,10 +78,10 @@ def advanced_app(path: str, form: FieldStorage) -> str, str, str:
 		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
 	else:
 		return "Page not found", "text/html", "404 Not Found"
-application = makeWSGIApp(advanced_app, advanced=True, setAdvancedHeaders=True)
+application = makeApplicationObject(advanced_app, advanced=True, setAdvancedHeaders=True)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 You can also use your own application object instead of the one created by <code>makeWSGIApp</code>.
@@ -151,7 +152,9 @@ pyhtml_ = """<{{evalPyHTML}}>
 pyhtml = PyHTML(pyhtml_)
 html = pyhtml.decoded()
 ```
-, which is actually automatically done by PyWSGIRef.
+, which is actually automatically done by PyWSGIRef.<br/>
+The <code><{{evalPyHTML}}></code> phrase at the beginning of the document includes a Doctype announcement,<br/>
+a html and head block and some common meta phrases as utf-8 encoding or device-width scaling.
 ### Others
 Use the following to get information about your release and the author of the module:
 ```python
@@ -159,4 +162,13 @@ from PyWSGIRef import about
 
 about()
 ```
+### Curious?
+Join the <b>BETA</b> group to get new features even earlier!<br/>
+Note that BETA features may not be tested when using them.
+```python
+from PyWSGIRef import BETA
+
+#enable beta mode
+BETA.enable()
+```
 ### More coming soon

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/README.md

@@ -34,10 +34,10 @@ from PyWSGIRef import *
 # Create a WSGI application object
 def simple_app(path: str) -> str:
 	return f"Hello, you visited {path}!"
-application = makeWSGIApp(simple_app)
+application = makeApplicationObject(simple_app)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 The <code>makeWSGIApp</code> function requires a callable that takes a single argument (the path) and returns a string response.<br/>
@@ -60,10 +60,10 @@ def advanced_app(path: str, form: FieldStorage) -> str, str, str:
 		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
 	else:
 		return "Page not found", "text/html", "404 Not Found"
-application = makeWSGIApp(advanced_app, advanced=True, setAdvancedHeaders=True)
+application = makeApplicationObject(advanced_app, advanced=True, setAdvancedHeaders=True)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 You can also use your own application object instead of the one created by <code>makeWSGIApp</code>.
@@ -134,7 +134,9 @@ pyhtml_ = """<{{evalPyHTML}}>
 pyhtml = PyHTML(pyhtml_)
 html = pyhtml.decoded()
 ```
-, which is actually automatically done by PyWSGIRef.
+, which is actually automatically done by PyWSGIRef.<br/>
+The <code><{{evalPyHTML}}></code> phrase at the beginning of the document includes a Doctype announcement,<br/>
+a html and head block and some common meta phrases as utf-8 encoding or device-width scaling.
 ### Others
 Use the following to get information about your release and the author of the module:
 ```python
@@ -142,4 +144,13 @@ from PyWSGIRef import about
 
 about()
 ```
+### Curious?
+Join the <b>BETA</b> group to get new features even earlier!<br/>
+Note that BETA features may not be tested when using them.
+```python
+from PyWSGIRef import BETA
+
+#enable beta mode
+BETA.enable()
+```
 ### More coming soon

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "PyWSGIRef"
-version = "1.1.1"
+version = "1.1.3"
 authors = [
   {name="Leander Kafemann", email="leander@kafemann.berlin" },
 ]
@@ -16,6 +16,7 @@ dependencies = [
     "requests",
     "typing",
     "legacy-cgi",
+    "naturalsize",
 ]
 
 [project.urls]

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/src/PyWSGIRef/__init__.py

@@ -10,12 +10,13 @@ from .exceptions import *
 from .pyhtml import PyHTML
 from .defaults import *
 from .templateDict import TemplateDict, OneWayBoolean
+from .beta import BETA
 
 def about():
     """
     Returns information about your release and other projects by LK
     """
-    return {"Version":(1, 1, 1), "Author":"Leander Kafemann", "date":"08.06.2025",\
+    return {"Version":(1, 1, 3), "Author":"Leander Kafemann", "date":"10.06.2025",\
             "recommend":("Büro by LK",  "pyimager by LK"), "feedbackTo": "leander@kafemann.berlin"}
 
 SCHABLONEN = TemplateDict()

pywsgiref-1.1.3/src/PyWSGIRef/beta.py

@@ -0,0 +1,31 @@
+"""
+BETA mode...
+"""
+
+class beta:
+    """
+    BETA mode for PyWSGIRef.
+    """
+    def __init__(self):
+        self._beta = False
+
+    @property
+    def value(self) -> bool:
+        return self._beta
+
+    def enable(self):
+        """
+        Enables BETA mode.
+        """
+        if self._beta:
+            raise ValueError("BETA mode is already enabled.")
+        self._beta = True
+
+BETA = beta()
+
+def enableBetaMode():
+    """
+    Enables BETA mode.
+    """
+    BETA.enable()
+    print("BETA mode enabled.")

pywsgiref-1.1.3/src/PyWSGIRef/commons.py

@@ -0,0 +1,14 @@
+START_REPLACE = """<!DOCTYPE html>
+<html lang="de-de">
+    <head>
+        <meta charset="UTF-8"/>
+        <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+        <meta name="announcement" content="This is a PyWSGIRef generated page."/>
+        """
+
+END_REPLACE = """
+        <p style="font-size: 7px; text-align: center;">Generated by PyWSGIRef</p>
+    </body>
+</html>"""
+
+MODERN_STYLING = """<link rel='stylesheet' href='https://leanderkafemann.github.io/PyWSGIRef-Backend/styling/modernStyling.css'/>"""

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/src/PyWSGIRef/exceptions.py

@@ -28,5 +28,21 @@ class AdvancedHeadersWithoutAdvancedModeError(Exception):
     Raised when advanced headers are set without advanced mode being enabled.
     """
     def __init__(self, message="Advanced headers cannot be set without enabling advanced mode."):
+        self.message = message
+        super().__init__(self.message)
+
+class InvalidIncludePhraseFiletypeError(InvalidFiletypeError):
+    """
+    Raised when an invalid file type is encountered in the include phrase of a PyHTML file.
+    """
+    def __init__(self, message="Invalid file type in include phrase. Only .css, .js, and .json files are allowed."):
+        self.message = message
+        super().__init__(self.message)
+
+class StaticResourceUsageOutsideHeadError(Exception):
+    """
+    Raised when a static resource is tried to include outside the head term of a PyHTML file.
+    """
+    def __init__(self, message="Static resource usage out of <head> term detected."):
         self.message = message
         super().__init__(self.message)

pywsgiref-1.1.3/src/PyWSGIRef/pyhtml.py

@@ -0,0 +1,54 @@
+from naturalsize import replStr, replStrPassage
+
+from .defaults import HELLO_WORLD as DEFAULT
+from .commons import *
+from .exceptions import InvalidIncludePhraseFiletypeError, StaticResourceUsageOutsideHeadError
+from .beta import BETA
+
+class PyHTML:
+    def __init__(self, html: str = DEFAULT):
+        self.html = html
+    def decode(self):
+        """
+        Decodes the HTML content.
+        """
+        self.html = self.html.strip()
+
+        # common html beginning phrase
+        if self.html.startswith("<{{evalPyHTML}}>"):
+            self.html = START_REPLACE + self.html[16:]
+
+        # common html ending phrase
+        if self.html.endswith("<{{evalPyHTML}}>"):
+            self.html = self.html[:-16] + END_REPLACE
+        
+        if BETA.value():
+            # static ressources
+            idx = self.html.find("<{{evalPyHTML-include: ")
+            if idx != -1:
+                idxEnd = self.html.find(" :include-}}>", idx)
+                if idxEnd > self.html.find("</head>"):
+                    raise StaticResourceUsageOutsideHeadError()
+                setIn = ""
+                for i in self.html[idx:idxEnd+12].split(":")[1].strip().split(","):
+                    if i.endswith(".css"):
+                        setIn += "\t\t<link rel='stylesheet' href='{}'/>\n".format(i)
+                    elif i.endswith(".js"):
+                        setIn += "\t\t<script src='{}'></script>\n".format(i)
+                    elif i.endswith(".json"):
+                        setIn += "\t\t<link rel='manifest' href='{}'/>\n".format(i)
+                    else:
+                        raise InvalidIncludePhraseFiletypeError()
+                self.html = replStrPassage(idx, idxEnd+12, self.html, setIn)
+
+            # PyWSGIRef's styling
+            idx = self.html.find("<{{evalPyHTML-modernStyling: true}}>")
+            if idx != -1:
+                self.html = replStrPassage(idx, idx+35, self.html, MODERN_STYLING)
+
+    def decoded(self) -> str:
+        """
+        Returns the decoded HTML content.
+        """
+        self.decode()
+        return self.html

{pywsgiref-1.1.1 → pywsgiref-1.1.3/src/PyWSGIRef.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyWSGIRef
-Version: 1.1.1
+Version: 1.1.3
 Summary: easy server-setup
 Author-email: Leander Kafemann <leander@kafemann.berlin>
 Project-URL: Homepage, https://github.com/LeanderKafemann/PyWSGIRef
@@ -13,6 +13,7 @@ License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: typing
 Requires-Dist: legacy-cgi
+Requires-Dist: naturalsize
 Dynamic: license-file
 
 # PyWSGIRef
@@ -51,10 +52,10 @@ from PyWSGIRef import *
 # Create a WSGI application object
 def simple_app(path: str) -> str:
 	return f"Hello, you visited {path}!"
-application = makeWSGIApp(simple_app)
+application = makeApplicationObject(simple_app)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 The <code>makeWSGIApp</code> function requires a callable that takes a single argument (the path) and returns a string response.<br/>
@@ -77,10 +78,10 @@ def advanced_app(path: str, form: FieldStorage) -> str, str, str:
 		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
 	else:
 		return "Page not found", "text/html", "404 Not Found"
-application = makeWSGIApp(advanced_app, advanced=True, setAdvancedHeaders=True)
+application = makeApplicationObject(advanced_app, advanced=True, setAdvancedHeaders=True)
 
 # Create a WSGI server
-server = makeWSGIServer(application, port=8000)
+server = setUpServer(application, port=8000)
 server.serve_forever()
 ```
 You can also use your own application object instead of the one created by <code>makeWSGIApp</code>.
@@ -151,7 +152,9 @@ pyhtml_ = """<{{evalPyHTML}}>
 pyhtml = PyHTML(pyhtml_)
 html = pyhtml.decoded()
 ```
-, which is actually automatically done by PyWSGIRef.
+, which is actually automatically done by PyWSGIRef.<br/>
+The <code><{{evalPyHTML}}></code> phrase at the beginning of the document includes a Doctype announcement,<br/>
+a html and head block and some common meta phrases as utf-8 encoding or device-width scaling.
 ### Others
 Use the following to get information about your release and the author of the module:
 ```python
@@ -159,4 +162,13 @@ from PyWSGIRef import about
 
 about()
 ```
+### Curious?
+Join the <b>BETA</b> group to get new features even earlier!<br/>
+Note that BETA features may not be tested when using them.
+```python
+from PyWSGIRef import BETA
+
+#enable beta mode
+BETA.enable()
+```
 ### More coming soon

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/src/PyWSGIRef.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 src/PyWSGIRef/__init__.py
 src/PyWSGIRef/__main__.py
+src/PyWSGIRef/beta.py
 src/PyWSGIRef/commons.py
 src/PyWSGIRef/defaults.py
 src/PyWSGIRef/exceptions.py

{pywsgiref-1.1.1 → pywsgiref-1.1.3}/src/PyWSGIRef.egg-info/requires.txt

@@ -1,3 +1,4 @@
 requests
 typing
 legacy-cgi
+naturalsize

pywsgiref-1.1.1/src/PyWSGIRef/commons.py

@@ -1,6 +0,0 @@
-START_REPLACE = """<!DOCTYPE html>
-<html lang="de">
-    <head>
-        <meta charset="UTF-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1.0">
-        """

pywsgiref-1.1.1/src/PyWSGIRef/pyhtml.py

@@ -1,20 +0,0 @@
-from .defaults import HELLO_WORLD as DEFAULT
-from .commons import *
-
-class PyHTML:
-    def __init__(self, html: str = DEFAULT):
-        self.html = html
-    def decode(self):
-        """
-        Decodes the HTML content.
-        """
-        self.html = self.html.strip()
-        if self.html.startswith("<{{evalPyHTML}}>"):
-            self.html = START_REPLACE + self.html[16:]
-
-    def decoded(self) -> str:
-        """
-        Returns the decoded HTML content.
-        """
-        self.decode()
-        return self.html