Pyjoyment 0.1.0__py3-none-any.whl

Pyjo/IOLoop/certs/README.md

@@ -0,0 +1,41 @@
+# The default certificate for TLS servers
+
+The certificate and key that a TLS server of `Pyjo.IOLoop.Server` uses when
+it is given none, as `lib/Mojo/IOLoop/resources` in Mojolicious. They are not
+secret and are meant for development only.
+
+| Files                      | Certificate                                       |
+| -------------------------- | ------------------------------------------------- |
+| `ca.crt`                   | The CA that signs the server, `Pyjoyment Test CA` |
+| `server.crt`, `server.key` | `localhost` and `127.0.0.1`, for a server         |
+
+The key of the CA is not kept, so the certificate is made again with a new
+CA. They are RSA 2048 keys, valid for a hundred years, made with OpenSSL 3 in
+a temporary directory, from the root of the repository:
+
+```sh
+certs=$PWD/Pyjo/IOLoop/certs
+cd "$(mktemp -d)"
+
+openssl req -x509 -newkey rsa:2048 -nodes -days 36500 \
+  -keyout ca.key -out ca.crt -subj '/O=Pyjoyment/CN=Pyjoyment Test CA' \
+  -addext 'basicConstraints=critical,CA:TRUE' \
+  -addext 'keyUsage=critical,keyCertSign,cRLSign' \
+  -addext 'subjectKeyIdentifier=hash'
+
+openssl req -newkey rsa:2048 -nodes -keyout server.key -out server.csr -subj '/O=Pyjoyment/CN=localhost'
+printf 'basicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature,keyEncipherment\nextendedKeyUsage=serverAuth\nsubjectAltName=DNS:localhost,IP:127.0.0.1\nsubjectKeyIdentifier=hash\nauthorityKeyIdentifier=keyid\n' > server.ext
+openssl x509 -req -days 36500 -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
+  -out server.crt -extfile server.ext
+
+openssl verify -CAfile ca.crt server.crt
+```
+
+Then copy the certificates and the key into `Pyjo/IOLoop/certs`, readable by
+everyone, and delete the temporary directory, the key of the CA with it:
+
+```sh
+chmod 644 server.key
+cp ca.crt server.crt server.key "$certs/"
+cd "$certs" && rm -rf "$OLDPWD"
+```

Pyjo/IOLoop/certs/ca.crt

@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDUzCCAjugAwIBAgIUGusTwLea9+WoMwFTwdUZ02xRYGowDQYJKoZIhvcNAQEL
+BQAwMDESMBAGA1UECgwJUHlqb3ltZW50MRowGAYDVQQDDBFQeWpveW1lbnQgVGVz
+dCBDQTAgFw0yNjEwMTMyMzAwNTVaGA8yMTI2MDkxOTIzMDA1NVowMDESMBAGA1UE
+CgwJUHlqb3ltZW50MRowGAYDVQQDDBFQeWpveW1lbnQgVGVzdCBDQTCCASIwDQYJ
+KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaawIuyilsP0nJF4w9L4TCfgyg/MEib
+c0vRmzGHU25FwPd3DXLxxXvp8LAbLraV7y0ML2pBDLPnAGlZeiwj80gnjU7Xa6cz
+uf530qau29XUY2wL1DdZ8glbfXFssF5tzday6QNCBNHrmKhAM4AfHZCF8ZQba65p
+x5XO3VRuayYu4hzvbNgV/0/CbQdfLu7iQk+RepzBjhELwYOnSddXqMVEKMHJ1T1n
+G8qBP1lhZ1RZCo6sPRG/Ctsb865QrhXR/Yy3Z4PR1kMxQuWOmegDqkvFZ2eflg+6
+Tg803GIVLyD/iHNqI1Bmpra9yFAYdfDKJMKR+xi7bViUlRnaKCsuoeECAwEAAaNj
+MGEwHwYDVR0jBBgwFoAU1sNAQ516BAG2T7eAeEWnmQElItAwDwYDVR0TAQH/BAUw
+AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFNbDQEOdegQBtk+3gHhFp5kB
+JSLQMA0GCSqGSIb3DQEBCwUAA4IBAQBE/R+rlDJ8rk9NEnWbqVIDQLuguj6jf+rJ
+fALdS4puNhuyz0MHEI8VtdWyQ/LgG9gIUBtmGcmK1rA00URw9CNyYoMXARgSEerb
+M8u4I6nQX8jB2HtF2HTzwfy3VC41KpB2yGpMZGZ4wdrAOU1OF5XkV0s73leX1ID4
+iRViAJFJCusHrxZvGhy4+a+wloqHWcZulnRZ9WnwhO6dYGmNvB9hMQepBEUPchzm
+w48PwIRgzODHbpYed1Umm3DBuHJ9qnYaoiDHwubhFpnmmc0WLQ3OqAfAGrAfi8YJ
+HzMQVY4dpV2VcoHx/CLLA1c0yS/sZhRcSmyrPVZd4fTEgc7l1ZZO
+-----END CERTIFICATE-----

