{"id":51509503,"url":"https://github.com/murphsicles/zsql","last_synced_at":"2026-07-08T04:30:57.008Z","repository":{"id":361087679,"uuid":"1253051348","full_name":"murphsicles/zsql","owner":"murphsicles","description":"@db/zsql — Lightweight embedded SQL database for Zeta","archived":false,"fork":false,"pushed_at":"2026-05-29T05:39:39.000Z","size":106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T07:27:48.196Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/murphsicles.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T05:39:36.000Z","updated_at":"2026-05-29T05:39:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/murphsicles/zsql","commit_stats":null,"previous_names":["murphsicles/zsql"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/murphsicles/zsql","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murphsicles%2Fzsql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murphsicles%2Fzsql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murphsicles%2Fzsql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murphsicles%2Fzsql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/murphsicles","download_url":"https://codeload.github.com/murphsicles/zsql/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/murphsicles%2Fzsql/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35252324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-08T04:30:56.296Z","updated_at":"2026-07-08T04:30:56.995Z","avatar_url":"https://github.com/murphsicles.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZSQL\n\n[![Zeta](https://img.shields.io/badge/Zeta-Language-%23FF6B6B?style=flat-square)](https://zeta-lang.org)\n[![zorbs.io](https://img.shields.io/badge/zorbs.io-@db/zsql-%2300C4FF?style=flat-square)](https://zorbs.io/@db/zsql)\n[![GitHub](https://img.shields.io/badge/GitHub-murphsicles/zsql-%23181717?style=flat-square)](https://github.com/murphsicles/zsql)\n\nLightweight embedded SQL database for Zeta. ZSQL wraps SQLite3 — giving you a zero-config, serverless SQL engine backed by the most widely deployed database engine in the world.\n\nZSQL is a companion to [Zenith](https://zorbs.io/@db/zenith) — use Zenith for fast in-memory key-value workloads and ZSQL for persistent SQL querying.\n\n## Quick Start\n\nAdd to your `zorb.toml`:\n\n```toml\n[dependencies]\n@db/zsql = \"1.0\"\n```\n\nOpen a database and execute queries:\n\n```zeta\nuse @db/zsql::Connection;\n\nfn main() {\n    let conn = Connection::open(\"my_data.db\").unwrap();\n\n    conn.execute(\"CREATE TABLE IF NOT EXISTS users (\n        id    INTEGER PRIMARY KEY,\n        name  TEXT NOT NULL,\n        age   INTEGER\n    )\", []).unwrap();\n\n    conn.execute(\"INSERT INTO users (name, age) VALUES (?1, ?2)\",\n        params_from_iter([\"Alice\".into(), \"30\".into()])).unwrap();\n\n    let mut stmt = conn.prepare(\"SELECT id, name, age FROM users WHERE age \u003e ?1\").unwrap();\n    let rows = stmt.query_map([25], |row| {\n        (row.get::\u003ci32\u003e(0).unwrap(), row.get::\u003cString\u003e(1).unwrap(), row.get::\u003ci32\u003e(2).unwrap())\n    }).unwrap();\n\n    for row in rows {\n        let (id, name, age) = row.unwrap();\n        print(\"User {}: {} (age {})\\n\", id, name, age);\n    }\n}\n```\n\n## In-Memory Database\n\n```zeta\nlet conn = Connection::open_in_memory().unwrap();\nconn.execute_batch(\"CREATE TABLE t (x INTEGER); INSERT INTO t VALUES (1), (2), (3);\").unwrap();\n```\n\n## Transactions\n\n```zeta\nlet tx = conn.transaction_with_behavior(TransactionBehavior::Immediate, true).unwrap();\ntx.execute(\"UPDATE accounts SET balance = balance - 100 WHERE id = 1\", []).unwrap();\ntx.commit().unwrap();\n```\n\n## API\n\n| Function / Type | Description |\n|----------------|-------------|\n| `Connection::open(path)` | Open or create a SQLite database file |\n| `Connection::open_in_memory()` | Create an in-memory database |\n| `conn.execute(sql, params)` | Execute a query |\n| `conn.prepare(sql)` | Prepare a statement |\n| `stmt.query_map(params, f)` | Execute and map rows |\n| `conn.transaction()` | Begin a transaction |\n| `Transaction::commit()` / `.rollback()` | Commit or roll back |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurphsicles%2Fzsql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmurphsicles%2Fzsql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmurphsicles%2Fzsql/lists"}