edgedb-rust
edgedb-rust copied to clipboard
`edgedb` crate structure
We has always wanted to expose bindings under edgedb crate instead of the edgedb-tokio/whatever. But the structure of that is not very clear. Here is a sketch of my current thinking.
- Expose
edgedb::model,edgedb::error, and whatever is needed for derive macros. - Feature
tokio: exposesedgedb::tokio - Feature
blocking: exposesedgedb::blocking(which probably a blocking wrapper around tokio) - We might have
default-tokioanddefault-blockingclient which expose respective clients to the top-level namespaceedgedb::tokio::Client -> edgedb::client,edgedb::blocking::Client -> edgedb::Client. - Potentically async-std/glommio or whatever new runtime can be done via it's own crate and brought here via feature flag. Also blocking implementation that doesn't depend on tokio could be implemented in the future too.
Ideally when async traits arrive to the stable Rust here is how it should work:
- There is an
edgedb-asynccrate which contains traits for executing queries - Libraries (which are not end-user apps) depend on
edgedb-modelandedgedb-async, but notedgedbcrate (it's unclear how that would work withedgedb-derive, though). - When we bump major version of
edgedbonly app could be updated - When we bump major version of
edgedb-modelandedgedb-asyncwe do adapters that allow libraries using older versions to work (i.e. transform to new types, seelogcrate for an inspiration)
But I'm not sure whether this is practical enough, and/or when this will become practical.