@tishlang/tish 1.7.0 → 1.9.0

package/crates/tish_pg/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "tishlang_pg"
+version = "0.1.0"
+edition = "2021"
+description = "PostgreSQL driver for the Tish native runtime — tokio-postgres + deadpool"
+license-file = { workspace = true }
+repository = { workspace = true }
+
+[lib]
+name = "tishlang_pg"
+crate-type = ["rlib"]
+
+[features]
+default = ["tish-bindings"]
+# Exposes sync `pub fn(args: &[Value]) -> Value` wrappers for the bytecode VM
+# (`cargo:tish_pg` module URL, registered by the `tishlang` CLI when built with `pg`).
+tish-bindings = ["dep:tishlang_runtime", "dep:once_cell", "dep:slab"]
+
+[dependencies]
+tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
+tokio-postgres = { version = "0.7", features = ["with-serde_json-1", "with-uuid-1", "with-chrono-0_4"] }
+futures = "0.3"
+deadpool = "0.12"
+deadpool-postgres = "0.14"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+thiserror = "1"
+url = "2"
+tishlang_runtime = { path = "../tish_runtime", version = ">=0.1", optional = true, features = ["send-values"] }
+once_cell = { version = "1", optional = true }
+slab = { version = "0.4", optional = true }
+
+[dev-dependencies]
+tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

package/crates/tish_pg/README.md

@@ -0,0 +1,38 @@
+# tishlang_pg
+
+**PostgreSQL for Tish** — a Rust library (`rlib`) that **Tish-compiled programs** use: Tish compiles to native Rust, and this crate is a normal Rust dependency of that output, so **authors still write `.tish`**.
+
+## What this is **not**
+
+- **No Node.js** / no N-API in this crate
+- No JavaScript runtime in the driver itself
+
+## What this **is**
+
+- **`tokio-postgres`** + **`deadpool-postgres`** for the wire protocol and pooling.
+- A **Rust API** (`PgPool`, `PoolConfig`, `QueryResult`) plus Tish-facing bindings (`cargo:tish_pg`) used when the CLI is built with the **`pg`** feature.
+
+## From `.tish` (npm package)
+
+Install the scoped package and import the same surface as the standalone `tish-pg` repo used to ship:
+
+```tish
+import { connect, queryPrepared, prepare, close } from '@tishlang/pg'
+```
+
+Requires **`tish run` / `tish build` with the `pg` feature** (included in the default `full` feature set).
+
+## Building in this workspace
+
+From the `tish` repo root:
+
+```bash
+cargo build -p tishlang_pg
+cargo test -p tishlang_pg
+```
+
+See the workspace [`justfile`](../../justfile) for common tasks.
+
+## License
+
+Same as the parent workspace (`LICENSE` at repo root).

package/crates/tish_pg/src/error.rs

@@ -0,0 +1,52 @@
+use std::fmt::Write as _;
+use std::error::Error as StdError;
+
+use deadpool::managed::PoolError;
+use thiserror::Error;
+
+/// `tokio_postgres::Error`’s [`Display`] is often just `"db error"` for server
+/// faults; the real text lives on [`tokio_postgres::Error::as_db_error`].
+pub fn format_pg_error(e: &tokio_postgres::Error) -> String {
+    if let Some(db) = e.as_db_error() {
+        let mut s = format!("{} [{}]", db.message(), db.code().code());
+        if let Some(d) = db.detail() {
+            let _ = write!(s, " ({})", d);
+        }
+        if let Some(h) = db.hint() {
+            let _ = write!(s, " hint: {}", h);
+        }
+        return s;
+    }
+    let mut out = e.to_string();
+    if let Some(src) = e.source() {
+        let _ = write!(out, " ({})", src);
+    }
+    out
+}
+
+pub fn format_tish_pg_error(e: &TishPgError) -> String {
+    match e {
+        TishPgError::Postgres(pg) => format_pg_error(pg),
+        TishPgError::Pool(pe) => match pe {
+            PoolError::Backend(pg) => format_pg_error(pg),
+            _ => pe.to_string(),
+        },
+        _ => e.to_string(),
+    }
+}
+
+#[derive(Debug, Error)]
+pub enum TishPgError {
+    #[error("invalid connection string: {0}")]
+    BadConnectionString(String),
+    #[error("invalid query parameter: {0}")]
+    BadParam(String),
+    #[error("postgres: {0}")]
+    Postgres(#[from] tokio_postgres::Error),
+    #[error("pool: {0}")]
+    Pool(#[from] deadpool::managed::PoolError<tokio_postgres::Error>),
+    #[error("build pool: {0}")]
+    Build(#[from] deadpool_postgres::BuildError),
+}
+
+pub type Result<T> = std::result::Result<T, TishPgError>;