postrust-server 0.4.0

PostgREST-compatible REST and GraphQL API server for PostgreSQL, built on Axum
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

[package]
name = "postrust-server"
version.workspace = true
edition.workspace = true
license.workspace = true
repository.workspace = true
authors.workspace = true
description = "PostgREST-compatible REST and GraphQL API server for PostgreSQL, built on Axum"
homepage.workspace = true
readme = "README.md"
keywords = ["postgres", "rest", "api", "graphql", "server"]

[[bin]]
name = "postrust"
path = "src/main.rs"

# musl's allocator serialises heavily under multithreaded load. Measured on the
# Alpine image: the GraphQL embed scenario ran at 636 req/s against 4,379 for
# the same code built with glibc, with the database image held constant to rule
# it out. mimalloc closes that gap and is only pulled in for musl targets.
[target.'cfg(target_env = "musl")'.dependencies]
mimalloc = "0.1"

[features]
default = []
admin-ui = ["utoipa", "postrust-graphql", "async-graphql", "async-graphql-axum"]

# Return object keys in the order the columns were selected, as PostgREST does,
# rather than alphabetically.
#
# This cannot be a runtime setting. Key order follows from whether
# `serde_json::Map` is a BTreeMap or an IndexMap, which is fixed when the crate
# is compiled, so it is a feature rather than a flag in the config.
#
# Off by default because it is not free. Measured by running both builds as
# containers against one database and alternating between them: a 3-column
# response cost 1%, an 8-column response 15%. For small objects a handful of
# short string comparisons beats hashing every key, so the sorted map is
# genuinely the faster one here.
#
# Turn it on when byte-level PostgREST compatibility matters more than that.
compat-key-order = ["serde_json/preserve_order"]

[dependencies]
# Async
tokio.workspace = true
async-trait.workspace = true

# Web
axum.workspace = true
tower.workspace = true
tower-http.workspace = true
hyper.workspace = true

# Database
sqlx.workspace = true

# Serialization
serde.workspace = true
serde_json.workspace = true

# Error handling
thiserror.workspace = true
anyhow.workspace = true

# Utilities
http.workspace = true
bytes.workspace = true
tracing.workspace = true
tracing-subscriber.workspace = true
chrono.workspace = true

# Internal
postrust-core.workspace = true
postrust-sql.workspace = true
postrust-auth.workspace = true
postrust-response.workspace = true

# Admin UI (optional)
utoipa = { version = "5", features = ["axum_extras"], optional = true }
postrust-graphql = { workspace = true, optional = true }
async-graphql = { version = "7", optional = true }
async-graphql-axum = { version = "7", optional = true }

[dev-dependencies]
pretty_assertions.workspace = true