Pyjoyment 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. Pyjo/App/ASGI.py +735 -0
  2. Pyjo/App/CGI.py +773 -0
  3. Pyjo/App/FastCGI.py +631 -0
  4. Pyjo/App/Lambda.py +987 -0
  5. Pyjo/App/WSGI.py +427 -0
  6. Pyjo/App/__init__.py +409 -0
  7. Pyjo/Asset/File.py +377 -0
  8. Pyjo/Asset/Memory.py +235 -0
  9. Pyjo/Asset/__init__.py +200 -0
  10. Pyjo/Base.py +215 -0
  11. Pyjo/Cache.py +119 -0
  12. Pyjo/Collection.py +570 -0
  13. Pyjo/Content/MultiPart.py +325 -0
  14. Pyjo/Content/Single.py +193 -0
  15. Pyjo/Content/__init__.py +806 -0
  16. Pyjo/Cookie/Request.py +90 -0
  17. Pyjo/Cookie/Response.py +294 -0
  18. Pyjo/Cookie/__init__.py +143 -0
  19. Pyjo/DOM/CSS.py +1019 -0
  20. Pyjo/DOM/HTML.py +550 -0
  21. Pyjo/DOM/__init__.py +1329 -0
  22. Pyjo/Date.py +294 -0
  23. Pyjo/EventEmitter.py +522 -0
  24. Pyjo/Exception.py +494 -0
  25. Pyjo/File.py +959 -0
  26. Pyjo/GetOpt.py +605 -0
  27. Pyjo/Headers.py +760 -0
  28. Pyjo/HelloWorld.py +77 -0
  29. Pyjo/Home.py +109 -0
  30. Pyjo/IOLoop/ChildProcess.py +591 -0
  31. Pyjo/IOLoop/Client.py +736 -0
  32. Pyjo/IOLoop/Datagram.py +982 -0
  33. Pyjo/IOLoop/Messages.py +664 -0
  34. Pyjo/IOLoop/Server.py +458 -0
  35. Pyjo/IOLoop/Stdio.py +446 -0
  36. Pyjo/IOLoop/Stream.py +644 -0
  37. Pyjo/IOLoop/Subprocess.py +419 -0
  38. Pyjo/IOLoop/TLS.py +360 -0
  39. Pyjo/IOLoop/__init__.py +1036 -0
  40. Pyjo/IOLoop/certs/README.md +41 -0
  41. Pyjo/IOLoop/certs/ca.crt +20 -0
  42. Pyjo/IOLoop/certs/server.crt +21 -0
  43. Pyjo/IOLoop/certs/server.key +28 -0
  44. Pyjo/JSON/Pointer.py +135 -0
  45. Pyjo/JSON/RPC.py +772 -0
  46. Pyjo/JSON/Schema.py +2506 -0
  47. Pyjo/JSON/__init__.py +573 -0
  48. Pyjo/Loader.py +342 -0
  49. Pyjo/Log.py +723 -0
  50. Pyjo/Message/Request.py +725 -0
  51. Pyjo/Message/Response.py +476 -0
  52. Pyjo/Message/__init__.py +830 -0
  53. Pyjo/Parameters.py +472 -0
  54. Pyjo/Path.py +419 -0
  55. Pyjo/Promise.py +894 -0
  56. Pyjo/Prove.py +1305 -0
  57. Pyjo/Reactor/Asyncio.py +854 -0
  58. Pyjo/Reactor/Poll.py +439 -0
  59. Pyjo/Reactor/__init__.py +525 -0
  60. Pyjo/SSE.py +119 -0
  61. Pyjo/Server/ASGI.py +486 -0
  62. Pyjo/Server/CGI.py +259 -0
  63. Pyjo/Server/Daemon.py +1007 -0
  64. Pyjo/Server/FastCGI.py +517 -0
  65. Pyjo/Server/Hot/__init__.py +687 -0
  66. Pyjo/Server/Hot/__main__.py +5 -0
  67. Pyjo/Server/Lambda.py +641 -0
  68. Pyjo/Server/Prefork.py +917 -0
  69. Pyjo/Server/Prethread.py +394 -0
  70. Pyjo/Server/Reload/Backend/Poll.py +114 -0
  71. Pyjo/Server/Reload/Backend/__init__.py +126 -0
  72. Pyjo/Server/Reload/__init__.py +482 -0
  73. Pyjo/Server/Reload/__main__.py +5 -0
  74. Pyjo/Server/Stdio.py +228 -0
  75. Pyjo/Server/WSGI.py +349 -0
  76. Pyjo/Server/__init__.py +396 -0
  77. Pyjo/String/Bytes.py +532 -0
  78. Pyjo/String/HTML.py +210 -0
  79. Pyjo/String/Mixin.py +333 -0
  80. Pyjo/String/Template.py +470 -0
  81. Pyjo/String/Unicode.py +553 -0
  82. Pyjo/String/__init__.py +0 -0
  83. Pyjo/TOML.py +232 -0
  84. Pyjo/Template.py +1290 -0
  85. Pyjo/Test/Pyjo.py +1454 -0
  86. Pyjo/Test/__init__.py +1233 -0
  87. Pyjo/Test/pytest_plugin.py +305 -0
  88. Pyjo/Transaction/HTTP.py +374 -0
  89. Pyjo/Transaction/WebSocket.py +709 -0
  90. Pyjo/Transaction/__init__.py +429 -0
  91. Pyjo/URL/Template.py +459 -0
  92. Pyjo/URL/__init__.py +651 -0
  93. Pyjo/Upload.py +139 -0
  94. Pyjo/UserAgent/CookieJar.py +391 -0
  95. Pyjo/UserAgent/Proxy.py +138 -0
  96. Pyjo/UserAgent/Server.py +239 -0
  97. Pyjo/UserAgent/Transactor.py +766 -0
  98. Pyjo/UserAgent/__init__.py +1243 -0
  99. Pyjo/Util.py +3567 -0
  100. Pyjo/WebSocket.py +332 -0
  101. Pyjo/YAML.py +1167 -0
  102. Pyjo/__init__.py +441 -0
  103. Pyjo/__main__.py +35 -0
  104. Pyjo/py.typed +0 -0
  105. Pyjoyment/Command/Author/__init__.py +20 -0
  106. Pyjoyment/Command/Author/generate/__init__.py +106 -0
  107. Pyjoyment/Command/Author/generate/app.py +299 -0
  108. Pyjoyment/Command/Author/generate/dockerfile.py +281 -0
  109. Pyjoyment/Command/Author/generate/kubernetes.py +514 -0
  110. Pyjoyment/Command/Author/generate/lambda_zip.py +372 -0
  111. Pyjoyment/Command/Author/generate/lite_app.py +113 -0
  112. Pyjoyment/Command/Author/generate/plugin.py +267 -0
  113. Pyjoyment/Command/Author/generate/pyproject.py +123 -0
  114. Pyjoyment/Command/Author/inflate.py +101 -0
  115. Pyjoyment/Command/__init__.py +332 -0
  116. Pyjoyment/Command/asgi.py +92 -0
  117. Pyjoyment/Command/cgi.py +90 -0
  118. Pyjoyment/Command/daemon.py +160 -0
  119. Pyjoyment/Command/eval.py +128 -0
  120. Pyjoyment/Command/fastcgi.py +99 -0
  121. Pyjoyment/Command/get.py +305 -0
  122. Pyjoyment/Command/lambda.py +117 -0
  123. Pyjoyment/Command/prefork.py +181 -0
  124. Pyjoyment/Command/prethread.py +126 -0
  125. Pyjoyment/Command/routes.py +133 -0
  126. Pyjoyment/Command/stdio.py +92 -0
  127. Pyjoyment/Command/version.py +141 -0
  128. Pyjoyment/Command/wsgi.py +93 -0
  129. Pyjoyment/Commands.py +546 -0
  130. Pyjoyment/Controller.py +1307 -0
  131. Pyjoyment/HelloWorld.py +56 -0
  132. Pyjoyment/Lite.py +494 -0
  133. Pyjoyment/Plugin/AllowedHosts.py +205 -0
  134. Pyjoyment/Plugin/Config.py +248 -0
  135. Pyjoyment/Plugin/DefaultHelpers.py +1202 -0
  136. Pyjoyment/Plugin/EPLRenderer.py +134 -0
  137. Pyjoyment/Plugin/EPRenderer.py +212 -0
  138. Pyjoyment/Plugin/HeaderCondition.py +98 -0
  139. Pyjoyment/Plugin/Health.py +325 -0
  140. Pyjoyment/Plugin/JSONConfig.py +172 -0
  141. Pyjoyment/Plugin/Mount.py +223 -0
  142. Pyjoyment/Plugin/PyRenderer.py +209 -0
  143. Pyjoyment/Plugin/TOMLConfig.py +141 -0
  144. Pyjoyment/Plugin/TagHelpers.py +959 -0
  145. Pyjoyment/Plugin/YAMLConfig.py +178 -0
  146. Pyjoyment/Plugin/__init__.py +80 -0
  147. Pyjoyment/Plugins.py +215 -0
  148. Pyjoyment/Renderer.py +673 -0
  149. Pyjoyment/Routes/Match.py +251 -0
  150. Pyjoyment/Routes/Pattern.py +443 -0
  151. Pyjoyment/Routes/Route.py +827 -0
  152. Pyjoyment/Routes/__init__.py +419 -0
  153. Pyjoyment/Sessions.py +255 -0
  154. Pyjoyment/Static.py +421 -0
  155. Pyjoyment/Types.py +238 -0
  156. Pyjoyment/Validator/Validation.py +395 -0
  157. Pyjoyment/Validator/__init__.py +304 -0
  158. Pyjoyment/__init__.py +1083 -0
  159. Pyjoyment/__main__.py +5 -0
  160. Pyjoyment/py.typed +0 -0
  161. Pyjoyment/resources/public/favicon.ico +0 -0
  162. Pyjoyment/resources/public/favicon.svg +345 -0
  163. Pyjoyment/resources/public/pyjo/bootstrap/LICENSE +21 -0
  164. Pyjoyment/resources/public/pyjo/bootstrap/bootstrap.bundle.min.js.map +1 -0
  165. Pyjoyment/resources/public/pyjo/bootstrap/bootstrap.css +6 -0
  166. Pyjoyment/resources/public/pyjo/bootstrap/bootstrap.js +7 -0
  167. Pyjoyment/resources/public/pyjo/bootstrap/bootstrap.min.css.map +1 -0
  168. Pyjoyment/resources/public/pyjo/failunicat.png +0 -0
  169. Pyjoyment/resources/public/pyjo/failunicat.svg +50 -0
  170. Pyjoyment/resources/public/pyjo/highlight.js/LICENSE +29 -0
  171. Pyjoyment/resources/public/pyjo/highlight.js/highlight-mojo-dark.css +56 -0
  172. Pyjoyment/resources/public/pyjo/highlight.js/highlight.min.js +1262 -0
  173. Pyjoyment/resources/public/pyjo/highlight.js/pyjoyment.min.js +1 -0
  174. Pyjoyment/resources/public/pyjo/logo-black-4x.png +0 -0
  175. Pyjoyment/resources/public/pyjo/logo-black-4x.svg +346 -0
  176. Pyjoyment/resources/public/pyjo/logo-white-2x.png +0 -0
  177. Pyjoyment/resources/public/pyjo/logo-white-2x.svg +346 -0
  178. Pyjoyment/resources/public/pyjo/logo-white-4x.png +0 -0
  179. Pyjoyment/resources/public/pyjo/logo-white-4x.svg +346 -0
  180. Pyjoyment/resources/public/pyjo/logo-white.png +0 -0
  181. Pyjoyment/resources/public/pyjo/logo-white.svg +346 -0
  182. Pyjoyment/resources/public/pyjo/logo.png +0 -0
  183. Pyjoyment/resources/public/pyjo/logo.svg +346 -0
  184. Pyjoyment/resources/public/pyjo/notfound.png +0 -0
  185. Pyjoyment/resources/public/pyjo/notfound.svg +3 -0
  186. Pyjoyment/resources/public/pyjo/nounicat.png +0 -0
  187. Pyjoyment/resources/public/pyjo/nounicat.svg +5 -0
  188. Pyjoyment/resources/public/pyjo/pinstripe-dark.png +0 -0
  189. Pyjoyment/resources/public/pyjo/pinstripe-dark.svg +4 -0
  190. Pyjoyment/resources/public/pyjo/pinstripe-light.png +0 -0
  191. Pyjoyment/resources/public/pyjo/pinstripe-light.svg +4 -0
  192. Pyjoyment/resources/public/pyjo/pyjo.css +204 -0
  193. Pyjoyment/resources/templates/pyjo/debug.html.ep +346 -0
  194. Pyjoyment/resources/templates/pyjo/exception.html.ep +32 -0
  195. Pyjoyment/resources/templates/pyjo/not_found.html.ep +45 -0
  196. pyjoyment-0.1.0.dist-info/METADATA +376 -0
  197. pyjoyment-0.1.0.dist-info/RECORD +200 -0
  198. pyjoyment-0.1.0.dist-info/WHEEL +4 -0
  199. pyjoyment-0.1.0.dist-info/entry_points.txt +8 -0
  200. pyjoyment-0.1.0.dist-info/licenses/LICENSE +201 -0