Pyjo/IOLoop/certs/server.crt

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDezCCAmOgAwIBAgIUExWjIj2Z0yG9TTigOtVSxDE6hQYwDQYJKoZIhvcNAQEL
+BQAwMDESMBAGA1UECgwJUHlqb3ltZW50MRowGAYDVQQDDBFQeWpveW1lbnQgVGVz
+dCBDQTAgFw0yNjEwMTMyMzAwNTVaGA8yMTI2MDkxOTIzMDA1NVowKDESMBAGA1UE
+CgwJUHlqb3ltZW50MRIwEAYDVQQDDAlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEB
+AQUAA4IBDwAwggEKAoIBAQC1kmztQGuxRLp20syf7WuJ7tGplv0IWPsLysmsCi9T
+ptQyA7EMLhXcWia67yKU0nm9h2H1oIELv0+x2+9W0zU68ZVgUuzIdeRZfBUGmaKf
+WGyr5nChOgQuRVtTPUpY2jEOo/hfTUMblp5HsyfLstT0BpO6DmK3mBHDhhvxNDia
+o9aVB+YUrCINoBExKpgCnMdWb7Tstiwfd17RecdK0Jbo6T3QgCETHsZxP/8xvAoo
+BVGZKXedDqANIgbx+l/t/ElxtMaTUg2zDryZGtNPETLm9jtqDNHX2X4lRtiUDn0e
++UFvf2G0pjzCnF+oU3BHfEg0DjoiRrpN27ga4OdEevRZAgMBAAGjgZIwgY8wDAYD
+VR0TAQH/BAIwADAOBgNVHQ8BAf8EBAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwEw
+GgYDVR0RBBMwEYIJbG9jYWxob3N0hwR/AAABMB0GA1UdDgQWBBS6+cOKqM8zZjgn
+fa9eXgRCq0BzwzAfBgNVHSMEGDAWgBTWw0BDnXoEAbZPt4B4RaeZASUi0DANBgkq
+hkiG9w0BAQsFAAOCAQEAXaP1PCz+XjDRouw6iVOegiL/nVBn84Hq66WC4VBQWhBn
+vtJC87Y6w62Mt/bB9CCWWwCwE2nIUWh96a52fKC6zkeX1hLWhYQJUtBD4Grpxe3r
+aTgcocHhQLV8kkxBPoEMQuBNFEc8rGVIy8St0GIVwan4YiL/GBOMswDQeSt7iKGt
+tTrGhBTryxK1dvZIm9XpIl9MaiwRu1MmF4prQtMvaXxFwZBu8KN2GG5whzuMOgZx
+lrz6fcaBKe3htygARqRD8qCvQBStLwJX6KVvl/0uRwkC45n67hp9dcGSr+Qp8uCe
+l2zWle6Nw9rlF36Hv/VRYo6yWQQt/xot6XQAEoXAVw==
+-----END CERTIFICATE-----

