feat: new_lifespan to allow configuring sqla engine directly

[hadrien]

Problem

• We cannot configure connect_args with environment variables
• Fixes Enabling Non-Legacy SQLite Transactional Modes #24

Solution

• add new_lifespan to allow passing sqla engine parameters directly:

  from fastapi import FastAPI
  from fastsqla import new_lifespan
  
  lifespan = new_lifespan(
      "sqlite+aiosqlite:///app/db.sqlite"), connect_args={"autocommit": False}
  )
  
  app = FastAPI(lifespan=lifespan)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (3be5771) to head (794d8bc).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main       #25   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         1           
  Lines          100       108    +8     
  Branches         6         7    +1     
=========================================
+ Hits           100       108    +8     

Flag	Coverage Δ
default	100.00% <100.00%> (ø)
sqlmodel	98.14% <100.00%> (+0.14%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[hadrien]

@vicrep What do you think? thanks!

[vicrep]

This is great, thanks for doing this @hadrien !

I liked the 12-factor-style-config being the default recommended approach, but for some specific setups, and nested config args (eg. that reported issue), the ergonomics of doing it fully through environ were at times lacking.

[hyperknot]

Super nice, thank you for the quick fix!

[hadrien]

/songify

[diffbeats]

🎵 DiffBeats just dropped a track for this PR!

"feat: new_lifespan to allow configuring sqla engine directly"

🎧 Listen now →

Lyrics

First off, a feature request, it's brand new
Configure the engine, it's what we gonna do
Environment variables, a tricky little thing
But with this fix, what joy it will bring

[Chorus]
Oh, lifespan's got a new groove, spinning round
Configuring the engine, safe and sound
SQL a, the hero, in the code we see
Fixing that ticket, number two-four, you and me

Verse two, where the magic starts to flow
Fast API, ready to put on a show
New lifespan, a key that's been unchained
Engine parameters, they've been rearranged

[Chorus]
Oh, lifespan's got a new groove, spinning round
Configuring the engine, safe and sound
SQL a, the hero, in the code we see
Fixing that ticket, number two-four, you and me

Bridge, it's a tight squeeze, a technical plea
Passing parameters directly, wild and free
Connect args, a secret, cannot be named
Autocommit is false, the game well tamed

[Chorus]
Oh, lifespan's got a new groove, spinning round
Configuring the engine, safe and sound
SQL a, the hero, in the code we see
Fixing that ticket, number two-four, you and me