feat(python): update readme

Author: geonnave

lakers-python/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
-name = "lakers-python"
+name = "lakers-python" # this will be the name of the package on pypi
 edition = "2021"
-version ="0.1.0"
+version ="0.1.2"
 repository.workspace = true
 license.workspace = true
 
@@ -14,5 +14,5 @@ lakers-shared = { path = "../shared", features = ["python-bindings"] }
 lakers-crypto = { path = "../crypto", default-features = false, features = ["rustcrypto"] }
 
 [lib]
-name = "lakers" # this will be the name of the python package, and it must match the module name in lib.rs
+name = "lakers" # this will be the name of the python package (as in `import lakers`), and it must match the module name in lib.rs
 crate-type = ["cdylib"]

lakers-python/README.md

@@ -1,13 +1,36 @@
 # Lakers Python
-Python wrapper for the `lakers` crate.
+Python wrapper for the [`lakers` crate](https://github.com/openwsn-berkeley/lakers).
+
+# Installation and usage
+
+```console
+pip install lakers-python
+```
+
+```python
+import lakers
+
+# generate a keypair
+lakers.p256_generate_key_pair()
+
+# instantiate a initiator and prepare EDHOC's message 1
+initiator = lakers.EdhocInitiator()
+message_1 = initiator.prepare_message_1(c_i=None, ead_1=None)
+
+# for more examples, see the tests in the repository
+```
+
+# Development
 
 To build and test:
 ```bash
 maturin develop
 pytest
 ```
 
-# Requirements
+## Requirements
+
+The maturin executable must be available. The recommended way is to install and use it in a virtual environment:
 
 ```
 python3 -m venv .venv