Pyjo/IOLoop/certs/server.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC1kmztQGuxRLp2
+0syf7WuJ7tGplv0IWPsLysmsCi9TptQyA7EMLhXcWia67yKU0nm9h2H1oIELv0+x
+2+9W0zU68ZVgUuzIdeRZfBUGmaKfWGyr5nChOgQuRVtTPUpY2jEOo/hfTUMblp5H
+syfLstT0BpO6DmK3mBHDhhvxNDiao9aVB+YUrCINoBExKpgCnMdWb7Tstiwfd17R
+ecdK0Jbo6T3QgCETHsZxP/8xvAooBVGZKXedDqANIgbx+l/t/ElxtMaTUg2zDryZ
+GtNPETLm9jtqDNHX2X4lRtiUDn0e+UFvf2G0pjzCnF+oU3BHfEg0DjoiRrpN27ga
+4OdEevRZAgMBAAECggEADMsSfvR0Kg81QqhHZ+jM9BDmR6hWb4NCfAIXq9YjX8Xg
+S15YeAraujYFZtQw1/LNBlo+wBVlJkheY4IjNtdGl768F0d8fMLWuincmuSSEV9j
+98gyrR92+jIjlUW7Im/MN1N9DWz2kp/uCtAAGLGC4OdCOyCmmrg9nyzItPnol5ef
+hFTxxLhES2QbYV2KHZ9+7DfIL1K2HM7FDLfdX8u2w7pXOMcfFw1Ul4S58nrQYULf
+nyDXrYYU+awcGYGsW2EYesS+AAI4h2Gd0Yse0wtqcOCYZrjhDpTB9aZ1gYS8VPsj
+/TwTWMWhyAmBwrAZ55jPR9cAds5RuRaeG5UtINWAoQKBgQDcMmqtZJdXRxeEh7P9
+IDGlsewTkOppHQBpjGVp+PrD6JOTqJgBH1hRkvX/jblviqORqmG5AWGnoJYeqpOw
+5nzalZrQKha6rdJ5h8GMwTwoO/Wgm+zHWWB25rdRMXIAkNALXG/E25ln66bZjDEQ
+I/pTI0qorX2qnNtzP4hCQHna4QKBgQDTGEO//kiyX488VpXW5VnBZPDvZ63+gmCt
+4MJWFvlg6NYQ4RICi7LLjoc71HM1uyVXPBJ7LhPhaMrtYT3froM+1ClG2OAKaNTw
+XRNtyEl61YXMEQvTHKcVJqgirFb1ozkBm46Xyl3f2xumYP+FBBULthVfnNa5wEUJ
+vXEKTbKAeQKBgQCue3jSmuHdc+TrzIhQLKGKlZjmzC8jSarY+DooJfW3JWVDXRXN
+1eOrCBPMA6aL/0SrmWJEMhcKuBIcjLfpNkp6/o8lIiTOmgws5uj0uu4LR6/UK5oN
+QQJSVXGvccnPLvDb/8xFJmnB0hZtTkxWaNvj4xQ24vqwJgkyooY7UVH9oQKBgFGl
+XO7xZyS2mSv5QVMwuhp29ElkjIOX4dTezcuGb0XwSHuW0eRyK+FXay7U6QqrK7Il
+5fAGzmGsqnBN4CSX1uOCI8TnNSBRk6q0FUOs596+n1VicnRg7K7dmMJwbeHsE6xv
+giNrfguLL5KWib3k6k7xSisE+ng1yX4O653Ul2nhAoGAYl9SDnK4lZHqVsMIMO2D
+4V+SFPpoAHFYKGM2kbRPvsWPja5WkDE0rMh50FkeDSZgkmI9/tGYkNi7d3GiM1T5
+pg2u6dPfP5kqzMHOWe6twDh/OWAXduxfiEp54GrKL1jbfr1XniKFWqqKTCeGCUU4
+QbxC3HkS17GyLy/r4Uo6+zg=
+-----END PRIVATE KEY-----

Pyjo/JSON/Pointer.py

