python3-olm 3.2.18__cp313-cp313-win_amd64.whl

python3_olm-3.2.18.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: python3-olm
+Version: 3.2.18
+Summary: python CFFI bindings for the olm cryptographic ratchet library
+Author-email: Damir Jelić <poljar@termina.org.uk>
+License: Apache-2.0
+Project-URL: homepage, https://gitlab.matrix.org/matrix-org/olm/-/tree/master/python
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Topic :: Communications
+Requires-Python: <4.0.0,>=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: cffi>=1.0.0
+
+python-olm
+==========
+
+Python bindings for Olm.
+
+The specification of the Olm cryptographic ratchet which is used for peer to
+peer sessions of this library can be found [here][4].
+
+The specification of the Megolm cryptographic ratchet which is used for group
+sessions of this library can be found [here][5].
+
+An example of the implementation of the Olm and Megolm cryptographic protocol
+can be found in the Matrix protocol for which the implementation guide can be
+found [here][6].
+
+The full API reference can be found [here][7].
+
+# Installation instructions
+
+To install from the source package, you will need:
+
+- cmake (recommended) or GNU make
+- a C/C++ compiler
+
+You can then run `pip install python-olm`.
+
+This should work in UNIX-like environments, including macOS, and may work in
+other environments too, but is known to not work yet in Windows.
+
+# Accounts
+
+Accounts create and hold the central identity of the Olm protocol, they consist of a fingerprint and identity
+key pair. They also produce one time keys that are used to start peer to peer
+encrypted communication channels.
+
+## Account Creation
+
+A new account is created with the Account class, it creates a new Olm key pair.
+The public parts of the key pair are available using the identity_keys property
+of the class.
+
+```python
+>>> alice = Account()
+>>> alice.identity_keys
+{'curve25519': '2PytGagXercwHjzQETLcMa3JOsaU2qkPIESaqoi59zE',
+ 'ed25519': 'HHpOuFYdHwoa54GxSttz9YmaTmbuVU3js92UTUjYJgM'}
+```
+
+
+## One Time keys
+
+One time keys need to be generated before people can start an encrypted peer to
+peer channel to an account.
+
+```python
+>>> alice.generate_one_time_keys(1)
+>>> alice.one_time_keys
+{'curve25519': {'AAAAAQ': 'KiHoW6CIy905UC4V1Frmwr3VW8bTWkBL4uWtWFFllxM'}}
+```
+
+After the one time keys are published they should be marked as such so they
+aren't reused.
+
+```python
+>>> alice.mark_keys_as_published()
+>>> alice.one_time_keys
+{'curve25519': {}}
+```
+
+## Pickling
+
+Accounts should be stored for later reuse, storing an account is done with the
+pickle method while the restoring step is done with the from_pickle class
+method.
+
+```python
+>>> pickle = alice.pickle()
+>>> restored = Account.from_pickle(pickle)
+```
+
+# Sessions
+
+Sessions are used to create an encrypted peer to peer communication channel
+between two accounts.
+
+## Session Creation
+```python
+>>> alice = Account()
+>>> bob = Account()
+>>> bob.generate_one_time_keys(1)
+>>> id_key = bob.identity_keys["curve25519"]
+>>> one_time = list(bob.one_time_keys["curve25519"].values())[0]
+>>> alice_session = OutboundSession(alice, id_key, one_time)
+```
+
+## Encryption
+
+After an outbound session is created an encrypted message can be exchanged:
+
+```python
+>>> message = alice_session.encrypt("It's a secret to everybody")
+>>> message.ciphertext
+'AwogkL7RoakT9gnjcZMra+y39WXKRmnxBPEaEp6OSueIA0cSIJxGpBoP8YZ+CGweXQ10LujbXMgK88
+xG/JZMQJ5ulK9ZGiC8TYrezNYr3qyIBLlecXr/9wnegvJaSFDmWDVOcf4XfyI/AwogqIZfAklRXGC5b
+ZJcZxVxQGgJ8Dz4OQII8k0Dp8msUXwQACIQvagY1dO55Qvnk5PZ2GF+wdKnvj6Zxl2g'
+>>> message.message_type
+0
+```
+
+After the message is transfered, bob can create an InboundSession to decrypt the
+message.
+
+```python
+>>> bob_session = InboundSession(bob, message)
+>>> bob_session.decrypt(message)
+"It's a secret to everybody"
+```
+
+## Pickling
+
+Sessions like accounts can be stored for later use the API is the same as for
+accounts.
+
+```python
+>>> pickle = session.pickle()
+>>> restored = Session.from_pickle(pickle)
+```
+
+# Group Sessions
+
+Group Sessions are used to create a one-to-many encrypted communication channel.
+The group session key needs to be shared with all participants that should be able
+to decrypt the group messages. Another thing to notice is that, since the group
+session key is ratcheted every time a message is encrypted, the session key should
+be shared before any messages are encrypted.
+
+## Group Session Creation
+
+Group sessions aren't bound to an account like peer-to-peer sessions so their
+creation is straightforward.
+
+```python
+>>> alice_group = OutboundGroupSession()
+>>> bob_inbound_group = InboundGroupSession(alice_group.session_key)
+```
+
+## Group Encryption
+
+Group encryption is pretty simple. The important part is to share the session
+key with all participants over a secure channel (e.g. peer-to-peer Olm
+sessions).
+
+```python
+>>> message = alice_group.encrypt("It's a secret to everybody")
+>>> bob_inbound_group.decrypt(message)
+("It's a secret to everybody", 0)
+```
+
+## Pickling
+
+Pickling works the same way as for peer-to-peer Olm sessions.
+
+```python
+>>> pickle = session.pickle()
+>>> restored = InboundGroupSession.from_pickle(pickle)
+```
+[1]: https://git.matrix.org/git/olm/about/
+[2]: https://git.matrix.org/git/olm/tree/python?id=f8c61b8f8432d0b0b38d57f513c5048fb42f22ab
+[3]: https://cffi.readthedocs.io/en/latest/
+[4]: https://git.matrix.org/git/olm/about/docs/olm.rst
+[5]: https://git.matrix.org/git/olm/about/docs/megolm.rst
+[6]: https://matrix.org/docs/guides/end-to-end-encryption-implementation-guide
+[7]: https://poljar.github.io/python-olm/html/index.html

