{"repo":"surrealdb/surrealdb.py","free":true,"listed":false,"github":"https://github.com/surrealdb/surrealdb.py","clone":"git clone https://github.com/surrealdb/surrealdb.py.git","description":"SurrealDB SDK for Python","language":"Python","stars":266,"topics":["surreal","surrealdb","database-connector","database","python","python-library","realtime-database","iot-database","python-module","database-sdk"],"license":"Apache-2.0","category":"databases-storage","readme_excerpt":"  The official SurrealDB SDK for Python.               surrealdb.py The official SurrealDB SDK for Python. Documentation View the SDK documentation here. How to install Quick start In this short guide, you will learn how to install, import, and initialize the SDK, as well as perform the basic data manipulation queries. This guide uses the Surreal class, but this example would also work with AsyncSurreal class, with the addition of await in front of the class methods. Running SurrealDB You can run SurrealDB locally or start with a free SurrealDB cloud account. For local, two options: 1. Install SurrealDB and run SurrealDB. Run in-memory with: 2. Run with Docker. Learn the basics CRUD builder pattern (v3.0) create , update , upsert , delete , and insert return an awaitable (or lazy, for sync) builder. The builder exposes chainable clause methods that map directly to SurrealQL clauses. The builder is typed via @overload : - RecordID target - dict[str, Value] - Table target - list[Value] - str target - Value (a record-id string returns a dict; a table-name string returns a list - the type checker can't tell them apart, so falls back to Value ) select() (async and sync) always runs eagerly and unwraps single records: - select(RecordID(...)) (or a \"table:id\" string) - dict[str, Value] None ( None when the record does not exist) - select(Table(...)) (or a bare table-name string) - list[Value] What a RecordID and a Table accept Both constructor","default_branch":null,"files":null,"tree":[],"storefront":"/r/surrealdb","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/surrealdb/surrealdb.py/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}