docs(python): python bindings go brrrrr

Author: Arqu

command-code-examples/python/author-list.py

@@ -0,0 +1,13 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+authors = node.author_list()
+for auth in authors:
+    print("Author: {}".format(auth.to_string()))

command-code-examples/python/author-new.py

@@ -0,0 +1,9 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))

command-code-examples/python/doc-get.py

@@ -1,9 +1,19 @@
 import iroh
 
-node = iroh.node()
-author = node.create_author()
-doc = node.create_doc()
+IROH_DATA_DIR = "./iroh-data"
 
-doc.set_bytes(author, bytes("foo", "utf8"), bytes("bar", "utf8"))
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
 
-doc.get_bytes(bytes("foo", "utf8"))
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+doc = node.doc_new()
+print("Created doc: {}".format(doc.id()))
+
+hash = doc.set_bytes(author, bytes("foo", "utf8"), bytes("bar", "utf8"))
+print("Inserted: {}".format(hash.to_string()))
+
+# FIXME: this doesn't work yet
+# content = doc.get_content_bytes(hash)
+# print("Got content: {}".format(content.decode("utf8")))

command-code-examples/python/doc-join.py

@@ -0,0 +1,14 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+# you'll need to get a ticket from somewhere, see the `doc share` command documentation
+# for details. This ticket will fail to join, but is a valid ticket.
+TICKET_STRING = "sdx7wazju2rysqydgfpmhqkrluc5lbcuainravjipwmbl7r3k3uqcigncyopdcnooufnteu5vuatpzhoqrml35ifgyuozr6kwhjiz4jxyaaqcbiajbmsainmsmbqcjqaibavg5hiaaaaaaaaaaabad47sebqbqfiiqzkzeydadakqrckvsjqgajgabaecu3u5aaaaaaaaaaaaeagt6iqg"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+doc_ticket = iroh.DocTicket.from_string(TICKET_STRING)
+doc = node.doc_join(doc_ticket)
+print("Joined doc: {}".format(doc.id()))

command-code-examples/python/doc-keys.py

@@ -0,0 +1,21 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+doc = node.doc_new()
+print("Created doc: {}".format(doc.id()))
+
+for i, key in enumerate(['a', 'b', 'c']):
+    doc.set_bytes(author, bytes(key, "utf8"), bytes(str(i), "utf8"))
+
+keys = doc.keys()
+print("Keys:")
+for key in keys:
+    content = doc.get_content_bytes(key)
+    print("{} : {} (hash: {})".format(key.key(), content.decode("utf8"), key.hash().to_string()))

command-code-examples/python/doc-new.py

@@ -0,0 +1,12 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+doc = node.doc_new()
+print("Created doc: {}".format(doc.id()))

command-code-examples/python/doc-set.py

@@ -1,9 +1,19 @@
 import iroh
 
-node = iroh.node()
-author = node.create_author()
-doc = node.create_doc()
+IROH_DATA_DIR = "./iroh-data"
 
-doc.set_bytes(author, bytes("foo", "utf8"), bytes("bar", "utf8"))
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
 
-doc.get_bytes(bytes("foo", "utf8"))
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+doc = node.doc_new()
+print("Created doc: {}".format(doc.id()))
+
+hash = doc.set_bytes(author, bytes("foo", "utf8"), bytes("bar", "utf8"))
+print("Inserted: {}".format(hash.to_string()))
+
+# FIXME: this doesn't work yet
+# content = doc.get_content_bytes(hash)
+# print("Got content: {}".format(content.decode("utf8")))

command-code-examples/python/doc-share.py

@@ -0,0 +1,15 @@
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+doc = node.doc_new()
+print("Created doc: {}".format(doc.id()))
+
+ticket = doc.share_write()
+print("Write-Access Ticket: {}".format(ticket.to_string()))

src/app/docs/commands/author-list/page.mdx

@@ -27,6 +27,23 @@ i3vpd4e7coeonwv6otni36bdux73opig5du6zjekvnl3c64gn4ua
 wkl4cgrykxvcvr6pjnbvymrzm7h4je7d4ztszp35xfnk2rnflcxq
 ```
 
+```python {{ title: 'python' }}
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+authors = node.author_list()
+for auth in authors:
+    print("Author: {}".format(auth.to_string()))
+
+```
+
 ```swift {{ title: 'go' }}
 package main
 

src/app/docs/commands/author-new/page.mdx

@@ -37,6 +37,19 @@ author:2rkuvpk4…
 >
 ```
 
+```python {{ title: 'python' }}
+import iroh
+
+IROH_DATA_DIR = "./iroh-data"
+
+node = iroh.IrohNode(IROH_DATA_DIR)
+print("Started Iroh node: {}".format(node.node_id()))
+
+author = node.author_new()
+print("Created author: {}".format(author.to_string()))
+
+```
+
 ```swift {{ title: 'go' }}
 package main