Pyjo/Server/CGI.py ADDED
@@ -0,0 +1,259 @@
1
+ """
2
+ Pyjo.Server.CGI - CGI server
3
+ ============================
4
+ ::
5
+
6
+ from Pyjo.Server.CGI import CGI
7
+
8
+ cgi = CGI()
9
+
10
+
11
+ @cgi.unsubscribe('request').on('request')
12
+ def request(cgi, tx):
13
+ # Request
14
+ method = tx.req.method
15
+ path = tx.req.url.path
16
+
17
+ # Response
18
+ tx.res.code = 200
19
+ tx.res.headers.content_type = 'text/plain'
20
+ tx.res.body = f'{method} request for {path}!'.encode()
21
+
22
+ # Resume transaction
23
+ tx.resume()
24
+
25
+
26
+ cgi.run()
27
+
28
+ # Or import the module, as in Google Python Style Guide
29
+
30
+ import Pyjo.Server.CGI
31
+
32
+ cgi = Pyjo.Server.CGI.new()
33
+
34
+
35
+ @cgi.unsubscribe('request').on('request')
36
+ def request(cgi, tx):
37
+ # Request
38
+ method = tx.req.method
39
+ path = tx.req.url.path
40
+
41
+ # Response
42
+ tx.res.code = 200
43
+ tx.res.headers.content_type = 'text/plain'
44
+ tx.res.body = f'{method} request for {path}!'.encode()
45
+
46
+ # Resume transaction
47
+ tx.resume()
48
+
49
+
50
+ cgi.run()
51
+
52
+ :mod:`Pyjo.Server.CGI` is a simple and portable implementation of
53
+ :rfc:`3875`.
54
+
55
+ The response can come later, as the event loop of :mod:`Pyjo.IOLoop` runs
56
+ while the script waits for it, and the script writes it once the application
57
+ resumes the transaction. The body of chunks is written without the chunked
58
+ transfer encoding, as a script returns no header that relates to the
59
+ connection of the client, which the web server makes, except in non-parsed
60
+ header mode, whose response goes to the client as it is. The request body is
61
+ read with the length of ``CONTENT_LENGTH``, so a chunked request, which has
62
+ none, reaches the application without its body.
63
+
64
+ CGI servers
65
+ -----------
66
+
67
+ * uWSGI with its plugin ``cgi``: a chunked request is not answered.
68
+ * :mod:`http.server` with ``--cgi``, up to Python 3.14: it sends the output of
69
+ the script as it is, after a status line ``200`` and headers of its own,
70
+ so the status of the response is lost, and the ``Status`` header and the
71
+ ``Date`` header of the script reach the client.
72
+
73
+ Events
74
+ ------
75
+
76
+ :mod:`Pyjo.Server.CGI` inherits all events from :mod:`Pyjo.Server`.
77
+
78
+ See also
79
+ --------
80
+
81
+ :mod:`Pyjoyment`, https://mojolicious.org.
82
+
83
+ Ported from `Mojo::Server::CGI <https://github.com/mojolicious/mojo/blob/v9.49/lib/Mojo/Server/CGI.pm>`_
84
+ of Mojolicious 9.49.
85
+
86
+ Classes
87
+ -------
88
+ """
89
+
90
+ import Pyjo.IOLoop
91
+ import Pyjo.Message.Response
92
+ import Pyjo.Server
93
+
94
+ import os
95
+ import re
96
+ import sys
97
+
98
+ from typing import Any, BinaryIO, cast
99
+
100
+
101
+ class Pyjo_Server_CGI(Pyjo.Server.object):
102
+ """
103
+ :mod:`Pyjo.Server.CGI` inherits all methods from :mod:`Pyjo.Server` and
104
+ implements the following new ones.
105
+ """
106
+
107
+ def __init__(self, *, nph: bool | None = None, **kwargs: Any) -> None:
108
+ """::
109
+
110
+ cgi = Pyjo.Server.CGI.new()
111
+ cgi = Pyjo.Server.CGI.new(nph=True)
112
+
113
+ Construct a new :mod:`Pyjo.Server.CGI` object.
114
+ """
115
+ super().__init__(**kwargs)
116
+
117
+ self.nph = nph
118
+ """::
119
+
120
+ boolean = cgi.nph
121
+ cgi.nph = boolean
122
+
123
+ Activate non-parsed header mode.
124
+ """
125
+
126
+ def run(self) -> int | None:
127
+ """::
128
+
129
+ status = cgi.run()
130
+
131
+ Run CGI.
132
+ """
133
+ self.app.server(self)
134
+ try:
135
+ return self._run()
136
+
137
+ # Not in Mojolicious: the end of the server, as it serves one request
138
+ finally:
139
+ self._server_stopped()
140
+
141
+ def _run(self) -> int | None:
142
+ tx = self.build_tx()
143
+ req = tx.req.parse(dict(os.environ))
144
+ tx.local_port = int(port) if (port := os.environ.get('SERVER_PORT')) else None
145
+ tx.remote_address = os.environ.get('REMOTE_ADDR')
146
+
147
+ # Request body (may block if we try to read too much)
148
+ stdin = cast(BinaryIO, sys.stdin.buffer)
149
+ length = int(req.headers.content_length or 0)
150
+ while not req.is_finished:
151
+ chunk = stdin.read(length if length and length < 131072 else 131072)
152
+ if not chunk:
153
+ break
154
+ req.parse(chunk)
155
+ length -= len(chunk)
156
+ if length <= 0:
157
+ break
158
+
159
+ # Unlike Mojolicious: the response once the application resumes the transaction, as the daemon writes it, as the
160
+ # event loop runs while the script waits, where Mojo writes the default response of a later one
161
+ resumed: list[Any] = []
162
+ tx.on('resume', resumed.append)
163
+ self.emit('request', tx)
164
+ while not resumed:
165
+ Pyjo.IOLoop.one_tick()
166
+
167
+ # Response start-line
168
+ res = tx.res.fix_headers()
169
+ if self.nph and not _write(res, 'get_start_line_chunk'):
170
+ return None
171
+
172
+ # Response headers
173
+ code = res.code or 404
174
+ msg = res.message or res.default_message()
175
+ if not self.nph:
176
+ res.headers.status = f'{code} {msg}'
177
+
178
+ # Unlike Mojolicious: the body of chunks without the chunked transfer encoding, as a script returns no header
179
+ # that relates to the connection of the client (RFC 3875 6.3.4), which the web server writes, where Mojo writes
180
+ # the chunks with their sizes
181
+ decode = None
182
+ if not self.nph and res.content.is_chunked:
183
+ res.headers.remove('Transfer-Encoding')
184
+ decode = _Chunks()
185
+ if not _write(res, 'get_header_chunk'):
186
+ return None
187
+
188
+ # Response body
189
+ if not tx.is_empty and not _write(res, 'get_body_chunk', decode):
190
+ return None
191
+
192
+ # Finish transaction
193
+ tx.closed()
194
+
195
+ return res.code
196
+
197
+
198
+ def _write(res: Pyjo.Message.Response.object, method: str, decode: '_Chunks | None' = None) -> bool:
199
+ # Text written to sys.stdout before goes first
200
+ sys.stdout.flush()
201
+ stdout = cast(BinaryIO, sys.stdout.buffer)
202
+ offset = 0
203
+ while True:
204
+ # Not in Mojolicious: no chunk yet, so the event loop runs once before it tries again, where Mojo sleeps for a
205
+ # second
206
+ chunk: bytes | None = getattr(res, method)(offset)
207
+ if chunk is None:
208
+ Pyjo.IOLoop.one_tick()
209
+ continue
210
+
211
+ # End of part
212
+ if not (length := len(chunk)):
213
+ break
214
+
215
+ # Make sure we can still write
216
+ offset += length
217
+ if stdout.closed:
218
+ return False
219
+ # Not in Mojolicious: the chunks without their sizes
220
+ if decode is not None and not len(chunk := decode(chunk)):
221
+ continue
222
+ stdout.write(chunk)
223
+ stdout.flush()
224
+
225
+ return True
226
+
227
+
228
+ # Not in Mojolicious: the body of the chunks of a dynamic response, without the sizes that write_chunk of Pyjo.Content
229
+ # writes before them
230
+ class _Chunks:
231
+ def __init__(self) -> None:
232
+ self.buffer = b''
233
+ self.left = 0
234
+
235
+ def __call__(self, chunk: bytes) -> bytes:
236
+ self.buffer += chunk
237
+ body = b''
238
+ while len(self.buffer):
239
+ if self.left:
240
+ part = self.buffer[: self.left]
241
+ body += part
242
+ self.buffer = self.buffer[len(part) :]
243
+ self.left -= len(part)
244
+ continue
245
+
246
+ # The size of the next chunk, after the end of the one before, and none at the end
247
+ if (m := re.match(rb'(?:\r\n)?([0-9a-fA-F]+)\r\n', self.buffer)) is None:
248
+ break
249
+ self.buffer = self.buffer[m.end() :]
250
+ if not (left := int(m[1], 16)):
251
+ self.buffer = b''
252
+ break
253
+ self.left = left
254
+ return body
255
+
256
+
257
+ new = Pyjo_Server_CGI.new
258
+ object = Pyjo_Server_CGI
259
+ CGI = Pyjo_Server_CGI