@@ -0,0 +1,135 @@
+"""
+Pyjo.JSON.Pointer - JSON Pointers
+=================================
+::
+
+    from Pyjo.JSON.Pointer import Pointer
+
+    pointer = Pointer({'foo': [23, 'bar']})
+    print(pointer.get('/foo/1'))
+    if pointer.contains('/foo'):
+        print('Contains "/foo".')
+
+    # Or import the module, as in Google Python Style Guide
+
+    import Pyjo.JSON.Pointer
+
+    pointer = Pyjo.JSON.Pointer.new({'foo': [23, 'bar']})
+    print(pointer.get('/foo/1'))
+    if pointer.contains('/foo'):
+        print('Contains "/foo".')
+
+:mod:`Pyjo.JSON.Pointer` is an implementation of :rfc:`6901`.
+
+See also
+--------
+
+:mod:`Pyjoyment`, https://mojolicious.org.
+
+Ported from `Mojo::JSON::Pointer <https://github.com/mojolicious/mojo/blob/v9.49/lib/Mojo/JSON/Pointer.pm>`_
+of Mojolicious 9.49.
+
+Classes
+-------
+"""
+
+import Pyjo.Base
+
+import re
+
+from typing import Any, cast
+
+
+class Pyjo_JSON_Pointer(Pyjo.Base.object):
+    """
+    :mod:`Pyjo.JSON.Pointer` inherits all methods from :mod:`Pyjo.Base` and
+    implements the following new ones.
+    """
+
+    def __init__(self, data: Any = None) -> None:
+        """::
+
+            pointer = Pyjo.JSON.Pointer.new()
+            pointer = Pyjo.JSON.Pointer.new({'foo': 'bar'})
+
+        Build new :mod:`Pyjo.JSON.Pointer` object.
+        """
+        self.data: Any = data
+        """::
+
+            data = pointer.data
+            pointer.data = {'foo': 'bar'}
+
+        Data structure to be processed.
+        """
+
+    def contains(self, pointer: str) -> bool:
+        """::
+
+            boolean = pointer.contains('/foo/1')
+
+        Check if :attr:`data` contains a value that can be identified with the
+        given JSON Pointer. ::
+
+            # True
+            Pyjo.JSON.Pointer.new('just a string').contains('')
+            Pyjo.JSON.Pointer.new({'♥': 'pyjoyment'}).contains('/♥')
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5]}).contains('/foo')
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5]}).contains('/baz/1')
+
+            # False
+            Pyjo.JSON.Pointer.new({'♥': 'pyjoyment'}).contains('/☃')
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5]}).contains('/bar')
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5]}).contains('/baz/9')
+        """
+        return self._pointer(False, pointer) is not None
+
+    def get(self, pointer: str) -> Any:
+        """::
+
+            value = pointer.get('/foo/bar')
+
+        Extract value from :attr:`data` identified by the given JSON Pointer. ::
+
+            # "just a string"
+            Pyjo.JSON.Pointer.new('just a string').get('')
+
+            # "pyjoyment"
+            Pyjo.JSON.Pointer.new({'♥': 'pyjoyment'}).get('/♥')
+
+            # "bar"
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5, 6]}).get('/foo')
+
+            # 4
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5, 6]}).get('/baz/0')
+
+            # 6
+            Pyjo.JSON.Pointer.new({'foo': 'bar', 'baz': [4, 5, 6]}).get('/baz/2')
+        """
+        return self._pointer(True, pointer)
+
+    def _pointer(self, get: bool, pointer: str) -> Any:
+        data: Any = self.data
+        if not pointer.startswith('/'):
+            return None if len(pointer) else data if get else True
+        for p in pointer[1:].split('/'):
+            p = p.replace('~1', '/').replace('~0', '~')
+
+            # Hash
+            if isinstance(data, dict) and p in data:
+                data = cast(dict[str, Any], data)[p]
+
+            # Array
+            elif isinstance(data, (list, tuple)) and re.fullmatch(r'[0-9]+', p) and len(cast(list[Any], data)) > int(p):
+                data = cast(list[Any], data)[int(p)]
+
+            # Nothing
+            else:
+                return None
+
+        return data if get else True
+
+
+new = Pyjo_JSON_Pointer.new
+object = Pyjo_JSON_Pointer
+Pointer = Pyjo_JSON_Pointer