python3_olm-3.2.18.dist-info/RECORD

@@ -0,0 +1,15 @@
+_libolm.pyd,sha256=324poEL0fw8v1qnHTiAPUJBS6iKxtHEngnoubIvGcLE,287744
+olm/__init__.py,sha256=da1JTzBIEMe2CVqvmy4mXjjIGlzQy7PcPW_IRk3S0s8,1489
+olm/_compat.py,sha256=jfSCAA_RWK5xJ9wv99NZ-zsItcnGqJnZPsFrOUP_jXA,2410
+olm/_finalize.py,sha256=QAHFUr5GQoCRc6nNvV93Rm3bVKv-wEKRCrUExdAvUu0,2277
+olm/account.py,sha256=BxfvJei-QOSHiLZUUDCXlLL4_BcOvKgy6U44_7vGgYU,12194
+olm/group_session.py,sha256=buKNmbLvM0ih0gFbbF6zFCIl1n_khxP859MaKY78Xbc,19477
+olm/pk.py,sha256=WaXNM67PiBm6RdyXJMbeRD3K4eVNhBTATaqxi6ZjpE0,15036
+olm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+olm/sas.py,sha256=ScRwsDywgZyZGj4uYdjS0lqGKvhut7-02k0wpx-kSvU,8730
+olm/session.py,sha256=xoHBT9ad2wDmcwXMIJQi1YMUOGuRDthjYa5WXMNPOKM,19697
+olm/utility.py,sha256=VkGjTy_Pas3JQ2YxSF6D6zlEtu5TVXWIAnoGPUpl7p8,4548
+python3_olm-3.2.18.dist-info/METADATA,sha256=h1ngYuO7UAjhXo_pLo6efeHH16ev8DDiI9_eaPh3w4g,5694
+python3_olm-3.2.18.dist-info/WHEEL,sha256=x5Wpw_tLx5PQKiWdxpqvs0e7Sg-SO0mTWdEADYDGPGA,101
+python3_olm-3.2.18.dist-info/top_level.txt,sha256=sogtEKKsrbWWMXwOlv_q_6mSjqy0gOFb2UEUNpRDRN0,12
+python3_olm-3.2.18.dist-info/RECORD,,

python3_olm-3.2.18.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64
+

python3_olm-3.2.18.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_libolm
+olm