SeaQL / SeaQL/sea-orm

Compare with Diesel page is heavily outdated

Open
#2,438 0 comments 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Area:docs
Dominant language
Rust
Stars
9.9k
Forks
735
Avg merge
6h 36m
Merged PRs (30d)
8

Description

The Compare with Diesel page on your webpage is heavily outdated.

The following points are not correct (anymore):

Diesel uses native drivers by default and it may take some effort for you to replace it with a pure Rust driver. Each side has their pros and cons, so it's up to your preference.

Diesel-async provides pure rust drivers for all backends but SQLite.

You can also do dynamic queries with Diesel, but you'd lose some of the benefits of compile-time type-checking.

That's just not correct. All dynamic queries build with diesel's query DSL are also checked at compile time

While in the Diesel ecosystem there are awesome libraries like barrel,

Barrel is deprecated for a long while, instead there is now a built-in schema management tool in diesel's CLI (for more than a year now…)

SeaORM is very new.

I think you can drop the "very new" classification here and instead also call yourself well established.

Additionally I personally feel that this part sounds a bit misleading, given that diesel-async now also exists for several years:

First off, perhaps the number one requested feature, async Rust support. While using async may not offer you better performance today, programming in async is an architectural decision you have to make early on. By choosing SeaORM, we together look forward to Rust's async ecosystem maturing.

(To be clear here it's technically not wrong, it just make it sound like you cannot use diesel in an async context)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Compare with Diesel page at https://www.sea-ql.org/SeaORM/docs/internal-design/diesel/ and review each quoted comparison against the issue details. Update the driver, dynamic-query, schema-management, SeaORM maturity, and async-support wording so the page reflects diesel-async and Diesel CLI; done means all listed claims are accurate and the async comparison is not misleading.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
databases, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.