Pyjoyment 0.0.1__tar.gz → 0.1.0__tar.gz

pyjoyment-0.1.0/.gitignore

@@ -0,0 +1,67 @@
+# The parts of https://www.toptal.com/developers/gitignore/api/python,node,macos,visualstudiocode
+# that apply here; a path is anchored where it could match a directory of the
+# project, as "lib/" of the template would match t/lib. hatchling builds the
+# packages without the files that this file ignores.
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+.eggs/
+/build/
+/dist/
+
+# The SBOM of a release, which the workflow Release creates for the sdist
+/pyjoyment-*.spdx.json
+
+# Virtual environments of uv, of the tests of the servers and of the benchmarks
+.venv
+.venv-*
+benchmarks/venv/
+
+# Caches of the tools
+.ruff_cache/
+
+# The working directories of OpenTofu, with the archives of the functions, the locks
+# of the providers, which are not locked, the states and the variables of each one
+.terraform/
+.terraform.lock.hcl
+*.tfstate
+*.tfstate.*
+*.tfvars
+
+# The ZIP files of the functions that "generate lambda-zip" writes for OpenTofu
+examples/*/function/dist/
+
+# Logs, as the one of TF_LOG_PATH of OpenTofu
+*.log
+
+# The packages of npm, which npm run bundle copies from
+node_modules/
+npm-debug.log*
+
+# macOS
+.DS_Store
+._*
+
+# Editors
+.idea/
+.vscode/
+
+# Secrets, as in the rules of .claude/settings.json
+.env
+.env.*
+.envrc
+.pypirc
+*.jks
+*.keystore
+*.p12
+*.pfx
+*.pem
+*.key
+# The key of the default certificate for TLS servers, like in Mojo
+!/Pyjo/IOLoop/certs/server.key
+# Certificates of the tests, like t/mojo/certs in Mojo
+!/t/certs/*.key

pyjoyment-0.1.0/.proverc

@@ -0,0 +1,2 @@
+--ext=py
+--exec=python

pyjoyment-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                       The Artistic License 2.0
+
+            Copyright (c) 2000-2006, The Perl Foundation.
+
+     Everyone is permitted to copy and distribute verbatim copies
+      of this license document, but changing it is not allowed.
+
+Preamble
+
+This license establishes the terms under which a given free software
+Package may be copied, modified, distributed, and/or redistributed.
+The intent is that the Copyright Holder maintains some artistic
+control over the development of that Package while still keeping the
+Package available as open source and free software.
+
+You are always permitted to make arrangements wholly outside of this
+license directly with the Copyright Holder of a given Package.  If the
+terms of this license do not permit the full use that you propose to
+make of the Package, you should contact the Copyright Holder and seek
+a different licensing arrangement.
+
+Definitions
+
+    "Copyright Holder" means the individual(s) or organization(s)
+    named in the copyright notice for the entire Package.
+
+    "Contributor" means any party that has contributed code or other
+    material to the Package, in accordance with the Copyright Holder's
+    procedures.
+
+    "You" and "your" means any person who would like to copy,
+    distribute, or modify the Package.
+
+    "Package" means the collection of files distributed by the
+    Copyright Holder, and derivatives of that collection and/or of
+    those files. A given Package may consist of either the Standard
+    Version, or a Modified Version.
+
+    "Distribute" means providing a copy of the Package or making it
+    accessible to anyone else, or in the case of a company or
+    organization, to others outside of your company or organization.
+
+    "Distributor Fee" means any fee that you charge for Distributing
+    this Package or providing support for this Package to another
+    party.  It does not mean licensing fees.
+
+    "Standard Version" refers to the Package if it has not been
+    modified, or has been modified only in ways explicitly requested
+    by the Copyright Holder.
+
+    "Modified Version" means the Package, if it has been changed, and
+    such changes were not explicitly requested by the Copyright
+    Holder.
+
+    "Original License" means this Artistic License as Distributed with
+    the Standard Version of the Package, in its current version or as
+    it may be modified by The Perl Foundation in the future.
+
+    "Source" form means the source code, documentation source, and
+    configuration files for the Package.
+
+    "Compiled" form means the compiled bytecode, object code, binary,
+    or any other form resulting from mechanical transformation or
+    translation of the Source form.
+
+
+Permission for Use and Modification Without Distribution
+
+(1)  You are permitted to use the Standard Version and create and use
+Modified Versions for any purpose without restriction, provided that
+you do not Distribute the Modified Version.
+
+
+Permissions for Redistribution of the Standard Version
+
+(2)  You may Distribute verbatim copies of the Source form of the
+Standard Version of this Package in any medium without restriction,
+either gratis or for a Distributor Fee, provided that you duplicate
+all of the original copyright notices and associated disclaimers.  At
+your discretion, such verbatim copies may or may not include a
+Compiled form of the Package.
+
+(3)  You may apply any bug fixes, portability changes, and other
+modifications made available from the Copyright Holder.  The resulting
+Package will still be considered the Standard Version, and as such
+will be subject to the Original License.
+
+
+Distribution of Modified Versions of the Package as Source
+
+(4)  You may Distribute your Modified Version as Source (either gratis
+or for a Distributor Fee, and with or without a Compiled form of the
+Modified Version) provided that you clearly document how it differs
+from the Standard Version, including, but not limited to, documenting
+any non-standard features, executables, or modules, and provided that
+you do at least ONE of the following:
+
+    (a)  make the Modified Version available to the Copyright Holder
+    of the Standard Version, under the Original License, so that the
+    Copyright Holder may include your modifications in the Standard
+    Version.
+
+    (b)  ensure that installation of your Modified Version does not
+    prevent the user installing or running the Standard Version. In
+    addition, the Modified Version must bear a name that is different
+    from the name of the Standard Version.
+
+    (c)  allow anyone who receives a copy of the Modified Version to
+    make the Source form of the Modified Version available to others
+    under
+
+        (i)  the Original License or
+
+        (ii)  a license that permits the licensee to freely copy,
+        modify and redistribute the Modified Version using the same
+        licensing terms that apply to the copy that the licensee
+        received, and requires that the Source form of the Modified
+        Version, and of any works derived from it, be made freely
+        available in that license fees are prohibited but Distributor
+        Fees are allowed.
+
+
+Distribution of Compiled Forms of the Standard Version
+or Modified Versions without the Source
+
+(5)  You may Distribute Compiled forms of the Standard Version without
+the Source, provided that you include complete instructions on how to
+get the Source of the Standard Version.  Such instructions must be
+valid at the time of your distribution.  If these instructions, at any
+time while you are carrying out such distribution, become invalid, you
+must provide new instructions on demand or cease further distribution.
+If you provide valid instructions or cease distribution within thirty
+days after you become aware that the instructions are invalid, then
+you do not forfeit any of your rights under this license.
+
+(6)  You may Distribute a Modified Version in Compiled form without
+the Source, provided that you comply with Section 4 with respect to
+the Source of the Modified Version.
+
+
+Aggregating or Linking the Package
+
+(7)  You may aggregate the Package (either the Standard Version or
+Modified Version) with other packages and Distribute the resulting
+aggregation provided that you do not charge a licensing fee for the
+Package.  Distributor Fees are permitted, and licensing fees for other
+components in the aggregation are permitted. The terms of this license
+apply to the use and Distribution of the Standard or Modified Versions
+as included in the aggregation.
+
+(8) You are permitted to link Modified and Standard Versions with
+other works, to embed the Package in a larger work of your own, or to
+build stand-alone binary or bytecode versions of applications that
+include the Package, and Distribute the result without restriction,
+provided the result does not expose a direct interface to the Package.
+
+
+Items That are Not Considered Part of a Modified Version
+
+(9) Works (including, but not limited to, modules and scripts) that
+merely extend or make use of the Package, do not, by themselves, cause
+the Package to be a Modified Version.  In addition, such works are not
+considered parts of the Package itself, and are not subject to the
+terms of this license.
+
+
+General Provisions
+
+(10)  Any use, modification, and distribution of the Standard or
+Modified Versions is governed by this Artistic License. By using,
+modifying or distributing the Package, you accept this license. Do not
+use, modify, or distribute the Package, if you do not accept this
+license.
+
+(11)  If your Modified Version has been derived from a Modified
+Version made by someone other than you, you are nevertheless required
+to ensure that your Modified Version complies with the requirements of
+this license.
+
+(12)  This license does not grant you the right to use any trademark,
+service mark, tradename, or logo of the Copyright Holder.
+
+(13)  This license includes the non-exclusive, worldwide,
+free-of-charge patent license to make, have made, use, offer to sell,
+sell, import and otherwise transfer the Package with respect to any
+patent claims licensable by the Copyright Holder that are necessarily
+infringed by the Package. If you institute patent litigation
+(including a cross-claim or counterclaim) against any party alleging
+that the Package constitutes direct or contributory patent
+infringement, then this Artistic License to you shall terminate on the
+date that such litigation is filed.
+
+(14)  Disclaimer of Warranty:
+THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS
+IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
+NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL
+LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

pyjoyment-0.1.0/PKG-INFO

@@ -0,0 +1,376 @@
+Metadata-Version: 2.5
+Name: Pyjoyment
+Version: 0.1.0
+Summary: A real-time web framework for the Python programming language, ported from Mojolicious.
+Project-URL: Homepage, https://github.com/dex4er/Pyjoyment
+Project-URL: Documentation, https://pyjoyment.readthedocs.io/
+Project-URL: Source, https://github.com/dex4er/Pyjoyment
+Project-URL: Issues, https://github.com/dex4er/Pyjoyment/issues
+Project-URL: Changelog, https://github.com/dex4er/Pyjoyment/releases
+Author-email: Piotr Roszatycki <piotr.roszatycki@gmail.com>
+License-Expression: Artistic-2.0
+License-File: LICENSE
+Keywords: asgi,async,asyncio,aws-lambda,framework,html,http,json-rpc,json-schema,mojo,mojolicious,pyjo,pyjoyment,tap,test,web,websocket,wsgi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: File Formats :: JSON :: JSON Schema
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+[![Home](https://img.shields.io/badge/%F0%9F%8F%A0-Pyjoyment-02a7a0)](https://github.com/dex4er/Pyjoyment)
+[![GitHub](https://img.shields.io/github/stars/dex4er/Pyjoyment?style=flat&label=GitHub%20%E2%AD%90&logo=github)](https://github.com/dex4er/Pyjoyment)
+[![Documentation](https://img.shields.io/badge/docs-Read_the_Docs-blue?logo=readthedocs&logoColor=white)](https://pyjoyment.readthedocs.io/en/latest/)
+[![DeepWiki](https://img.shields.io/badge/Ask-DeepWiki-blue)](https://deepwiki.com/dex4er/Pyjoyment)
+[![License](https://img.shields.io/github/license/dex4er/Pyjoyment.svg)](https://github.com/dex4er/Pyjoyment/blob/main/LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/Pyjoyment?logo=pypi&logoColor=white)](https://pypi.org/project/Pyjoyment/)
+[![Tests](https://github.com/dex4er/Pyjoyment/actions/workflows/tests.yaml/badge.svg?branch=main)](https://github.com/dex4er/Pyjoyment/actions/workflows/tests.yaml)
+[![Trunk Check](https://github.com/dex4er/Pyjoyment/actions/workflows/trunk-check.yaml/badge.svg?branch=main)](https://github.com/dex4er/Pyjoyment/actions/workflows/trunk-check.yaml)
+
+# Pyjoyment
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/dex4er/Pyjoyment/main/Pyjoyment/resources/public/pyjo/logo-white-4x.png">
+    <img src="https://raw.githubusercontent.com/dex4er/Pyjoyment/main/Pyjoyment/resources/public/pyjo/logo-black-4x.png" alt="Pyjoyment" width="322">
+  </picture>
+</p>
+
+A real-time web framework for the Python programming language, ported from
+[Mojolicious](https://mojolicious.org), the real-time web framework for Perl.
+Pyjoyment keeps the API of Mojolicious with Python names, so its documentation
+and experience carry over.
+
+The `Pyjo` package is the web development toolkit, ported from the `Mojo`
+modules, which can be used for all kinds of applications independently of the
+web framework:
+
+- HTTP and WebSocket client and server.
+- Non-blocking I/O web server, which also speaks FastCGI, to a web server in
+  front of it and to an application behind it, as PHP on php-fpm, and runs as
+  an ASGI, WSGI or CGI application, or as an event function of AWS Lambda.
+- HTML/XML parser with CSS selector support.
+- JSON with JSON Pointers and JSON Schema, from type hints and validated,
+  YAML and TOML, all loaded and dumped.
+- JSON-RPC 2.0, its server and its client, over HTTP or any other transport.
+- Command line options with `Pyjo.GetOpt`, in the way of Getopt::Long,
+  argparse and Cobra, also from environment variables.
+- Python-ish templates and template strings, with automatic escaping.
+- Containers for URLs, paths, query strings, headers, cookies and HTTP
+  messages.
+- Event emitter, event loop with TCP, UDP and UNIX domain sockets and child
+  processes, logger and utility functions.
+- Test scripts which print the [Test Anything Protocol](https://testanything.org/)
+  (TAP), with `Pyjo.Test`, inspired by Perl's `Test::More`, and a test
+  harness, `Pyjo.Prove`, inspired by Perl's `prove`.
+
+The `Pyjoyment` package is the web framework itself: routes, controllers,
+renderer, plugins, `Pyjoyment.Lite` and the command line interface. It
+renders JSON, YAML and TOML, and reads its configuration from Python, JSON,
+YAML and TOML files.
+
+It mounts the applications of other frameworks under a path or a host, next to
+its own routes: WSGI applications, as those of Flask, and ASGI applications, as
+those of Starlette and the servers of the MCP SDK, in the same process and on
+the same server, whose responses stream at the pace of the client, with their
+WebSockets, FastCGI applications, as PHP on php-fpm, which it connects to, CGI
+programs, which it runs, as a web server does, with one script for every path
+or the scripts of a directory, and event functions of AWS Lambda, which it runs
+in a process of their own, as Lambda does.
+
+Both are cloud native: `generate dockerfile` writes the image of an
+application, whose server stops gracefully on the `TERM` of its container
+and listens on the port of `PORT`, as Knative, Cloud Run, Render, Koyeb and
+Heroku set it, and an application runs as an event function of AWS Lambda
+too.
+
+Pyjoyment requires Python 3.12 or newer and runs on PyPy on a best-effort
+basis. It needs nothing besides the Python standard library.
+
+## Status
+
+Pyjoyment was written against Mojolicious 6 and is being revived as a port of
+Mojolicious 9 to Python 3.12 and newer, with `asyncio` as its event loop.
+The toolkit, the `Pyjo` package, is ported: URLs, DOM and CSS selectors,
+JSON, templates, HTTP messages and cookies, the event loop with promises, the
+user agent, and the servers, on their own, preforking, prethreading, with hot
+deployment or reloading, and through FastCGI, ASGI, WSGI, CGI and AWS Lambda. So is the web framework, the
+`Pyjoyment` package: routes, controllers, the renderer with templates and
+template strings, plugins, `Pyjoyment.Lite` and the commands. The tests of
+Mojolicious are ported with them, and a ported module names the Mojolicious
+version it was ported from in its documentation.
+
+Pyjoyment runs on Linux, macOS and Windows. On Windows, Python has no
+`os.fork` and no UNIX domain sockets, so `Pyjo.Server.Prefork`,
+`Pyjo.Server.Hot`, `Pyjo.Server.Reload` and `Pyjo.IOLoop.Subprocess` do not
+run there, and `Pyjo.Server.Prethread` runs the workers in threads instead.
+The event loop watches up to 512 sockets there, with the `select` of Windows,
+and a server stops with Ctrl-C, gracefully, or with Ctrl-Break, immediately.
+
+The progress is tracked in [GitHub Issues](https://github.com/dex4er/Pyjoyment/issues).
+
+## Installation
+
+Pyjoyment is installed from its Git repository, as the release on PyPI
+predates the revival:
+
+```sh
+pip install git+https://github.com/dex4er/Pyjoyment
+```
+
+or, in a project managed with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv add git+https://github.com/dex4er/Pyjoyment
+```
+
+The skills for coding agents that write applications with Pyjoyment are a
+plugin of [Claude Code](https://code.claude.com/docs/en/plugins), whose
+`SKILL.md` files other agents read too:
+
+```text
+/plugin install pyjoyment --marketplace dex4er/Pyjoyment
+```
+
+or from the shell, as the extensions of the editors have no `/plugin`:
+
+```sh
+claude plugin install pyjoyment --marketplace dex4er/Pyjoyment
+```
+
+## Quick start
+
+These three lines are a whole web application.
+
+```python
+from Pyjoyment.Lite import *
+
+
+get('/', {'text': 'I ♥ Pyjoyment!'})
+
+app.start()
+```
+
+To run the example with the built-in development web server, just put the
+code into a file and start it with `pyjo-reload`.
+
+```console
+$ pyjo-reload hello.py
+Web application available at http://127.0.0.1:3000
+```
+
+Test it with any HTTP client you prefer.
+
+```console
+$ curl http://127.0.0.1:3000/
+I ♥ Pyjoyment!
+```
+
+## Duct tape for the HTML5 web
+
+Use all the latest Python and HTML features in beautiful single file
+prototypes like this one, and grow them easily into well-structured
+Model-View-Controller web applications with `pyjo generate app`.
+
+```python
+"""
+__DATA__
+
+@@ index.html.ep
+% url = url_for('title')
+<script>
+  const ws = new WebSocket('<%= url.to_abs() %>');
+  ws.onmessage = function (event) { document.body.innerHTML += event.data };
+  ws.onopen    = function (event) { ws.send('https://mojolicious.org') };
+</script>
+"""
+
+from Pyjoyment.Lite import *
+
+
+# Render template "index.html.ep" from the DATA section
+@get('/')
+def index(c):
+    c.render(template='index')
+
+
+# WebSocket service used by the template to extract the title from a website
+@websocket('/title')
+def title(c):
+    @c.on('message')
+    def message(c, msg):
+        c.ua().get_p(msg).then(lambda tx: c.send(tx.result.dom().at('title').text))
+
+
+app.start()
+```
+
+The templates of a script of `Pyjoyment.Lite` are in its docstring, after a
+line `__DATA__`, and the website is requested without blocking, as the
+WebSocket service runs in the event loop.
+
+## Servers
+
+`Pyjo.HelloWorld` is the application that a server runs when it is given
+none, and it answers every request with `Your Pyjo is working!`. It runs
+natively on the web server of Pyjoyment:
+
+```python
+import Pyjo.HelloWorld
+import Pyjo.Server.Daemon
+
+
+Pyjo.Server.Daemon.new(app=Pyjo.HelloWorld.new(), listen=['http://*:3000']).run()
+```
+
+on [uvicorn](https://www.uvicorn.org/), an ASGI server
+(`pip install uvicorn`):
+
+```python
+import Pyjo.HelloWorld
+import Pyjo.Server.ASGI
+
+import uvicorn
+
+
+app = Pyjo.Server.ASGI.new(app=Pyjo.HelloWorld.new()).to_asgi_app()
+
+uvicorn.run(app, port=3000)
+```
+
+or on [Werkzeug](https://werkzeug.palletsprojects.com/), a WSGI server
+(`pip install werkzeug`):
+
+```python
+import Pyjo.HelloWorld
+import Pyjo.Server.WSGI
+
+from werkzeug.serving import run_simple
+
+
+app = Pyjo.Server.WSGI.new(app=Pyjo.HelloWorld.new()).to_wsgi_app()
+
+run_simple('localhost', 3000, app)
+```
+
+and answers on port 3000:
+
+```sh
+curl http://localhost:3000/
+```
+
+On a platform that tells the server the port to listen on with the `PORT`
+environment variable, as [Knative](https://knative.dev/),
+[Cloud Run](https://cloud.google.com/run), [Render](https://render.com/),
+[Koyeb](https://www.koyeb.com/) or [Heroku](https://www.heroku.com/), the
+web server of Pyjoyment listens on that port, and `generate dockerfile`
+writes the `Dockerfile` of the image of an application, with the port that
+the image exposes:
+
+```sh
+./myapp.py generate dockerfile --port 8080
+```
+
+On [AWS Lambda](https://aws.amazon.com/lambda/), it is an event function,
+whose handler `hello_world_lambda.handler` answers the events of API
+Gateway, Function URLs and Application Load Balancers:
+
+```python
+import Pyjo.HelloWorld
+import Pyjo.Server.Lambda
+
+
+# The handler "hello_world_lambda.handler" of an event function of AWS Lambda
+handler = Pyjo.Server.Lambda.new(app=Pyjo.HelloWorld.new()).to_lambda_app()
+```
+
+On a custom runtime, as `provided.al2023`, its `bootstrap` runs it with the
+runtime client of Pyjoyment:
+
+```sh
+#!/bin/sh
+# The bootstrap of a custom runtime of AWS Lambda, as provided.al2023, which runs the handler of the function, as
+# "hello_world_lambda.handler" of _HANDLER, with the runtime client of Pyjoyment
+exec python3 -m Pyjo.Server.Lambda
+```
+
+## Distributions
+
+Pyjoyment needs nothing besides the Python standard library, so what needs
+another library is a distribution of its own, which adds a module to a
+namespace of Pyjoyment, as `Pyjo.Reactor` for a reactor or `Pyjoyment.Plugin`
+for a plugin. They are installed from their Git repositories until they are
+on PyPI.
+
+- [Pyjo.Reactor.Twisted - Low-level event reactor with Twisted support](https://pyjoyment.readthedocs.io/projects/pyjo-reactor-twisted/en/latest/)
+
+## Documentation
+
+The documentation is on [Read the Docs](https://pyjoyment.readthedocs.io/).
+
+## Examples
+
+### Web scraping
+
+```python
+import Pyjo.UserAgent
+
+from Pyjo.String.Unicode import u
+
+
+# Extract named character references from HTML spec
+tx = Pyjo.UserAgent.new().get('https://html.spec.whatwg.org')
+for n in tx.res.dom('#named-character-references-table tbody > tr').each():
+    u(n.at('td > code').text + ' ' + n.children('td')[1].text).trim().say()
+```
+
+### URL manipulation
+
+```python
+import Pyjo.URL
+
+
+# 'ssh+git://git@github.com/dex4er/Pyjoyment.git'
+url = Pyjo.URL.new('https://github.com/dex4er/Pyjoyment')
+print(url.set(scheme='ssh+git', userinfo='git', path=f'{url.path}.git').to_unsafe_str())
+
+# 'https://pypi.org/search/?q=Pyjoyment&o=&c=Programming+Language+%3A%3A+Python'
+url = Pyjo.URL.new('https://pypi.org/search/')
+print(url.set(query=[('q', 'Pyjoyment'), ('o', ''), ('c', 'Programming Language :: Python')]))
+```
+
+## Copyright and license
+
+Copyright (C) 2014-2026, Piotr Roszatycki.
+
+Based on Mojolicious: Copyright (C) 2008-2025, Sebastian Riedel and others.
+
+This program is free software, you can redistribute it and/or modify it under
+the terms of the Artistic License version 2.0.
+
+The pages of errors bundle [Bootstrap](https://getbootstrap.com), with
+Popper, under the MIT License, and [highlight.js](https://highlightjs.org)
+under the BSD 3-Clause License, whose texts are next to them in
+`Pyjoyment/resources/public/pyjo`.