PyWSGIRef 1.1.20__tar.gz → 1.1.22__tar.gz

{pywsgiref-1.1.20 → pywsgiref-1.1.22}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Leander Kafemann
-
-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.
+MIT License
+
+Copyright (c) 2025-2026 Leander Kafemann
+
+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.

{pywsgiref-1.1.20/src/PyWSGIRef.egg-info → pywsgiref-1.1.22}/PKG-INFO

@@ -1,208 +1,214 @@
-Metadata-Version: 2.4
-Name: PyWSGIRef
-Version: 1.1.20
-Summary: easy server-setup
-Author-email: Leander Kafemann <leander.kafemann+python@icloud.com>
-Project-URL: Homepage, https://github.com/LeanderKafemann/PyWSGIRef
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: legacy-cgi
-Requires-Dist: naturalsize
-Dynamic: license-file
-
-# PyWSGIRef
-easy server-setup
-## Advantage
-Many web services offer simple ways to set up a WSGI webserver.<br/>
-The built-in WSGI server in Python is, however, not very easy to use.<br/>
-PyWSGIRef provides a simple way to set up a WSGI server with minimal code.<br/><br/>
-Also, a problem with many of those web services is that they aren't able to make web requests<br/>
-and it's very slow to read files once the server is running.<br/>
-PyWSGIRef solves this problem by providing a simple way to load PyHTML files from the web or from the local filesystem<br/>
-before the server is running.<br/><br/>
-PyHTML files are HTML files that can contain {}-s for Python formatting or<br/>
-(upcoming) code blocks or shortened HTML, which can be used to create dynamic HTML content.<br/>
-PyWSGIRef also provides a simple way to decode these.
-## Installation
-### Using *pip*
-You can install PyWSGIRef via pip using
-<li>in a commandline:</li><br/>
-
-```bash
-py -m pip install PyWSGIRef
-```
-<br/>
-<li>in a python script:</li><br/>
-
-```python
-import os
-os.system('py -m pip install PyWSGIRef')
-```
-## Usage
-### Setting up the WSGI server
-```python
-from PyWSGIRef import *
-
-# Create a WSGI application object
-def simple_app(path: str) -> str:
-	return f"Hello, you visited {path}!"
-application = makeApplicationObject(simple_app)
-
-# Create a WSGI server
-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/>
-The <code>makeWSGIServer</code> function creates a WSGI server that listens on the specified port (default is 8000)<br/>
-and calls the application object with the environ.<br/>
-You may also specify advanced options in <code>makeWSGIApp</code>:<br/>
-- you can set the <code>advanced</code> parameter to <code>True</code>, so that your application method also gets an FieldStorage type object<br/>
-- you can set the <code>setAdvancedHeaders</code> parameter to <code>True</code>, so that the application method is also able to set status codes and types in the response headers,<br/>
-  which is only possible if the <code>advanced</code> parameter is set to <code>True</code><br/>
-Example:
-```python
-from PyWSGIRef import *
-
-# Create a WSGI application object with advanced options
-def advanced_app(path: str, form: FieldStorage) -> str, str, str:
-	# You can access form data here
-	name = str(form.getvalue('name'))
-	
-	if path == "/hello":
-		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
-	else:
-		return "Page not found", "text/html", "404 Not Found"
-application = makeApplicationObject(advanced_app, advanced=True, setAdvancedHeaders=True)
-
-# Create a WSGI server
-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>.
-### Loading PyHTML
-PyWSGIRef also provides a simple way to load PyHTML files:
-```python
-from PyWSGIRef import *
-
-# load from file
-html = loadFromFile('index.pyhtml')
-
-# load from web
-html = loadFromWeb('https://example.com/index.pyhtml')
-```
-This is useful for serving dynamic HTML content in your WSGI application.<br/>
-The funcs are callable unless you set up a server.<br/>
-You can also add multiple PyHTML files from the web at the same time using the <code>multiWebInit</code> function.
-### Using Templates
-PyWSGIRef also provides a simple way to use templates in your WSGI application:
-```python
-from PyWSGIRef import *
-
-# add template to template dictionary
-# -> saves as PyHTML object
-addSchablone("index", loadedPyHTMLFile)
-
-# load template from dictionary
-# get HTML code from PyHTML object
-html = SCHABLONEN["index"].decoded()
-# use Python formatting
-serverPageContent = html.format("Hello, World!")
-```
-Note that you may only use the <code>addSchablone</code> function before you set up a server.
-### Default HTML templates
-PyWSGIRef comes with some default HTML templates that you can use in your WSGI application.<br/>
-You can access them via the <code>PyWSGIRef.defaults</code>:
-```python
-from PyWSGIRef import *
-
-# load default HTML template
-addSchablone("hello", HELLO_WORLD)
-addSchablone("error", ERROR)
-```
-### __main__ script
-You may produce a simple WSGI server by using either:<br/>
-```python
-from PyWSGIRef import main
-
-main()
-```
-or (from a commandline)
-```bash
-py -m PyWSGIRef
-```
-### Decoding PyHTML
-(more coming soon...)<br/>
-PyWSGIRef provides a simple way to shorten a common HTML beginning phrase in PyHTML:
-```python
-from PyWSGIRef import PyHTML
-
-# Shorten HTML beginning phrase
-pyhtml_ = """<{{evalPyHTML}}>
-		<title>My Page</title>
-	</head>
-	<body>
-		<h1>Hello, World!</h1>
-	</body>
-</html>"""
-pyhtml = PyHTML(pyhtml_)
-html = pyhtml.decoded()
-```
-, 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.<br/><br/>
-PyWSGIRef also provides a simple way to end PyHTML files:<br/>
-just use the <code><{{evalPyHTML}}></code> phrase at the end of the document and<br/>
-PyWSGIRef will automatically add the closing html and body tags.<br/><br/>
-You can also add PyWSGIRef's own, featured modern stylesheet using:<br/>
-<code><{{evalPyHTML-modernStyling: true}}></code> inside the head block of your PyHTML file.<br/><br/>
-You may add your own static resources like CSS or JavaScript files using the <code><{{evalPyHTML-include: ... :include-}}></code> phrase.<br/>
-Different static resources can be included by separating them with a comma.<br/>
-You may include CSS, JS, JSON and ICO files.<br/><br/>
-With the <code><{{evalPyHTML-script: alert('Hello, World!'); :script-}}></code> phrase,<br/>
-you can add a script block anywhere inside your PyHTML file.<br/>
-Using pretty much the same syntax, you can also add a style block using
-<code><{{evalPyHTML-style: body { background-color: lightblue; } :style-}}></code>.
-### Shutting down your server
-You can shut down your server by calling the <code>shutdown</code> method on the server object:
-```python
-from PyWSGIRef import *
-
-# ...
-# Create a WSGI server
-server = setUpServer(application, port=8000)
-
-# Shut down the server
-server.shutdown()
-```
-### Others
-Use the following to get information about your release and the author of the module:
-```python
-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()
-```
-Currently to be tested are:<br/>
-- PyHTML python script blocks<br/>
-- PyHTML python if clause blocks<br/>
-- application object running time measuring<br/>
-- application object counter of access<br/><br/>
-
-
-Please report any bugs you find in the GitHub repository and suggest new features!<br/><br/>
-
-Thanks a lot for helping improving PyWSGIRef!
-### More coming soon
+Metadata-Version: 2.4
+Name: PyWSGIRef
+Version: 1.1.22
+Summary: easy server-setup
+Author-email: Leander Kafemann <leander.kafemann+python@icloud.com>
+Project-URL: Homepage, https://github.com/LeanderKafemann/PyWSGIRef
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: legacy-cgi
+Requires-Dist: naturalsize
+Dynamic: license-file
+
+# PyWSGIRef
+easy server-setup
+## Advantage
+Many web services offer simple ways to set up a WSGI webserver.<br/>
+The built-in WSGI server in Python is, however, not very easy to use.<br/>
+PyWSGIRef provides a simple way to set up a WSGI server with minimal code.<br/><br/>
+Also, a problem with many of those web services is that they aren't able to make web requests<br/>
+and it's very slow to read files once the server is running.<br/>
+PyWSGIRef solves this problem by providing a simple way to load PyHTML files from the web or from the local filesystem<br/>
+before the server is running.<br/><br/>
+PyHTML files are HTML files that can contain {}-s for Python formatting or<br/>
+(upcoming) code blocks or shortened HTML, which can be used to create dynamic HTML content.<br/>
+PyWSGIRef also provides a simple way to decode these.
+## Installation
+### Using *pip*
+You can install PyWSGIRef via pip using
+<li>in a commandline:</li><br/>
+
+```bash
+py -m pip install PyWSGIRef
+```
+<br/>
+<li>in a python script:</li><br/>
+
+```python
+import os
+os.system('py -m pip install PyWSGIRef')
+```
+## Usage
+### Setting up the WSGI server
+```python
+from PyWSGIRef import *
+
+# Create a WSGI application object
+def simple_app(path: str) -> str:
+	return f"Hello, you visited {path}!"
+application = makeApplicationObject(simple_app)
+
+# Create a WSGI server
+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/>
+The <code>makeWSGIServer</code> function creates a WSGI server that listens on the specified port (default is 8000)<br/>
+and calls the application object with the environ.<br/>
+You may also specify advanced options in <code>makeWSGIApp</code>:<br/>
+- you can set the <code>advanced</code> parameter to <code>True</code>, so that your application method also gets an FieldStorage type object<br/>
+- you can set the <code>setAdvancedHeaders</code> parameter to <code>True</code>, so that the application method is also able to set status codes and types in the response headers,<br/>
+  which is only possible if the <code>advanced</code> parameter is set to <code>True</code><br/>
+Example:
+```python
+from PyWSGIRef import *
+
+# Create a WSGI application object with advanced options
+def advanced_app(path: str, form: FieldStorage) -> str, str, str:
+	# You can access form data here
+	name = str(form.getvalue('name'))
+	
+	if path == "/hello":
+		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
+	else:
+		return "Page not found", "text/html", "404 Not Found"
+application = makeApplicationObject(advanced_app, advanced=True, setAdvancedHeaders=True)
+
+# Create a WSGI server
+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>.
+### Loading PyHTML
+PyWSGIRef also provides a simple way to load PyHTML files:
+```python
+from PyWSGIRef import *
+
+# load from file
+html = loadFromFile('index.pyhtml')
+
+# load from web
+html = loadFromWeb('https://example.com/index.pyhtml')
+```
+This is useful for serving dynamic HTML content in your WSGI application.<br/>
+The funcs are callable unless you set up a server.<br/>
+You can also add multiple PyHTML files from the web at the same time using the <code>multiWebInit</code> function.
+### Using Templates
+PyWSGIRef also provides a simple way to use templates in your WSGI application:
+```python
+from PyWSGIRef import *
+
+# add template to template dictionary
+# -> saves as PyHTML object
+addSchablone("index", loadedPyHTMLFile)
+
+# load template from dictionary
+# get HTML code from PyHTML object
+html = SCHABLONEN["index"].decoded()
+# use Python formatting
+serverPageContent = html.format("Hello, World!")
+```
+Note that you may only use the <code>addSchablone</code> function before you set up a server.
+### Default HTML templates
+PyWSGIRef comes with some default HTML templates that you can use in your WSGI application.<br/>
+You can access them via the <code>PyWSGIRef.defaults</code>:
+```python
+from PyWSGIRef import *
+
+# load default HTML template
+addSchablone("hello", HELLO_WORLD)
+addSchablone("error", ERROR)
+```
+### __main__ script
+You may produce a simple WSGI server by using either:<br/>
+```python
+from PyWSGIRef import main
+
+main()
+```
+or (from a commandline)
+```bash
+py -m PyWSGIRef
+```
+### Decoding PyHTML
+(more coming soon...)<br/>
+PyWSGIRef provides a simple way to shorten a common HTML beginning phrase in PyHTML:
+```python
+from PyWSGIRef import PyHTML
+
+# Shorten HTML beginning phrase
+pyhtml_ = """<{{evalPyHTML}}>
+		<title>My Page</title>
+	</head>
+	<body>
+		<h1>Hello, World!</h1>
+	</body>
+</html>"""
+pyhtml = PyHTML(pyhtml_)
+html = pyhtml.decoded()
+```
+, 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.<br/><br/>
+PyWSGIRef also provides a simple way to end PyHTML files:<br/>
+just use the <code><{{evalPyHTML}}></code> phrase at the end of the document and<br/>
+PyWSGIRef will automatically add the closing html and body tags.<br/><br/>
+You can also add PyWSGIRef's own, featured modern stylesheet using:<br/>
+<code><{{evalPyHTML-modernStyling: true}}></code> inside the head block of your PyHTML file.<br/><br/>
+You may add your own static resources like CSS or JavaScript files using the <code><{{evalPyHTML-include: ... :include-}}></code> phrase.<br/>
+Different static resources can be included by separating them with a comma.<br/>
+You may include CSS, JS, JSON and ICO files.<br/><br/>
+With the <code><{{evalPyHTML-script: alert('Hello, World!'); :script-}}></code> phrase,<br/>
+you can add a script block anywhere inside your PyHTML file.<br/>
+Using pretty much the same syntax, you can also add a style block using
+<code><{{evalPyHTML-style: body { background-color: lightblue; } :style-}}></code>.
+
+### Stats
+Some stats are saved into the <code>STATS</code> object.<br/>
+You may access them using the object itself or <code>STATS.export_stats()</code>.<br/>
+The performance times of your application are collected there too.<br/>
+
+### Shutting down your server
+You can shut down your server by calling the <code>shutdown</code> method on the server object:
+```python
+from PyWSGIRef import *
+
+# ...
+# Create a WSGI server
+server = setUpServer(application, port=8000)
+
+# Shut down the server
+server.shutdown()
+```
+
+### Others
+Use the following to get information about your release and the author of the module:
+```python
+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()
+```
+Currently to be tested are:<br/>
+- PyHTML python script blocks<br/>
+- PyHTML python if clause blocks<br/>
+- PyHTML macros<br/><br/>
+
+
+Please report any bugs you find in the GitHub repository and suggest new features!<br/><br/>
+
+Thanks a lot for helping improving PyWSGIRef!
+### More coming soon