pax_global_header 0000666 0000000 0000000 00000000064 15070515525 0014517 g ustar 00root root 0000000 0000000 52 comment=c7b9b1c68103eeb8dd4a4664e83551197dfb1074
litestar-2.18.0/ 0000775 0000000 0000000 00000000000 15070515525 0013436 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.all-contributorsrc 0000664 0000000 0000000 00000147045 15070515525 0017302 0 ustar 00root root 0000000 0000000 {
"files": [
"README.md"
],
"imageSize": 100,
"commit": false,
"contributors": [
{
"login": "Goldziher",
"name": "Na'aman Hirschfeld",
"avatar_url": "https://avatars.githubusercontent.com/u/30733348?v=4",
"profile": "https://www.linkedin.com/in/nhirschfeld/",
"contributions": [
"maintenance",
"code",
"doc",
"test",
"ideas",
"example",
"bug"
]
},
{
"login": "peterschutt",
"name": "Peter Schutt",
"avatar_url": "https://avatars.githubusercontent.com/u/20659309?v=4",
"profile": "https://github.com/peterschutt",
"contributions": [
"maintenance",
"code",
"doc",
"test",
"ideas",
"example",
"bug"
]
},
{
"login": "ashwinvin",
"name": "Ashwin Vinod",
"avatar_url": "https://avatars.githubusercontent.com/u/38067089?v=4",
"profile": "https://ashwinvin.github.io",
"contributions": [
"code",
"doc"
]
},
{
"login": "dkress59",
"name": "Damian",
"avatar_url": "https://avatars.githubusercontent.com/u/28515387?v=4",
"profile": "http://www.damiankress.de",
"contributions": [
"doc"
]
},
{
"login": "vincentsarago",
"name": "Vincent Sarago",
"avatar_url": "https://avatars.githubusercontent.com/u/10407788?v=4",
"profile": "https://remotepixel.ca",
"contributions": [
"code"
]
},
{
"login": "JonasKs",
"name": "Jonas Krüger Svensson",
"avatar_url": "https://avatars.githubusercontent.com/u/5310116?v=4",
"profile": "https://hotfix.guru",
"contributions": [
"platform"
]
},
{
"login": "sondrelg",
"name": "Sondre Lillebø Gundersen",
"avatar_url": "https://avatars.githubusercontent.com/u/25310870?v=4",
"profile": "https://github.com/sondrelg",
"contributions": [
"platform"
]
},
{
"login": "vrslev",
"name": "Lev",
"avatar_url": "https://avatars.githubusercontent.com/u/75225148?v=4",
"profile": "https://github.com/vrslev",
"contributions": [
"code",
"ideas"
]
},
{
"login": "timwedde",
"name": "Tim Wedde",
"avatar_url": "https://avatars.githubusercontent.com/u/20231751?v=4",
"profile": "https://github.com/timwedde",
"contributions": [
"code"
]
},
{
"login": "tclasen",
"name": "Tory Clasen",
"avatar_url": "https://avatars.githubusercontent.com/u/11999013?v=4",
"profile": "https://github.com/tclasen",
"contributions": [
"code"
]
},
{
"login": "Bobronium",
"name": "Arseny Boykov",
"avatar_url": "https://avatars.githubusercontent.com/u/36469655?v=4",
"profile": "http://t.me/Bobronium",
"contributions": [
"code",
"ideas"
]
},
{
"login": "yudjinn",
"name": "Jacob Rodgers",
"avatar_url": "https://avatars.githubusercontent.com/u/7493084?v=4",
"profile": "https://github.com/yudjinn",
"contributions": [
"example"
]
},
{
"login": "danesolberg",
"name": "Dane Solberg",
"avatar_url": "https://avatars.githubusercontent.com/u/25882507?v=4",
"profile": "https://github.com/danesolberg",
"contributions": [
"code"
]
},
{
"login": "madlad33",
"name": "madlad33",
"avatar_url": "https://avatars.githubusercontent.com/u/54079440?v=4",
"profile": "https://github.com/madlad33",
"contributions": [
"code"
]
},
{
"login": "Butch78",
"name": "Matthew Aylward ",
"avatar_url": "https://avatars.githubusercontent.com/u/19205392?v=4",
"profile": "http://matthewtyleraylward.com",
"contributions": [
"code"
]
},
{
"login": "Joko013",
"name": "Jan Klima",
"avatar_url": "https://avatars.githubusercontent.com/u/30841710?v=4",
"profile": "https://github.com/Joko013",
"contributions": [
"code"
]
},
{
"login": "i404788",
"name": "C2D",
"avatar_url": "https://avatars.githubusercontent.com/u/50617709?v=4",
"profile": "https://github.com/i404788",
"contributions": [
"test"
]
},
{
"login": "to-ph",
"name": "to-ph",
"avatar_url": "https://avatars.githubusercontent.com/u/84818322?v=4",
"profile": "https://github.com/to-ph",
"contributions": [
"code"
]
},
{
"login": "imbev",
"name": "imbev",
"avatar_url": "https://avatars.githubusercontent.com/u/105524473?v=4",
"profile": "https://imbev.gitlab.io/site",
"contributions": [
"doc"
]
},
{
"login": "185504a9",
"name": "cătălin",
"avatar_url": "https://avatars.githubusercontent.com/u/45485069?v=4",
"profile": "https://git.roboces.dev/catalin",
"contributions": [
"code"
]
},
{
"login": "Seon82",
"name": "Seon82",
"avatar_url": "https://avatars.githubusercontent.com/u/46298009?v=4",
"profile": "https://github.com/Seon82",
"contributions": [
"doc"
]
},
{
"login": "slavugan",
"name": "Slava",
"avatar_url": "https://avatars.githubusercontent.com/u/8457612?v=4",
"profile": "https://github.com/slavugan",
"contributions": [
"code"
]
},
{
"login": "Harry-Lees",
"name": "Harry",
"avatar_url": "https://avatars.githubusercontent.com/u/52263746?v=4",
"profile": "https://github.com/Harry-Lees",
"contributions": [
"code",
"doc"
]
},
{
"login": "cofin",
"name": "Cody Fincher",
"avatar_url": "https://avatars.githubusercontent.com/u/204685?v=4",
"profile": "https://github.com/cofin",
"contributions": [
"maintenance",
"code",
"doc",
"test",
"ideas",
"example",
"bug"
]
},
{
"login": "cclauss",
"name": "Christian Clauss",
"avatar_url": "https://avatars.githubusercontent.com/u/3709715?v=4",
"profile": "https://www.patreon.com/cclauss",
"contributions": [
"doc"
]
},
{
"login": "josepdaniel",
"name": "josepdaniel",
"avatar_url": "https://avatars.githubusercontent.com/u/36941460?v=4",
"profile": "https://github.com/josepdaniel",
"contributions": [
"code"
]
},
{
"login": "devtud",
"name": "devtud",
"avatar_url": "https://avatars.githubusercontent.com/u/6808024?v=4",
"profile": "https://github.com/devtud",
"contributions": [
"bug"
]
},
{
"login": "nramos0",
"name": "Nicholas Ramos",
"avatar_url": "https://avatars.githubusercontent.com/u/35410160?v=4",
"profile": "https://github.com/nramos0",
"contributions": [
"code"
]
},
{
"login": "seladb",
"name": "seladb",
"avatar_url": "https://avatars.githubusercontent.com/u/9059541?v=4",
"profile": "https://twitter.com/seladb",
"contributions": [
"doc",
"code"
]
},
{
"login": "aedify-swi",
"name": "Simon Wienhöfer",
"avatar_url": "https://avatars.githubusercontent.com/u/66629131?v=4",
"profile": "https://github.com/aedify-swi",
"contributions": [
"code"
]
},
{
"login": "mobiusxs",
"name": "MobiusXS",
"avatar_url": "https://avatars.githubusercontent.com/u/57055149?v=4",
"profile": "https://github.com/mobiusxs",
"contributions": [
"code"
]
},
{
"login": "Aidan-Simard",
"name": "Aidan Simard",
"avatar_url": "https://avatars.githubusercontent.com/u/73361895?v=4",
"profile": "http://aidansimard.dev",
"contributions": [
"doc"
]
},
{
"login": "waweber",
"name": "wweber",
"avatar_url": "https://avatars.githubusercontent.com/u/714224?v=4",
"profile": "https://github.com/waweber",
"contributions": [
"code"
]
},
{
"login": "samuelcolvin",
"name": "Samuel Colvin",
"avatar_url": "https://avatars.githubusercontent.com/u/4039449?v=4",
"profile": "http://scolvin.com",
"contributions": [
"code"
]
},
{
"login": "toudi",
"name": "Mateusz Mikołajczyk",
"avatar_url": "https://avatars.githubusercontent.com/u/81148?v=4",
"profile": "https://github.com/toudi",
"contributions": [
"code"
]
},
{
"login": "Alex-CodeLab",
"name": "Alex ",
"avatar_url": "https://avatars.githubusercontent.com/u/1678423?v=4",
"profile": "https://github.com/Alex-CodeLab",
"contributions": [
"code"
]
},
{
"login": "odiseo0",
"name": "Odiseo",
"avatar_url": "https://avatars.githubusercontent.com/u/87550035?v=4",
"profile": "https://github.com/odiseo0",
"contributions": [
"doc"
]
},
{
"login": "ingjavierpinilla",
"name": "Javier Pinilla",
"avatar_url": "https://avatars.githubusercontent.com/u/36714646?v=4",
"profile": "https://github.com/ingjavierpinilla",
"contributions": [
"code"
]
},
{
"login": "Chaoyingz",
"name": "Chaoying",
"avatar_url": "https://avatars.githubusercontent.com/u/32626585?v=4",
"profile": "https://github.com/Chaoyingz",
"contributions": [
"doc"
]
},
{
"login": "infohash",
"name": "infohash",
"avatar_url": "https://avatars.githubusercontent.com/u/46137868?v=4",
"profile": "https://github.com/infohash",
"contributions": [
"code"
]
},
{
"login": "john-ingles",
"name": "John Ingles",
"avatar_url": "https://avatars.githubusercontent.com/u/35442886?v=4",
"profile": "https://www.linkedin.com/in/john-ingles/",
"contributions": [
"code"
]
},
{
"login": "h0rn3t",
"name": "Eugene",
"avatar_url": "https://avatars.githubusercontent.com/u/1213719?v=4",
"profile": "https://github.com/h0rn3t",
"contributions": [
"test",
"code"
]
},
{
"login": "jonadaly",
"name": "Jon Daly",
"avatar_url": "https://avatars.githubusercontent.com/u/26462826?v=4",
"profile": "https://github.com/jonadaly",
"contributions": [
"doc",
"code"
]
},
{
"login": "Harshal6927",
"name": "Harshal Laheri",
"avatar_url": "https://avatars.githubusercontent.com/u/73422191?v=4",
"profile": "https://harshallaheri.me/",
"contributions": [
"code",
"doc"
]
},
{
"login": "sorasful",
"name": "Téva KRIEF",
"avatar_url": "https://avatars.githubusercontent.com/u/32820423?v=4",
"profile": "https://github.com/sorasful",
"contributions": [
"code"
]
},
{
"login": "jtraub",
"name": "Konstantin Mikhailov",
"avatar_url": "https://avatars.githubusercontent.com/u/153191?v=4",
"profile": "https://github.com/jtraub",
"contributions": [
"maintenance",
"code",
"doc",
"test",
"ideas",
"example",
"bug"
]
},
{
"login": "devmitch",
"name": "Mitchell Henry",
"avatar_url": "https://avatars.githubusercontent.com/u/17354727?v=4",
"profile": "http://linkedin.com/in/mitchell-henry334/",
"contributions": [
"doc"
]
},
{
"login": "chbndrhnns",
"name": "chbndrhnns",
"avatar_url": "https://avatars.githubusercontent.com/u/7534547?v=4",
"profile": "https://github.com/chbndrhnns",
"contributions": [
"doc"
]
},
{
"login": "nielsvanhooy",
"name": "nielsvanhooy",
"avatar_url": "https://avatars.githubusercontent.com/u/40770348?v=4",
"profile": "https://github.com/nielsvanhooy",
"contributions": [
"code",
"bug",
"test"
]
},
{
"login": "provinzkraut",
"name": "provinzkraut",
"avatar_url": "https://avatars.githubusercontent.com/u/25355197?v=4",
"profile": "https://github.com/provinzkraut",
"contributions": [
"maintenance",
"code",
"doc",
"test",
"ideas",
"example",
"bug",
"design"
]
},
{
"login": "jab",
"name": "Joshua Bronson",
"avatar_url": "https://avatars.githubusercontent.com/u/64992?v=4",
"profile": "https://github.com/jab",
"contributions": [
"doc"
]
},
{
"login": "ReznikovRoman",
"name": "Roman Reznikov",
"avatar_url": "https://avatars.githubusercontent.com/u/44291988?v=4",
"profile": "http://linkedin.com/in/roman-reznikov",
"contributions": [
"doc"
]
},
{
"login": "mookrs",
"name": "mookrs",
"avatar_url": "https://avatars.githubusercontent.com/u/985439?v=4",
"profile": "http://mookrs.com",
"contributions": [
"doc"
]
},
{
"login": "mivade",
"name": "Mike DePalatis",
"avatar_url": "https://avatars.githubusercontent.com/u/2805515?v=4",
"profile": "http://mike.depalatis.net",
"contributions": [
"doc"
]
},
{
"login": "pemocarlo",
"name": "Carlos Alberto Pérez-Molano",
"avatar_url": "https://avatars.githubusercontent.com/u/7297323?v=4",
"profile": "https://github.com/pemocarlo",
"contributions": [
"doc"
]
},
{
"login": "ThinksFast",
"name": "ThinksFast",
"avatar_url": "https://avatars.githubusercontent.com/u/114229148?v=4",
"profile": "https://www.bestcryptocodes.com",
"contributions": [
"test",
"doc"
]
},
{
"login": "ottermata",
"name": "Christopher Krause",
"avatar_url": "https://avatars.githubusercontent.com/u/9451844?v=4",
"profile": "https://github.com/ottermata",
"contributions": [
"code"
]
},
{
"login": "smithk86",
"name": "Kyle Smith",
"avatar_url": "https://avatars.githubusercontent.com/u/1161424?v=4",
"profile": "http://www.kylesmith.me",
"contributions": [
"code",
"doc",
"bug"
]
},
{
"login": "scott2b",
"name": "Scott Bradley",
"avatar_url": "https://avatars.githubusercontent.com/u/307713?v=4",
"profile": "https://github.com/scott2b",
"contributions": [
"bug"
]
},
{
"login": "srikanthccv",
"name": "Srikanth Chekuri",
"avatar_url": "https://avatars.githubusercontent.com/u/22846633?v=4",
"profile": "https://www.linkedin.com/in/srikanthccv/",
"contributions": [
"test",
"doc"
]
},
{
"login": "LonelyVikingMichael",
"name": "Michael Bosch",
"avatar_url": "https://avatars.githubusercontent.com/u/78952809?v=4",
"profile": "https://lonelyviking.com",
"contributions": [
"doc"
]
},
{
"login": "sssssss340",
"name": "sssssss340",
"avatar_url": "https://avatars.githubusercontent.com/u/8406195?v=4",
"profile": "https://github.com/sssssss340",
"contributions": [
"bug"
]
},
{
"login": "ste-pool",
"name": "ste-pool",
"avatar_url": "https://avatars.githubusercontent.com/u/17198460?v=4",
"profile": "https://github.com/ste-pool",
"contributions": [
"code",
"infra"
]
},
{
"login": "Alc-Alc",
"name": "Alc-Alc",
"avatar_url": "https://avatars.githubusercontent.com/u/45509143?v=4",
"profile": "https://github.com/Alc-Alc",
"contributions": [
"doc",
"code",
"test",
"infra"
]
},
{
"login": "asomethings",
"name": "asomethings",
"avatar_url": "https://avatars.githubusercontent.com/u/16171942?v=4",
"profile": "http://asomethings.com",
"contributions": [
"code"
]
},
{
"login": "garburator",
"name": "Garry Bullock",
"avatar_url": "https://avatars.githubusercontent.com/u/14207857?v=4",
"profile": "https://github.com/garburator",
"contributions": [
"doc"
]
},
{
"login": "NiclasHaderer",
"name": "Niclas Haderer",
"avatar_url": "https://avatars.githubusercontent.com/u/109728711?v=4",
"profile": "https://github.com/NiclasHaderer",
"contributions": [
"code"
]
},
{
"login": "dialvarezs",
"name": "Diego Alvarez",
"avatar_url": "https://avatars.githubusercontent.com/u/13831919?v=4",
"profile": "https://github.com/dialvarezs",
"contributions": [
"doc",
"code",
"test"
]
},
{
"login": "rgajason",
"name": "Jason Nance",
"avatar_url": "https://avatars.githubusercontent.com/u/51208317?v=4",
"profile": "https://www.rgare.com",
"contributions": [
"doc"
]
},
{
"login": "spikenn",
"name": "Igor Kapadze",
"avatar_url": "https://avatars.githubusercontent.com/u/32995595?v=4",
"profile": "https://github.com/spikenn",
"contributions": [
"doc"
]
},
{
"login": "Jarmos-san",
"name": "Somraj Saha",
"avatar_url": "https://avatars.githubusercontent.com/u/31373860?v=4",
"profile": "https://jarmos.vercel.app",
"contributions": [
"doc"
]
},
{
"login": "maggias",
"name": "Magnús Ágúst Skúlason",
"avatar_url": "https://avatars.githubusercontent.com/u/11139514?v=4",
"profile": "http://skulason.me",
"contributions": [
"code",
"doc"
]
},
{
"login": "pomma89",
"name": "Alessio Parma",
"avatar_url": "https://avatars.githubusercontent.com/u/4697032?v=4",
"profile": "https://alessioparma.xyz/",
"contributions": [
"doc"
]
},
{
"login": "Lugoues",
"name": "Peter Brunner",
"avatar_url": "https://avatars.githubusercontent.com/u/372610?v=4",
"profile": "https://github.com/Lugoues",
"contributions": [
"code"
]
},
{
"login": "JacobCoffee",
"name": "Jacob Coffee",
"avatar_url": "https://avatars.githubusercontent.com/u/45884264?v=4",
"profile": "https://scriptr.dev/",
"contributions": [
"doc",
"code",
"test",
"infra",
"ideas",
"maintenance",
"business",
"design"
]
},
{
"login": "Gamazic",
"name": "Gamazic",
"avatar_url": "https://avatars.githubusercontent.com/u/33692402?v=4",
"profile": "https://github.com/Gamazic",
"contributions": [
"code"
]
},
{
"login": "kareemmahlees",
"name": "Kareem Mahlees",
"avatar_url": "https://avatars.githubusercontent.com/u/89863279?v=4",
"profile": "https://github.com/kareemmahlees",
"contributions": [
"code"
]
},
{
"login": "abdulhaq-e",
"name": "Abdulhaq Emhemmed",
"avatar_url": "https://avatars.githubusercontent.com/u/2532125?v=4",
"profile": "https://github.com/abdulhaq-e",
"contributions": [
"code",
"doc"
]
},
{
"login": "jenish2014",
"name": "Jenish",
"avatar_url": "https://avatars.githubusercontent.com/u/9599888?v=4",
"profile": "https://github.com/jenish2014",
"contributions": [
"code",
"doc"
]
},
{
"login": "chris-telemetry",
"name": "chris-telemetry",
"avatar_url": "https://avatars.githubusercontent.com/u/78052999?v=4",
"profile": "https://github.com/chris-telemetry",
"contributions": [
"code"
]
},
{
"login": "WardPearce",
"name": "Ward",
"avatar_url": "https://avatars.githubusercontent.com/u/27844174?v=4",
"profile": "http://wardpearce.com",
"contributions": [
"bug"
]
},
{
"login": "knowsuchagency",
"name": "Stephan Fitzpatrick",
"avatar_url": "https://avatars.githubusercontent.com/u/11974795?v=4",
"profile": "https://knowsuchagency.com",
"contributions": [
"bug"
]
},
{
"login": "ekeric13",
"name": "Eric Kennedy",
"avatar_url": "https://avatars.githubusercontent.com/u/6489651?v=4",
"profile": "https://codepen.io/ekeric13/",
"contributions": [
"doc"
]
},
{
"login": "wassafshahzad",
"name": "wassaf shahzad",
"avatar_url": "https://avatars.githubusercontent.com/u/25094157?v=4",
"profile": "https://github.com/wassafshahzad",
"contributions": [
"code"
]
},
{
"login": "nilsso",
"name": "Nils Olsson",
"avatar_url": "https://avatars.githubusercontent.com/u/567181?v=4",
"profile": "http://nilsso.github.io",
"contributions": [
"code",
"bug"
]
},
{
"login": "Nadock",
"name": "Riley Chase",
"avatar_url": "https://avatars.githubusercontent.com/u/1491530?v=4",
"profile": "http://rileychase.net",
"contributions": [
"code"
]
},
{
"login": "onerandomusername",
"name": "arl",
"avatar_url": "https://avatars.githubusercontent.com/u/71233171?v=4",
"profile": "https://gh.arielle.codes",
"contributions": [
"maintenance"
]
},
{
"login": "Galdanwing",
"name": "Antoine van der Horst",
"avatar_url": "https://avatars.githubusercontent.com/u/29492757?v=4",
"profile": "https://github.com/Galdanwing",
"contributions": [
"doc"
]
},
{
"login": "zoni",
"name": "Nick Groenen",
"avatar_url": "https://avatars.githubusercontent.com/u/145285?v=4",
"profile": "https://nick.groenen.me",
"contributions": [
"doc"
]
},
{
"login": "giorgiovilardo",
"name": "Giorgio Vilardo",
"avatar_url": "https://avatars.githubusercontent.com/u/56472600?v=4",
"profile": "https://github.com/giorgiovilardo",
"contributions": [
"doc"
]
},
{
"login": "bollwyvl",
"name": "Nicholas Bollweg",
"avatar_url": "https://avatars.githubusercontent.com/u/45380?v=4",
"profile": "https://github.com/bollwyvl",
"contributions": [
"code"
]
},
{
"login": "tompin82",
"name": "Tomas Jonsson",
"avatar_url": "https://avatars.githubusercontent.com/u/47041409?v=4",
"profile": "https://github.com/tompin82",
"contributions": [
"test",
"code"
]
},
{
"login": "khiemdoan",
"name": "Khiem Doan",
"avatar_url": "https://avatars.githubusercontent.com/u/15646249?v=4",
"profile": "https://www.linkedin.com/in/khiem-doan/",
"contributions": [
"doc"
]
},
{
"login": "kedod",
"name": "kedod",
"avatar_url": "https://avatars.githubusercontent.com/u/35638715?v=4",
"profile": "https://github.com/kedod",
"contributions": [
"doc",
"code",
"test"
]
},
{
"login": "sonpro1296",
"name": "sonpro1296",
"avatar_url": "https://avatars.githubusercontent.com/u/17319142?v=4",
"profile": "https://github.com/sonpro1296",
"contributions": [
"code",
"test",
"infra",
"doc"
]
},
{
"login": "patrickarmengol",
"name": "Patrick Armengol",
"avatar_url": "https://avatars.githubusercontent.com/u/42473149?v=4",
"profile": "https://patrickarmengol.com",
"contributions": [
"doc"
]
},
{
"login": "SanderWegter",
"name": "Sander",
"avatar_url": "https://avatars.githubusercontent.com/u/7465799?v=4",
"profile": "https://sanderwegter.nl",
"contributions": [
"doc"
]
},
{
"login": "erhuabushuo",
"name": "疯人院主任",
"avatar_url": "https://avatars.githubusercontent.com/u/1642364?v=4",
"profile": "https://github.com/erhuabushuo",
"contributions": [
"doc"
]
},
{
"login": "aviral-nayya",
"name": "aviral-nayya",
"avatar_url": "https://avatars.githubusercontent.com/u/121891493?v=4",
"profile": "https://github.com/aviral-nayya",
"contributions": [
"code"
]
},
{
"login": "whiskeyriver",
"name": "whiskeyriver",
"avatar_url": "https://avatars.githubusercontent.com/u/162092?v=4",
"profile": "https://github.com/whiskeyriver",
"contributions": [
"code"
]
},
{
"login": "v3ss0n",
"name": "Phyo Arkar Lwin",
"avatar_url": "https://avatars.githubusercontent.com/u/419606?v=4",
"profile": "https://hexcode.tech",
"contributions": [
"code"
]
},
{
"login": "MatthewNewland",
"name": "MatthewNewland",
"avatar_url": "https://avatars.githubusercontent.com/u/9618670?v=4",
"profile": "https://github.com/MatthewNewland",
"contributions": [
"bug",
"code",
"test"
]
},
{
"login": "vtarchon",
"name": "Tom Kuo",
"avatar_url": "https://avatars.githubusercontent.com/u/1598170?v=4",
"profile": "https://github.com/vtarchon",
"contributions": [
"bug"
]
},
{
"login": "LeckerenSirupwaffeln",
"name": "LeckerenSirupwaffeln",
"avatar_url": "https://avatars.githubusercontent.com/u/83568015?v=4",
"profile": "https://github.com/LeckerenSirupwaffeln",
"contributions": [
"bug"
]
},
{
"login": "eldano1995",
"name": "Daniel González Fernández",
"avatar_url": "https://avatars.githubusercontent.com/u/24553679?v=4",
"profile": "https://github.com/eldano1995",
"contributions": [
"doc"
]
},
{
"login": "01EK98",
"name": "01EK98",
"avatar_url": "https://avatars.githubusercontent.com/u/101988390?v=4",
"profile": "https://github.com/01EK98",
"contributions": [
"doc"
]
},
{
"login": "sarbor",
"name": "Sarbo Roy",
"avatar_url": "https://avatars.githubusercontent.com/u/15257226?v=4",
"profile": "https://github.com/sarbor",
"contributions": [
"code"
]
},
{
"login": "rseeley",
"name": "Ryan Seeley",
"avatar_url": "https://avatars.githubusercontent.com/u/5397221?v=4",
"profile": "https://github.com/rseeley",
"contributions": [
"code"
]
},
{
"login": "ctrl-Felix",
"name": "Felix",
"avatar_url": "https://avatars.githubusercontent.com/u/62290842?v=4",
"profile": "https://github.com/ctrl-Felix",
"contributions": [
"doc",
"bug"
]
},
{
"login": "gsakkis",
"name": "George Sakkis",
"avatar_url": "https://avatars.githubusercontent.com/u/291289?v=4",
"profile": "https://www.linkedin.com/in/gsakkis",
"contributions": [
"code"
]
},
{
"login": "floxay",
"name": "Huba Tuba",
"avatar_url": "https://avatars.githubusercontent.com/u/57007485?v=4",
"profile": "https://github.com/floxay",
"contributions": [
"doc",
"code",
"test"
]
},
{
"login": "sfermigier",
"name": "Stefane Fermigier",
"avatar_url": "https://avatars.githubusercontent.com/u/271079?v=4",
"profile": "http://fermigier.com/",
"contributions": [
"doc"
]
},
{
"login": "r4gesingh47",
"name": "r4ge",
"avatar_url": "https://avatars.githubusercontent.com/u/71139938?v=4",
"profile": "https://github.com/r4gesingh47",
"contributions": [
"code",
"doc"
]
},
{
"login": "jaykv",
"name": "Jay",
"avatar_url": "https://avatars.githubusercontent.com/u/18240054?v=4",
"profile": "https://github.com/jaykv",
"contributions": [
"code"
]
},
{
"login": "sinisaos",
"name": "sinisaos",
"avatar_url": "https://avatars.githubusercontent.com/u/30960668?v=4",
"profile": "https://github.com/sinisaos",
"contributions": [
"doc"
]
},
{
"login": "Tsdevendra1",
"name": "Tharuka Devendra",
"avatar_url": "https://avatars.githubusercontent.com/u/38055748?v=4",
"profile": "https://github.com/Tsdevendra1",
"contributions": [
"code"
]
},
{
"login": "euri10",
"name": "euri10",
"avatar_url": "https://avatars.githubusercontent.com/u/1104190?v=4",
"profile": "https://github.com/euri10",
"contributions": [
"code",
"doc",
"bug"
]
},
{
"login": "su-shubham",
"name": "Shubham",
"avatar_url": "https://avatars.githubusercontent.com/u/75021117?v=4",
"profile": "https://github.com/su-shubham",
"contributions": [
"doc"
]
},
{
"login": "erik-hasse",
"name": "Erik Hasse",
"avatar_url": "https://avatars.githubusercontent.com/u/37126755?v=4",
"profile": "https://www.linkedin.com/in/erik-hasse",
"contributions": [
"bug",
"code"
]
},
{
"login": "sobolevn",
"name": "Nikita Sobolev",
"avatar_url": "https://avatars.githubusercontent.com/u/4660275?v=4",
"profile": "https://sobolevn.me",
"contributions": [
"infra",
"code"
]
},
{
"login": "lazyc97",
"name": "Nguyễn Hoàng Đức",
"avatar_url": "https://avatars.githubusercontent.com/u/8538104?v=4",
"profile": "https://github.com/lazyc97",
"contributions": [
"bug"
]
},
{
"login": "RavanaBhrama",
"name": "RavanaBhrama",
"avatar_url": "https://avatars.githubusercontent.com/u/131459969?v=4",
"profile": "https://github.com/RavanaBhrama",
"contributions": [
"doc"
]
},
{
"login": "mj0nez",
"name": "Marcel Johannesmann",
"avatar_url": "https://avatars.githubusercontent.com/u/20128340?v=4",
"profile": "https://github.com/mj0nez",
"contributions": [
"doc"
]
},
{
"login": "therealzanfar",
"name": "Matthew",
"avatar_url": "https://avatars.githubusercontent.com/u/10294685?v=4",
"profile": "http://zanfar.com/",
"contributions": [
"doc"
]
},
{
"login": "Mattwmaster58",
"name": "Mattwmaster58",
"avatar_url": "https://avatars.githubusercontent.com/u/26337069?v=4",
"profile": "https://github.com/Mattwmaster58",
"contributions": [
"bug",
"code",
"test"
]
},
{
"login": "aorith",
"name": "Manuel Sanchez Pinar",
"avatar_url": "https://avatars.githubusercontent.com/u/5411704?v=4",
"profile": "https://es.linkedin.com/in/manusp",
"contributions": [
"doc"
]
},
{
"login": "juan-riveros",
"name": "Juan Riveros",
"avatar_url": "https://avatars.githubusercontent.com/u/1297567?v=4",
"profile": "https://github.com/juan-riveros",
"contributions": [
"doc"
]
},
{
"login": "davidbrochart",
"name": "David Brochart",
"avatar_url": "https://avatars.githubusercontent.com/u/4711805?v=4",
"profile": "https://github.com/davidbrochart",
"contributions": [
"doc"
]
},
{
"login": "sean-donoghue",
"name": "Sean Donoghue",
"avatar_url": "https://avatars.githubusercontent.com/u/64597271?v=4",
"profile": "https://github.com/sean-donoghue",
"contributions": [
"doc"
]
},
{
"login": "sykloid",
"name": "P.C. Shyamshankar",
"avatar_url": "https://avatars.githubusercontent.com/u/22753?v=4",
"profile": "https://sykloid.org/",
"contributions": [
"bug",
"code",
"test"
]
},
{
"login": "wevonosky",
"name": "William Evonosky",
"avatar_url": "https://avatars.githubusercontent.com/u/19598171?v=4",
"profile": "https://github.com/wevonosky",
"contributions": [
"code"
]
},
{
"login": "geeshta",
"name": "geeshta",
"avatar_url": "https://avatars.githubusercontent.com/u/61031243?v=4",
"profile": "https://github.com/geeshta",
"contributions": [
"doc",
"code",
"bug"
]
},
{
"login": "RobertRosca",
"name": "Robert Rosca",
"avatar_url": "https://avatars.githubusercontent.com/u/32569096?v=4",
"profile": "https://fosstodon.org/@robertrosca",
"contributions": [
"doc"
]
},
{
"login": "syshenyu",
"name": "DICE_Lab",
"avatar_url": "https://avatars.githubusercontent.com/u/92897003?v=4",
"profile": "https://github.com/syshenyu",
"contributions": [
"code"
]
},
{
"login": "lsanpablo",
"name": "Luis San Pablo",
"avatar_url": "https://avatars.githubusercontent.com/u/7145688?v=4",
"profile": "https://github.com/lsanpablo",
"contributions": [
"code",
"test",
"doc"
]
},
{
"login": "Lancetnik",
"name": "Pastukhov Nikita",
"avatar_url": "https://avatars.githubusercontent.com/u/44573917?v=4",
"profile": "https://github.com/Lancetnik",
"contributions": [
"doc"
]
},
{
"login": "ddxv",
"name": "James O'Claire",
"avatar_url": "https://avatars.githubusercontent.com/u/7601451?v=4",
"profile": "http://jamesoclaire.com",
"contributions": [
"doc"
]
},
{
"login": "pbaletkeman",
"name": "Pete",
"avatar_url": "https://avatars.githubusercontent.com/u/22402240?v=4",
"profile": "https://github.com/pbaletkeman",
"contributions": [
"doc"
]
},
{
"login": "heralight",
"name": "Alexandre Richonnier",
"avatar_url": "https://avatars.githubusercontent.com/u/534840?v=4",
"profile": "http://www.hera.cc",
"contributions": [
"code",
"doc"
]
},
{
"login": "betaboon",
"name": "betaboon",
"avatar_url": "https://avatars.githubusercontent.com/u/7346933?v=4",
"profile": "https://github.com/betaboon",
"contributions": [
"code"
]
},
{
"login": "brakhane",
"name": "Dennis Brakhane",
"avatar_url": "https://avatars.githubusercontent.com/u/541637?v=4",
"profile": "https://github.com/brakhane",
"contributions": [
"code",
"bug"
]
},
{
"login": "AgarwalPragy",
"name": "Pragy Agarwal",
"avatar_url": "https://avatars.githubusercontent.com/u/7423639?v=4",
"profile": "https://mind.wiki",
"contributions": [
"doc"
]
},
{
"login": "dybi",
"name": "Piotr Dybowski",
"avatar_url": "https://avatars.githubusercontent.com/u/36961162?v=4",
"profile": "https://github.com/dybi",
"contributions": [
"doc"
]
},
{
"login": "myslak71",
"name": "Konrad Szczurek",
"avatar_url": "https://avatars.githubusercontent.com/u/43068450?v=4",
"profile": "https://github.com/myslak71",
"contributions": [
"doc",
"test"
]
},
{
"login": "orgarten",
"name": "Orell Garten",
"avatar_url": "https://avatars.githubusercontent.com/u/10799869?v=4",
"profile": "https://github.com/orgarten",
"contributions": [
"code",
"doc",
"test"
]
},
{
"login": "Kumzy",
"name": "Julien",
"avatar_url": "https://avatars.githubusercontent.com/u/5995441?v=4",
"profile": "https://github.com/Kumzy",
"contributions": [
"doc"
]
},
{
"login": "leejayhsu",
"name": "Leejay Hsu",
"avatar_url": "https://avatars.githubusercontent.com/u/37034741?v=4",
"profile": "https://github.com/leejayhsu",
"contributions": [
"maintenance",
"infra",
"doc"
]
},
{
"login": "mbeijen",
"name": "Michiel W. Beijen",
"avatar_url": "https://avatars.githubusercontent.com/u/659504?v=4",
"profile": "https://x14.nl",
"contributions": [
"doc"
]
},
{
"login": "baoliay2008",
"name": "L. Bao",
"avatar_url": "https://avatars.githubusercontent.com/u/13620348?v=4",
"profile": "https://github.com/baoliay2008",
"contributions": [
"doc"
]
},
{
"login": "jdglaser",
"name": "Jarred Glaser",
"avatar_url": "https://avatars.githubusercontent.com/u/32422167?v=4",
"profile": "http://jarredglaser.com",
"contributions": [
"doc"
]
},
{
"login": "hunterjsb",
"name": "Hunter Boyd",
"avatar_url": "https://avatars.githubusercontent.com/u/69213737?v=4",
"profile": "https://github.com/hunterjsb",
"contributions": [
"doc"
]
},
{
"login": "cesarmg1980",
"name": "Cesar Giulietti",
"avatar_url": "https://avatars.githubusercontent.com/u/38872121?v=4",
"profile": "https://github.com/cesarmg1980",
"contributions": [
"doc"
]
},
{
"login": "marcuslimdw",
"name": "Marcus Lim",
"avatar_url": "https://avatars.githubusercontent.com/u/42759889?v=4",
"profile": "https://gitlab.com/marcuslimdw/",
"contributions": [
"doc"
]
},
{
"login": "hzhou0",
"name": "Henry Zhou",
"avatar_url": "https://avatars.githubusercontent.com/u/43188301?v=4",
"profile": "https://github.com/hzhou0",
"contributions": [
"bug",
"code"
]
},
{
"login": "WilliamStam",
"name": "William Stam",
"avatar_url": "https://avatars.githubusercontent.com/u/182800?v=4",
"profile": "https://github.com/WilliamStam",
"contributions": [
"doc"
]
},
{
"login": "andrewdoh",
"name": "andrew do",
"avatar_url": "https://avatars.githubusercontent.com/u/7662358?v=4",
"profile": "https://github.com/andrewdoh",
"contributions": [
"code",
"test",
"doc"
]
},
{
"login": "cbscsm",
"name": "Boseong Choi",
"avatar_url": "https://avatars.githubusercontent.com/u/31615733?v=4",
"profile": "https://github.com/cbscsm",
"contributions": [
"code",
"test"
]
},
{
"login": "wer153",
"name": "Kim Minki",
"avatar_url": "https://avatars.githubusercontent.com/u/23370765?v=4",
"profile": "https://github.com/wer153",
"contributions": [
"code",
"doc"
]
},
{
"login": "jseop-lim",
"name": "Jeongseop Lim",
"avatar_url": "https://avatars.githubusercontent.com/u/86508420?v=4",
"profile": "https://velog.io/@azzurri21",
"contributions": [
"doc"
]
},
{
"login": "FergusMok",
"name": "FergusMok",
"avatar_url": "https://avatars.githubusercontent.com/u/10182564?v=4",
"profile": "https://github.com/FergusMok",
"contributions": [
"doc",
"code",
"test"
]
},
{
"login": "manusinghal19",
"name": "Manu Singhal",
"avatar_url": "https://avatars.githubusercontent.com/u/8455587?v=4",
"profile": "https://github.com/manusinghal19",
"contributions": [
"doc"
]
},
{
"login": "jrycw",
"name": "Jerry Wu",
"avatar_url": "https://avatars.githubusercontent.com/u/67060418?v=4",
"profile": "https://cv.ycwu.space",
"contributions": [
"doc"
]
},
{
"login": "horo-fox",
"name": "horo",
"avatar_url": "https://avatars.githubusercontent.com/u/143025439?v=4",
"profile": "https://github.com/horo-fox",
"contributions": [
"bug"
]
},
{
"login": "rosstitmarsh",
"name": "Ross Titmarsh",
"avatar_url": "https://avatars.githubusercontent.com/u/23349806?v=4",
"profile": "https://github.com/rosstitmarsh",
"contributions": [
"code"
]
},
{
"login": "korneevm",
"name": "Mike Korneev",
"avatar_url": "https://avatars.githubusercontent.com/u/743250?v=4",
"profile": "https://github.com/korneevm",
"contributions": [
"doc"
]
},
{
"login": "patrickneise",
"name": "Patrick Neise",
"avatar_url": "https://avatars.githubusercontent.com/u/6312074?v=4",
"profile": "https://github.com/patrickneise",
"contributions": [
"code"
]
},
{
"login": "JeanArhancet",
"name": "Jean Arhancet",
"avatar_url": "https://avatars.githubusercontent.com/u/10811879?v=4",
"profile": "https://github.com/JeanArhancet",
"contributions": [
"bug"
]
},
{
"login": "betaprior",
"name": "Leo Alekseyev",
"avatar_url": "https://avatars.githubusercontent.com/u/338250?v=4",
"profile": "http://dnquark.com",
"contributions": [
"code"
]
},
{
"login": "aranvir",
"name": "aranvir",
"avatar_url": "https://avatars.githubusercontent.com/u/75439739?v=4",
"profile": "https://github.com/aranvir",
"contributions": [
"doc",
"code",
"test"
]
},
{
"login": "bunny-therapist",
"name": "bunny-therapist",
"avatar_url": "https://avatars.githubusercontent.com/u/87039365?v=4",
"profile": "https://github.com/bunny-therapist",
"contributions": [
"code"
]
},
{
"login": "benluo",
"name": "Ben Luo",
"avatar_url": "https://avatars.githubusercontent.com/u/70398?v=4",
"profile": "http://www.benluo.cc",
"contributions": [
"doc"
]
},
{
"login": "hugovk",
"name": "Hugo van Kemenade",
"avatar_url": "https://avatars.githubusercontent.com/u/1324225?v=4",
"profile": "https://github.com/hugovk",
"contributions": [
"doc"
]
},
{
"login": "error418",
"name": "Michael Gerbig",
"avatar_url": "https://avatars.githubusercontent.com/u/7716544?v=4",
"profile": "https://error418.github.io",
"contributions": [
"doc"
]
},
{
"login": "crisog",
"name": "CrisOG",
"avatar_url": "https://avatars.githubusercontent.com/u/40803711?v=4",
"profile": "https://github.com/crisog",
"contributions": [
"bug",
"code",
"test"
]
},
{
"login": "haryle",
"name": "harryle",
"avatar_url": "https://avatars.githubusercontent.com/u/64817481?v=4",
"profile": "https://github.com/haryle",
"contributions": [
"code",
"test"
]
},
{
"login": "ubernostrum",
"name": "James Bennett",
"avatar_url": "https://avatars.githubusercontent.com/u/12384?v=4",
"profile": "http://www.b-list.org/",
"contributions": [
"bug"
]
},
{
"login": "sherbang",
"name": "sherbang",
"avatar_url": "https://avatars.githubusercontent.com/u/275015?v=4",
"profile": "https://github.com/sherbang",
"contributions": [
"doc"
]
},
{
"login": "carlsmedstad",
"name": "Carl Smedstad",
"avatar_url": "https://avatars.githubusercontent.com/u/6952324?v=4",
"profile": "https://github.com/carlsmedstad",
"contributions": [
"test"
]
},
{
"login": "maintain0404",
"name": "Taein Min",
"avatar_url": "https://avatars.githubusercontent.com/u/50428534?v=4",
"profile": "https://github.com/maintain0404",
"contributions": [
"doc"
]
},
{
"login": "wallseat",
"name": "Stanislav Lyu.",
"avatar_url": "https://avatars.githubusercontent.com/u/26143672?v=4",
"profile": "https://github.com/wallseat",
"contributions": [
"bug"
]
},
{
"login": "tibor-reiss",
"name": "Tibor Reiss",
"avatar_url": "https://avatars.githubusercontent.com/u/75096465?v=4",
"profile": "https://github.com/tibor-reiss",
"contributions": [
"test",
"doc",
"code"
]
},
{
"login": "0xE111",
"name": "Alex",
"avatar_url": "https://avatars.githubusercontent.com/u/11032969?v=4",
"profile": "https://pogrom.dev",
"contributions": [
"bug",
"code"
]
},
{
"login": "JorenSix",
"name": "Joren Six",
"avatar_url": "https://avatars.githubusercontent.com/u/60453?v=4",
"profile": "http://0110.be",
"contributions": [
"doc"
]
},
{
"login": "jderrien",
"name": "jderrien",
"avatar_url": "https://avatars.githubusercontent.com/u/145396?v=4",
"profile": "https://github.com/jderrien",
"contributions": [
"doc"
]
},
{
"login": "PossiblePanda",
"name": "PossiblePanda",
"avatar_url": "https://avatars.githubusercontent.com/u/85448494?v=4",
"profile": "https://possiblepanda.me",
"contributions": [
"doc"
]
},
{
"login": "evstratbg",
"name": "evstrat",
"avatar_url": "https://avatars.githubusercontent.com/u/10176401?v=4",
"profile": "https://github.com/evstratbg",
"contributions": [
"infra"
]
},
{
"login": "eltociear",
"name": "Ikko Eltociear Ashimine",
"avatar_url": "https://avatars.githubusercontent.com/u/22633385?v=4",
"profile": "https://speakerdeck.com/eltociear",
"contributions": [
"doc"
]
},
{
"login": "taihim",
"name": "Taimur Ibrahim",
"avatar_url": "https://avatars.githubusercontent.com/u/13764071?v=4",
"profile": "https://github.com/taihim",
"contributions": [
"doc"
]
},
{
"login": "l-armstrong",
"name": "l-armstrong",
"avatar_url": "https://avatars.githubusercontent.com/u/43922258?v=4",
"profile": "https://github.com/l-armstrong",
"contributions": [
"doc"
]
},
{
"login": "Anu-cool-007",
"name": "Anuranjan Srivastava",
"avatar_url": "https://avatars.githubusercontent.com/u/16525919?v=4",
"profile": "https://github.com/Anu-cool-007",
"contributions": [
"code"
]
},
{
"login": "Zimzozaur",
"name": "Simon Joseph",
"avatar_url": "https://avatars.githubusercontent.com/u/106471045?v=4",
"profile": "https://github.com/Zimzozaur",
"contributions": [
"doc"
]
},
{
"login": "abelkm99",
"name": "Abel Kidanemariam",
"avatar_url": "https://avatars.githubusercontent.com/u/41730180?v=4",
"profile": "https://github.com/abelkm99",
"contributions": [
"code",
"test",
"doc"
]
},
{
"login": "trim21",
"name": "Trim21",
"avatar_url": "https://avatars.githubusercontent.com/u/13553903?v=4",
"profile": "https://blog.trim21.me/",
"contributions": [
"code",
"test"
]
},
{
"login": "aarcex3",
"name": "Agustin Arce",
"avatar_url": "https://avatars.githubusercontent.com/u/59893355?v=4",
"profile": "http://aarcex3.github.io",
"contributions": [
"doc"
]
},
{
"login": "FarhanAliRaza",
"name": "Farhan Ali Raza",
"avatar_url": "https://avatars.githubusercontent.com/u/62690310?v=4",
"profile": "https://github.com/FarhanAliRaza",
"contributions": [
"doc"
]
},
{
"login": "pogopaule",
"name": "Fabian",
"avatar_url": "https://avatars.githubusercontent.com/u/576949?v=4",
"profile": "https://github.com/pogopaule",
"contributions": [
"code"
]
},
{
"login": "mohammedbabelly20",
"name": "Mohammed Babelly",
"avatar_url": "https://avatars.githubusercontent.com/u/104768048?v=4",
"profile": "https://github.com/mohammedbabelly20",
"contributions": [
"code"
]
},
{
"login": "charles-dyfis-net",
"name": "Charles Duffy",
"avatar_url": "https://avatars.githubusercontent.com/u/22370?v=4",
"profile": "https://keybase.io/charlesdyfisnet",
"contributions": [
"code"
]
},
{
"login": "RenameMe1",
"name": "Evgeny Demchenko",
"avatar_url": "https://avatars.githubusercontent.com/u/165988121?v=4",
"profile": "https://github.com/RenameMe1",
"contributions": [
"doc",
"test"
]
},
{
"login": "olzhasar",
"name": "Olzhas Arystanov",
"avatar_url": "https://avatars.githubusercontent.com/u/12471703?v=4",
"profile": "https://olzhasar.com",
"contributions": [
"bug",
"doc"
]
},
{
"login": "vikigenius",
"name": "Vikash",
"avatar_url": "https://avatars.githubusercontent.com/u/12724810?v=4",
"profile": "https://github.com/vikigenius",
"contributions": [
"code"
]
},
{
"login": "ftsartek",
"name": "Jordan Russell",
"avatar_url": "https://avatars.githubusercontent.com/u/20253317?v=4",
"profile": "https://github.com/ftsartek",
"contributions": [
"doc",
"test",
"code"
]
},
{
"login": "sloria",
"name": "Steven Loria",
"avatar_url": "https://avatars.githubusercontent.com/u/2379650?v=4",
"profile": "https://stevenloria.com",
"contributions": [
"doc"
]
},
{
"login": "oek1ng",
"name": "oek1ng",
"avatar_url": "https://avatars.githubusercontent.com/u/193062679?v=4",
"profile": "https://github.com/oek1ng",
"contributions": [
"code"
]
},
{
"login": "Ada-lave",
"name": "Vladislav",
"avatar_url": "https://avatars.githubusercontent.com/u/113159483?v=4",
"profile": "https://github.com/Ada-lave",
"contributions": [
"doc"
]
},
{
"login": "eandersons",
"name": "Edgars",
"avatar_url": "https://avatars.githubusercontent.com/u/9976861?v=4",
"profile": "https://gaitenis.id.lv",
"contributions": [
"doc"
]
},
{
"login": "Jannchie",
"name": "Jianqi Pan",
"avatar_url": "https://avatars.githubusercontent.com/u/29743310?v=4",
"profile": "https://jannchie.com",
"contributions": [
"code"
]
},
{
"login": "PokkaKiyo",
"name": "PokkaKiyo",
"avatar_url": "https://avatars.githubusercontent.com/u/31039465?v=4",
"profile": "https://github.com/PokkaKiyo",
"contributions": [
"test"
]
},
{
"login": "s-aleshin",
"name": "Sergei Aleshin",
"avatar_url": "https://avatars.githubusercontent.com/u/66841202?v=4",
"profile": "https://github.com/s-aleshin",
"contributions": [
"code"
]
}
],
"contributorsPerLine": 7,
"projectName": "litestar",
"projectOwner": "litestar-org",
"repoType": "github",
"repoHost": "https://github.com",
"skipCi": true,
"commitConvention": "angular",
"commitType": "docs"
}
litestar-2.18.0/.devcontainer/ 0000775 0000000 0000000 00000000000 15070515525 0016175 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.devcontainer/Dockerfile 0000664 0000000 0000000 00000001261 15070515525 0020167 0 ustar 00root root 0000000 0000000 # [Choice] Python version (use -bookworm or -bullseye variants on local arm64/Apple Silicon): 3, 3.13, 3.12, 3.11, 3.10, 3.9, 3.8, 3-bookworm, 3.13-bookworm, 3.12-bookworm, 3.11-bookworm, 3.10-bookworm, 3.9-bookworm, 3.8-bookworm, 3-bullseye, 3.11-bullseye, 3.10-bullseye, 3.9-bullseye, 3.8-bullseye, 3-buster, 3.11-buster, 3.10-buster, 3.9-buster, 3.8-buster
ARG VERSION=3.12
ARG VARIANT=-bookworm
FROM python:${VERSION}${VARIANT}
ARG VERSION
ENV UV_LOCKED=1 UV_PYTHON=${VERSION}
COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
&& apt-get purge -y fish
RUN python3 -m pip install --upgrade setuptools cython pip
litestar-2.18.0/.devcontainer/devcontainer.json 0000664 0000000 0000000 00000003406 15070515525 0021554 0 ustar 00root root 0000000 0000000 {
"name": "litestar-org/litestar",
"build": {
"dockerfile": "./Dockerfile",
"context": "."
},
"features": {
"ghcr.io/devcontainers/features/common-utils:2": {
"installZsh": "true",
"username": "vscode",
"userUid": "1000",
"userGid": "1000",
"upgradePackages": "true"
},
"ghcr.io/devcontainers/features/github-cli:1": {},
"ghcr.io/devcontainers-contrib/features/pre-commit:2": {},
"ghcr.io/devcontainers/features/python:1": "none",
"ghcr.io/devcontainers/features/git:1": {
"version": "latest",
"ppa": "false"
}
},
"customizations": {
"codespaces": {
"openFiles": ["CONTRIBUTING.rst"]
},
"vscode": {
"extensions": [
"mhutchie.git-graph",
"eamodio.gitlens",
"github.vscode-github-actions",
"ms-python.black-formatter",
"ms-python.mypy-type-checker",
"charliermarsh.ruff"
],
"settings": {
"python.editor.defaultFormatter": "charliermarsh.ruff",
"python.defaultInterpreterPath": "${workspaceFolder}/.venv",
"python.terminal.activateEnvInCurrentTerminal": true,
"python.testing.unittestEnabled": false,
"python.testing.pytestEnabled": true,
"python.testing.pytestArgs": ["."],
"python.terminal.launchArgs": ["-X", "dev"],
"terminal.integrated.shell.linux": "/bin/bash",
"terminal.integrated.profiles.linux": {
"bash": {
"path": "bash",
"icon": "terminal-bash"
},
"zsh": {
"path": "zsh"
},
"fish": {
"path": "fish"
}
}
}
}
},
"forwardPorts": [8000],
"postCreateCommand": [
"uv",
"sync"
],
"remoteUser": "vscode"
}
litestar-2.18.0/.github/ 0000775 0000000 0000000 00000000000 15070515525 0014776 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.github/CODEOWNERS 0000664 0000000 0000000 00000001076 15070515525 0016375 0 ustar 00root root 0000000 0000000 # Code owner settings for `litestar`
# @maintainers should be assigned to all reviews.
# Most specific assignment takes precedence though, so if you add a more specific thing than the `*` glob, you must also add @maintainers
# For more info about code owners see https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners#codeowners-file-example
# Global Assignment
* @litestar-org/maintainers @litestar-org/members
# Documentation
docs/* @litestar-org/maintainers @JacobCoffee @provinzkraut
litestar-2.18.0/.github/ISSUE_TEMPLATE/ 0000775 0000000 0000000 00000000000 15070515525 0017161 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.github/ISSUE_TEMPLATE/BUG.yml 0000664 0000000 0000000 00000005122 15070515525 0020321 0 ustar 00root root 0000000 0000000 name: "Bug Report"
description: Create an issue for a bug.
title: "Bug: "
labels:
- "Bug :bug:"
- "Triage Required"
projects:
- "litestar-org/16"
body:
- type: textarea
id: description
attributes:
label: "Description"
description: Please enter an description of the bug you are encountering
placeholder:
validations:
required: true
- type: input
id: reprod-url
attributes:
label: "URL to code causing the issue"
description: Please enter the URL to provide a reproduction of the issue, if applicable
placeholder: ex. https://github.com/USERNAME/REPO-NAME
validations:
required: false
- type: textarea
id: mcve
attributes:
label: "MCVE"
description: >-
Please provide a minimal, complete, and verifiable example of the issue.
This will be automatically formatted into code, so no need for backticks.
placeholder: |
from litestar import Litestar, get
@get("/")
def hello_world() -> str:
return "hello world"
app = Litestar(route_handlers=[hello_world])
render: python
validations:
required: false
- type: textarea
id: reprod
attributes:
label: "Steps to reproduce"
description: Please enter the exact steps to reproduce the issue
value: |
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
validations:
required: false
- type: textarea
id: screenshot
attributes:
label: "Screenshots"
description: If applicable, add screenshots to help explain your problem.
placeholder: Drag-and-drop images up add them directly or use Markdown to embed external images.
validations:
required: false
- type: textarea
id: logs
attributes:
label: "Logs"
description: >-
Please copy and paste any relevant log output.
This will be automatically formatted into code, so no need for backticks.
render: text
validations:
required: false
- type: textarea
id: version
attributes:
label: "Litestar Version"
description: What version of Litestar are you using when encountering this issue?
validations:
required: true
- type: checkboxes
id: platform
attributes:
label: "Platform"
description: What platform are you encountering the issue on?
options:
- label: "Linux"
- label: "Mac"
- label: "Windows"
- label: "Other (Please specify in the description above)"
validations:
required: false
litestar-2.18.0/.github/ISSUE_TEMPLATE/DOCS.yml 0000664 0000000 0000000 00000000650 15070515525 0020435 0 ustar 00root root 0000000 0000000 name: "Documentation Update"
description: Create an issue for documentation changes
title: "Docs: <title>"
labels:
- "Documentation :books:"
projects:
- "litestar-org/16"
body:
- type: textarea
id: summary
attributes:
label: "Summary"
description: Provide a brief summary of your feature request
placeholder: Describe in a few lines your feature request
validations:
required: true
litestar-2.18.0/.github/ISSUE_TEMPLATE/REQUEST.yml 0000664 0000000 0000000 00000002343 15070515525 0021036 0 ustar 00root root 0000000 0000000 name: "Feature Request"
description: Create an issue for a new feature request
title: "Enhancement: <title>"
labels:
- "Enhancement"
projects:
- "litestar-org/16"
body:
- type: textarea
id: summary
attributes:
label: "Summary"
description: Provide a brief summary of your feature request
placeholder: Describe in a few lines your feature request
validations:
required: true
- type: textarea
id: basic_example
attributes:
label: "Basic Example"
description: Indicate here some basic examples of your feature.
placeholder: Provide some basic example of your feature request
validations:
required: false
- type: textarea
id: drawbacks
attributes:
label: "Drawbacks and Impact"
description: What are the drawbacks or impacts of your feature request?
placeholder: Describe any the drawbacks or impacts of your feature request
validations:
required: false
- type: textarea
id: unresolved_question
attributes:
label: "Unresolved questions"
description: What, if any, unresolved questions do you have about your feature request?
placeholder: Identify any unresolved issues.
validations:
required: false
litestar-2.18.0/.github/ISSUE_TEMPLATE/config.yml 0000664 0000000 0000000 00000000727 15070515525 0021157 0 ustar 00root root 0000000 0000000 blank_issues_enabled: false
contact_links:
- name: Litestar Documentation
url: https://docs.litestar.dev/
about: Official Litestar documentation - please check here before opening an issue.
- name: Litestar Website
url: https://litestar.dev/
about: Main Litestar website - for details about Litestar's projects.
- name: Discord
url: https://discord.gg/litestar
about: Join our Discord community to chat or get in touch with the maintainers.
litestar-2.18.0/.github/PULL_REQUEST_TEMPLATE.md 0000664 0000000 0000000 00000001320 15070515525 0020573 0 ustar 00root root 0000000 0000000 <!--
By submitting this pull request, you agree to:
- follow [Litestar's Code of Conduct](https://github.com/litestar-org/.github/blob/main/CODE_OF_CONDUCT.md)
- follow [Litestar's contribution guidelines](https://github.com/litestar-org/.github/blob/main/CONTRIBUTING.md)
- follow the [PSFs's Code of Conduct](https://www.python.org/psf/conduct/)
-->
## Description
-
<!--
Please add in issue numbers this pull request will close, if applicable
Examples: Fixes #4321 or Closes #1234
Ensure you are using a supported keyword to properly link an issue:
https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword
-->
## Closes
litestar-2.18.0/.github/dependabot.yml 0000664 0000000 0000000 00000000165 15070515525 0017630 0 ustar 00root root 0000000 0000000 version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "daily"
litestar-2.18.0/.github/labeler.yml 0000664 0000000 0000000 00000013624 15070515525 0017135 0 ustar 00root root 0000000 0000000 version: v1
labels:
# -- types -------------------------------------------------------------------
- label: 'type/feat'
sync: true
matcher:
title: '^feat(\([^)]+\))?!?:'
- label: 'type/bug'
sync: true
matcher:
title: '^fix(\([^)]+\))?!?:'
- label: 'type/docs'
sync: true
matcher:
title: '^docs(\([^)]+\))?:'
- label: 'Breaking 🔨'
sync: true
matcher:
title: '^(feat|fix)(\([^)]+\))?!:'
# -- distinct areas ----------------------------------------------------------
- label: '3.x'
sync: true
matcher:
baseBranch: '^v3$'
- label: 'area/docs'
sync: true
matcher:
files:
any: ['docs/*', 'docs/**/*', '**/*.rst', '**/*.md']
- label: 'area/unit-tests'
sync: true
matcher:
files:
any: ['test/unit/*', 'test/unit/**/*']
- label: 'area/end-to-end-tests'
sync: true
matcher:
files:
any: ['test/e2e/*', 'test/e2e/**/*']
- label: 'area/test-apps'
sync: true
matcher:
files:
any: ['test/test_apps/*', 'test/test_apps/**/*']
- label: 'area/docs'
sync: true
matcher:
files:
any: ['docs/*', 'docs/**/*', '**/*.rst', '**/*.md']
- label: 'area/unit-tests'
sync: true
matcher:
files:
any: ['test/unit/*', 'test/unit/**/*']
- label: 'area/end-to-end-tests'
sync: true
matcher:
files:
any: ['test/e2e/*', 'test/e2e/**/*']
- label: 'area/test-apps'
sync: true
matcher:
files:
any: ['test/test_apps/*', 'test/test_apps/**/*']
- label: 'area/ci'
sync: true
matcher:
files:
any: ['.github/**/*', 'codecov.yml', 'pre-commit-config.yaml', 'sonar-project.properties']
- label: 'area/dependencies'
sync: true
matcher:
files:
any: ['pyproject.toml', '*.lock']
- label: 'area/enums'
sync: true
matcher:
files: ['litestar/enums.py']
- label: 'area/background-tasks'
sync: true
matcher:
files: ['litestar/background_tasks.py']
- label: 'area/constants'
sync: true
matcher:
files: ['litestar/constants.py']
- label: 'area/concurrency'
sync: true
matcher:
files: ['litestar/concurrency.py']
- label: 'area/parsers'
sync: true
matcher:
files: ['litestar/_parsers.py']
- label: 'area/layers'
sync: true
matcher:
files: ['litestar/_layers/*']
- label: 'area/multipart'
sync: true
matcher:
files: ['litestar/_multipart.py']
- label: 'area/di'
sync: true
matcher:
files: ['litestar/di.py']
- label: 'area/file-system'
sync: true
matcher:
files: ['litestar/file_system.py']
- label: 'area/controller'
sync: true
matcher:
files: ['litestar/controller.py']
- label: 'area/serialization'
sync: true
matcher:
files: ['litestar/serialization/*']
- label: 'area/params'
sync: true
matcher:
files: ['litestar/params.py']
- label: 'area/template'
sync: true
matcher:
files: ['litestar/template/*']
- label: 'area/events'
sync: true
matcher:
files: ['litestar/events/*']
- label: 'area/router'
sync: true
matcher:
files: ['litestar/router.py']
- label: 'area/exceptions'
sync: true
matcher:
files: ['litestar/exceptions/*']
- label: 'area/static-files'
sync: true
matcher:
files: ['litestar/static_files/*']
- label: 'area/signature'
sync: true
matcher:
files: ['litestar/_signature/*']
- label: 'area/plugins'
sync: true
matcher:
files: ['litestar/plugins/*']
- label: 'area/stores'
sync: true
matcher:
files: ['litestar/stores/*']
- label: 'area/logging'
sync: true
matcher:
files: ['litestar/logging/*']
- label: 'area/connection'
sync: true
matcher:
files: ['litestar/connection/*']
- label: 'area/asgi'
sync: true
matcher:
files: ['litestar/_asgi/*']
- label: 'area/types'
sync: true
matcher:
files: ['litestar/types/*']
- label: 'area/kwargs'
sync: true
matcher:
files: ['litestar/_kwargs/*']
- label: 'area/datastructures'
sync: true
matcher:
files: ['litestar/datastructures/*']
- label: 'area/channels'
sync: true
matcher:
files: ['litestar/channels/*']
- label: 'area/response'
sync: true
matcher:
files: ['litestar/response/*']
- label: 'area/repository'
sync: true
matcher:
files: ['litestar/repository/*']
- label: 'area/security'
sync: true
matcher:
files: ['litestar/security/*']
- label: 'area/dto'
sync: true
matcher:
files: ['litestar/dto/*']
- label: 'area/testing'
sync: true
matcher:
files: ['litestar/testing/*']
- label: 'area/openapi'
sync: true
matcher:
files: ['litestar/_openapi/*']
- label: 'area/middleware'
sync: true
matcher:
files: ['litestar/middleware/*']
- label: 'area/handlers'
sync: true
matcher:
files: ['litestar/handlers/*']
- label: 'area/contrib'
sync: true
matcher:
files: ['litestar/contrib/*']
- label: 'area/private-api'
sync: true
matcher:
files:
any: ['litestar/_*.py', 'litestar/*/_*.py', 'litestar/_*/**/*.py']
# -- Size Based Labels -------------------------------------------------------
- label: 'size: small'
sync: true
matcher:
files:
count:
gte: 1
lte: 10
- label: 'size: medium'
sync: true
matcher:
files:
count:
gte: 10
lte: 25
- label: 'size: large'
sync: true
matcher:
files:
count:
gte: 26
# -- Merge Checks --------------------------------------------------------------
checks:
- context: 'No Merge check'
description: "Disable merging when 'do not merge' label is set"
labels:
none: ['do not merge']
litestar-2.18.0/.github/workflows/ 0000775 0000000 0000000 00000000000 15070515525 0017033 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.github/workflows/ci.yml 0000664 0000000 0000000 00000022326 15070515525 0020156 0 ustar 00root root 0000000 0000000 name: Tests And Linting
on:
pull_request:
merge_group:
push:
branches:
- main
- v1.51
env:
UV_LOCKED: 1
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.8"
- name: Install Pre-Commit
run: python -m pip install pre-commit
- name: Load cached Pre-Commit Dependencies
id: cached-pre-commit-dependencies
uses: actions/cache@v4
with:
path: ~/.cache/pre-commit/
key: pre-commit-4|${{ env.pythonLocation }}|${{ hashFiles('.pre-commit-config.yaml') }}
- name: Execute Pre-Commit
run: pre-commit run --show-diff-on-failure --color=always --all-files
mypy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.8"
allow-prereleases: true
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Run mypy
run: uv run mypy
pyright:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.8"
allow-prereleases: true
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Run pyright
run: uv run pyright
slotscheck:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.8"
allow-prereleases: false
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Run slotscheck
run: uv run slotscheck litestar
test:
name: "test (${{ matrix.python-version }})"
strategy:
fail-fast: true
matrix:
python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
uses: ./.github/workflows/test.yml
with:
coverage: ${{ (matrix.python-version == '3.12' || matrix.python-version == '3.8') }}
python-version: ${{ matrix.python-version }}
# add an aggregate step here to check if any of the steps of the matrix 'test' job
# failed. this allows us to have dynamic or diverging steps in the matrix, while still
# being able to mark the 'test' step as a required check for a PR to be considered
# mergeable, without having to specify each individual matrix item.
test_success:
needs: test
# ensure this step always runs
if: always()
runs-on: ubuntu-latest
steps:
- name: Report success or fail
run: exit ${{ needs.test.result == 'success' && '0' || '1' }}
test_typing_extensions:
runs-on: ubuntu-latest
strategy:
matrix:
typing-extensions: ["4.12.1", "4.13.1", "latest"]
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Set up python
uses: actions/setup-python@v5
with:
python-version: 3.13
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.6.12"
enable-cache: true
- name: Install dependencies
run: uv sync
- name: Install typing-extensions
if: ${{ matrix.typing-extensions != 'latest' }}
run: uv pip install typing-extensions=="${{ matrix.typing-extensions }}"
- name: Install typing-extensions
if: ${{ matrix.typing-extensions == 'latest' }}
run: uv pip install typing-extensions --upgrade --prerelease=allow
- name: Test
run: uv run --no-sync -- python -m pytest tests/unit/test_typing.py
test_integration:
name: Test server integration
runs-on: ubuntu-latest
strategy:
matrix:
uvicorn-version: ["uvicorn<0.27.0", "uvicorn>=0.27.0"]
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Set up python 3.11
uses: actions/setup-python@v5
with:
python-version: 3.11
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Install Build Dependencies
run: sudo apt-get install build-essential libpq-dev python3-dev -y
- name: Install dependencies
run: |
uv sync
uv pip install -U "${{ matrix.uvicorn-version }}"
- name: Set PYTHONPATH
run: echo "PYTHONPATH=$PWD" >> $GITHUB_ENV
- name: Test
run: uv run --no-sync pytest tests -m server_integration
test-platform-compat:
if: github.event_name == 'push' || contains(github.event.pull_request.labels.*.name, 'test platform compat')
strategy:
fail-fast: false
matrix:
os: ["macos-latest", "windows-latest"]
uses: ./.github/workflows/test.yml
with:
python-version: "3.13"
os: ${{ matrix.os }}
timeout: 30
codeql:
needs:
- test
- validate
runs-on: ubuntu-latest
permissions:
security-events: write
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Initialize CodeQL Without Dependencies
uses: github/codeql-action/init@v3
with:
setup-python-dependencies: false
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
build-docs:
needs:
- validate
if: github.event_name == 'pull_request'
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Install Build Dependencies
run: sudo apt-get install build-essential libpq-dev python3-dev -y
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.12"
allow-prereleases: true
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Build docs
run: uv run make docs
- name: Check docs links
env:
LITESTAR_DOCS_IGNORE_MISSING_EXAMPLE_OUTPUT: 1
run: uv run make docs-linkcheck
- name: Save PR number
run: |
echo "${{ github.event.number }}" > .pr_number
- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: docs-preview
path: |
docs/_build/html
.pr_number
include-hidden-files: true
test_minimal_app:
name: Test Minimal Application with Base Dependencies
runs-on: ubuntu-latest
env:
python_version: "3.12"
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Set pythonpath
run: echo "PYTHONPATH=$PWD" >> $GITHUB_ENV
- name: Test
run: |
mv tests/examples/test_hello_world.py test_hello_world.py
uv run pytest test_hello_world.py
test_pydantic_1_app:
name: Test Minimal Pydantic 1 application
runs-on: ubuntu-latest
env:
python_version: "3.12"
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Install Build Dependencies
run: sudo apt-get install build-essential libpq-dev python3-dev -y
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Install dependencies
run: |
uv sync
uv pip install "pydantic==1.*"
- name: Set pythonpath
run: echo "PYTHONPATH=$PWD" >> $GITHUB_ENV
- name: Test
run: uv run --no-sync coverage run --branch -m unittest test_apps/pydantic_1_app.py
- name: Rename coverage file
run: mv .coverage* .coverage.pydantic_v1
- uses: actions/upload-artifact@v4
with:
name: coverage-data-pydantic_v1-${{ inputs.python-version }}
path: .coverage.pydantic_v1
include-hidden-files: true
upload-test-coverage:
runs-on: ubuntu-latest
needs:
- test
- test_pydantic_1_app
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Download Artifacts
uses: actions/download-artifact@v5
with:
pattern: coverage-data*
merge-multiple: true
- name: Combine coverage files
run: |
python -Im pip install coverage covdefaults
python -Im coverage combine
python -Im coverage xml -i
- name: Fix coverage file name
run: sed -i "s/home\/runner\/work\/litestar\/litestar/github\/workspace/g" coverage.xml
- name: Upload coverage reports to Codecov
uses: codecov/codecov-action@v5
with:
files: coverage.xml
token: ${{ secrets.CODECOV_TOKEN }}
litestar-2.18.0/.github/workflows/codeql.yml 0000664 0000000 0000000 00000000674 15070515525 0021034 0 ustar 00root root 0000000 0000000 name: CodeQL scheduled
on:
schedule:
- cron: "0 4 * * *"
jobs:
codeql:
runs-on: ubuntu-latest
permissions:
security-events: write
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
ref: "main"
- name: Initialize CodeQL With Dependencies
uses: github/codeql-action/init@v3
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
litestar-2.18.0/.github/workflows/docs-preview.yml 0000664 0000000 0000000 00000004733 15070515525 0022174 0 ustar 00root root 0000000 0000000 name: Deploy documentation preview
on:
workflow_run:
workflows: [Tests And Linting]
types: [completed]
jobs:
deploy:
if: ${{ github.event.workflow_run.conclusion == 'success' && github.event.workflow_run.event == 'pull_request' }}
runs-on: ubuntu-latest
permissions:
issues: write
pull-requests: write
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Download artifact
uses: dawidd6/action-download-artifact@v11
with:
workflow_conclusion: success
run_id: ${{ github.event.workflow_run.id }}
path: docs-preview
name: docs-preview
- name: Validate and set PR number
run: |
PR_NUMBER=$(cat docs-preview/.pr_number)
if ! [[ "$PR_NUMBER" =~ ^[0-9]+$ ]]; then
echo "Invalid PR number: $PR_NUMBER"
exit 1
fi
echo "PR_NUMBER=$PR_NUMBER" >> $GITHUB_ENV
- name: Deploy docs preview
uses: JamesIves/github-pages-deploy-action@v4
with:
folder: docs-preview/docs/_build/html
token: ${{ secrets.DOCS_PREVIEW_DEPLOY_TOKEN }}
repository-name: litestar-org/litestar-docs-preview
clean: false
target-folder: ${{ env.PR_NUMBER }}
branch: gh-pages
- uses: actions/github-script@v7
env:
PR_NUMBER: ${{ env.PR_NUMBER }}
with:
script: |
const issue_number = process.env.PR_NUMBER
const body = "Documentation preview will be available shortly at https://litestar-org.github.io/litestar-docs-preview/" + issue_number
const opts = github.rest.issues.listComments.endpoint.merge({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issue_number,
});
const comments = await github.paginate(opts)
for (const comment of comments) {
if (comment.user.id === 41898282 && comment.body === body) {
await github.rest.issues.deleteComment({
owner: context.repo.owner,
repo: context.repo.repo,
comment_id: comment.id
})
}
}
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issue_number,
body: body,
})
litestar-2.18.0/.github/workflows/docs.yml 0000664 0000000 0000000 00000003143 15070515525 0020507 0 ustar 00root root 0000000 0000000 name: Documentation Building
on:
release:
types: [published]
push:
branches:
- main
workflow_dispatch:
inputs:
version:
description: 'Version to build docs for (1, 2, main)'
required: true
default: 'main'
type: choice
options:
- main
- '2'
- '1'
env:
UV_LOCKED: 1
jobs:
docs:
permissions:
contents: write
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Install dependencies
run: uv sync
- name: Fetch gh pages
run: git fetch origin gh-pages --depth=1
- name: Build release docs
run: uv run python tools/build_docs.py docs-build
if: github.event_name == 'release'
- name: Build docs (main branch)
run: uv run python tools/build_docs.py docs-build --version main
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
- name: Build docs (manual trigger)
run: |
if [ "${{ inputs.version }}" == "release" ]; then
uv run python tools/build_docs.py docs-build
else
uv run python tools/build_docs.py docs-build --version ${{ inputs.version }}
fi
if: github.event_name == 'workflow_dispatch'
- name: Deploy
uses: JamesIves/github-pages-deploy-action@v4
with:
folder: docs-build
litestar-2.18.0/.github/workflows/notify-released-issues.yml 0000664 0000000 0000000 00000001570 15070515525 0024164 0 ustar 00root root 0000000 0000000 name: Notify released issues
on:
workflow_call:
inputs:
release_tag:
type: string
required: true
jobs:
notify:
runs-on: ubuntu-latest
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Get released issues
id: get-released-issues
run:
echo "issues=$(python ./.github/workflows/notify_released_issues/get_closed_issues.py ${{ inputs.release_tag }})" >> "$GITHUB_OUTPUT"
- uses: actions/github-script@v7
env:
CLOSED_ISSUES: ${{ steps.get-released-issues.outputs.issues }}
with:
script: |
const script = require('./.github/workflows/notify_released_issues/notify.js')
await script({github, context, core})
litestar-2.18.0/.github/workflows/notify_released_issues/ 0000775 0000000 0000000 00000000000 15070515525 0023602 5 ustar 00root root 0000000 0000000 litestar-2.18.0/.github/workflows/notify_released_issues/get_closed_issues.py 0000664 0000000 0000000 00000001650 15070515525 0027661 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import itertools
import json
import pathlib
import re
import sys
__all__ = (
"find_resolved_issues",
"main",
)
def find_resolved_issues(source: str, tag: str) -> list[str]:
version = tag.split("v", maxsplit=1)[-1]
changelog_line = f".. changelog:: {version}"
stop_line = ".. changelog::"
return list(
{
issue
for line in itertools.takewhile(
lambda l: stop_line not in l, # noqa: E741
source.split(changelog_line, maxsplit=1)[1].splitlines(),
)
if re.match(r"\s+:issue: [\d ,]+", line)
for issue in re.findall(r"\d+", line)
}
)
def main(tag: str) -> str:
source = pathlib.Path("docs/release-notes/changelog.rst").read_text()
return json.dumps(find_resolved_issues(source, tag))
if __name__ == "__main__":
print(main(sys.argv[1])) # noqa: T201
litestar-2.18.0/.github/workflows/notify_released_issues/notify.js 0000664 0000000 0000000 00000002273 15070515525 0025454 0 ustar 00root root 0000000 0000000 module.exports = async ({github, context, core}) => {
const issues = JSON.parse(process.env.CLOSED_ISSUES)
const releaseURL = context.payload.release.html_url
const releaseName = context.payload.release.name
const baseBody = "A fix for this issue has been released in"
const body = baseBody + ` [${releaseName}](${releaseURL})`
for (const issueNumber of issues) {
const opts = github.rest.issues.listComments.endpoint.merge({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
});
const comments = await github.paginate(opts)
for (const comment of comments) {
if (comment.user.id === 41898282 && comment.body.startsWith(baseBody)) {
await github.rest.issues.deleteComment({
owner: context.repo.owner,
repo: context.repo.repo,
comment_id: comment.id
})
}
}
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
body: body,
})
}
}
litestar-2.18.0/.github/workflows/pr-labeler.yml 0000664 0000000 0000000 00000002622 15070515525 0021605 0 ustar 00root root 0000000 0000000 name: "Pull Request Labeler"
on:
pull_request_target:
jobs:
apply-labels:
permissions:
contents: read
pull-requests: write
checks: write
statuses: write
runs-on: ubuntu-latest
steps:
- uses: fuxingloh/multi-labeler@v4
with:
github-token: "${{ secrets.GITHUB_TOKEN }}"
distinguish-pr-origin:
needs: apply-labels
if: ${{ always() }}
permissions:
pull-requests: write
runs-on: ubuntu-latest
steps:
- uses: actions/github-script@v7
with:
github-token: ${{secrets.GITHUB_TOKEN}}
script: |
const maintainers = [
'JacobCoffee', 'provinzkraut', 'cofin',
'peterschutt', 'Alc-Alc', 'guacs',
'dependabot[bot]', 'all-contributors[bot]'
]
if (maintainers.includes(context.payload.sender.login)) {
github.rest.issues.addLabels({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
labels: ['pr/internal']
})
} else {
github.rest.issues.addLabels({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
labels: ['pr/external', 'Triage Required :hospital:']
})
}
litestar-2.18.0/.github/workflows/pr-merged.yml 0000664 0000000 0000000 00000003654 15070515525 0021450 0 ustar 00root root 0000000 0000000 name: "PR merged"
on:
pull_request:
types:
- closed
branches:
- main
- v3.0
jobs:
close_and_notify:
name: Close issues and notify
if: github.event.pull_request.merged == true
runs-on: ubuntu-latest
steps:
- uses: actions/github-script@v7
with:
script: |
const prNumber = context.payload.number
const branch = context.baseRef
// TODO: use semantic commits to specify the exact version, when it will be released
const commentBody = `<!--closing-comment-->\nThis issue has been closed in #${prNumber}. The change will be included in upcoming releases.`
const query = `query($number: Int!, $owner: String!, $name: String!) { repository(owner: $owner, name: $name) {
pullRequest(number: $number) {
id
closingIssuesReferences (first: 10) { edges { node { number } } }
}
}
}`
const res = await github.graphql(query, {number: prNumber, owner: context.repo.owner, name: context.repo.repo})
const linkedIssues = res.repository.pullRequest.closingIssuesReferences.edges.map(
edge => edge.node.number
)
for (const issueNumber of linkedIssues) {
const res = await github.rest.issues.update({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
state: "closed",
state_reason: "completed"
})
if (res.status === 200) {
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
body: commentBody,
})
}
}
litestar-2.18.0/.github/workflows/pr-title.yml 0000664 0000000 0000000 00000000532 15070515525 0021316 0 ustar 00root root 0000000 0000000 name: "Lint PR Title"
on:
pull_request_target:
types:
- opened
- edited
- synchronize
permissions:
pull-requests: read
jobs:
main:
name: Validate PR title
runs-on: ubuntu-latest
steps:
- uses: amannn/action-semantic-pull-request@v5
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
litestar-2.18.0/.github/workflows/publish.yml 0000664 0000000 0000000 00000001557 15070515525 0021234 0 ustar 00root root 0000000 0000000 name: Latest Release
on:
release:
types: [published]
workflow_dispatch:
jobs:
publish-release:
name: upload release to PyPI
runs-on: ubuntu-latest
permissions:
id-token: write
environment: release
steps:
- name: Check out repository
uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: "3.12"
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.5.4"
enable-cache: true
- name: Build package
run: uv build
- name: Publish package distributions to PyPI
uses: pypa/gh-action-pypi-publish@release/v1
notify-issues:
needs: publish-release
name: Notify issues
uses: ./.github/workflows/notify-released-issues.yml
with:
release_tag: ${{ github.event.release.tag_name }}
litestar-2.18.0/.github/workflows/test.yml 0000664 0000000 0000000 00000004133 15070515525 0020536 0 ustar 00root root 0000000 0000000 name: Test
on:
workflow_call:
inputs:
python-version:
required: true
type: string
coverage:
required: false
type: boolean
default: false
os:
required: false
type: string
default: "ubuntu-latest"
timeout:
required: false
type: number
default: 10
env:
UV_LOCKED: 1
jobs:
test:
runs-on: ${{ inputs.os }}
timeout-minutes: ${{ inputs.timeout }}
defaults:
run:
shell: bash
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Set up python ${{ inputs.python-version }}
uses: actions/setup-python@v5
with:
python-version: ${{ inputs.python-version }}
# Linux Source
- name: Install Build Dependencies
run: sudo apt-get install build-essential libpq-dev python3-dev -y
if: startsWith(inputs.os, 'ubuntu')
# MacOS Source
- name: Install Build Dependencies
run: brew install libpq && brew link --force libpq
if: startsWith(inputs.os, 'macos')
# Windows Source
- name: Install Build Dependencies
uses: ikalnytskyi/action-setup-postgres@v7
if: startsWith(inputs.os, 'windows')
- name: Install uv
uses: astral-sh/setup-uv@v6
with:
version: "0.8.8"
enable-cache: true
- name: Install dependencies
run: uv sync
- name: Set PYTHONPATH
run: echo "PYTHONPATH=$PWD" >> $GITHUB_ENV
- name: Test
if: ${{ !inputs.coverage }}
run: uv run pytest docs/examples tests -n auto
- name: Test with coverage
if: inputs.coverage
run: uv run pytest docs/examples tests -n auto --cov
- name: Rename coverage file
if: inputs.coverage
run: mv .coverage .coverage.${{ inputs.python-version }}
- uses: actions/upload-artifact@v4
if: inputs.coverage
with:
name: coverage-data-${{ inputs.python-version }}
path: .coverage.${{ inputs.python-version }}
include-hidden-files: true
litestar-2.18.0/.gitignore 0000664 0000000 0000000 00000001004 15070515525 0015421 0 ustar 00root root 0000000 0000000 # folders
*.egg-info/
.auto_pytabs_cache/
.hypothesis/
.idea/
.mypy_cache/
.pytest_cache/
.scannerwork/
.unasyncd_cache/
.venv/
.venv*
.vscode/
__pycache__/
assets/
build/
dist/
html/
node_modules/
results/
site/
target/
# files
**/*.so
**/*.sqlite
**/*.sqlite*
*.iml
.DS_Store
.coverage
.ruff_cache
/docs/_build/
coverage.*
setup.py
# pdm
.pdm.toml
.pdm-python
.pdm-build/
# pdm - PEP 582
__pypackages__/
# pyenv / rtx / asdf
.tool-versions
.python-version
/.dmypy.json
# test certificates
certs/
pdm.toml
.zed
litestar-2.18.0/.pre-commit-config.yaml 0000664 0000000 0000000 00000002767 15070515525 0017733 0 ustar 00root root 0000000 0000000 default_language_version:
python: "3.12"
repos:
- repo: https://github.com/compilerla/conventional-pre-commit
rev: v3.6.0
hooks:
- id: conventional-pre-commit
stages: [commit-msg]
- repo: https://github.com/pre-commit/pre-commit-hooks
rev: v5.0.0
hooks:
- id: check-ast
- id: check-case-conflict
- id: check-toml
- id: debug-statements
exclude: ^(litestar/config/app\.py|litestar/app\.py|test_apps/debugging/main\.py)$
- id: end-of-file-fixer
- id: mixed-line-ending
- id: trailing-whitespace
exclude: "tests/unit/test_openapi/test_typescript_converter/test_converter.py"
- repo: https://github.com/provinzkraut/unasyncd
rev: "v0.8.1"
hooks:
- id: unasyncd
additional_dependencies: ["ruff==0.12.8"]
- repo: https://github.com/astral-sh/ruff-pre-commit
rev: "v0.12.8"
hooks:
- id: ruff
args: ["--fix"]
- id: ruff-format
- repo: https://github.com/crate-ci/typos
rev: v1.30.3
hooks:
- id: typos
- repo: https://github.com/python-formate/flake8-dunder-all
rev: v0.4.1
hooks:
- id: ensure-dunder-all
exclude: "test*|examples*|tools"
args: ["--use-tuple"]
- repo: https://github.com/sphinx-contrib/sphinx-lint
rev: "v1.0.0"
hooks:
- id: sphinx-lint
- repo: local
hooks:
- id: pypi-readme
name: pypi-readme
language: python
entry: python tools/pypi_readme.py
types: [markdown]
litestar-2.18.0/CITATION.cff 0000664 0000000 0000000 00000003053 15070515525 0015331 0 ustar 00root root 0000000 0000000 cff-version: 1.2.0
title: Litestar
message: 'If you use this software, please cite it as below.'
type: software
authors:
- given-names: Janek Nouvertné
- given-names: Peter Schutt
- given-names: Cody Fincher
- given-names: Visakh Unnikrishnan
- given-names: Jacob Coffee
- given-names: Na'aman Hirschfeld
repository-code: 'https://github.com/litestar-org/litestar'
url: 'https://docs.litestar.dev/latest/'
abstract: >-
Litestar is a powerful, flexible, and highly performant Python web framework
for building modern APIs and applications. With an emphasis on developer
experience and performance, Litestar provides a rich set of features out of the
box, including automatic API documentation, data validation and serialization,
ORM integration, dependency injection, caching, websockets, and more.
Litestar's layered architecture and open ecosystem enable seamless integration
with popular libraries like Pydantic, SQLAlchemy, and msgspec. It offers both
asynchronous and synchronous execution models without performance penalties.
With Litestar, you can effortlessly build and deploy production-ready APIs and
web applications, leveraging features like interactive API documentation,
middlewares for common tasks, session and JWT-based authentication, and strict
runtime validation for enhanced safety. Experience the perfect blend of ease
of use, flexibility and performance with Litestar.
keywords:
- python
- web
- framework
- typing
- dependency injection
- api
license: MIT
version: v2.8.0
date-released: '2024-04-05'
litestar-2.18.0/CONTRIBUTING.rst 0000664 0000000 0000000 00000034024 15070515525 0016102 0 ustar 00root root 0000000 0000000 Contribution Guide
==================
.. _pipx: https://pypa.github.io/pipx/
.. |pipx| replace:: `pipx <https://pypa.github.io/pipx/>`__
.. _homebrew: https://brew.sh/
.. |homebrew| replace:: `Homebrew <https://brew.sh/>`__
Getting Started
---------------
Supported Python Versions
+++++++++++++++++++++++++
The lowest currently supported version is Python 3.8.
At a minimum you will need Python 3.8 for code changes and 3.12 if you plan on doing documentation building / changes.
You can use various tools to manage multiple Python versions on your system including:
* `pyenv <https://github.com/pyenv/pyenv>`_ and `pyenv-win for Windows <https://github.com/pyenv-win/pyenv-win>`_
* `rtx / mise <https://mise.jdx.dev/>`_
* `asdf <https://asdf-vm.com/>`_
* `Building each version manually from source <https://www.build-python-from-source.com/>`_
* Utilizing `GitHub Codespaces <https://codespaces.new/litestar-org/litestar?quickstart=1>`_
We use the lowest supported version in our type-checking CI,
this ensures that the changes you made are backward compatible.
Setting up the environment
++++++++++++++++++++++++++
.. tip:: We maintain a Makefile with several commands to help with common tasks.
You can run ``make help`` to see a list of available commands.
If you are utilizing `GitHub Codespaces <https://codespaces.new/litestar-org/litestar?quickstart=1>`_,
the environment will bootstrap itself automatically. The steps below are for local development.
#. Install `uv <https://docs.astral.sh/uv/getting-started/installation/>`_:
#. Run ``make install`` to create a `virtual environment <https://docs.python.org/3/tutorial/venv.html>`_
and install the required development dependencies or run the ``uv sync`` command manually:
.. code-block:: shell
:caption: Installing the development dependencies
uv sync
.. tip:: Many modern IDEs like PyCharm or VS Code will enable the uv-managed virtualenv that is created in step 2
for you automatically.
If your IDE / editor does not offer this functionality, then you will need to manually activate the virtualenv
yourself. Otherwise you may encounter errors or unexpected behaviour when trying to run the commands referenced
within this document.
To activate the virtualenv manually, please consult uv's documentation on
`working with virtual environments <https://docs.astral.sh/uv/pip/environments/>`_.
The rest of this document will assume this environment is active wherever commands are referenced.
Code contributions
------------------
Workflow
++++++++
#. `Fork <https://github.com/litestar-org/litestar/fork>`_ the `Litestar repository <https://github.com/litestar-org/litestar>`_
#. Clone your fork locally with git
#. `Set up the environment <#setting-up-the-environment>`_
#. Make your changes
#. (Optional) Run ``pre-commit run --all-files`` to run linters and formatters. This step is optional and will be executed
automatically by git before you make a commit, but you may want to run it manually in order to apply fixes
#. Commit your changes to git. We follow `conventional commits <https://www.conventionalcommits.org/>`_
which are enforced using a ``pre-commit`` hook.
#. Push the changes to your fork
#. Open a `pull request <https://docs.github.com/en/pull-requests>`_. Give the pull request a descriptive title
indicating what it changes. The style of the PR title should also follow
`conventional commits <https://www.conventionalcommits.org/>`_, and this is enforced using a GitHub action.
#. Add yourself as a contributor using the `all-contributors bot <https://allcontributors.org/docs/en/bot/usage>`_
Guidelines for writing code
----------------------------
- Code should be `Pythonic and zen <https://peps.python.org/pep-0020/>`_
- All code should be fully `typed <https://peps.python.org/pep-0484/>`_. This is enforced via
`mypy <https://mypy.readthedocs.io/en/stable/>`_ and `Pyright <https://github.com/microsoft/pyright/>`_
* When requiring complex types, use a `type alias <https://docs.python.org/3/library/typing.html#type-aliases>`_.
Check :doc:`reference/types` if a type alias for your use case already exists
* If something cannot be typed correctly due to a limitation of the type checkers, you may use :func:`typing.cast`
to rectify the situation. However, you should only use this as a last resort if you've exhausted all other options
of `type narrowing <https://mypy.readthedocs.io/en/stable/type_narrowing.html>`_, such as :func:`isinstance` checks
and `type guards <https://docs.python.org/3/library/typing.html#typing.TypeGuard>`_.
* You may use a properly scoped ``type: ignore`` if you ensured that a line is correct, but mypy / pyright has
issues with it.
Properly scoped meaning do not use blank ``type: ignore``, instead supply the specific error code, e.g.,
``type: ignore[attr-defined]``
- If you are adding or modifying existing code, ensure that it's fully tested. 100% test coverage is mandatory, and will
be checked on the PR using `SonarCloud <https://www.sonarsource.com/products/sonarcloud/>`_ and
`Codecov <https://codecov.io/>`_
- All functions, methods, classes, and attributes should be documented with a docstring. We use the
`Google docstring style <https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html>`_. If you come
across a function or method that doesn't conform to this standard, please update it as you go
- When adding a new public interface, it has to be included in the reference documentation located in
``docs/reference``. If applicable, add or modify examples in the docs related to the new functionality implemented,
following the guidelines established in `Adding examples`_.
Writing and running tests
+++++++++++++++++++++++++
Tests are contained within the ``tests`` directory, and follow the same directory structure as the ``litestar`` module.
If you are adding a test case, it should be located within the correct submodule of ``tests``. E.g., tests for
``litestar/utils/sync.py`` reside in ``tests/utils/test_sync.py``.
The ``Makefile`` includes several commands for running tests:
- ``make test`` to run tests located in ``tests``
- ``make test-examples`` to run tests located in ``docs/examples/tests``
- ``make test-all`` to run all tests
- ``make coverage`` to run tests with coverage and generate an html report
The tests make use of `pytest-xdist <https://pytest-xdist.readthedocs.io>`_ to speed up
test runs. These are enabled by default when running ``make test``, ``make test-all``
or ``make coverage``. Due to the nature of pytest-xdist, attaching a debugger isn't as
straightforward. For debugging, it's recommended to run the tests individually with
``pytest <test name>`` or via an IDE, which will skip ``pytest-xdist``.
Running type checkers
+++++++++++++++++++++
We use `mypy <https://mypy.readthedocs.io/en/stable/>`_ and `pyright <https://github.com/microsoft/pyright/>`_ to
enforce type safety. You can run them with:
- ``make mypy``
- ``make pyright``
- ``make type-check`` to run both
- ``make lint`` to run pre-commit hooks and type checkers.
Our type checkers are run on Python 3.8 in CI, so you should make sure to run them on the same version locally as well.
Project documentation
---------------------
The documentation is located in the ``/docs`` directory and is written in
`reStructuredText <https://docutils.sourceforge.io/rst.html>`_ with the `Sphinx <https://www.sphinx-doc.org/en/master/>`_.
library. If you're unfamiliar with any of those,
`reStructuredText primer <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html>`_ and
`Sphinx quickstart <https://www.sphinx-doc.org/en/master/usage/quickstart.html>`_ are recommended reads.
Docs theme and appearance
+++++++++++++++++++++++++
We welcome contributions that enhance / improve the appearance and usability of the docs. We use the excellent
`PyData Sphinx Theme <https://pydata-sphinx-theme.readthedocs.io/>`_ theme, which comes with a lot of options out of the box.
If you wish to contribute to the docs style / setup, or static site generation, you should consult the theme docs
as a first step.
Running the docs locally
++++++++++++++++++++++++
You can serve the documentation locally with
.. code-block:: shell
:caption: Serving the documentation locally
make docs-serve
or build it with
.. code-block:: shell
:caption: Serving the documentation locally
make docs
Writing and editing docs
++++++++++++++++++++++++
We welcome contributions that enhance / improve the content of the docs. Feel free to add examples, clarify text,
restructure the docs, etc., but make sure to follow these guidelines:
- Write text in idiomatic English, using simple language
- Do not use contractions for ease of reading for non-native English speakers
- Opt for `Oxford commas <https://en.wikipedia.org/wiki/Serial_comma>`_ when listing a series of terms
- Keep examples simple and self contained (see `Adding examples`_). This is to ensure they are tested
alongside the rest of the test suite and properly type checked and linted.
- Provide links where applicable.
- Use `intersphinx <https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>`_ wherever possible when
referencing external libraries
- Provide diagrams using `Mermaid <https://mermaid.js.org/>`_ where applicable and possible
Adding examples
~~~~~~~~~~~~~~~
The examples from the docs are located in their own modules inside the ``/docs/examples`` folder. This makes it easier
to test them alongside the rest of the test suite, ensuring they do not become stale as Litestar evolves.
Please follow the next guidelines when adding a new example:
- Add the example in the corresponding module directory in ``/docs/examples`` or create a new one if necessary
- Create a suite for the module in ``/tests/examples`` that tests the aspects of the example that it demonstrates
- Reference the example in the rst file with an external reference code block, e.g.
.. code-block:: rst
:caption: An example of how to use literal includes of external files
.. literalinclude:: /examples/test_thing.py
:language: python
:caption: All includes should have a descriptive caption
Automatically execute examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Our docs include a Sphinx extension that can automatically run requests against example apps
and include their result in the documentation page when its being built. This only requires 2 steps:
1. Create an example file with an ``app`` object in it, which is an instance of ``Litestar``
2. Add a comment in the form of ``# run: /hello`` to the example file
When building the docs (or serving them locally), a process serving the ``app`` instance
will be launched, and the requests specified in the comments will be run against it. The
comments will be stripped from the result, and the output of the ``curl`` invocation inserted
after the example code-block.
The ``# run:`` syntax is nothing special; everything after the colon will be passed to
the ``curl`` command that's being invoked. The URL is built automatically, so the
specified path can just be a path relative to the app.
In practice, this looks like the following:
.. code-block:: python
:caption: An example of how to use the automatic example runner
:no-upgrade:
from typing import Dict
from litestar import Litestar, get
@get("/")
def hello_world() -> Dict[str, str]:
"""Handler function that returns a greeting dictionary."""
return {"hello": "world"}
app = Litestar(route_handlers=[hello_world])
# run: /
This is equivalent to:
.. code-block:: python
:caption: An example of how to use the automatic example runner
from typing import Dict
from litestar import Litestar, get
@get("/")
def hello_world() -> Dict[str, str]:
"""Handler function that returns a greeting dictionary."""
return {"hello": "world"}
app = Litestar(route_handlers=[hello_world])
.. admonition:: Run it
.. code-block:: bash
> curl http://127.0.0.1:8000/
{"hello": "world"}
Creating a New Release
----------------------
#. Checkout the ``main`` branch:
.. code-block:: shell
:caption: Checking out the main branch of the ``litestar`` repository
git checkout main
#. Run the release preparation script:
.. code-block:: shell
:caption: Preparing a new release
python tools/prepare_release.py <new version number> --update-version --create-draft-release
Replace ``<new version number>`` with the desired version number following the
`versioning scheme <https://litestar.dev/about/litestar-releases#version-numbering>`_.
This script will:
- Update the version in ``pyproject.toml``
- Generate a changelog entry in :doc:`/release-notes/changelog`
- Create a draft release on GitHub
#. Review the generated changelog entry in :doc:`/release-notes/changelog` to ensure it looks correct.
#. Commit the changes to ``main``:
.. code-block:: shell
:caption: Committing the changes to the main branch
git commit -am "chore(release): prepare release vX.Y.Z"
Replace ``vX.Y.Z`` with the actual version number.
#. Create a new branch for the release:
.. code-block:: shell
:caption: Creating a new branch for the release
git checkout -b vX.Y.Z
#. Push the changes to a ``vX.Y.Z`` branch:
.. code-block:: shell
:caption: Pushing the changes to the ``vX.Y.Z`` branch
git push origin vX.Y.Z
#. Open a pull request from the ``vX.Y.Z`` branch to ``main``.
#. Once the pull request is approved, go to the draft release on GitHub
(the release preparation script will provide a link).
#. Review the release notes in the draft release to ensure they look correct.
#. If everything looks good, click "Publish release" to make the release official.
#. Go to the `Release Action <https://github.com/litestar-org/litestar/actions/workflows/publish.yml>`_ and approve
the release workflow if necessary.
#. Check that the release workflow runs successfully.
.. note:: The version number should follow `semantic versioning <https://semver.org/>`_ and
`PEP 440 <https://peps.python.org/pep-0440/>`_.
litestar-2.18.0/LICENSE 0000664 0000000 0000000 00000002120 15070515525 0014436 0 ustar 00root root 0000000 0000000 The MIT License (MIT)
Copyright (c) 2021, 2022, 2023, 2024, 2025 Litestar Org.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
litestar-2.18.0/Makefile 0000664 0000000 0000000 00000012633 15070515525 0015103 0 ustar 00root root 0000000 0000000 SHELL := /bin/bash
# =============================================================================
# Variables
# =============================================================================
.DEFAULT_GOAL:=help
.ONESHELL:
ENV_PREFIX = .venv/bin/
VENV_EXISTS = $(shell python3 -c "if __import__('pathlib').Path('.venv/bin/activate').exists(): print('yes')")
.EXPORT_ALL_VARIABLES:
.PHONY: help
help: ## Display this help text for Makefile
@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n make \033[36m<target>\033[0m\n"} /^[a-zA-Z0-9_-]+:.*?##/ { printf " \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
.PHONY: upgrade
upgrade: ## Upgrade all dependencies to the latest stable versions
@echo "=> Updating all dependencies"
@uv lock --upgrade
@echo "=> Dependencies Updated"
@uv run pre-commit autoupdate
@echo "=> Updated Pre-commit"
# =============================================================================
# Developer Utils
# =============================================================================
.PHONY: install
install: ## Install dependencies
@uv sync
.PHONY: clean
clean: ## Cleanup temporary build artifacts
@echo "=> Cleaning working directory"
@rm -rf .pytest_cache .ruff_cache .hypothesis build/ -rf dist/ .eggs/
@find . -name '*.egg-info' -exec rm -rf {} +
@find . -type f -name '*.egg' -exec rm -f {} +
@find . -name '*.pyc' -exec rm -f {} +
@find . -name '*.pyo' -exec rm -f {} +
@find . -name '*~' -exec rm -f {} +
@find . -name '__pycache__' -exec rm -rf {} +
@find . -name '.ipynb_checkpoints' -exec rm -rf {} +
@rm -rf .coverage coverage.xml coverage.json htmlcov/ .pytest_cache tests/.pytest_cache tests/**/.pytest_cache .mypy_cache
$(MAKE) docs-clean
.PHONY: destroy
destroy: ## Destroy the virtual environment
@rm -rf .venv
.PHONY: lock
lock: ## Rebuild lockfiles from scratch, updating all dependencies
@uv lock
# =============================================================================
# Tests, Linting, Coverage
# =============================================================================
.PHONY: mypy
mypy: ## Run mypy
@echo "=> Running mypy"
@uv run dmypy run
@echo "=> mypy complete"
.PHONY: mypy-nocache
mypy-nocache: ## Run Mypy without cache
@echo "=> Running mypy without a cache"
@uv run dmypy run -- --cache-dir=/dev/null
@echo "=> mypy complete"
.PHONY: pyright
pyright: ## Run pyright
@echo "=> Running pyright"
@uv run pyright
@echo "=> pyright complete"
.PHONY: type-check
type-check: mypy pyright ## Run all type checking
.PHONY: pre-commit
pre-commit: ## Runs pre-commit hooks; includes ruff formatting and linting, codespell
@echo "=> Running pre-commit process"
@uv run pre-commit run --all-files
@echo "=> Pre-commit complete"
.PHONY: slots-check
slots-check: ## Check for slots usage in classes
@echo "=> Checking for slots usage in classes"
@uv run slotscheck litestar
@echo "=> Slots check complete"
.PHONY: lint
lint: pre-commit type-check slots-check ## Run all linting
.PHONY: coverage
coverage: ## Run the tests and generate coverage report
@echo "=> Running tests with coverage"
@uv run pytest tests --cov -n auto
@uv run coverage html
@uv run coverage xml
@echo "=> Coverage report generated"
.PHONY: test
test: ## Run the tests
@echo "=> Running test cases"
@uv run pytest tests
@echo "=> Tests complete"
.PHONY: test-examples
test-examples: ## Run the examples tests
@uv run pytest docs/examples
.PHONY: test-all
test-all: test test-examples ## Run all tests
.PHONY: check-all
check-all: lint test-all coverage ## Run all linting, tests, and coverage checks
# =============================================================================
# Docs
# =============================================================================
# XXX: docs commands are pinned to Python 3.12 due to picologging not being compatible with 3.13
.PHONY: docs-install
docs-install: ## Install docs dependencies
@echo "=> Installing documentation dependencies"
@uv sync --python 3.12 --group docs
@echo "=> Installed documentation dependencies"
docs-clean: ## Dump the existing built docs
@echo "=> Cleaning documentation build assets"
@rm -rf docs/_build
@echo "=> Removed existing documentation build assets"
docs-serve: docs-clean ## Serve the docs locally
@echo "=> Serving documentation"
uv run --python 3.12 sphinx-autobuild docs docs/_build/ -j auto --watch litestar --watch docs --watch tests --watch CONTRIBUTING.rst --open-browser --port=0
docs: docs-clean ## Dump the existing built docs and rebuild them
@echo "=> Building documentation"
@uv run --python 3.12 sphinx-build -M html docs docs/_build/ -E -a -j auto -W --keep-going
.PHONY: docs-linkcheck
docs-linkcheck: ## Run the link check on the docs
@uv run --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_ignore='http://.*','https://.*'
.PHONY: docs-linkcheck-full
docs-linkcheck-full: ## Run the full link check on the docs
@uv run --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_anchors=0
litestar-2.18.0/README.md 0000664 0000000 0000000 00000314764 15070515525 0014734 0 ustar 00root root 0000000 0000000 <!-- markdownlint-disable -->
<p align="center">
<!-- github-banner-start -->
<img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/Branding%20-%20SVG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Light.svg#gh-light-mode-only" alt="Litestar Logo - Light" width="100%" height="auto" />
<img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/Branding%20-%20SVG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Dark.svg#gh-dark-mode-only" alt="Litestar Logo - Dark" width="100%" height="auto" />
<!-- github-banner-end -->
</p>
<!-- markdownlint-restore -->
<div align="center">
<!-- prettier-ignore-start -->
| Project | | Status |
|-----------|:----|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| CI/CD | | [](https://github.com/litestar-org/litestar/actions/workflows/publish.yml) [](https://github.com/litestar-org/litestar/actions/workflows/ci.yml) [](https://github.com/litestar-org/litestar/actions/workflows/docs.yml) |
| Quality | | [](https://codecov.io/github/litestar-org/litestar) |
| Package | | [](https://badge.fury.io/py/litestar)    |
| Community | | [](https://reddit.com/r/litestarapi) [](https://discord.gg/litestar) [](https://matrix.to/#/#litestar:matrix.org) [](https://blog.litestar.dev) [](https://twitter.com/LitestarAPI) [](https://blog.litestar.dev) |
| Meta | | [](https://github.com/litestar-org/litestar) [](https://github.com/python/mypy) [](https://spdx.org/licenses/) [](https://github.com/sponsors/litestar-org) [](https://github.com/astral-sh/ruff) [](https://github.com/psf/black) [](#contributors-) |
<!-- prettier-ignore-end -->
</div>
<hr>
Litestar is a powerful, flexible yet opinionated ASGI framework, focused on
building APIs. It offers high-performance data validation, dependency injection,
first-class ORM integration, authorization primitives, a rich plugin API, middleware,
and much more that's needed to get applications up and running.
Check out the [documentation 📚](https://docs.litestar.dev/) for a detailed overview of
its features!
Additionally, the [Litestar fullstack repository](https://github.com/litestar-org/litestar-fullstack)
can give you a good impression how a fully fledged Litestar application may look.
<details>
<summary>Table of Contents</summary>
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Core Features](#core-features)
- [Example Applications](#example-applications)
- [Features](#features)
- [Class-based Controllers](#class-based-controllers)
- [Data Parsing, Type Hints, and Msgspec](#data-parsing-type-hints-and-msgspec)
- [Plugin System, ORM support, and DTOs](#plugin-system-orm-support-and-dtos)
- [OpenAPI](#openapi)
- [Dependency Injection](#dependency-injection)
- [Middleware](#middleware)
- [Route Guards](#route-guards)
- [Request Life Cycle Hooks](#request-life-cycle-hooks)
- [Performance](#performance)
- [Contributing](#contributing)
</details>
## Installation
```shell
pip install litestar
```
or to include the CLI and a server (uvicorn) for running your application:
```shell
pip install 'litestar[standard]'
```
## Quick Start
```python title="app.py"
from litestar import Litestar, get
@get("/")
async def hello_world() -> dict[str, str]:
"""Keeping the tradition alive with hello world."""
return {"hello": "world"}
app = Litestar(route_handlers=[hello_world])
```
And run it with
```bash
litestar run
```
## Core Features
- [Class based controllers](#class-based-controllers)
- [Dependency Injection](#dependency-injection)
- [Layered Middleware](#middleware)
- [Plugin System](#plugin-system-orm-support-and-dtos)
- [OpenAPI 3.1 schema generation](#openapi)
- [Life Cycle Hooks](#request-life-cycle-hooks)
- [Route Guards based Authorization](#route-guards)
- Support for `dataclasses`, `TypedDict`, [`msgspec`](https://jcristharif.com/msgspec/), [pydantic version 1 and version 2 (even within the same application)](https://docs.pydantic.dev/latest/) and [(c)attrs](https://catt.rs/en/stable/)
- Layered parameter declaration
- Support for [RFC 9457](https://datatracker.ietf.org/doc/html/rfc9457) standardized "Problem Detail" error responses
- [Automatic API documentation with](#redoc-swagger-ui-and-stoplight-elements-api-documentation):
- [Scalar](https://github.com/scalar/scalar/)
- [RapiDoc](https://github.com/rapi-doc/RapiDoc)
- [Redoc](https://github.com/Redocly/redoc)
- [Stoplight Elements](https://github.com/stoplightio/elements)
- [Swagger-UI](https://swagger.io/tools/swagger-ui/)
- [Trio](https://trio.readthedocs.io/en/stable/) support (built-in, via [AnyIO](https://anyio.readthedocs.io/))
- Ultra-fast validation, serialization and deserialization using [msgspec](https://github.com/jcrist/msgspec)
- [SQLAlchemy integration](https://docs.advanced-alchemy.litestar.dev/latest/)
## Example Applications
<details>
<summary>Pre-built Example Apps</summary>
- [litestar-hello-world](https://github.com/litestar-org/litestar-hello-world): A bare-minimum application setup. Great
for testing and POC work.
- [litestar-fullstack](https://github.com/litestar-org/litestar-fullstack): A reference application that contains most of the boilerplate required for a web application.
It features a Litestar app configured with best practices, SQLAlchemy 2.0 and SAQ, a frontend integrated with Vitejs and Jinja2 templates, Docker, and more. Like all
Litestar projects, this application is open to contributions, big and small.
</details>
## Sponsors
Litestar is an open-source project, and we enjoy the support of our sponsors to help fund the exciting
work we do.
A **huge** thanks to our sponsors:
[//]: # "Note to maintainers: Highest sponsors first; no more than 3 per row - create new div if needed"
<a href="https://github.com/scalar/scalar/?utm_source=litestar&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar.com - Document, Discover and Test APIs with Scalar."><img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/sponsors/scalar.svg" width="180" alt="Scalar.com"></a>
<a href="https://telemetrysports.com/" title="Telemetry Sports - Changing the way data influences the sports experience"><img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/sponsors/telemetry-sports/unofficial-telemetry-whitebg.svg" width="150" alt="Telemetry Sports"></a>
<a href="https://docs.litestar.dev/latest/#sponsors" class="external-link" target="_blank">Check out our sponsors in the docs</a>
If you would like to support the work that we do please consider [becoming a sponsor][sponsor-polar]
via [Polar.sh][sponsor-polar] (preferred), [GitHub][sponsor-github] or [Open Collective][sponsor-oc].
Also, exclusively with [Polar][sponsor-polar], you can engage in pledge-based sponsorships.
[sponsor-github]: https://github.com/sponsors/litestar-org
[sponsor-oc]: https://opencollective.com/litestar
[sponsor-polar]: https://polar.sh/litestar-org
## Features
### Class-based Controllers
While supporting function-based route handlers, Litestar also supports and promotes python OOP using class based
controllers:
<details>
<summary>Example for class-based controllers</summary>
```python title="my_app/controllers/user.py"
from typing import List, Optional
from datetime import datetime
from litestar import Controller, get, post, put, patch, delete
from litestar.dto import DTOData
from pydantic import UUID4
from my_app.models import User, PartialUserDTO
class UserController(Controller):
path = "/users"
@post()
async def create_user(self, data: User) -> User: ...
@get()
async def list_users(self) -> List[User]: ...
@get(path="/{date:int}")
async def list_new_users(self, date: datetime) -> List[User]: ...
@patch(path="/{user_id:uuid}", dto=PartialUserDTO)
async def partial_update_user(
self, user_id: UUID4, data: DTOData[PartialUserDTO]
) -> User: ...
@put(path="/{user_id:uuid}")
async def update_user(self, user_id: UUID4, data: User) -> User: ...
@get(path="/{user_name:str}")
async def get_user_by_name(self, user_name: str) -> Optional[User]: ...
@get(path="/{user_id:uuid}")
async def get_user(self, user_id: UUID4) -> User: ...
@delete(path="/{user_id:uuid}")
async def delete_user(self, user_id: UUID4) -> None: ...
```
</details>
### Data Parsing, Type Hints, and Msgspec
Litestar is rigorously typed, and it enforces typing. For example, if you forget to type a return value for a route
handler, an exception will be raised. The reason for this is that Litestar uses typing data to generate OpenAPI specs,
as well as to validate and parse data. Thus, typing is essential to the framework.
Furthermore, Litestar allows extending its support using plugins.
### Plugin System, ORM support, and DTOs
Litestar has a plugin system that allows the user to extend serialization/deserialization, OpenAPI generation, and other
features.
It ships with a builtin plugin for SQL Alchemy, which allows the user to use SQLAlchemy declarative classes "natively"
i.e., as type parameters that will be serialized/deserialized and to return them as values from route
handlers.
Litestar also supports the programmatic creation of DTOs with a `DTOFactory` class, which also supports the use of
plugins.
### OpenAPI
Litestar has custom logic to generate OpenAPI 3.1.0 schema, include optional generation of examples using the
[`polyfactory`](https://pypi.org/project/polyfactory/) library.
#### ReDoc, Swagger-UI and Stoplight Elements API Documentation
Litestar serves the documentation from the generated OpenAPI schema with:
- [ReDoc](https://redoc.ly/)
- [Swagger-UI](https://swagger.io/tools/swagger-ui/)
- [Stoplight Elements](https://github.com/stoplightio/elements)
- [RapiDoc](https://rapidocweb.com/)
All these are available and enabled by default.
### Dependency Injection
Litestar has a simple but powerful DI system inspired by pytest. You can define named dependencies - sync or async - at
different levels of the application, and then selective use or overwrite them.
<details>
<summary>Example for DI</summary>
```python
from litestar import Litestar, get
from litestar.di import Provide
async def my_dependency() -> str: ...
@get("/")
async def index(injected: str) -> str:
return injected
app = Litestar([index], dependencies={"injected": Provide(my_dependency)})
```
</details>
### Middleware
Litestar supports typical ASGI middleware and ships with middlewares to handle things such as
- CORS
- CSRF
- Rate limiting
- GZip and Brotli compression
- Client- and server-side sessions
### Route Guards
Litestar has an authorization mechanism called `guards`, which allows the user to define guard functions at different
level of the application (app, router, controller etc.) and validate the request before hitting the route handler
function.
<details>
<summary>Example for route guards</summary>
```python
from litestar import Litestar, get
from litestar.connection import ASGIConnection
from litestar.handlers.base import BaseRouteHandler
from litestar.exceptions import NotAuthorizedException
async def is_authorized(connection: ASGIConnection, handler: BaseRouteHandler) -> None:
# validate authorization
# if not authorized, raise NotAuthorizedException
raise NotAuthorizedException()
@get("/", guards=[is_authorized])
async def index() -> None: ...
app = Litestar([index])
```
</details>
### Request Life Cycle Hooks
Litestar supports request life cycle hooks, similarly to Flask - i.e. `before_request` and `after_request`
## Performance
Litestar is fast. It is on par with, or significantly faster than comparable ASGI frameworks.
You can see and run the benchmarks [here](https://github.com/litestar-org/api-performance-tests),
or read more about it [here](https://docs.litestar.dev/latest/benchmarks) in our documentation.
## Contributing
Litestar is open to contributions big and small. You can always [join our discord](https://discord.gg/litestar) server
or [join our Matrix](https://matrix.to/#/#litestar:matrix.org) space
to discuss contributions and project maintenance. For guidelines on how to contribute, please
see [the contribution guide](CONTRIBUTING.rst).
<!-- contributors-start -->
## Contributors ✨
<details>
<summary>Thanks goes to these wonderful people:</summary>
<a href="https://allcontributors.org/docs/en/emoji-key">Emoji Key </a>
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/nhirschfeld/"><img src="https://avatars.githubusercontent.com/u/30733348?v=4?s=100" width="100px;" alt="Na'aman Hirschfeld"/><br /><sub><b>Na'aman Hirschfeld</b></sub></a><br /><a href="#maintenance-Goldziher" title="Maintenance">🚧</a> <a href="https://github.com/litestar-org/litestar/commits?author=Goldziher" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=Goldziher" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=Goldziher" title="Tests">⚠️</a> <a href="#ideas-Goldziher" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-Goldziher" title="Examples">💡</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3AGoldziher" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/peterschutt"><img src="https://avatars.githubusercontent.com/u/20659309?v=4?s=100" width="100px;" alt="Peter Schutt"/><br /><sub><b>Peter Schutt</b></sub></a><br /><a href="#maintenance-peterschutt" title="Maintenance">🚧</a> <a href="https://github.com/litestar-org/litestar/commits?author=peterschutt" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=peterschutt" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=peterschutt" title="Tests">⚠️</a> <a href="#ideas-peterschutt" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-peterschutt" title="Examples">💡</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Apeterschutt" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://ashwinvin.github.io"><img src="https://avatars.githubusercontent.com/u/38067089?v=4?s=100" width="100px;" alt="Ashwin Vinod"/><br /><sub><b>Ashwin Vinod</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ashwinvin" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=ashwinvin" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://www.damiankress.de"><img src="https://avatars.githubusercontent.com/u/28515387?v=4?s=100" width="100px;" alt="Damian"/><br /><sub><b>Damian</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=dkress59" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://remotepixel.ca"><img src="https://avatars.githubusercontent.com/u/10407788?v=4?s=100" width="100px;" alt="Vincent Sarago"/><br /><sub><b>Vincent Sarago</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=vincentsarago" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://hotfix.guru"><img src="https://avatars.githubusercontent.com/u/5310116?v=4?s=100" width="100px;" alt="Jonas Krüger Svensson"/><br /><sub><b>Jonas Krüger Svensson</b></sub></a><br /><a href="#platform-JonasKs" title="Packaging/porting to new platform">📦</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sondrelg"><img src="https://avatars.githubusercontent.com/u/25310870?v=4?s=100" width="100px;" alt="Sondre Lillebø Gundersen"/><br /><sub><b>Sondre Lillebø Gundersen</b></sub></a><br /><a href="#platform-sondrelg" title="Packaging/porting to new platform">📦</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/vrslev"><img src="https://avatars.githubusercontent.com/u/75225148?v=4?s=100" width="100px;" alt="Lev"/><br /><sub><b>Lev</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=vrslev" title="Code">💻</a> <a href="#ideas-vrslev" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/timwedde"><img src="https://avatars.githubusercontent.com/u/20231751?v=4?s=100" width="100px;" alt="Tim Wedde"/><br /><sub><b>Tim Wedde</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=timwedde" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/tclasen"><img src="https://avatars.githubusercontent.com/u/11999013?v=4?s=100" width="100px;" alt="Tory Clasen"/><br /><sub><b>Tory Clasen</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=tclasen" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://t.me/Bobronium"><img src="https://avatars.githubusercontent.com/u/36469655?v=4?s=100" width="100px;" alt="Arseny Boykov"/><br /><sub><b>Arseny Boykov</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Bobronium" title="Code">💻</a> <a href="#ideas-Bobronium" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/yudjinn"><img src="https://avatars.githubusercontent.com/u/7493084?v=4?s=100" width="100px;" alt="Jacob Rodgers"/><br /><sub><b>Jacob Rodgers</b></sub></a><br /><a href="#example-yudjinn" title="Examples">💡</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/danesolberg"><img src="https://avatars.githubusercontent.com/u/25882507?v=4?s=100" width="100px;" alt="Dane Solberg"/><br /><sub><b>Dane Solberg</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=danesolberg" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/madlad33"><img src="https://avatars.githubusercontent.com/u/54079440?v=4?s=100" width="100px;" alt="madlad33"/><br /><sub><b>madlad33</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=madlad33" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="http://matthewtyleraylward.com"><img src="https://avatars.githubusercontent.com/u/19205392?v=4?s=100" width="100px;" alt="Matthew Aylward "/><br /><sub><b>Matthew Aylward </b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Butch78" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Joko013"><img src="https://avatars.githubusercontent.com/u/30841710?v=4?s=100" width="100px;" alt="Jan Klima"/><br /><sub><b>Jan Klima</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Joko013" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/i404788"><img src="https://avatars.githubusercontent.com/u/50617709?v=4?s=100" width="100px;" alt="C2D"/><br /><sub><b>C2D</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=i404788" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/to-ph"><img src="https://avatars.githubusercontent.com/u/84818322?v=4?s=100" width="100px;" alt="to-ph"/><br /><sub><b>to-ph</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=to-ph" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://imbev.gitlab.io/site"><img src="https://avatars.githubusercontent.com/u/105524473?v=4?s=100" width="100px;" alt="imbev"/><br /><sub><b>imbev</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=imbev" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://git.roboces.dev/catalin"><img src="https://avatars.githubusercontent.com/u/45485069?v=4?s=100" width="100px;" alt="cătălin"/><br /><sub><b>cătălin</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=185504a9" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Seon82"><img src="https://avatars.githubusercontent.com/u/46298009?v=4?s=100" width="100px;" alt="Seon82"/><br /><sub><b>Seon82</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Seon82" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/slavugan"><img src="https://avatars.githubusercontent.com/u/8457612?v=4?s=100" width="100px;" alt="Slava"/><br /><sub><b>Slava</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=slavugan" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Harry-Lees"><img src="https://avatars.githubusercontent.com/u/52263746?v=4?s=100" width="100px;" alt="Harry"/><br /><sub><b>Harry</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Harry-Lees" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=Harry-Lees" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/cofin"><img src="https://avatars.githubusercontent.com/u/204685?v=4?s=100" width="100px;" alt="Cody Fincher"/><br /><sub><b>Cody Fincher</b></sub></a><br /><a href="#maintenance-cofin" title="Maintenance">🚧</a> <a href="https://github.com/litestar-org/litestar/commits?author=cofin" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=cofin" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=cofin" title="Tests">⚠️</a> <a href="#ideas-cofin" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-cofin" title="Examples">💡</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Acofin" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.patreon.com/cclauss"><img src="https://avatars.githubusercontent.com/u/3709715?v=4?s=100" width="100px;" alt="Christian Clauss"/><br /><sub><b>Christian Clauss</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=cclauss" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/josepdaniel"><img src="https://avatars.githubusercontent.com/u/36941460?v=4?s=100" width="100px;" alt="josepdaniel"/><br /><sub><b>josepdaniel</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=josepdaniel" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/devtud"><img src="https://avatars.githubusercontent.com/u/6808024?v=4?s=100" width="100px;" alt="devtud"/><br /><sub><b>devtud</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Adevtud" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/nramos0"><img src="https://avatars.githubusercontent.com/u/35410160?v=4?s=100" width="100px;" alt="Nicholas Ramos"/><br /><sub><b>Nicholas Ramos</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=nramos0" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://twitter.com/seladb"><img src="https://avatars.githubusercontent.com/u/9059541?v=4?s=100" width="100px;" alt="seladb"/><br /><sub><b>seladb</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=seladb" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=seladb" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/aedify-swi"><img src="https://avatars.githubusercontent.com/u/66629131?v=4?s=100" width="100px;" alt="Simon Wienhöfer"/><br /><sub><b>Simon Wienhöfer</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=aedify-swi" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/mobiusxs"><img src="https://avatars.githubusercontent.com/u/57055149?v=4?s=100" width="100px;" alt="MobiusXS"/><br /><sub><b>MobiusXS</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mobiusxs" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://aidansimard.dev"><img src="https://avatars.githubusercontent.com/u/73361895?v=4?s=100" width="100px;" alt="Aidan Simard"/><br /><sub><b>Aidan Simard</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Aidan-Simard" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/waweber"><img src="https://avatars.githubusercontent.com/u/714224?v=4?s=100" width="100px;" alt="wweber"/><br /><sub><b>wweber</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=waweber" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://scolvin.com"><img src="https://avatars.githubusercontent.com/u/4039449?v=4?s=100" width="100px;" alt="Samuel Colvin"/><br /><sub><b>Samuel Colvin</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=samuelcolvin" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/toudi"><img src="https://avatars.githubusercontent.com/u/81148?v=4?s=100" width="100px;" alt="Mateusz Mikołajczyk"/><br /><sub><b>Mateusz Mikołajczyk</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=toudi" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Alex-CodeLab"><img src="https://avatars.githubusercontent.com/u/1678423?v=4?s=100" width="100px;" alt="Alex "/><br /><sub><b>Alex </b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Alex-CodeLab" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/odiseo0"><img src="https://avatars.githubusercontent.com/u/87550035?v=4?s=100" width="100px;" alt="Odiseo"/><br /><sub><b>Odiseo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=odiseo0" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ingjavierpinilla"><img src="https://avatars.githubusercontent.com/u/36714646?v=4?s=100" width="100px;" alt="Javier Pinilla"/><br /><sub><b>Javier Pinilla</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ingjavierpinilla" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Chaoyingz"><img src="https://avatars.githubusercontent.com/u/32626585?v=4?s=100" width="100px;" alt="Chaoying"/><br /><sub><b>Chaoying</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Chaoyingz" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/infohash"><img src="https://avatars.githubusercontent.com/u/46137868?v=4?s=100" width="100px;" alt="infohash"/><br /><sub><b>infohash</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=infohash" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/john-ingles/"><img src="https://avatars.githubusercontent.com/u/35442886?v=4?s=100" width="100px;" alt="John Ingles"/><br /><sub><b>John Ingles</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=john-ingles" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/h0rn3t"><img src="https://avatars.githubusercontent.com/u/1213719?v=4?s=100" width="100px;" alt="Eugene"/><br /><sub><b>Eugene</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=h0rn3t" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=h0rn3t" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jonadaly"><img src="https://avatars.githubusercontent.com/u/26462826?v=4?s=100" width="100px;" alt="Jon Daly"/><br /><sub><b>Jon Daly</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jonadaly" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=jonadaly" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://harshallaheri.me/"><img src="https://avatars.githubusercontent.com/u/73422191?v=4?s=100" width="100px;" alt="Harshal Laheri"/><br /><sub><b>Harshal Laheri</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Harshal6927" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=Harshal6927" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sorasful"><img src="https://avatars.githubusercontent.com/u/32820423?v=4?s=100" width="100px;" alt="Téva KRIEF"/><br /><sub><b>Téva KRIEF</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sorasful" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jtraub"><img src="https://avatars.githubusercontent.com/u/153191?v=4?s=100" width="100px;" alt="Konstantin Mikhailov"/><br /><sub><b>Konstantin Mikhailov</b></sub></a><br /><a href="#maintenance-jtraub" title="Maintenance">🚧</a> <a href="https://github.com/litestar-org/litestar/commits?author=jtraub" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=jtraub" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=jtraub" title="Tests">⚠️</a> <a href="#ideas-jtraub" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-jtraub" title="Examples">💡</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Ajtraub" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://linkedin.com/in/mitchell-henry334/"><img src="https://avatars.githubusercontent.com/u/17354727?v=4?s=100" width="100px;" alt="Mitchell Henry"/><br /><sub><b>Mitchell Henry</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=devmitch" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/chbndrhnns"><img src="https://avatars.githubusercontent.com/u/7534547?v=4?s=100" width="100px;" alt="chbndrhnns"/><br /><sub><b>chbndrhnns</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=chbndrhnns" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/nielsvanhooy"><img src="https://avatars.githubusercontent.com/u/40770348?v=4?s=100" width="100px;" alt="nielsvanhooy"/><br /><sub><b>nielsvanhooy</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=nielsvanhooy" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Anielsvanhooy" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=nielsvanhooy" title="Tests">⚠️</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/provinzkraut"><img src="https://avatars.githubusercontent.com/u/25355197?v=4?s=100" width="100px;" alt="provinzkraut"/><br /><sub><b>provinzkraut</b></sub></a><br /><a href="#maintenance-provinzkraut" title="Maintenance">🚧</a> <a href="https://github.com/litestar-org/litestar/commits?author=provinzkraut" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=provinzkraut" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=provinzkraut" title="Tests">⚠️</a> <a href="#ideas-provinzkraut" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-provinzkraut" title="Examples">💡</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Aprovinzkraut" title="Bug reports">🐛</a> <a href="#design-provinzkraut" title="Design">🎨</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jab"><img src="https://avatars.githubusercontent.com/u/64992?v=4?s=100" width="100px;" alt="Joshua Bronson"/><br /><sub><b>Joshua Bronson</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jab" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://linkedin.com/in/roman-reznikov"><img src="https://avatars.githubusercontent.com/u/44291988?v=4?s=100" width="100px;" alt="Roman Reznikov"/><br /><sub><b>Roman Reznikov</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ReznikovRoman" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://mookrs.com"><img src="https://avatars.githubusercontent.com/u/985439?v=4?s=100" width="100px;" alt="mookrs"/><br /><sub><b>mookrs</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mookrs" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://mike.depalatis.net"><img src="https://avatars.githubusercontent.com/u/2805515?v=4?s=100" width="100px;" alt="Mike DePalatis"/><br /><sub><b>Mike DePalatis</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mivade" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/pemocarlo"><img src="https://avatars.githubusercontent.com/u/7297323?v=4?s=100" width="100px;" alt="Carlos Alberto Pérez-Molano"/><br /><sub><b>Carlos Alberto Pérez-Molano</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=pemocarlo" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.bestcryptocodes.com"><img src="https://avatars.githubusercontent.com/u/114229148?v=4?s=100" width="100px;" alt="ThinksFast"/><br /><sub><b>ThinksFast</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ThinksFast" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=ThinksFast" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ottermata"><img src="https://avatars.githubusercontent.com/u/9451844?v=4?s=100" width="100px;" alt="Christopher Krause"/><br /><sub><b>Christopher Krause</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ottermata" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://www.kylesmith.me"><img src="https://avatars.githubusercontent.com/u/1161424?v=4?s=100" width="100px;" alt="Kyle Smith"/><br /><sub><b>Kyle Smith</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=smithk86" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=smithk86" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Asmithk86" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/scott2b"><img src="https://avatars.githubusercontent.com/u/307713?v=4?s=100" width="100px;" alt="Scott Bradley"/><br /><sub><b>Scott Bradley</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Ascott2b" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/srikanthccv/"><img src="https://avatars.githubusercontent.com/u/22846633?v=4?s=100" width="100px;" alt="Srikanth Chekuri"/><br /><sub><b>Srikanth Chekuri</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=srikanthccv" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=srikanthccv" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://lonelyviking.com"><img src="https://avatars.githubusercontent.com/u/78952809?v=4?s=100" width="100px;" alt="Michael Bosch"/><br /><sub><b>Michael Bosch</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=LonelyVikingMichael" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sssssss340"><img src="https://avatars.githubusercontent.com/u/8406195?v=4?s=100" width="100px;" alt="sssssss340"/><br /><sub><b>sssssss340</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Asssssss340" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ste-pool"><img src="https://avatars.githubusercontent.com/u/17198460?v=4?s=100" width="100px;" alt="ste-pool"/><br /><sub><b>ste-pool</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ste-pool" title="Code">💻</a> <a href="#infra-ste-pool" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Alc-Alc"><img src="https://avatars.githubusercontent.com/u/45509143?v=4?s=100" width="100px;" alt="Alc-Alc"/><br /><sub><b>Alc-Alc</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Alc-Alc" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=Alc-Alc" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=Alc-Alc" title="Tests">⚠️</a> <a href="#infra-Alc-Alc" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://asomethings.com"><img src="https://avatars.githubusercontent.com/u/16171942?v=4?s=100" width="100px;" alt="asomethings"/><br /><sub><b>asomethings</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=asomethings" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/garburator"><img src="https://avatars.githubusercontent.com/u/14207857?v=4?s=100" width="100px;" alt="Garry Bullock"/><br /><sub><b>Garry Bullock</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=garburator" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/NiclasHaderer"><img src="https://avatars.githubusercontent.com/u/109728711?v=4?s=100" width="100px;" alt="Niclas Haderer"/><br /><sub><b>Niclas Haderer</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=NiclasHaderer" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/dialvarezs"><img src="https://avatars.githubusercontent.com/u/13831919?v=4?s=100" width="100px;" alt="Diego Alvarez"/><br /><sub><b>Diego Alvarez</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=dialvarezs" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=dialvarezs" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=dialvarezs" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.rgare.com"><img src="https://avatars.githubusercontent.com/u/51208317?v=4?s=100" width="100px;" alt="Jason Nance"/><br /><sub><b>Jason Nance</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=rgajason" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/spikenn"><img src="https://avatars.githubusercontent.com/u/32995595?v=4?s=100" width="100px;" alt="Igor Kapadze"/><br /><sub><b>Igor Kapadze</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=spikenn" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://jarmos.vercel.app"><img src="https://avatars.githubusercontent.com/u/31373860?v=4?s=100" width="100px;" alt="Somraj Saha"/><br /><sub><b>Somraj Saha</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Jarmos-san" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://skulason.me"><img src="https://avatars.githubusercontent.com/u/11139514?v=4?s=100" width="100px;" alt="Magnús Ágúst Skúlason"/><br /><sub><b>Magnús Ágúst Skúlason</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=maggias" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=maggias" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://alessioparma.xyz/"><img src="https://avatars.githubusercontent.com/u/4697032?v=4?s=100" width="100px;" alt="Alessio Parma"/><br /><sub><b>Alessio Parma</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=pomma89" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Lugoues"><img src="https://avatars.githubusercontent.com/u/372610?v=4?s=100" width="100px;" alt="Peter Brunner"/><br /><sub><b>Peter Brunner</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Lugoues" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://scriptr.dev/"><img src="https://avatars.githubusercontent.com/u/45884264?v=4?s=100" width="100px;" alt="Jacob Coffee"/><br /><sub><b>Jacob Coffee</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=JacobCoffee" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=JacobCoffee" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=JacobCoffee" title="Tests">⚠️</a> <a href="#infra-JacobCoffee" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#ideas-JacobCoffee" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-JacobCoffee" title="Maintenance">🚧</a> <a href="#business-JacobCoffee" title="Business development">💼</a> <a href="#design-JacobCoffee" title="Design">🎨</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Gamazic"><img src="https://avatars.githubusercontent.com/u/33692402?v=4?s=100" width="100px;" alt="Gamazic"/><br /><sub><b>Gamazic</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Gamazic" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/kareemmahlees"><img src="https://avatars.githubusercontent.com/u/89863279?v=4?s=100" width="100px;" alt="Kareem Mahlees"/><br /><sub><b>Kareem Mahlees</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=kareemmahlees" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/abdulhaq-e"><img src="https://avatars.githubusercontent.com/u/2532125?v=4?s=100" width="100px;" alt="Abdulhaq Emhemmed"/><br /><sub><b>Abdulhaq Emhemmed</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=abdulhaq-e" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=abdulhaq-e" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jenish2014"><img src="https://avatars.githubusercontent.com/u/9599888?v=4?s=100" width="100px;" alt="Jenish"/><br /><sub><b>Jenish</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jenish2014" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=jenish2014" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/chris-telemetry"><img src="https://avatars.githubusercontent.com/u/78052999?v=4?s=100" width="100px;" alt="chris-telemetry"/><br /><sub><b>chris-telemetry</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=chris-telemetry" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://wardpearce.com"><img src="https://avatars.githubusercontent.com/u/27844174?v=4?s=100" width="100px;" alt="Ward"/><br /><sub><b>Ward</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3AWardPearce" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://knowsuchagency.com"><img src="https://avatars.githubusercontent.com/u/11974795?v=4?s=100" width="100px;" alt="Stephan Fitzpatrick"/><br /><sub><b>Stephan Fitzpatrick</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Aknowsuchagency" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://codepen.io/ekeric13/"><img src="https://avatars.githubusercontent.com/u/6489651?v=4?s=100" width="100px;" alt="Eric Kennedy"/><br /><sub><b>Eric Kennedy</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ekeric13" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/wassafshahzad"><img src="https://avatars.githubusercontent.com/u/25094157?v=4?s=100" width="100px;" alt="wassaf shahzad"/><br /><sub><b>wassaf shahzad</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=wassafshahzad" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="http://nilsso.github.io"><img src="https://avatars.githubusercontent.com/u/567181?v=4?s=100" width="100px;" alt="Nils Olsson"/><br /><sub><b>Nils Olsson</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=nilsso" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Anilsso" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://rileychase.net"><img src="https://avatars.githubusercontent.com/u/1491530?v=4?s=100" width="100px;" alt="Riley Chase"/><br /><sub><b>Riley Chase</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Nadock" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://gh.arielle.codes"><img src="https://avatars.githubusercontent.com/u/71233171?v=4?s=100" width="100px;" alt="arl"/><br /><sub><b>arl</b></sub></a><br /><a href="#maintenance-onerandomusername" title="Maintenance">🚧</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Galdanwing"><img src="https://avatars.githubusercontent.com/u/29492757?v=4?s=100" width="100px;" alt="Antoine van der Horst"/><br /><sub><b>Antoine van der Horst</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Galdanwing" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://nick.groenen.me"><img src="https://avatars.githubusercontent.com/u/145285?v=4?s=100" width="100px;" alt="Nick Groenen"/><br /><sub><b>Nick Groenen</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=zoni" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/giorgiovilardo"><img src="https://avatars.githubusercontent.com/u/56472600?v=4?s=100" width="100px;" alt="Giorgio Vilardo"/><br /><sub><b>Giorgio Vilardo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=giorgiovilardo" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/bollwyvl"><img src="https://avatars.githubusercontent.com/u/45380?v=4?s=100" width="100px;" alt="Nicholas Bollweg"/><br /><sub><b>Nicholas Bollweg</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=bollwyvl" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/tompin82"><img src="https://avatars.githubusercontent.com/u/47041409?v=4?s=100" width="100px;" alt="Tomas Jonsson"/><br /><sub><b>Tomas Jonsson</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=tompin82" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=tompin82" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/khiem-doan/"><img src="https://avatars.githubusercontent.com/u/15646249?v=4?s=100" width="100px;" alt="Khiem Doan"/><br /><sub><b>Khiem Doan</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=khiemdoan" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/kedod"><img src="https://avatars.githubusercontent.com/u/35638715?v=4?s=100" width="100px;" alt="kedod"/><br /><sub><b>kedod</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=kedod" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=kedod" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=kedod" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sonpro1296"><img src="https://avatars.githubusercontent.com/u/17319142?v=4?s=100" width="100px;" alt="sonpro1296"/><br /><sub><b>sonpro1296</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sonpro1296" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=sonpro1296" title="Tests">⚠️</a> <a href="#infra-sonpro1296" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/litestar-org/litestar/commits?author=sonpro1296" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://patrickarmengol.com"><img src="https://avatars.githubusercontent.com/u/42473149?v=4?s=100" width="100px;" alt="Patrick Armengol"/><br /><sub><b>Patrick Armengol</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=patrickarmengol" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://sanderwegter.nl"><img src="https://avatars.githubusercontent.com/u/7465799?v=4?s=100" width="100px;" alt="Sander"/><br /><sub><b>Sander</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=SanderWegter" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/erhuabushuo"><img src="https://avatars.githubusercontent.com/u/1642364?v=4?s=100" width="100px;" alt="疯人院主任"/><br /><sub><b>疯人院主任</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=erhuabushuo" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/aviral-nayya"><img src="https://avatars.githubusercontent.com/u/121891493?v=4?s=100" width="100px;" alt="aviral-nayya"/><br /><sub><b>aviral-nayya</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=aviral-nayya" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/whiskeyriver"><img src="https://avatars.githubusercontent.com/u/162092?v=4?s=100" width="100px;" alt="whiskeyriver"/><br /><sub><b>whiskeyriver</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=whiskeyriver" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://hexcode.tech"><img src="https://avatars.githubusercontent.com/u/419606?v=4?s=100" width="100px;" alt="Phyo Arkar Lwin"/><br /><sub><b>Phyo Arkar Lwin</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=v3ss0n" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/MatthewNewland"><img src="https://avatars.githubusercontent.com/u/9618670?v=4?s=100" width="100px;" alt="MatthewNewland"/><br /><sub><b>MatthewNewland</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3AMatthewNewland" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=MatthewNewland" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=MatthewNewland" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/vtarchon"><img src="https://avatars.githubusercontent.com/u/1598170?v=4?s=100" width="100px;" alt="Tom Kuo"/><br /><sub><b>Tom Kuo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Avtarchon" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/LeckerenSirupwaffeln"><img src="https://avatars.githubusercontent.com/u/83568015?v=4?s=100" width="100px;" alt="LeckerenSirupwaffeln"/><br /><sub><b>LeckerenSirupwaffeln</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3ALeckerenSirupwaffeln" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/eldano1995"><img src="https://avatars.githubusercontent.com/u/24553679?v=4?s=100" width="100px;" alt="Daniel González Fernández"/><br /><sub><b>Daniel González Fernández</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=eldano1995" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/01EK98"><img src="https://avatars.githubusercontent.com/u/101988390?v=4?s=100" width="100px;" alt="01EK98"/><br /><sub><b>01EK98</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=01EK98" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sarbor"><img src="https://avatars.githubusercontent.com/u/15257226?v=4?s=100" width="100px;" alt="Sarbo Roy"/><br /><sub><b>Sarbo Roy</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sarbor" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/rseeley"><img src="https://avatars.githubusercontent.com/u/5397221?v=4?s=100" width="100px;" alt="Ryan Seeley"/><br /><sub><b>Ryan Seeley</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=rseeley" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ctrl-Felix"><img src="https://avatars.githubusercontent.com/u/62290842?v=4?s=100" width="100px;" alt="Felix"/><br /><sub><b>Felix</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ctrl-Felix" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Actrl-Felix" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/gsakkis"><img src="https://avatars.githubusercontent.com/u/291289?v=4?s=100" width="100px;" alt="George Sakkis"/><br /><sub><b>George Sakkis</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=gsakkis" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/floxay"><img src="https://avatars.githubusercontent.com/u/57007485?v=4?s=100" width="100px;" alt="Huba Tuba"/><br /><sub><b>Huba Tuba</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=floxay" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=floxay" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=floxay" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://fermigier.com/"><img src="https://avatars.githubusercontent.com/u/271079?v=4?s=100" width="100px;" alt="Stefane Fermigier"/><br /><sub><b>Stefane Fermigier</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sfermigier" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/r4gesingh47"><img src="https://avatars.githubusercontent.com/u/71139938?v=4?s=100" width="100px;" alt="r4ge"/><br /><sub><b>r4ge</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=r4gesingh47" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=r4gesingh47" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jaykv"><img src="https://avatars.githubusercontent.com/u/18240054?v=4?s=100" width="100px;" alt="Jay"/><br /><sub><b>Jay</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jaykv" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sinisaos"><img src="https://avatars.githubusercontent.com/u/30960668?v=4?s=100" width="100px;" alt="sinisaos"/><br /><sub><b>sinisaos</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sinisaos" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Tsdevendra1"><img src="https://avatars.githubusercontent.com/u/38055748?v=4?s=100" width="100px;" alt="Tharuka Devendra"/><br /><sub><b>Tharuka Devendra</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Tsdevendra1" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/euri10"><img src="https://avatars.githubusercontent.com/u/1104190?v=4?s=100" width="100px;" alt="euri10"/><br /><sub><b>euri10</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=euri10" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=euri10" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Aeuri10" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/su-shubham"><img src="https://avatars.githubusercontent.com/u/75021117?v=4?s=100" width="100px;" alt="Shubham"/><br /><sub><b>Shubham</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=su-shubham" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/erik-hasse"><img src="https://avatars.githubusercontent.com/u/37126755?v=4?s=100" width="100px;" alt="Erik Hasse"/><br /><sub><b>Erik Hasse</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Aerik-hasse" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=erik-hasse" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://sobolevn.me"><img src="https://avatars.githubusercontent.com/u/4660275?v=4?s=100" width="100px;" alt="Nikita Sobolev"/><br /><sub><b>Nikita Sobolev</b></sub></a><br /><a href="#infra-sobolevn" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/litestar-org/litestar/commits?author=sobolevn" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/lazyc97"><img src="https://avatars.githubusercontent.com/u/8538104?v=4?s=100" width="100px;" alt="Nguyễn Hoàng Đức"/><br /><sub><b>Nguyễn Hoàng Đức</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Alazyc97" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/RavanaBhrama"><img src="https://avatars.githubusercontent.com/u/131459969?v=4?s=100" width="100px;" alt="RavanaBhrama"/><br /><sub><b>RavanaBhrama</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=RavanaBhrama" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/mj0nez"><img src="https://avatars.githubusercontent.com/u/20128340?v=4?s=100" width="100px;" alt="Marcel Johannesmann"/><br /><sub><b>Marcel Johannesmann</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mj0nez" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://zanfar.com/"><img src="https://avatars.githubusercontent.com/u/10294685?v=4?s=100" width="100px;" alt="Matthew"/><br /><sub><b>Matthew</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=therealzanfar" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Mattwmaster58"><img src="https://avatars.githubusercontent.com/u/26337069?v=4?s=100" width="100px;" alt="Mattwmaster58"/><br /><sub><b>Mattwmaster58</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3AMattwmaster58" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=Mattwmaster58" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=Mattwmaster58" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://es.linkedin.com/in/manusp"><img src="https://avatars.githubusercontent.com/u/5411704?v=4?s=100" width="100px;" alt="Manuel Sanchez Pinar"/><br /><sub><b>Manuel Sanchez Pinar</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=aorith" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/juan-riveros"><img src="https://avatars.githubusercontent.com/u/1297567?v=4?s=100" width="100px;" alt="Juan Riveros"/><br /><sub><b>Juan Riveros</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=juan-riveros" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/davidbrochart"><img src="https://avatars.githubusercontent.com/u/4711805?v=4?s=100" width="100px;" alt="David Brochart"/><br /><sub><b>David Brochart</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=davidbrochart" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sean-donoghue"><img src="https://avatars.githubusercontent.com/u/64597271?v=4?s=100" width="100px;" alt="Sean Donoghue"/><br /><sub><b>Sean Donoghue</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sean-donoghue" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://sykloid.org/"><img src="https://avatars.githubusercontent.com/u/22753?v=4?s=100" width="100px;" alt="P.C. Shyamshankar"/><br /><sub><b>P.C. Shyamshankar</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Asykloid" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=sykloid" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=sykloid" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/wevonosky"><img src="https://avatars.githubusercontent.com/u/19598171?v=4?s=100" width="100px;" alt="William Evonosky"/><br /><sub><b>William Evonosky</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=wevonosky" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/geeshta"><img src="https://avatars.githubusercontent.com/u/61031243?v=4?s=100" width="100px;" alt="geeshta"/><br /><sub><b>geeshta</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=geeshta" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=geeshta" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Ageeshta" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://fosstodon.org/@robertrosca"><img src="https://avatars.githubusercontent.com/u/32569096?v=4?s=100" width="100px;" alt="Robert Rosca"/><br /><sub><b>Robert Rosca</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=RobertRosca" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/syshenyu"><img src="https://avatars.githubusercontent.com/u/92897003?v=4?s=100" width="100px;" alt="DICE_Lab"/><br /><sub><b>DICE_Lab</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=syshenyu" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/lsanpablo"><img src="https://avatars.githubusercontent.com/u/7145688?v=4?s=100" width="100px;" alt="Luis San Pablo"/><br /><sub><b>Luis San Pablo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=lsanpablo" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=lsanpablo" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=lsanpablo" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Lancetnik"><img src="https://avatars.githubusercontent.com/u/44573917?v=4?s=100" width="100px;" alt="Pastukhov Nikita"/><br /><sub><b>Pastukhov Nikita</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Lancetnik" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://jamesoclaire.com"><img src="https://avatars.githubusercontent.com/u/7601451?v=4?s=100" width="100px;" alt="James O'Claire"/><br /><sub><b>James O'Claire</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ddxv" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/pbaletkeman"><img src="https://avatars.githubusercontent.com/u/22402240?v=4?s=100" width="100px;" alt="Pete"/><br /><sub><b>Pete</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=pbaletkeman" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://www.hera.cc"><img src="https://avatars.githubusercontent.com/u/534840?v=4?s=100" width="100px;" alt="Alexandre Richonnier"/><br /><sub><b>Alexandre Richonnier</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=heralight" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=heralight" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/betaboon"><img src="https://avatars.githubusercontent.com/u/7346933?v=4?s=100" width="100px;" alt="betaboon"/><br /><sub><b>betaboon</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=betaboon" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/brakhane"><img src="https://avatars.githubusercontent.com/u/541637?v=4?s=100" width="100px;" alt="Dennis Brakhane"/><br /><sub><b>Dennis Brakhane</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=brakhane" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/issues?q=author%3Abrakhane" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://mind.wiki"><img src="https://avatars.githubusercontent.com/u/7423639?v=4?s=100" width="100px;" alt="Pragy Agarwal"/><br /><sub><b>Pragy Agarwal</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=AgarwalPragy" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/dybi"><img src="https://avatars.githubusercontent.com/u/36961162?v=4?s=100" width="100px;" alt="Piotr Dybowski"/><br /><sub><b>Piotr Dybowski</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=dybi" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/myslak71"><img src="https://avatars.githubusercontent.com/u/43068450?v=4?s=100" width="100px;" alt="Konrad Szczurek"/><br /><sub><b>Konrad Szczurek</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=myslak71" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=myslak71" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/orgarten"><img src="https://avatars.githubusercontent.com/u/10799869?v=4?s=100" width="100px;" alt="Orell Garten"/><br /><sub><b>Orell Garten</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=orgarten" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=orgarten" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=orgarten" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Kumzy"><img src="https://avatars.githubusercontent.com/u/5995441?v=4?s=100" width="100px;" alt="Julien"/><br /><sub><b>Julien</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Kumzy" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/leejayhsu"><img src="https://avatars.githubusercontent.com/u/37034741?v=4?s=100" width="100px;" alt="Leejay Hsu"/><br /><sub><b>Leejay Hsu</b></sub></a><br /><a href="#maintenance-leejayhsu" title="Maintenance">🚧</a> <a href="#infra-leejayhsu" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/litestar-org/litestar/commits?author=leejayhsu" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://x14.nl"><img src="https://avatars.githubusercontent.com/u/659504?v=4?s=100" width="100px;" alt="Michiel W. Beijen"/><br /><sub><b>Michiel W. Beijen</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mbeijen" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/baoliay2008"><img src="https://avatars.githubusercontent.com/u/13620348?v=4?s=100" width="100px;" alt="L. Bao"/><br /><sub><b>L. Bao</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=baoliay2008" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://jarredglaser.com"><img src="https://avatars.githubusercontent.com/u/32422167?v=4?s=100" width="100px;" alt="Jarred Glaser"/><br /><sub><b>Jarred Glaser</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jdglaser" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/hunterjsb"><img src="https://avatars.githubusercontent.com/u/69213737?v=4?s=100" width="100px;" alt="Hunter Boyd"/><br /><sub><b>Hunter Boyd</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=hunterjsb" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/cesarmg1980"><img src="https://avatars.githubusercontent.com/u/38872121?v=4?s=100" width="100px;" alt="Cesar Giulietti"/><br /><sub><b>Cesar Giulietti</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=cesarmg1980" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://gitlab.com/marcuslimdw/"><img src="https://avatars.githubusercontent.com/u/42759889?v=4?s=100" width="100px;" alt="Marcus Lim"/><br /><sub><b>Marcus Lim</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=marcuslimdw" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/hzhou0"><img src="https://avatars.githubusercontent.com/u/43188301?v=4?s=100" width="100px;" alt="Henry Zhou"/><br /><sub><b>Henry Zhou</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Ahzhou0" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=hzhou0" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/WilliamStam"><img src="https://avatars.githubusercontent.com/u/182800?v=4?s=100" width="100px;" alt="William Stam"/><br /><sub><b>William Stam</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=WilliamStam" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/andrewdoh"><img src="https://avatars.githubusercontent.com/u/7662358?v=4?s=100" width="100px;" alt="andrew do"/><br /><sub><b>andrew do</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=andrewdoh" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=andrewdoh" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=andrewdoh" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/cbscsm"><img src="https://avatars.githubusercontent.com/u/31615733?v=4?s=100" width="100px;" alt="Boseong Choi"/><br /><sub><b>Boseong Choi</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=cbscsm" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=cbscsm" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/wer153"><img src="https://avatars.githubusercontent.com/u/23370765?v=4?s=100" width="100px;" alt="Kim Minki"/><br /><sub><b>Kim Minki</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=wer153" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=wer153" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://velog.io/@azzurri21"><img src="https://avatars.githubusercontent.com/u/86508420?v=4?s=100" width="100px;" alt="Jeongseop Lim"/><br /><sub><b>Jeongseop Lim</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jseop-lim" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/FergusMok"><img src="https://avatars.githubusercontent.com/u/10182564?v=4?s=100" width="100px;" alt="FergusMok"/><br /><sub><b>FergusMok</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=FergusMok" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=FergusMok" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=FergusMok" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/manusinghal19"><img src="https://avatars.githubusercontent.com/u/8455587?v=4?s=100" width="100px;" alt="Manu Singhal"/><br /><sub><b>Manu Singhal</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=manusinghal19" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://cv.ycwu.space"><img src="https://avatars.githubusercontent.com/u/67060418?v=4?s=100" width="100px;" alt="Jerry Wu"/><br /><sub><b>Jerry Wu</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jrycw" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/horo-fox"><img src="https://avatars.githubusercontent.com/u/143025439?v=4?s=100" width="100px;" alt="horo"/><br /><sub><b>horo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Ahoro-fox" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/rosstitmarsh"><img src="https://avatars.githubusercontent.com/u/23349806?v=4?s=100" width="100px;" alt="Ross Titmarsh"/><br /><sub><b>Ross Titmarsh</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=rosstitmarsh" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/korneevm"><img src="https://avatars.githubusercontent.com/u/743250?v=4?s=100" width="100px;" alt="Mike Korneev"/><br /><sub><b>Mike Korneev</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=korneevm" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/patrickneise"><img src="https://avatars.githubusercontent.com/u/6312074?v=4?s=100" width="100px;" alt="Patrick Neise"/><br /><sub><b>Patrick Neise</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=patrickneise" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/JeanArhancet"><img src="https://avatars.githubusercontent.com/u/10811879?v=4?s=100" width="100px;" alt="Jean Arhancet"/><br /><sub><b>Jean Arhancet</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3AJeanArhancet" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://dnquark.com"><img src="https://avatars.githubusercontent.com/u/338250?v=4?s=100" width="100px;" alt="Leo Alekseyev"/><br /><sub><b>Leo Alekseyev</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=betaprior" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/aranvir"><img src="https://avatars.githubusercontent.com/u/75439739?v=4?s=100" width="100px;" alt="aranvir"/><br /><sub><b>aranvir</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=aranvir" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=aranvir" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=aranvir" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/bunny-therapist"><img src="https://avatars.githubusercontent.com/u/87039365?v=4?s=100" width="100px;" alt="bunny-therapist"/><br /><sub><b>bunny-therapist</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=bunny-therapist" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://www.benluo.cc"><img src="https://avatars.githubusercontent.com/u/70398?v=4?s=100" width="100px;" alt="Ben Luo"/><br /><sub><b>Ben Luo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=benluo" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/hugovk"><img src="https://avatars.githubusercontent.com/u/1324225?v=4?s=100" width="100px;" alt="Hugo van Kemenade"/><br /><sub><b>Hugo van Kemenade</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=hugovk" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://error418.github.io"><img src="https://avatars.githubusercontent.com/u/7716544?v=4?s=100" width="100px;" alt="Michael Gerbig"/><br /><sub><b>Michael Gerbig</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=error418" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/crisog"><img src="https://avatars.githubusercontent.com/u/40803711?v=4?s=100" width="100px;" alt="CrisOG"/><br /><sub><b>CrisOG</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Acrisog" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=crisog" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=crisog" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/haryle"><img src="https://avatars.githubusercontent.com/u/64817481?v=4?s=100" width="100px;" alt="harryle"/><br /><sub><b>harryle</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=haryle" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=haryle" title="Tests">⚠️</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="http://www.b-list.org/"><img src="https://avatars.githubusercontent.com/u/12384?v=4?s=100" width="100px;" alt="James Bennett"/><br /><sub><b>James Bennett</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Aubernostrum" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sherbang"><img src="https://avatars.githubusercontent.com/u/275015?v=4?s=100" width="100px;" alt="sherbang"/><br /><sub><b>sherbang</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sherbang" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/carlsmedstad"><img src="https://avatars.githubusercontent.com/u/6952324?v=4?s=100" width="100px;" alt="Carl Smedstad"/><br /><sub><b>Carl Smedstad</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=carlsmedstad" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/maintain0404"><img src="https://avatars.githubusercontent.com/u/50428534?v=4?s=100" width="100px;" alt="Taein Min"/><br /><sub><b>Taein Min</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=maintain0404" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/wallseat"><img src="https://avatars.githubusercontent.com/u/26143672?v=4?s=100" width="100px;" alt="Stanislav Lyu."/><br /><sub><b>Stanislav Lyu.</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Awallseat" title="Bug reports">🐛</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/tibor-reiss"><img src="https://avatars.githubusercontent.com/u/75096465?v=4?s=100" width="100px;" alt="Tibor Reiss"/><br /><sub><b>Tibor Reiss</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=tibor-reiss" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=tibor-reiss" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=tibor-reiss" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://pogrom.dev"><img src="https://avatars.githubusercontent.com/u/11032969?v=4?s=100" width="100px;" alt="Alex"/><br /><sub><b>Alex</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3A0xE111" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=0xE111" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="http://0110.be"><img src="https://avatars.githubusercontent.com/u/60453?v=4?s=100" width="100px;" alt="Joren Six"/><br /><sub><b>Joren Six</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=JorenSix" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jderrien"><img src="https://avatars.githubusercontent.com/u/145396?v=4?s=100" width="100px;" alt="jderrien"/><br /><sub><b>jderrien</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=jderrien" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://possiblepanda.me"><img src="https://avatars.githubusercontent.com/u/85448494?v=4?s=100" width="100px;" alt="PossiblePanda"/><br /><sub><b>PossiblePanda</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=PossiblePanda" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/evstratbg"><img src="https://avatars.githubusercontent.com/u/10176401?v=4?s=100" width="100px;" alt="evstrat"/><br /><sub><b>evstrat</b></sub></a><br /><a href="#infra-evstratbg" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://speakerdeck.com/eltociear"><img src="https://avatars.githubusercontent.com/u/22633385?v=4?s=100" width="100px;" alt="Ikko Eltociear Ashimine"/><br /><sub><b>Ikko Eltociear Ashimine</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=eltociear" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/taihim"><img src="https://avatars.githubusercontent.com/u/13764071?v=4?s=100" width="100px;" alt="Taimur Ibrahim"/><br /><sub><b>Taimur Ibrahim</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=taihim" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/l-armstrong"><img src="https://avatars.githubusercontent.com/u/43922258?v=4?s=100" width="100px;" alt="l-armstrong"/><br /><sub><b>l-armstrong</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=l-armstrong" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Anu-cool-007"><img src="https://avatars.githubusercontent.com/u/16525919?v=4?s=100" width="100px;" alt="Anuranjan Srivastava"/><br /><sub><b>Anuranjan Srivastava</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Anu-cool-007" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Zimzozaur"><img src="https://avatars.githubusercontent.com/u/106471045?v=4?s=100" width="100px;" alt="Simon Joseph"/><br /><sub><b>Simon Joseph</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Zimzozaur" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/abelkm99"><img src="https://avatars.githubusercontent.com/u/41730180?v=4?s=100" width="100px;" alt="Abel Kidanemariam"/><br /><sub><b>Abel Kidanemariam</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=abelkm99" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=abelkm99" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=abelkm99" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://blog.trim21.me/"><img src="https://avatars.githubusercontent.com/u/13553903?v=4?s=100" width="100px;" alt="Trim21"/><br /><sub><b>Trim21</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=trim21" title="Code">💻</a> <a href="https://github.com/litestar-org/litestar/commits?author=trim21" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://aarcex3.github.io"><img src="https://avatars.githubusercontent.com/u/59893355?v=4?s=100" width="100px;" alt="Agustin Arce"/><br /><sub><b>Agustin Arce</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=aarcex3" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/FarhanAliRaza"><img src="https://avatars.githubusercontent.com/u/62690310?v=4?s=100" width="100px;" alt="Farhan Ali Raza"/><br /><sub><b>Farhan Ali Raza</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=FarhanAliRaza" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/pogopaule"><img src="https://avatars.githubusercontent.com/u/576949?v=4?s=100" width="100px;" alt="Fabian"/><br /><sub><b>Fabian</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=pogopaule" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/mohammedbabelly20"><img src="https://avatars.githubusercontent.com/u/104768048?v=4?s=100" width="100px;" alt="Mohammed Babelly"/><br /><sub><b>Mohammed Babelly</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=mohammedbabelly20" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://keybase.io/charlesdyfisnet"><img src="https://avatars.githubusercontent.com/u/22370?v=4?s=100" width="100px;" alt="Charles Duffy"/><br /><sub><b>Charles Duffy</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=charles-dyfis-net" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/RenameMe1"><img src="https://avatars.githubusercontent.com/u/165988121?v=4?s=100" width="100px;" alt="Evgeny Demchenko"/><br /><sub><b>Evgeny Demchenko</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=RenameMe1" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=RenameMe1" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://olzhasar.com"><img src="https://avatars.githubusercontent.com/u/12471703?v=4?s=100" width="100px;" alt="Olzhas Arystanov"/><br /><sub><b>Olzhas Arystanov</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/issues?q=author%3Aolzhasar" title="Bug reports">🐛</a> <a href="https://github.com/litestar-org/litestar/commits?author=olzhasar" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/vikigenius"><img src="https://avatars.githubusercontent.com/u/12724810?v=4?s=100" width="100px;" alt="Vikash"/><br /><sub><b>Vikash</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=vikigenius" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ftsartek"><img src="https://avatars.githubusercontent.com/u/20253317?v=4?s=100" width="100px;" alt="Jordan Russell"/><br /><sub><b>Jordan Russell</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=ftsartek" title="Documentation">📖</a> <a href="https://github.com/litestar-org/litestar/commits?author=ftsartek" title="Tests">⚠️</a> <a href="https://github.com/litestar-org/litestar/commits?author=ftsartek" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://stevenloria.com"><img src="https://avatars.githubusercontent.com/u/2379650?v=4?s=100" width="100px;" alt="Steven Loria"/><br /><sub><b>Steven Loria</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=sloria" title="Documentation">📖</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/oek1ng"><img src="https://avatars.githubusercontent.com/u/193062679?v=4?s=100" width="100px;" alt="oek1ng"/><br /><sub><b>oek1ng</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=oek1ng" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Ada-lave"><img src="https://avatars.githubusercontent.com/u/113159483?v=4?s=100" width="100px;" alt="Vladislav"/><br /><sub><b>Vladislav</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Ada-lave" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://gaitenis.id.lv"><img src="https://avatars.githubusercontent.com/u/9976861?v=4?s=100" width="100px;" alt="Edgars"/><br /><sub><b>Edgars</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=eandersons" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://jannchie.com"><img src="https://avatars.githubusercontent.com/u/29743310?v=4?s=100" width="100px;" alt="Jianqi Pan"/><br /><sub><b>Jianqi Pan</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=Jannchie" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/PokkaKiyo"><img src="https://avatars.githubusercontent.com/u/31039465?v=4?s=100" width="100px;" alt="PokkaKiyo"/><br /><sub><b>PokkaKiyo</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=PokkaKiyo" title="Tests">⚠️</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/s-aleshin"><img src="https://avatars.githubusercontent.com/u/66841202?v=4?s=100" width="100px;" alt="Sergei Aleshin"/><br /><sub><b>Sergei Aleshin</b></sub></a><br /><a href="https://github.com/litestar-org/litestar/commits?author=s-aleshin" title="Code">💻</a></td>
</tr>
</tbody>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
Contributions of any kind welcome!
</details>
<!-- contributors-end -->
litestar-2.18.0/codecov.yml 0000664 0000000 0000000 00000000255 15070515525 0015605 0 ustar 00root root 0000000 0000000 coverage:
status:
project:
default:
target: auto
threshold: 0.1%
patch:
default:
target: auto
comment:
require_changes: true
litestar-2.18.0/docs/ 0000775 0000000 0000000 00000000000 15070515525 0014366 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/PYPI_README.md 0000664 0000000 0000000 00000046602 15070515525 0016516 0 ustar 00root root 0000000 0000000 <!-- markdownlint-disable -->
<p align="center">
<img src="https://raw.githubusercontent.com/litestar-org/branding/473f54621e55cde9acbb6fcab7fc03036173eb3d/assets/Branding%20-%20PNG%20-%20Transparent/Logo%20-%20Banner%20-%20Inline%20-%20Light.png" alt="Litestar Logo - Light" width="100%" height="auto" />
</p>
<!-- markdownlint-restore -->
<div align="center">
<!-- prettier-ignore-start -->
| Project | | Status |
|-----------|:----|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| CI/CD | | [](https://github.com/litestar-org/litestar/actions/workflows/publish.yml) [](https://github.com/litestar-org/litestar/actions/workflows/ci.yml) [](https://github.com/litestar-org/litestar/actions/workflows/docs.yml) |
| Quality | | [](https://codecov.io/github/litestar-org/litestar) |
| Package | | [](https://badge.fury.io/py/litestar)    |
| Community | | [](https://reddit.com/r/litestarapi) [](https://discord.gg/litestar) [](https://matrix.to/#/#litestar:matrix.org) [](https://blog.litestar.dev) [](https://twitter.com/LitestarAPI) [](https://blog.litestar.dev) |
| Meta | | [](https://github.com/litestar-org/litestar) [](https://github.com/python/mypy) [](https://spdx.org/licenses/) [](https://github.com/sponsors/litestar-org) [](https://github.com/astral-sh/ruff) [](https://github.com/psf/black) [](#contributors-) |
<!-- prettier-ignore-end -->
</div>
<hr>
Litestar is a powerful, flexible yet opinionated ASGI framework, focused on
building APIs. It offers high-performance data validation, dependency injection,
first-class ORM integration, authorization primitives, a rich plugin API, middleware,
and much more that's needed to get applications up and running.
Check out the [documentation 📚](https://docs.litestar.dev/) for a detailed overview of
its features!
Additionally, the [Litestar fullstack repository](https://github.com/litestar-org/litestar-fullstack)
can give you a good impression how a fully fledged Litestar application may look.
<details>
<summary>Table of Contents</summary>
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Core Features](#core-features)
- [Example Applications](#example-applications)
- [Features](#features)
- [Class-based Controllers](#class-based-controllers)
- [Data Parsing, Type Hints, and Msgspec](#data-parsing-type-hints-and-msgspec)
- [Plugin System, ORM support, and DTOs](#plugin-system-orm-support-and-dtos)
- [OpenAPI](#openapi)
- [Dependency Injection](#dependency-injection)
- [Middleware](#middleware)
- [Route Guards](#route-guards)
- [Request Life Cycle Hooks](#request-life-cycle-hooks)
- [Performance](#performance)
- [Contributing](#contributing)
</details>
## Installation
```shell
pip install litestar
```
or to include the CLI and a server (uvicorn) for running your application:
```shell
pip install 'litestar[standard]'
```
## Quick Start
```python title="app.py"
from litestar import Litestar, get
@get("/")
async def hello_world() -> dict[str, str]:
"""Keeping the tradition alive with hello world."""
return {"hello": "world"}
app = Litestar(route_handlers=[hello_world])
```
And run it with
```bash
litestar run
```
## Core Features
- [Class based controllers](#class-based-controllers)
- [Dependency Injection](#dependency-injection)
- [Layered Middleware](#middleware)
- [Plugin System](#plugin-system-orm-support-and-dtos)
- [OpenAPI 3.1 schema generation](#openapi)
- [Life Cycle Hooks](#request-life-cycle-hooks)
- [Route Guards based Authorization](#route-guards)
- Support for `dataclasses`, `TypedDict`, [`msgspec`](https://jcristharif.com/msgspec/), [pydantic version 1 and version 2 (even within the same application)](https://docs.pydantic.dev/latest/) and [(c)attrs](https://catt.rs/en/stable/)
- Layered parameter declaration
- Support for [RFC 9457](https://datatracker.ietf.org/doc/html/rfc9457) standardized "Problem Detail" error responses
- [Automatic API documentation with](#redoc-swagger-ui-and-stoplight-elements-api-documentation):
- [Scalar](https://github.com/scalar/scalar/)
- [RapiDoc](https://github.com/rapi-doc/RapiDoc)
- [Redoc](https://github.com/Redocly/redoc)
- [Stoplight Elements](https://github.com/stoplightio/elements)
- [Swagger-UI](https://swagger.io/tools/swagger-ui/)
- [Trio](https://trio.readthedocs.io/en/stable/) support (built-in, via [AnyIO](https://anyio.readthedocs.io/))
- Ultra-fast validation, serialization and deserialization using [msgspec](https://github.com/jcrist/msgspec)
- [SQLAlchemy integration](https://docs.advanced-alchemy.litestar.dev/latest/)
## Example Applications
<details>
<summary>Pre-built Example Apps</summary>
- [litestar-hello-world](https://github.com/litestar-org/litestar-hello-world): A bare-minimum application setup. Great
for testing and POC work.
- [litestar-fullstack](https://github.com/litestar-org/litestar-fullstack): A reference application that contains most of the boilerplate required for a web application.
It features a Litestar app configured with best practices, SQLAlchemy 2.0 and SAQ, a frontend integrated with Vitejs and Jinja2 templates, Docker, and more. Like all
Litestar projects, this application is open to contributions, big and small.
</details>
## Sponsors
Litestar is an open-source project, and we enjoy the support of our sponsors to help fund the exciting
work we do.
A **huge** thanks to our sponsors:
[//]: # "Note to maintainers: Highest sponsors first; no more than 3 per row - create new div if needed"
<a href="https://github.com/scalar/scalar/?utm_source=litestar&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar.com - Document, Discover and Test APIs with Scalar."><img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/sponsors/scalar.svg" width="180" alt="Scalar.com"></a>
<a href="https://telemetrysports.com/" title="Telemetry Sports - Changing the way data influences the sports experience"><img src="https://raw.githubusercontent.com/litestar-org/branding/main/assets/sponsors/telemetry-sports/unofficial-telemetry-whitebg.svg" width="150" alt="Telemetry Sports"></a>
<a href="https://docs.litestar.dev/latest/#sponsors" class="external-link" target="_blank">Check out our sponsors in the docs</a>
If you would like to support the work that we do please consider [becoming a sponsor][sponsor-polar]
via [Polar.sh][sponsor-polar] (preferred), [GitHub][sponsor-github] or [Open Collective][sponsor-oc].
Also, exclusively with [Polar][sponsor-polar], you can engage in pledge-based sponsorships.
[sponsor-github]: https://github.com/sponsors/litestar-org
[sponsor-oc]: https://opencollective.com/litestar
[sponsor-polar]: https://polar.sh/litestar-org
## Features
### Class-based Controllers
While supporting function-based route handlers, Litestar also supports and promotes python OOP using class based
controllers:
<details>
<summary>Example for class-based controllers</summary>
```python title="my_app/controllers/user.py"
from typing import List, Optional
from datetime import datetime
from litestar import Controller, get, post, put, patch, delete
from litestar.dto import DTOData
from pydantic import UUID4
from my_app.models import User, PartialUserDTO
class UserController(Controller):
path = "/users"
@post()
async def create_user(self, data: User) -> User: ...
@get()
async def list_users(self) -> List[User]: ...
@get(path="/{date:int}")
async def list_new_users(self, date: datetime) -> List[User]: ...
@patch(path="/{user_id:uuid}", dto=PartialUserDTO)
async def partial_update_user(
self, user_id: UUID4, data: DTOData[PartialUserDTO]
) -> User: ...
@put(path="/{user_id:uuid}")
async def update_user(self, user_id: UUID4, data: User) -> User: ...
@get(path="/{user_name:str}")
async def get_user_by_name(self, user_name: str) -> Optional[User]: ...
@get(path="/{user_id:uuid}")
async def get_user(self, user_id: UUID4) -> User: ...
@delete(path="/{user_id:uuid}")
async def delete_user(self, user_id: UUID4) -> None: ...
```
</details>
### Data Parsing, Type Hints, and Msgspec
Litestar is rigorously typed, and it enforces typing. For example, if you forget to type a return value for a route
handler, an exception will be raised. The reason for this is that Litestar uses typing data to generate OpenAPI specs,
as well as to validate and parse data. Thus, typing is essential to the framework.
Furthermore, Litestar allows extending its support using plugins.
### Plugin System, ORM support, and DTOs
Litestar has a plugin system that allows the user to extend serialization/deserialization, OpenAPI generation, and other
features.
It ships with a builtin plugin for SQL Alchemy, which allows the user to use SQLAlchemy declarative classes "natively"
i.e., as type parameters that will be serialized/deserialized and to return them as values from route
handlers.
Litestar also supports the programmatic creation of DTOs with a `DTOFactory` class, which also supports the use of
plugins.
### OpenAPI
Litestar has custom logic to generate OpenAPI 3.1.0 schema, include optional generation of examples using the
[`polyfactory`](https://pypi.org/project/polyfactory/) library.
#### ReDoc, Swagger-UI and Stoplight Elements API Documentation
Litestar serves the documentation from the generated OpenAPI schema with:
- [ReDoc](https://redoc.ly/)
- [Swagger-UI](https://swagger.io/tools/swagger-ui/)
- [Stoplight Elements](https://github.com/stoplightio/elements)
- [RapiDoc](https://rapidocweb.com/)
All these are available and enabled by default.
### Dependency Injection
Litestar has a simple but powerful DI system inspired by pytest. You can define named dependencies - sync or async - at
different levels of the application, and then selective use or overwrite them.
<details>
<summary>Example for DI</summary>
```python
from litestar import Litestar, get
from litestar.di import Provide
async def my_dependency() -> str: ...
@get("/")
async def index(injected: str) -> str:
return injected
app = Litestar([index], dependencies={"injected": Provide(my_dependency)})
```
</details>
### Middleware
Litestar supports typical ASGI middleware and ships with middlewares to handle things such as
- CORS
- CSRF
- Rate limiting
- GZip and Brotli compression
- Client- and server-side sessions
### Route Guards
Litestar has an authorization mechanism called `guards`, which allows the user to define guard functions at different
level of the application (app, router, controller etc.) and validate the request before hitting the route handler
function.
<details>
<summary>Example for route guards</summary>
```python
from litestar import Litestar, get
from litestar.connection import ASGIConnection
from litestar.handlers.base import BaseRouteHandler
from litestar.exceptions import NotAuthorizedException
async def is_authorized(connection: ASGIConnection, handler: BaseRouteHandler) -> None:
# validate authorization
# if not authorized, raise NotAuthorizedException
raise NotAuthorizedException()
@get("/", guards=[is_authorized])
async def index() -> None: ...
app = Litestar([index])
```
</details>
### Request Life Cycle Hooks
Litestar supports request life cycle hooks, similarly to Flask - i.e. `before_request` and `after_request`
## Performance
Litestar is fast. It is on par with, or significantly faster than comparable ASGI frameworks.
You can see and run the benchmarks [here](https://github.com/litestar-org/api-performance-tests),
or read more about it [here](https://docs.litestar.dev/latest/benchmarks) in our documentation.
## Contributing
Litestar is open to contributions big and small. You can always [join our discord](https://discord.gg/litestar) server
or [join our Matrix](https://matrix.to/#/#litestar:matrix.org) space
to discuss contributions and project maintenance. For guidelines on how to contribute, please
see [the contribution guide](CONTRIBUTING.rst).
litestar-2.18.0/docs/_static/ 0000775 0000000 0000000 00000000000 15070515525 0016014 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/_static/favicon.png 0000664 0000000 0000000 00000017005 15070515525 0020152 0 ustar 00root root 0000000 0000000 PNG
IHDR >a pHYs [M_p tEXtSoftware www.inkscape.org< IDATx}y\{ UqC@525Rn)صluju+"eeb*nWSE3 pef3z_ʙg<=<#д} x V
@^sA0N= m#A2@ @gD%[eR
iTwA.6ƁV $ w D ZY ` ] ts J $= < @+m[ F ;A( hz$x@6@>` 6 H%0@;g` m H6 Ɨt#== (++^ZZ
iH5k-ZYl͚5k PD`X"B#"t H6
s o2p1 :t~
G Czz:L4i ;sN{wt~:t `OtV7AhaodHR--ă9s,sO :CB&˯156`\DW$ ɋj3l构Θ,ŋP$+܌>.XҴ
2ɉz -fTիl:3=YPP~;D u#4[,Zd{t4<Izy8I I._ȶ̾zUg$\4zl&[doqРNq
Hs 8w/(P+_H6.ǀdb+Gi9~8x8] V6i
bqId|@o5$DҬk|饙
b˖EZ 7oq l:~V,U-7hH&[ ݲu"\&MfMfj" :4FmGVg< ,*%Fq1gxa15\kŋ/K e- $_Ud+<{0**ڥfdnnn=:uJ7X9dPffeApERB_ĩ<9ٻ㎮up 7["_P 9Mee|Iey
w] ^^>\S["D@Хk <xPV tw] VƱBI$#; d7ٳlk4l I6\wcXV^$$|o 144L|GO_}Nw;rذ,5lQ$?wCo O?̦ JKKDw[2&fKJKD?zž+W IN2Uw{8thHqYٷ/ٽH3ʻ$w^q:,$ERv~UoEѷn _}mҧ `T; 匘<I3.T $_{m6Q_*:s9$ FҙRA,//$Oh$&*f;23y٨:R 3f&[ѻw_mWbhhsrsDPBZn>X<i2fڨ\!Cu߄ 9ʕ+:eeo 9$9'>!K.UWwmQ>@!G9Gf3A ;vV w`AAM&QE/OЦ7>U 11CZ&Lp9NAAAbƂpw @HH),.noo!vfhъa***زeP+I6[ G[RY&&&0wS <E
۶EvB.o"ER6c{;wQ wQӢ/^"W
ԾZnɓL>c{Y ĉatSappSɵ^5 )?^֡yyyts3V})
==j9s,R n R?p@DbTTCZ[hŊ
/_%̀ ʕIZH` C" ÇSm۶ZgggcǎCCC1xkFZ"^F8V I)('7סtş~$6(Xj|K-Ya6˕m
Bw{lӛׯ_uc$a~~}%%% =}j?5 WwO I)Q*`z6:~~~n&d
1cF7>WქK%Ѭku C 3{p9,۶m5[]'6ᠠ 4k m۶ENpwc P+WH Vƽ U;p ӝCpu 8p@}hCTTRSSm \//Oߤz;f̙3w gH^ݨ0٬Y ݿk F"q6PZ>FV.$MHH#Gx&''3//EEE9߿ Fk@!; + ?PQ
U@`` <==
???Fh4>>>D`` F#퍰ָ;e3mSX,^іh?l~
cǎGFF-p%Fp ڟR^EP5g4 Usu Wd߿ }qE
+33jzZNʭHn*2jO$
)3gΨL0L =F3$D2n¢zþZ?[{_ YRRɒR09dr>H
+eƍk0dPMʯFo!!! */] CCqߠ7SOd4b_5ݳvr ?,&& E*'OBȑa)߁GW!!a/JKK5ݳu6dggȯb7n@E7PZZ
Ʉ"TTT:|qq1QPP ,] ;vTeGqq1Lu뾶' K] &w R
?e$ ۶mʕ+0hVf\~VƗz GU` 5lPuUV""B .\cqm (#@' @$Q3bA`@JJJT?LwV쓗ºu_c۶m(..v^~~A[VRR2͂m4 |чF?=6
~v-%- ]̪[I8ݽrmDq]*9(rٲxљ%K5Eo9tʝ -p @K$ź)J!55y
e<ptrԨNs pfp##r_4ZH{اO?5uqvil߱S)
].._a440`8MKNir..zm_~٭I7KiիרNlY]0znOD %%Erس10"" V |rf !FVtr'IP}_TT~e-簭8qu*cp==s.'['r<e.ÐA^TS' ~ܹSmSkܹsiOVjŊի.^\BA ^6αDQ/F1{,srr3 G umJ g}# T 3f<NLgY!Y08 2$]
EvwT_|cǎ2NB P&+ g ذfҥKNƎ UV JHHիNL
K]1:ի 9 D>tw> ?Dw@M. I]qЩ;wBV۰[ 8Qd" ]k{zd¤I7Mu)| aRm[:-m ܔ&Inݺng]ny\?@+II3 44 _QQiӞ=a÷;k@!!)Xh]&&5!yx}Uo~ڵF?8bH4YjJ "(UD4mڬA>ir~JJJF[)ɫWʦ!!uwr'RJ f!rHLLd-zΙ3gd2 Vښx+ｷB92ۓogϞUZgaaգG qYv]1M VN\pVM
V&MVácǎc^^^u|Gs >>~vv ZG ˎ@@Ugkqĕ+WՋO~≊YVV9sjr֬يi\` ܷ j C+ czmyI?{,۷hWbbbI ^XXHSu< dvvv8N<ɮ]V Ggfdd辻 p^H~+%#F> xDhߐ\sx7lVU<W^L&_~ե ;;h`]гgo
`&Ï>˦;7ZjVıĉλl9qY;UY)!Jff-ǵkׁG UdeT144L*䰰Ÿ:t3gΨ<Hr֬يŸԶׯ;}§ݷON DzYEL
}GApSOŪ3?ww>z SN)7zmrA4Y&L-Z J Z!%eؼyXOS$ߑٿy^bJA+cN]7MLV $Kd횰X,|75}[j͵k?(#5ifF؋]e03--M b IH+R#iɼ5!;;<0D |XXXh7nӻVwՍ"nr^x,Xx/ :t;f6T/ ٳGQCR?V?]6o0?㭷p%$9ph]
ۤU}EK,Uӱcg
`KER}Tgޚ0Z78tbXWMU:8 < $5"RN\jC*eVDG0߿_=R ?.^D{K,]K0q3_U
<oK W@|MG58<z I>}ަ} .hV6''GSwCJu( @$ D`2Sl{YYY2R-4sjaȇ# { I XwPPX8Sӛӧ?͌ 3ƍ{`6K3 v b˷~4 <~\-Mί*"DL*w%6^4=gyV|FFDDD ?jpi`2ؤISc~֚PU
|$ d4zrҤLIIiP$''s>Ç3""ҡ<p M} Rx:F'_ /U@+Qo{^L
JKKo֚f [Xj7 bwi`=ԑ1Y5JE2AE~ŗo9lMŋv٩%mYt?Aί*|D2Ց_ٽ 7M,Y={V1>~7;ƭ۶˽x"ܹs ;vbv[sn(>M/:d/898
dRRR8idUSf~YC
LsŊKwkr&PCA2Z$K --qq49hϞ=2>ˡCcnUV ѓ-m .*HIIOŀ U{ɼ㎮;[AAMjj4Ϯ?߇JEL8J &'>c[9jh߲e:S aÆ˲iyG5O:_$<ڑ"h.9^5?g\3lٲxEo9ߡ)AAM駟IimիKM&9glT}"il{"njkWfɵ >l>z#fY$moL9I:E2>M$7&))<M[K3m+.u>P] QIZׯ:?ʑ# 5=<
/$'+}7}x^%<(UmZEy7= ɠ&u 5aa<UL$飋k P$O(־9>>~,--%Q%g
rm=j
b @.
Nr6mtwU>}1U%秳nAH^U0_~Ncz
L2e*˕d;- Vv_PÇ뭔ѲJ77#/YxF|+X9DN ʲ{"o 8`I_U :o4ݺΠ uj6JT5%+%l dv'H
$r[ l纬u5}9{/(xG:y :HR4elѢr4
w7^KHoܢ",(,䫯7 ]!]tըA@r(3ռ.pEݑZǸi<%$g%|[ Vc(G[rȇt{۴⢷ޖ]-ßHFVj(sE f(**//ۿ_nc&9f tI_ @$A$y%~2 ;Υ ^^>ի̙ˣǎiZ[{$V Y AZEgϞšCqa$% =zGڵXc ^J s `3BƗ,"++999EnN Y 6m << :<@X"B}zuD$<I @' V P1Rh }D
NF Am-{
Qj 6%B80Pn* J>1` S$=ḩP$# tptH Qִ@&T ) M @@P L<J7@ eS? & IENDB` litestar-2.18.0/docs/_static/logo.svg 0000664 0000000 0000000 00000007640 15070515525 0017504 0 ustar 00root root 0000000 0000000 <svg xmlns="http://www.w3.org/2000/svg" width="500" zoomAndPan="magnify" viewBox="0 0 375 374.999991" height="500"
preserveAspectRatio="xMidYMid meet" version="1.0">
<defs>
<clipPath id="9eb7762d41">
<path d="M 15.933594 105 L 328 105 L 328 259 L 15.933594 259 Z M 15.933594 105 " clip-rule="nonzero"/>
</clipPath>
<clipPath id="183d3cc178">
<path d="M 142 78.769531 L 359.433594 78.769531 L 359.433594 296.269531 L 142 296.269531 Z M 142 78.769531 "
clip-rule="nonzero"/>
</clipPath>
</defs>
<g clip-path="url(#9eb7762d41)">
<path fill="#edb641"
d="M 147.625 240.3125 C 161.5 233.984375 173.554688 227.011719 183.425781 220.550781 C 202.304688 208.203125 226.4375 185.242188 227.761719 183.410156 L 218.917969 177.503906 L 211.257812 172.386719 L 235.503906 171.441406 L 243.296875 171.136719 L 245.414062 163.640625 L 252.007812 140.304688 L 260.402344 163.054688 L 263.097656 170.363281 L 270.890625 170.058594 L 295.136719 169.113281 L 276.078125 184.117188 L 269.953125 188.9375 L 272.652344 196.25 L 281.046875 218.996094 L 260.871094 205.523438 L 254.390625 201.195312 L 248.265625 206.015625 L 229.207031 221.023438 L 232.480469 209.425781 L 235.796875 197.691406 L 236.207031 196.234375 C 213.003906 213.585938 180.546875 230.304688 161.140625 236.488281 C 156.6875 237.90625 152.183594 239.179688 147.625 240.3125 Z M 101.992188 258.078125 C 136.382812 256.734375 177.355469 248 217.675781 222.363281 L 209.90625 249.867188 L 254.910156 214.4375 L 302.539062 246.246094 L 282.71875 192.539062 L 327.71875 157.109375 L 270.46875 159.34375 L 250.648438 105.636719 L 235.085938 160.726562 L 177.835938 162.964844 L 210.980469 185.097656 C 189.164062 204.921875 134.445312 247.195312 61.957031 250.03125 C 47.300781 250.601562 31.914062 249.558594 15.933594 246.394531 C 15.933594 246.394531 52.011719 260.035156 101.992188 258.078125 "
fill-opacity="1" fill-rule="nonzero"/>
</g>
<g clip-path="url(#183d3cc178)">
<path fill="#edb641"
d="M 250.789062 78.96875 C 190.78125 78.96875 142.140625 127.570312 142.140625 187.519531 C 142.140625 198.875 143.886719 209.816406 147.121094 220.101562 C 151.847656 217.75 156.363281 215.316406 160.660156 212.84375 C 158.394531 204.789062 157.183594 196.296875 157.183594 187.519531 C 157.183594 135.871094 199.089844 93.996094 250.789062 93.996094 C 302.484375 93.996094 344.390625 135.871094 344.390625 187.519531 C 344.390625 239.171875 302.484375 281.042969 250.789062 281.042969 C 222.75 281.042969 197.597656 268.722656 180.441406 249.210938 C 175.453125 251.152344 170.402344 252.917969 165.289062 254.511719 C 185.183594 279.816406 216.082031 296.070312 250.789062 296.070312 C 310.792969 296.070312 359.433594 247.472656 359.433594 187.519531 C 359.433594 127.570312 310.792969 78.96875 250.789062 78.96875 "
fill-opacity="1" fill-rule="nonzero"/>
</g>
<path fill="#edb641"
d="M 92.292969 173.023438 L 98.289062 191.460938 L 117.691406 191.460938 L 101.992188 202.855469 L 107.988281 221.292969 L 92.292969 209.898438 L 76.59375 221.292969 L 82.589844 202.855469 L 66.894531 191.460938 L 86.296875 191.460938 L 92.292969 173.023438 "
fill-opacity="1" fill-rule="nonzero"/>
<path fill="#edb641"
d="M 120.214844 112.25 L 125.390625 128.167969 L 142.140625 128.167969 L 128.589844 138 L 133.765625 153.917969 L 120.214844 144.082031 L 106.664062 153.917969 L 111.839844 138 L 98.289062 128.167969 L 115.039062 128.167969 L 120.214844 112.25 "
fill-opacity="1" fill-rule="nonzero"/>
<path fill="#edb641"
d="M 34.695312 209.136719 L 37.71875 218.421875 L 47.492188 218.421875 L 39.585938 224.160156 L 42.605469 233.449219 L 34.695312 227.707031 L 26.792969 233.449219 L 29.8125 224.160156 L 21.90625 218.421875 L 31.679688 218.421875 L 34.695312 209.136719 "
fill-opacity="1" fill-rule="nonzero"/>
</svg>
litestar-2.18.0/docs/_static/style.css 0000664 0000000 0000000 00000001234 15070515525 0017666 0 ustar 00root root 0000000 0000000 #version-warning {
top: 0;
position: sticky;
z-index: 60;
width: 100%;
height: 2.5rem;
display: flex;
column-gap: 0.5rem;
justify-content: center;
justify-items: center;
align-items: center;
background-color: #eee;
border-bottom: 2px solid #ae2828;
}
@media (prefers-color-scheme: dark) {
body:not([data-theme="light"]) #version-warning {
background-color: black;
}
}
.breaking-change {
font-variant: all-small-caps;
margin-left: 0.4rem;
color: #f55353;
}
p {
font-size: 1.1em;
}
html[data-theme="dark"] .mermaid svg {
background-color: white;
padding: 1em;
}
html[data-theme="dark"] .mermaid svg p {
color: black;
}
litestar-2.18.0/docs/_static/versioning.js 0000664 0000000 0000000 00000005704 15070515525 0020543 0 ustar 00root root 0000000 0000000 const loadVersions = async () => {
const res = await fetch(
DOCUMENTATION_OPTIONS.URL_ROOT + "_static/versions.json",
);
if (res.status !== 200) {
return null;
}
return await res.json();
};
const addVersionWarning = (currentVersion, latestVersion) => {
if (currentVersion === latestVersion) {
return;
}
const header = document.querySelector(".bd-header__inner")?.parentElement;
if (!header) {
return;
}
const container = document.createElement("div");
container.id = "version-warning";
const warningText = document.createElement("span");
warningText.textContent = `You are viewing the documentation for ${
currentVersion === "dev" ||
parseInt(currentVersion) > parseInt(latestVersion)
? "a preview"
: "an outdated"
} version of Litestar.`;
container.appendChild(warningText);
const latestLink = document.createElement("a");
latestLink.textContent = "Click here to go to the latest version";
latestLink.href = DOCUMENTATION_OPTIONS.URL_ROOT + "../latest";
container.appendChild(latestLink);
header.before(container);
};
const formatVersionName = (version, isLatest) =>
version + (isLatest ? " (latest)" : "");
const addVersionSelect = (currentVersion, versionSpec) => {
const navEnd = document.querySelector(".navbar-header-items__end");
if (!navEnd) {
return;
}
const container = document.createElement("div");
container.classList.add("navbar-nav");
const dropdown = document.createElement("div");
dropdown.classList.add("dropdown");
container.appendChild(dropdown);
const dropdownToggle = document.createElement("button");
dropdownToggle.classList.add("btn", "dropdown-toggle", "nav-item");
dropdownToggle.setAttribute("data-bs-toggle", "dropdown");
dropdownToggle.setAttribute("type", "button");
dropdownToggle.textContent = `Version: ${formatVersionName(
currentVersion,
currentVersion === versionSpec.latest,
)}`;
dropdown.appendChild(dropdownToggle);
const dropdownContent = document.createElement("div");
dropdownContent.classList.add("dropdown-menu");
dropdown.appendChild(dropdownContent);
for (const version of versionSpec.versions) {
const navItem = document.createElement("li");
navItem.classList.add("nav-item");
const navLink = document.createElement("a");
navLink.classList.add("nav-link", "nav-internal");
navLink.href = DOCUMENTATION_OPTIONS.URL_ROOT + `../${version}`;
navLink.textContent = formatVersionName(
version,
version === versionSpec.latest,
);
navItem.appendChild(navLink);
dropdownContent.appendChild(navItem);
}
navEnd.prepend(container);
};
const setupVersioning = (versions) => {
if (versions === null) {
return;
}
const currentVersion = DOCUMENTATION_OPTIONS.VERSION;
addVersionWarning(currentVersion, versions.latest);
addVersionSelect(currentVersion, versions);
};
window.addEventListener("DOMContentLoaded", () => {
loadVersions().then(setupVersioning);
});
litestar-2.18.0/docs/_static/versions.json 0000664 0000000 0000000 00000000062 15070515525 0020555 0 ustar 00root root 0000000 0000000 { "versions": ["1", "2", "main"], "latest": "2" }
litestar-2.18.0/docs/admonitions/ 0000775 0000000 0000000 00000000000 15070515525 0016712 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/admonitions/sync-to-thread-info.rst 0000664 0000000 0000000 00000001652 15070515525 0023242 0 ustar 00root root 0000000 0000000 .. admonition:: Synchronous and asynchronous callables
:class: important
Both synchronous and asynchronous callables are supported. One important aspect of
this is that using a synchronous function which perform blocking operations, such
as I/O or computationally intensive tasks, can potentially block the main thread
running the event loop, and in turn block the whole application.
To mitigate this, the ``sync_to_thread`` parameter can be set to ``True``, which
will result in the function being run in a thread pool.
If a synchronous function is non-blocking, setting ``sync_to_thread`` to ``False``
will tell Litestar that the user is sure about its behavior
and the function can be treated as non-blocking.
If a synchronous function is passed, without setting an explicit ``sync_to_thread``
value, a warning will be raised.
.. seealso::
:doc:`/topics/sync-vs-async`
litestar-2.18.0/docs/benchmarks.rst 0000664 0000000 0000000 00000007741 15070515525 0017246 0 ustar 00root root 0000000 0000000 Benchmarks
==========
Methodology
-----------
- Benchmarking is done using the
`bombardier <https://github.com/codesenberg/bombardier>`__ benchmarking tool.
- Benchmarks are run on a dedicated machine, with a base Debian 11 installation.
- Each framework is contained within its own docker container, running on a dedicated
CPU core (using the ``cset shield`` command and the ``--cpuset-cpus`` option for
docker)
- Tests for the frameworks are written to make them as comparable as possible while
completing the same tasks (you can see them
`here <https://github.com/litestar-org/api-performance-tests/tree/main/frameworks>`__)
- Each application is run using `uvicorn <https://www.uvicorn.org/>`__ with
**one worker** and `uvloop <https://uvloop.readthedocs.io/>`__
- Test data has been randomly generated and is being imported from a shared module
- All frameworks are used with their "stock" configuration, i.e. without applying any
additional optimizations. All tests have been written according to the respective
official documentation, applying the practices shown there
Results
-------
.. note::
If a result is missing for a specific framework that means either
- The framework does not support this functionality (this will be mentioned in the
test description)
- More than 0.1% of responses were dropped
JSON
~~~~
Serializing a dictionary into JSON
.. figure:: /images/benchmarks/rps_json.svg
:alt: RPS JSON
RPS JSON
.. note::
Because all frameworks are being used in their "stock" configuration, Litestar will
run the data through `msgspec <https://jcristharif.com/msgspec/>`_ and FastAPI
through `Pydantic <https://docs.pydantic.dev/latest/>`_
Serialization
~~~~~~~~~~~~~
Serializing Pydantic models and dataclasses into JSON
.. figure:: /images/benchmarks/rps_serialization.svg
:alt: RPS serializing Pydantic models and dataclasses into JSON
RPS serializing Pydantic models and dataclasses into JSON
Files
~~~~~
.. figure:: /images/benchmarks/rps_files.svg
:alt: RPS files
RPS files
.. note::
Synchronous file responses are not / only partially supported for Sanic and Quart
Path and query parameter handling
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*All responses return “No Content”*
- No params: No path parameters
- Path params: Single path parameter, coerced into an integer
- Query params: Single query parameter, coerced into an integer
- Mixed params: A path and a query parameters, coerced into integers
.. figure:: /images/benchmarks/rps_params.svg
:alt: RPS path and query parameters
RPS path and query parameters
Dependency injection
~~~~~~~~~~~~~~~~~~~~
- Resolving 3 nested synchronous dependencies
- Resolving 3 nested asynchronous dependencies (only supported by ``Litestar`` and ``FastAPI``)
- Resolving 3 nested synchronous, and 3 nested asynchronous dependencies (only supported by ``Litestar`` and ``FastAPI``)
.. figure:: /images/benchmarks/rps_dependency-injection.svg
:alt: RPS Dependency injection
RPS Dependency injection
.. note::
Dependency injection is not supported by Starlette.
Plaintext
~~~~~~~~~
.. figure:: /images/benchmarks/rps_plaintext.svg
:alt: RPS Plaintext
RPS Plaintext
Interpreting the results
------------------------
An interpretation of these results should be approached with caution, as is the case for nearly all benchmarks.
A high score in a test does not necessarily translate to high performance of **your** application and **your** use case.
For almost any test you can probably write an app that performs better or worse at a comparable task **in your scenario**.
While trying to design the tests in a way that simulate somewhat realistic scenarios, they can never give an exact
representation of how a real world application behaves and performs, where, aside from the workload, many other factors
come into play. These tests were mainly written to be used internally for Litestar development, to help us locate and
track performance regressions and improvements.
litestar-2.18.0/docs/conf.py 0000664 0000000 0000000 00000037113 15070515525 0015672 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import importlib.metadata
import os
import re
import warnings
from functools import partial
from typing import Any
from sphinx.addnodes import document
from sphinx.application import Sphinx
from sqlalchemy.exc import SAWarning
warnings.filterwarnings("ignore", category=SAWarning)
__all__ = ["setup", "update_html_context"]
PY_CLASS = "py:class"
PY_RE = r"py:.*"
PY_METH = "py:meth"
PY_ATTR = "py:attr"
PY_OBJ = "py:obj"
PY_FUNC = "py:func"
project = "Litestar"
copyright = "2025, Litestar-Org"
author = "Litestar-Org"
release = os.getenv("_LITESTAR_DOCS_BUILD_VERSION", importlib.metadata.version("litestar").rsplit(".")[0])
extensions = [
"sphinx.ext.intersphinx",
"sphinx.ext.autodoc",
"sphinx.ext.napoleon",
"sphinx.ext.autosectionlabel",
"sphinx_design",
"auto_pytabs.sphinx_ext",
"tools.sphinx_ext",
"sphinx_copybutton",
"sphinxcontrib.mermaid",
"sphinx_click",
"sphinx_paramlinks",
]
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
intersphinx_mapping = {
"python": ("https://docs.python.org/3", None),
"msgspec": ("https://jcristharif.com/msgspec/", None),
"anyio": ("https://anyio.readthedocs.io/en/stable/", None),
"multidict": ("https://multidict.aio-libs.org/en/stable/", None),
"cryptography": ("https://cryptography.io/en/latest/", None),
"sqlalchemy": ("https://docs.sqlalchemy.org/en/20/", None),
"alembic": ("https://alembic.sqlalchemy.org/en/latest/", None),
"click": ("https://click.palletsprojects.com/en/8.1.x/", None),
"redis": ("https://redis.readthedocs.io/en/stable/", None),
"picologging": ("https://microsoft.github.io/picologging", None),
"structlog": ("https://www.structlog.org/en/stable/", None),
"tortoise": ("https://tortoise.github.io/", None),
"piccolo": ("https://piccolo-orm.readthedocs.io/en/latest", None),
"opentelemetry": ("https://opentelemetry-python.readthedocs.io/en/latest/", None),
"advanced-alchemy": ("https://docs.advanced-alchemy.litestar.dev/latest/", None),
"jinja2": ("https://jinja.palletsprojects.com/en/latest/", None),
"trio": ("https://trio.readthedocs.io/en/stable/", None),
"pydantic": ("https://docs.pydantic.dev/latest/", None),
"typing_extensions": ("https://typing-extensions.readthedocs.io/en/stable/", None),
"valkey": ("https://valkey-py.readthedocs.io/en/latest/", None),
}
napoleon_google_docstring = True
napoleon_include_special_with_doc = True
napoleon_use_admonition_for_examples = True
napoleon_use_admonition_for_notes = True
napoleon_use_admonition_for_references = False
napoleon_attr_annotations = True
autoclass_content = "class"
autodoc_class_signature = "separated"
autodoc_default_options = {"special-members": "__init__", "show-inheritance": True, "members": True}
autodoc_member_order = "bysource"
autodoc_typehints_format = "short"
autodoc_mock_imports = []
nitpicky = True
nitpick_ignore = [
# external library / undocumented external
(PY_CLASS, "BaseModel"),
(PY_CLASS, "ExternalType"),
(PY_CLASS, "TypeEngine"),
(PY_CLASS, "UserDefinedType"),
(PY_CLASS, "_RegistryType"),
(PY_CLASS, "_orm.Mapper"),
(PY_CLASS, "_orm.registry"),
(PY_CLASS, "_schema.MetaData"),
(PY_CLASS, "_schema.Table"),
(PY_CLASS, "_types.TypeDecorator"),
(PY_CLASS, "abc.Collection"),
(PY_CLASS, "advanced_alchemy.utils.dataclass.Empty"),
(PY_CLASS, "jinja2.environment.Environment"),
(PY_CLASS, "pydantic.BaseModel"),
(PY_CLASS, "pydantic.generics.GenericModel"),
(PY_CLASS, "pydantic.main.BaseModel"),
(PY_CLASS, "redis.asyncio.Redis"),
(PY_CLASS, "sqlalchemy.dialects.postgresql.named_types.ENUM"),
(PY_CLASS, "sqlalchemy.orm.decl_api.DeclarativeMeta"),
(PY_CLASS, "sqlalchemy.sql.sqltypes.TupleType"),
(PY_CLASS, "valkey.asyncio.Valkey"),
(PY_METH, "_types.TypeDecorator.process_bind_param"),
(PY_METH, "_types.TypeDecorator.process_result_value"),
(PY_METH, "litestar.typing.ParsedType.is_subclass_of"),
(PY_METH, "type_engine"),
# type vars and aliases / intentionally undocumented
(PY_CLASS, "AnyIOBackend"),
(PY_CLASS, "BaseSessionBackendT"),
(PY_CLASS, "C"),
(PY_CLASS, "CollectionT"),
(PY_CLASS, "ControllerRouterHandler"),
(PY_CLASS, "EmptyType"),
(PY_CLASS, "ModelT"),
(PY_CLASS, "PathParameterDefinition"),
(PY_CLASS, "RouteHandlerType"),
(PY_CLASS, "SelectT"),
(PY_CLASS, "T"),
(PY_OBJ, "litestar.security.base.AuthType"),
# investigate
(PY_CLASS, "Environment"),
(PY_CLASS, "P"),
(PY_CLASS, "pydantic_v1.BaseModel"),
(PY_CLASS, "pydantic_v2.BaseModel"),
(PY_CLASS, "advanced_alchemy.config.types.Empty"),
(PY_OBJ, "litestar.template.base.TemplateType_co"),
(PY_OBJ, "litestar.template.base.ContextType_co"),
(PY_CLASS, "litestar.template.base.TemplateType_co"),
(PY_CLASS, "litestar.template.base.ContextType_co"),
(PY_CLASS, "litestar.template.base.R"),
(PY_ATTR, "litestar.openapi.controller.OpenAPIController.swagger_ui_init_oauth"),
# intentionally undocumented
(PY_CLASS, "BacklogStrategy"),
(PY_CLASS, "ExceptionT"),
(PY_CLASS, "NoneType"),
(PY_CLASS, "litestar._openapi.schema_generation.schema.SchemaCreator"),
(PY_CLASS, "litestar._signature.model.SignatureModel"),
(PY_CLASS, "litestar.contrib.sqlalchemy.plugins.init.config.compat._CreateEngineMixin"),
(PY_CLASS, "litestar.utils.signature.ParsedSignature"),
(PY_CLASS, "litestar.utils.sync.AsyncCallable"),
# types in changelog that no longer exist
(PY_ATTR, "litestar.dto.factory.DTOConfig.underscore_fields_private"),
(PY_CLASS, "anyio.abc.BlockingPortal"),
(PY_CLASS, "litestar.contrib.msgspec.MsgspecDTO"),
(PY_CLASS, "litestar.contrib.repository.filters.NotInCollectionFilter"),
(PY_CLASS, "litestar.contrib.repository.filters.NotInSearchFilter"),
(PY_CLASS, "litestar.contrib.repository.filters.OnBeforeAfter"),
(PY_CLASS, "litestar.contrib.repository.filters.OrderBy"),
(PY_CLASS, "litestar.contrib.repository.filters.SearchFilter"),
(PY_CLASS, "litestar.dto.base_factory.AbstractDTOFactory"),
(PY_CLASS, "litestar.dto.factory.DTOConfig"),
(PY_CLASS, "litestar.dto.factory.DTOData"),
(PY_CLASS, "litestar.dto.interface.DTOInterface"),
(PY_CLASS, "litestar.partial.Partial"),
(PY_CLASS, "litestar.response.RedirectResponse"),
(PY_CLASS, "litestar.response_containers.Redirect"),
(PY_CLASS, "litestar.response_containers.Template"),
(PY_CLASS, "litestar.contrib.sqlalchemy.plugins.SQLAlchemyPlugin"),
(PY_CLASS, "litestar.contrib.sqlalchemy.plugins.SQLAlchemySerializationPlugin"),
(PY_CLASS, "litestar.contrib.sqlalchemy.plugins.SQLAlchemyInitPlugin"),
(PY_CLASS, "litestar.contrib.sqlalchemy.dto.SQLAlchemyDTO"),
(PY_CLASS, "litestar.contrib.sqlalchemy.types.BigIntIdentity"),
(PY_CLASS, "litestar.contrib.sqlalchemy.types.JsonB"),
(PY_CLASS, "litestar.contrib.htmx.request.HTMXRequest"),
(PY_CLASS, "litestar.typing.ParsedType"),
(PY_METH, "litestar.dto.factory.DTOData.create_instance"),
(PY_METH, "litestar.dto.interface.DTOInterface.data_to_encodable_type"),
(PY_CLASS, "MetaData"),
(PY_FUNC, "sqlalchemy.get_engine"),
(PY_OBJ, "litestar.template.base.T_co"),
("py:exc", "RepositoryError"),
("py:exc", "InternalServerError"),
("py:exc", "HTTPExceptions"),
(PY_CLASS, "litestar.template.Template"),
(PY_CLASS, "litestar.middleware.compression.gzip_facade.GzipCompression"),
(PY_CLASS, "litestar.handlers.http_handlers.decorators._subclass_warning"),
(PY_CLASS, "litestar.background_tasks.P"),
(PY_CLASS, "P.args"),
(PY_CLASS, "P.kwargs"),
(PY_CLASS, "litestar.contrib.jinja.P"),
(PY_CLASS, "litestar.contrib.mako.P"),
(PY_CLASS, "JWTDecodeOptions"),
(PY_CLASS, "litestar.template.base.P"),
(PY_CLASS, "litestar.contrib.pydantic.PydanticDTO"),
(PY_CLASS, "litestar.contrib.pydantic.PydanticPlugin"),
(PY_CLASS, "typing.Self"),
(PY_CLASS, "attr.AttrsInstance"),
(PY_CLASS, "typing_extensions.TypeGuard"),
(PY_CLASS, "advanced_alchemy.types.BigIntIdentity"),
(PY_CLASS, "advanced_alchemy.types.JsonB"),
(PY_CLASS, "advanced_alchemy.repository.SQLAlchemyAsyncRepository"),
# docs in flux as we prepare for `advanced_alchemy` 1.0 release. re-enable when finished
(PY_CLASS, "advanced_alchemy.base.UUIDBase"),
(PY_CLASS, "advanced_alchemy.base.UUIDAuditBase"),
(PY_CLASS, "advanced_alchemy.base.BigIntBase"),
(PY_CLASS, "advanced_alchemy.base.BigIntAuditBase"),
]
nitpick_ignore_regex = [
(PY_ATTR, "litestar.repository.testing.AsyncGenericMockRepository.id_attribute"),
(PY_ATTR, "litestar.repository.AbstractAsyncRepository.id_attribute"),
(PY_ATTR, "litestar.repository.AbstractSyncRepository.id_attribute"),
# (PY_ATTR, "litestar.repository.AsyncGenericMockRepository.id_attribute"),
(PY_OBJ, r"typing\..*"),
(PY_RE, r".*R_co"),
(PY_RE, r".*UserType"),
(PY_RE, r"ModelT"),
(PY_RE, r"litestar.*\.T"),
(PY_RE, r"litestar.contrib.sqlalchemy.repository.ModelT"),
(PY_RE, r"litestar\.middleware\.session\.base\.BaseSessionBackendT"),
(PY_RE, r"litestar\.types.*"),
(PY_RE, r"httpx.*"),
# type vars
(PY_RE, r"litestar.middleware.session.base.ConfigT"),
(PY_RE, r"litestar\.connection\.base\.AuthT"),
(PY_RE, r"litestar\.connection\.base\.HandlerT"),
(PY_RE, r"litestar\.connection\.base\.StateT"),
(PY_RE, r"litestar\.connection\.base\.UserT"),
(PY_RE, r"litestar\.pagination\.C"),
(PY_RE, r"multidict\..*"),
(PY_RE, r"advanced_alchemy.*\.T"),
(PY_RE, r"advanced_alchemy\.config.common\.EngineT"),
(PY_RE, r"advanced_alchemy\.config.common\.SessionT"),
(PY_RE, r".*R"),
(PY_OBJ, r"litestar.security.jwt.auth.TokenT"),
(PY_CLASS, "ExceptionToProblemDetailMapType"),
(PY_CLASS, "litestar.security.jwt.token.JWTDecodeOptions"),
]
# Warnings about missing references to those targets in the specified location will be ignored.
# The source of the references is taken 1:1 from the warnings as reported by Sphinx, e.g
# **/litestar/testing/client/async_client.py:docstring of litestar.testing.AsyncTestClient.exit_stack:1: WARNING: py:class reference target not found: AsyncExitStack
# would be added as: "litestar.testing.AsyncTestClient.exit_stack": {"AsyncExitStack"},
ignore_missing_refs = {
# No idea what autodoc is doing here. Possibly unfixable on our end
"litestar.template.base.TemplateEngineProtocol.get_template": {"litestar.template.base.T_co"},
"litestar.template": {"litestar.template.base.T_co"},
"litestar.openapi.OpenAPIController.security": {"SecurityRequirement"},
"litestar.response.file.async_file_iterator": {"FileSystemAdapter"},
re.compile("litestar.response.redirect.*"): {"RedirectStatusType"},
re.compile(r"litestar\.plugins.*"): re.compile(".*ModelT"),
re.compile(r"litestar\.(contrib|repository)\.*"): re.compile(".*T"),
re.compile(r"litestar\.contrib\.sqlalchemy\.*"): re.compile(
".*(ConnectionT|EngineT|SessionT|SessionMakerT|SlotsBase)"
),
re.compile(r"litestar\.dto.*"): re.compile(".*T|.*FieldDefinition|Empty"),
re.compile(r"litestar\.template\.(config|TemplateConfig).*"): re.compile(".*EngineType"),
"litestar.concurrency.set_asyncio_executor": {"ThreadPoolExecutor"},
"litestar.concurrency.get_asyncio_executor": {"ThreadPoolExecutor"},
re.compile(r"litestar\.channels\.backends\.asyncpg.*"): {"asyncpg.connection.Connection", "asyncpg.Connection"},
re.compile(r"litestar\.handlers\.websocket_handlers\.stream.*"): {"WebSocketMode"},
}
# Do not warn about broken links to the following:
linkcheck_ignore = [
r"http://localhost(:\d+)?",
r"http://127.0.0.1(:\d+)?",
"http://testserver",
]
auto_pytabs_min_version = (3, 8)
auto_pytabs_max_version = (3, 11)
auto_pytabs_compat_mode = True
autosectionlabel_prefix_document = True
suppress_warnings = [
"autosectionlabel.*",
"ref.python", # TODO: remove when https://github.com/sphinx-doc/sphinx/issues/4961 is fixed
]
html_theme = "litestar_sphinx_theme"
html_static_path = ["_static"]
html_js_files = ["versioning.js"]
html_css_files = ["style.css"]
html_show_sourcelink = False
html_title = "Litestar Framework"
html_theme_options = {
"use_page_nav": False,
"github_repo_name": "litestar",
"logo": {
"link": "https://litestar.dev",
},
"pygment_light_style": "xcode",
"pygment_dark_style": "lightbulb",
"navigation_with_keys": True,
"extra_navbar_items": {
"Documentation": "index",
"Community": {
"Contributing": {
"description": "Learn how to contribute to the Litestar project",
"link": "https://docs.litestar.dev/latest/contribution-guide.html",
"icon": "contributing",
},
"Code of Conduct": {
"description": "Review the etiquette for interacting with the Litestar community",
"link": "https://github.com/litestar-org/.github?tab=coc-ov-file",
"icon": "coc",
},
"Security": {
"description": "Overview of Litestar's security protocols",
"link": "https://github.com/litestar-org/.github?tab=coc-ov-file#security-ov-file",
"icon": "coc",
},
},
"About": {
"Litestar Organization": {
"description": "Details about the Litestar organization",
"link": "https://litestar.dev/about/organization",
"icon": "org",
},
"Releases": {
"description": "Explore the release process, versioning, and deprecation policy for Litestar",
"link": "https://litestar.dev/about/litestar-releases",
"icon": "releases",
},
},
"Release notes": {
"What's new in 2.0": "release-notes/whats-new-2",
"2.x Changelog": "https://docs.litestar.dev/2/release-notes/changelog.html",
"1.x Changelog": "https://docs.litestar.dev/1/release-notes/changelog.html",
},
"Help": {
"Discord Help Forum": {
"description": "Dedicated Discord help forum",
"link": "https://discord.gg/litestar",
"icon": "coc",
},
"GitHub Discussions": {
"description": "GitHub Discussions ",
"link": "https://github.com/orgs/litestar-org/discussions",
"icon": "coc",
},
"Stack Overflow": {
"description": "We monitor the <code><b>litestar</b></code> tag on Stack Overflow",
"link": "https://stackoverflow.com/questions/tagged/litestar",
"icon": "coc",
},
},
},
}
def update_html_context(
app: Sphinx, pagename: str, templatename: str, context: dict[str, Any], doctree: document
) -> None:
context["generate_toctree_html"] = partial(context["generate_toctree_html"], startdepth=0)
def delayed_setup(app: Sphinx) -> None:
"""
When running linkcheck pydata_sphinx_theme causes a build failure, and checking
the builder in the initial `setup` function call is not possible, so the check
and extension setup has to be delayed until the builder is initialized.
"""
if app.builder.name == "linkcheck":
return
app.setup_extension("pydata_sphinx_theme")
app.connect("html-page-context", update_html_context) # type: ignore
def setup(app: Sphinx) -> dict[str, bool]:
app.connect("builder-inited", delayed_setup, priority=0) # type: ignore
app.setup_extension("litestar_sphinx_theme")
return {"parallel_read_safe": True, "parallel_write_safe": True}
litestar-2.18.0/docs/contribution-guide.rst 0000664 0000000 0000000 00000000053 15070515525 0020730 0 ustar 00root root 0000000 0000000 :orphan:
.. include:: ../CONTRIBUTING.rst
litestar-2.18.0/docs/examples/ 0000775 0000000 0000000 00000000000 15070515525 0016204 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0020303 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/application_hooks/ 0000775 0000000 0000000 00000000000 15070515525 0021712 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/application_hooks/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024011 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/application_hooks/after_exception_hook.py 0000664 0000000 0000000 00000002041 15070515525 0026460 0 ustar 00root root 0000000 0000000 import logging
from typing import TYPE_CHECKING
from litestar import Litestar, get
from litestar.exceptions import HTTPException
from litestar.status_codes import HTTP_400_BAD_REQUEST
logger = logging.getLogger()
if TYPE_CHECKING:
from litestar.types import Scope
@get("/some-path", sync_to_thread=False)
def my_handler() -> None:
"""Route handler that raises an exception."""
raise HTTPException(detail="bad request", status_code=HTTP_400_BAD_REQUEST)
async def after_exception_handler(exc: Exception, scope: "Scope") -> None:
"""Hook function that will be invoked after each exception."""
state = Litestar.from_scope(scope).state
if not hasattr(state, "error_count"):
state.error_count = 1
else:
state.error_count += 1
logger.info(
"an exception of type %s has occurred for requested path %s and the application error count is %d.",
type(exc).__name__,
scope["path"],
state.error_count,
)
app = Litestar([my_handler], after_exception=[after_exception_handler])
litestar-2.18.0/docs/examples/application_hooks/before_send_hook.py 0000664 0000000 0000000 00000002066 15070515525 0025563 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from litestar import Litestar, get
from litestar.datastructures import MutableScopeHeaders
if TYPE_CHECKING:
from typing import Dict
from litestar.types import Message, Scope
@get("/test", sync_to_thread=False)
def handler() -> Dict[str, str]:
"""Example Handler function."""
return {"key": "value"}
async def before_send_hook_handler(message: Message, scope: Scope) -> None:
"""The function will be called on each ASGI message.
We therefore ensure it runs only on the message start event.
"""
if message["type"] == "http.response.start":
headers = MutableScopeHeaders.from_message(message=message)
headers["My Header"] = Litestar.from_scope(scope).state.message
def on_startup(app: Litestar) -> None:
"""A function that will populate the app state before any requests are received."""
app.state.message = "value injected during send"
app = Litestar(route_handlers=[handler], on_startup=[on_startup], before_send=[before_send_hook_handler])
litestar-2.18.0/docs/examples/application_hooks/lifespan_manager.py 0000664 0000000 0000000 00000001076 15070515525 0025563 0 ustar 00root root 0000000 0000000 from contextlib import asynccontextmanager
from typing import AsyncGenerator
from sqlalchemy.ext.asyncio import create_async_engine
from litestar import Litestar
@asynccontextmanager
async def db_connection(app: Litestar) -> AsyncGenerator[None, None]:
engine = getattr(app.state, "engine", None)
if engine is None:
engine = create_async_engine("postgresql+asyncpg://postgres:mysecretpassword@pg.db:5432/db")
app.state.engine = engine
try:
yield
finally:
await engine.dispose()
app = Litestar(lifespan=[db_connection])
litestar-2.18.0/docs/examples/application_hooks/on_app_init.py 0000664 0000000 0000000 00000001225 15070515525 0024563 0 ustar 00root root 0000000 0000000 from typing import TYPE_CHECKING
from litestar import Litestar
if TYPE_CHECKING:
from litestar.config.app import AppConfig
async def close_db_connection() -> None:
"""Closes the database connection on application shutdown."""
def receive_app_config(app_config: "AppConfig") -> "AppConfig":
"""Receives parameters from the application.
In reality, this would be a library of boilerplate that is carried from one application to another, or a third-party
developed application configuration tool.
"""
app_config.on_shutdown.append(close_db_connection)
return app_config
app = Litestar([], on_app_init=[receive_app_config])
litestar-2.18.0/docs/examples/application_state/ 0000775 0000000 0000000 00000000000 15070515525 0021707 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/application_state/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024006 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/application_state/passing_initial_state.py 0000664 0000000 0000000 00000000432 15070515525 0026635 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, get
from litestar.datastructures import State
@get("/", sync_to_thread=False)
def handler(state: State) -> Dict[str, Any]:
return state.dict()
app = Litestar(route_handlers=[handler], state=State({"count": 100}))
litestar-2.18.0/docs/examples/application_state/using_application_state.py 0000664 0000000 0000000 00000002705 15070515525 0027175 0 ustar 00root root 0000000 0000000 import logging
from typing import TYPE_CHECKING, Any
from litestar import Litestar, Request, get
from litestar.datastructures import State
from litestar.di import Provide
if TYPE_CHECKING:
from litestar.types import ASGIApp, Receive, Scope, Send
logger = logging.getLogger(__name__)
def set_state_on_startup(app: Litestar) -> None:
"""Startup and shutdown hooks can receive `State` as a keyword arg."""
app.state.value = "abc123"
def middleware_factory(*, app: "ASGIApp") -> "ASGIApp":
"""A middleware can access application state via `scope`."""
async def my_middleware(scope: "Scope", receive: "Receive", send: "Send") -> None:
state = Litestar.from_scope(scope).state
logger.info("state value in middleware: %s", state.value)
await app(scope, receive, send)
return my_middleware
async def my_dependency(state: State) -> Any:
"""Dependencies can receive state via injection."""
logger.info("state value in dependency: %s", state.value)
@get("/", dependencies={"dep": Provide(my_dependency)}, middleware=[middleware_factory], sync_to_thread=False)
def get_handler(state: State, request: Request, dep: Any) -> None:
"""Handlers can receive state via injection."""
logger.info("state value in handler from `State`: %s", state.value)
logger.info("state value in handler from `Request`: %s", request.app.state.value)
app = Litestar(route_handlers=[get_handler], on_startup=[set_state_on_startup])
litestar-2.18.0/docs/examples/application_state/using_custom_state.py 0000664 0000000 0000000 00000000572 15070515525 0026204 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, get
from litestar.datastructures import State
class MyState(State):
count: int = 0
def increment(self) -> None:
self.count += 1
@get("/", sync_to_thread=False)
def handler(state: MyState) -> Dict[str, Any]:
state.increment()
return state.dict()
app = Litestar(route_handlers=[handler])
litestar-2.18.0/docs/examples/application_state/using_immutable_state.py 0000664 0000000 0000000 00000000507 15070515525 0026647 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, get
from litestar.datastructures import ImmutableState
@get("/", sync_to_thread=False)
def handler(state: ImmutableState) -> Dict[str, Any]:
setattr(state, "count", 1) # raises AttributeError
return state.dict()
app = Litestar(route_handlers=[handler])
litestar-2.18.0/docs/examples/caching/ 0000775 0000000 0000000 00000000000 15070515525 0017600 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/caching/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0021677 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/caching/cache.py 0000664 0000000 0000000 00000001050 15070515525 0021211 0 ustar 00root root 0000000 0000000 from litestar import Litestar, get
from litestar.config.response_cache import CACHE_FOREVER
@get("/cached", cache=True)
async def my_cached_handler() -> str:
return "cached"
@get("/cached-seconds", cache=120) # seconds
async def my_cached_handler_seconds() -> str:
return "cached for 120 seconds"
@get("/cached-forever", cache=CACHE_FOREVER)
async def my_cached_handler_forever() -> str:
return "cached forever"
app = Litestar(
[my_cached_handler, my_cached_handler_seconds, my_cached_handler_forever],
)
litestar-2.18.0/docs/examples/caching/cache_response_filter.py 0000664 0000000 0000000 00000000754 15070515525 0024506 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.config.response_cache import ResponseCacheConfig
from litestar.types import HTTPScope
def custom_cache_response_filter(_: HTTPScope, status_code: int) -> bool:
# Cache only 2xx responses
return 200 <= status_code < 300
response_cache_config = ResponseCacheConfig(cache_response_filter=custom_cache_response_filter)
# Create the app with a custom cache response filter
app = Litestar(
response_cache_config=response_cache_config,
)
litestar-2.18.0/docs/examples/caching/key_builder.py 0000664 0000000 0000000 00000000467 15070515525 0022457 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request
from litestar.config.response_cache import ResponseCacheConfig
def key_builder(request: Request) -> str:
return request.url.path + request.headers.get("my-header", "")
app = Litestar([], response_cache_config=ResponseCacheConfig(key_builder=key_builder))
litestar-2.18.0/docs/examples/caching/key_builder_for_route_handler.py 0000664 0000000 0000000 00000000504 15070515525 0026230 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request, get
def key_builder(request: Request) -> str:
return request.url.path + request.headers.get("my-header", "")
@get("/cached-path", cache=True, cache_key_builder=key_builder)
async def cached_handler() -> str:
return "cached"
app = Litestar([cached_handler])
litestar-2.18.0/docs/examples/caching/redis_store.py 0000664 0000000 0000000 00000001040 15070515525 0022467 0 ustar 00root root 0000000 0000000 import asyncio
from litestar import Litestar, get
from litestar.config.response_cache import ResponseCacheConfig
from litestar.stores.redis import RedisStore
@get(cache=10)
async def something() -> str:
await asyncio.sleep(1)
return "something"
redis_store = RedisStore.with_client(url="redis://localhost/", port=6379, db=0)
cache_config = ResponseCacheConfig(store="redis_backed_store")
app = Litestar(
[something],
stores={"redis_backed_store": redis_store},
response_cache_config=cache_config,
)
litestar-2.18.0/docs/examples/channels/ 0000775 0000000 0000000 00000000000 15070515525 0017777 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/channels/create_route_handlers.py 0000664 0000000 0000000 00000000504 15070515525 0024711 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.channels import ChannelsPlugin
from litestar.channels.backends.memory import MemoryChannelsBackend
channels_plugin = ChannelsPlugin(
backend=MemoryChannelsBackend(),
channels=["foo", "bar"],
create_ws_route_handlers=True,
)
app = Litestar(plugins=[channels_plugin])
litestar-2.18.0/docs/examples/channels/create_route_handlers_send_history.py 0000664 0000000 0000000 00000000742 15070515525 0027507 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.channels import ChannelsPlugin
from litestar.channels.backends.memory import MemoryChannelsBackend
channels_plugin = ChannelsPlugin(
backend=MemoryChannelsBackend(history=10), # set the amount of messages per channel
# to keep in the backend
channels=["foo", "bar"],
create_ws_route_handlers=True,
ws_handler_send_history=10, # send 10 entries of the history by default
)
app = Litestar(plugins=[channels_plugin])
litestar-2.18.0/docs/examples/channels/iter_stream.py 0000664 0000000 0000000 00000001055 15070515525 0022670 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket, websocket
from litestar.channels import ChannelsPlugin
from litestar.channels.backends.memory import MemoryChannelsBackend
@websocket("/ws")
async def handler(socket: WebSocket, channels: ChannelsPlugin) -> None:
await socket.accept()
async with channels.start_subscription(["some_channel"]) as subscriber:
async for message in subscriber.iter_events():
await socket.send_text(message)
app = Litestar(
[handler],
plugins=[ChannelsPlugin(backend=MemoryChannelsBackend())],
)
litestar-2.18.0/docs/examples/channels/put_history.py 0000664 0000000 0000000 00000001052 15070515525 0022740 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket, websocket
from litestar.channels import ChannelsPlugin
from litestar.channels.backends.memory import MemoryChannelsBackend
@websocket("/ws")
async def handler(socket: WebSocket, channels: ChannelsPlugin) -> None:
await socket.accept()
async with channels.start_subscription(["some_channel"]) as subscriber:
await channels.put_subscriber_history(subscriber, ["some_channel"], limit=10)
app = Litestar(
[handler],
plugins=[ChannelsPlugin(backend=MemoryChannelsBackend(history=20))],
)
litestar-2.18.0/docs/examples/channels/run_in_background.py 0000664 0000000 0000000 00000001227 15070515525 0024044 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket, websocket
from litestar.channels import ChannelsPlugin
from litestar.channels.backends.memory import MemoryChannelsBackend
@websocket("/ws")
async def handler(socket: WebSocket, channels: ChannelsPlugin) -> None:
await socket.accept()
async with channels.start_subscription(["some_channel"]) as subscriber, subscriber.run_in_background(
socket.send_text
):
while True:
response = await socket.receive_text()
await socket.send_text(response)
app = Litestar(
[handler],
plugins=[ChannelsPlugin(backend=MemoryChannelsBackend(), channels=["some_channel"])],
)
litestar-2.18.0/docs/examples/contrib/ 0000775 0000000 0000000 00000000000 15070515525 0017644 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0021743 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/piccolo/ 0000775 0000000 0000000 00000000000 15070515525 0021274 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/piccolo/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023373 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/piccolo/app.py 0000664 0000000 0000000 00000003573 15070515525 0022436 0 ustar 00root root 0000000 0000000 from typing import List
from piccolo.columns import Boolean, Varchar
from piccolo.table import Table, create_db_tables
from litestar import Litestar, MediaType, delete, get, patch, post
from litestar.contrib.piccolo import PiccoloDTO
from litestar.dto import DTOConfig, DTOData
from litestar.exceptions import NotFoundException
from .piccolo_conf import DB
class Task(Table, db=DB):
"""
An example table.
"""
name = Varchar()
completed = Boolean(default=False)
class PatchDTO(PiccoloDTO[Task]):
"""Allow partial updates."""
config = DTOConfig(exclude={"id"}, partial=True)
@get(
"/tasks",
return_dto=PiccoloDTO[Task],
media_type=MediaType.JSON,
tags=["Task"],
)
async def tasks() -> List[Task]:
return await Task.select().order_by(Task.id, ascending=False)
@post(
"/tasks",
dto=PiccoloDTO[Task],
return_dto=PiccoloDTO[Task],
media_type=MediaType.JSON,
tags=["Task"],
)
async def create_task(data: Task) -> Task:
await data.save()
await data.refresh()
return data
@patch(
"/tasks/{task_id:int}",
dto=PatchDTO,
return_dto=PiccoloDTO[Task],
media_type=MediaType.JSON,
tags=["Task"],
)
async def update_task(task_id: int, data: DTOData[Task]) -> Task:
task = await Task.objects().get(Task.id == task_id)
if not task:
raise NotFoundException("Task does not exist")
result = data.update_instance(task)
await result.save()
return result
@delete("/tasks/{task_id:int}", tags=["Task"])
async def delete_task(task_id: int) -> None:
task = await Task.objects().get(Task.id == task_id)
if not task:
raise NotFoundException("Task does not exist")
await task.remove()
async def on_startup():
await create_db_tables(Task, if_not_exists=True)
app = Litestar(route_handlers=[tasks, create_task, delete_task, update_task], on_startup=[on_startup], debug=True)
litestar-2.18.0/docs/examples/contrib/piccolo/piccolo_conf.py 0000664 0000000 0000000 00000000104 15070515525 0024276 0 ustar 00root root 0000000 0000000 from piccolo.engine.sqlite import SQLiteEngine
DB = SQLiteEngine()
litestar-2.18.0/docs/examples/contrib/sqlalchemy/ 0000775 0000000 0000000 00000000000 15070515525 0022006 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024105 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/ 0000775 0000000 0000000 00000000000 15070515525 0023467 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0025566 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_before_send_handler.py 0000664 0000000 0000000 00000000701 15070515525 0033426 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from litestar import Litestar
from litestar.plugins.sqlalchemy import (
SQLAlchemyAsyncConfig,
SQLAlchemyInitPlugin,
async_autocommit_before_send_handler,
)
config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///:memory:", before_send_handler=async_autocommit_before_send_handler
)
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_dependencies.py 0000664 0000000 0000000 00000001443 15070515525 0032110 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import select
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyInitPlugin
if TYPE_CHECKING:
from typing import Tuple
from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession
@post("/")
async def handler(db_session: AsyncSession, db_engine: AsyncEngine) -> Tuple[int, int]:
one = (await db_session.execute(select(1))).scalar()
async with db_engine.begin() as conn:
two = (await conn.execute(select(2))).scalar()
return one, two
config = SQLAlchemyAsyncConfig(connection_string="sqlite+aiosqlite:///async.sqlite")
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[handler], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_init_plugin_example.py 0000664 0000000 0000000 00000002467 15070515525 0033525 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyInitPlugin
if TYPE_CHECKING:
from typing import Any, Dict, List
from sqlalchemy.ext.asyncio import AsyncSession
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/")
async def add_item(data: Dict[str, Any], db_session: AsyncSession) -> List[Dict[str, Any]]:
todo_item = TodoItem(**data)
async with db_session.begin():
db_session.add(todo_item)
return [
{
"title": item.title,
"done": item.done,
}
for item in (await db_session.execute(select(TodoItem))).scalars()
]
async def init_db(app: Litestar) -> None:
async with config.get_engine().begin() as conn:
await conn.run_sync(Base.metadata.create_all)
config = SQLAlchemyAsyncConfig(connection_string="sqlite+aiosqlite:///todo_async.sqlite")
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[add_item], plugins=[plugin], on_startup=[init_db], debug=True)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_plugin_example.py 0000664 0000000 0000000 00000001760 15070515525 0032475 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING, Sequence
from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyPlugin
if TYPE_CHECKING:
from sqlalchemy.ext.asyncio import AsyncSession
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/")
async def add_item(data: TodoItem, db_session: AsyncSession) -> Sequence[TodoItem]:
async with db_session.begin():
db_session.add(data)
return (await db_session.execute(select(TodoItem))).scalars().all()
config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///todo_async.sqlite", create_all=True, metadata=Base.metadata
)
plugin = SQLAlchemyPlugin(config=config)
app = Litestar(route_handlers=[add_item], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_serialization_dto.py 0000664 0000000 0000000 00000001133 15070515525 0033201 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
if TYPE_CHECKING:
from typing import List
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/", dto=SQLAlchemyDTO[TodoItem])
async def add_item(data: TodoItem) -> List[TodoItem]:
return [data]
app = Litestar(route_handlers=[add_item])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_async_serialization_plugin.py 0000664 0000000 0000000 00000001171 15070515525 0033713 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemySerializationPlugin
if TYPE_CHECKING:
from typing import List
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/")
async def add_item(data: TodoItem) -> List[TodoItem]:
return [data]
app = Litestar(route_handlers=[add_item], plugins=[SQLAlchemySerializationPlugin()])
sqlalchemy_async_serialization_plugin_marking_fields.py 0000664 0000000 0000000 00000001434 15070515525 0036674 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.dto import dto_field
from litestar.plugins.sqlalchemy import SQLAlchemySerializationPlugin
if TYPE_CHECKING:
from typing import List
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
super_secret_value: Mapped[str] = mapped_column(info=dto_field("private"))
@post("/")
async def add_item(data: TodoItem) -> List[TodoItem]:
data.super_secret_value = "This is a secret"
return [data]
app = Litestar(route_handlers=[add_item], plugins=[SQLAlchemySerializationPlugin()])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_sync_before_send_handler.py 0000664 0000000 0000000 00000000647 15070515525 0033276 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from litestar import Litestar
from litestar.plugins.sqlalchemy import SQLAlchemyInitPlugin, SQLAlchemySyncConfig, sync_autocommit_before_send_handler
config = SQLAlchemySyncConfig(
connection_string="sqlite:///:memory:",
before_send_handler=sync_autocommit_before_send_handler,
)
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_sync_dependencies.py 0000664 0000000 0000000 00000001415 15070515525 0031746 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import select
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyInitPlugin, SQLAlchemySyncConfig
if TYPE_CHECKING:
from typing import Tuple
from sqlalchemy import Engine
from sqlalchemy.orm import Session
@post("/", sync_to_thread=True)
def handler(db_session: Session, db_engine: Engine) -> Tuple[int, int]:
one = db_session.execute(select(1)).scalar()
with db_engine.begin() as conn:
two = conn.execute(select(2)).scalar()
return one, two
config = SQLAlchemySyncConfig(connection_string="sqlite:///sync.sqlite")
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[handler], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_sync_init_plugin_example.py 0000664 0000000 0000000 00000002362 15070515525 0033356 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyInitPlugin, SQLAlchemySyncConfig
if TYPE_CHECKING:
from typing import Any, Dict, List
from sqlalchemy.orm import Session
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/", sync_to_thread=True)
def add_item(data: Dict[str, Any], db_session: Session) -> List[Dict[str, Any]]:
todo_item = TodoItem(**data)
with db_session.begin():
db_session.add(todo_item)
return [
{
"title": item.title,
"done": item.done,
}
for item in db_session.execute(select(TodoItem)).scalars()
]
def init_db(app: Litestar) -> None:
with config.get_engine().begin() as conn:
Base.metadata.create_all(conn)
config = SQLAlchemySyncConfig(connection_string="sqlite:///todo_sync.sqlite")
plugin = SQLAlchemyInitPlugin(config=config)
app = Litestar(route_handlers=[add_item], plugins=[plugin], on_startup=[init_db])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_sync_plugin_example.py 0000664 0000000 0000000 00000001714 15070515525 0032333 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING, Sequence
from sqlalchemy import select
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyPlugin, SQLAlchemySyncConfig
if TYPE_CHECKING:
from sqlalchemy.orm import Session
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/", sync_to_thread=True)
def add_item(data: TodoItem, db_session: Session) -> Sequence[TodoItem]:
with db_session.begin():
db_session.add(data)
return db_session.execute(select(TodoItem)).scalars().all()
config = SQLAlchemySyncConfig(connection_string="sqlite:///todo_sync.sqlite", create_all=True, metadata=Base.metadata)
plugin = SQLAlchemyPlugin(config=config)
app = Litestar(route_handlers=[add_item], plugins=[plugin])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/sqlalchemy_sync_serialization_plugin.py 0000664 0000000 0000000 00000001211 15070515525 0033545 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemySerializationPlugin
if TYPE_CHECKING:
from typing import List
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@post("/", sync_to_thread=False)
def add_item(data: TodoItem) -> List[TodoItem]:
return [data]
app = Litestar(route_handlers=[add_item], plugins=[SQLAlchemySerializationPlugin()])
sqlalchemy_sync_serialization_plugin_marking_fields.py 0000664 0000000 0000000 00000001454 15070515525 0036535 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, post
from litestar.dto import dto_field
from litestar.plugins.sqlalchemy import SQLAlchemySerializationPlugin
if TYPE_CHECKING:
from typing import List
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_item"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
super_secret_value: Mapped[str] = mapped_column(info=dto_field("private"))
@post("/", sync_to_thread=False)
def add_item(data: TodoItem) -> List[TodoItem]:
data.super_secret_value = "This is a secret"
return [data]
app = Litestar(route_handlers=[add_item], plugins=[SQLAlchemySerializationPlugin()])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/ 0000775 0000000 0000000 00000000000 15070515525 0025332 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0027431 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/full_app_no_plugins.py 0000664 0000000 0000000 00000006252 15070515525 0031750 0 ustar 00root root 0000000 0000000 from contextlib import asynccontextmanager
from typing import Any, AsyncGenerator, Dict, List, Optional, Sequence
from sqlalchemy import select
from sqlalchemy.exc import IntegrityError, NoResultFound
from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, get, post, put
from litestar.datastructures import State
from litestar.exceptions import ClientException, NotFoundException
from litestar.status_codes import HTTP_409_CONFLICT
TodoType = Dict[str, Any]
TodoCollectionType = List[TodoType]
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_items"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@asynccontextmanager
async def db_connection(app: Litestar) -> AsyncGenerator[None, None]:
engine = getattr(app.state, "engine", None)
if engine is None:
engine = create_async_engine("sqlite+aiosqlite:///todo.sqlite", echo=True)
app.state.engine = engine
async with engine.begin() as conn:
await conn.run_sync(Base.metadata.create_all)
try:
yield
finally:
await engine.dispose()
sessionmaker = async_sessionmaker(expire_on_commit=False)
def serialize_todo(todo: TodoItem) -> TodoType:
return {"title": todo.title, "done": todo.done}
async def get_todo_by_title(todo_name: str, session: AsyncSession) -> TodoItem:
query = select(TodoItem).where(TodoItem.title == todo_name)
result = await session.execute(query)
try:
return result.scalar_one()
except NoResultFound as e:
raise NotFoundException(detail=f"TODO {todo_name!r} not found") from e
async def get_todo_list(done: Optional[bool], session: AsyncSession) -> Sequence[TodoItem]:
query = select(TodoItem)
if done is not None:
query = query.where(TodoItem.done.is_(done))
result = await session.execute(query)
return result.scalars().all()
@get("/")
async def get_list(state: State, done: Optional[bool] = None) -> TodoCollectionType:
async with sessionmaker(bind=state.engine) as session:
return [serialize_todo(todo) for todo in await get_todo_list(done, session)]
@post("/")
async def add_item(data: TodoType, state: State) -> TodoType:
new_todo = TodoItem(title=data["title"], done=data["done"])
async with sessionmaker(bind=state.engine) as session:
try:
async with session.begin():
session.add(new_todo)
except IntegrityError as e:
raise ClientException(
status_code=HTTP_409_CONFLICT,
detail=f"TODO {new_todo.title!r} already exists",
) from e
return serialize_todo(new_todo)
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoType, state: State) -> TodoType:
async with sessionmaker(bind=state.engine) as session, session.begin():
todo_item = await get_todo_by_title(item_title, session)
todo_item.title = data["title"]
todo_item.done = data["done"]
return serialize_todo(todo_item)
app = Litestar([get_list, add_item, update_item], lifespan=[db_connection])
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/full_app_with_init_plugin.py 0000664 0000000 0000000 00000005032 15070515525 0033142 0 ustar 00root root 0000000 0000000 from typing import AsyncGenerator, List, Optional
from sqlalchemy import select
from sqlalchemy.exc import IntegrityError, NoResultFound
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, get, post, put
from litestar.exceptions import ClientException, NotFoundException
from litestar.plugins.sqlalchemy import (
SQLAlchemyAsyncConfig,
SQLAlchemyInitPlugin,
SQLAlchemySerializationPlugin,
)
from litestar.status_codes import HTTP_409_CONFLICT
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_items"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
async def provide_transaction(db_session: AsyncSession) -> AsyncGenerator[AsyncSession, None]:
try:
async with db_session.begin():
yield db_session
except IntegrityError as exc:
raise ClientException(
status_code=HTTP_409_CONFLICT,
detail=str(exc),
) from exc
async def get_todo_by_title(todo_name: str, session: AsyncSession) -> TodoItem:
query = select(TodoItem).where(TodoItem.title == todo_name)
result = await session.execute(query)
try:
return result.scalar_one()
except NoResultFound as e:
raise NotFoundException(detail=f"TODO {todo_name!r} not found") from e
async def get_todo_list(done: Optional[bool], session: AsyncSession) -> List[TodoItem]:
query = select(TodoItem)
if done is not None:
query = query.where(TodoItem.done.is_(done))
result = await session.execute(query)
return list(result.scalars().all())
@get("/")
async def get_list(transaction: AsyncSession, done: Optional[bool] = None) -> List[TodoItem]:
return await get_todo_list(done, transaction)
@post("/")
async def add_item(data: TodoItem, transaction: AsyncSession) -> TodoItem:
transaction.add(data)
return data
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoItem, transaction: AsyncSession) -> TodoItem:
todo_item = await get_todo_by_title(item_title, transaction)
todo_item.title = data.title
todo_item.done = data.done
return todo_item
db_config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///todo.sqlite", metadata=Base.metadata, create_all=True
)
app = Litestar(
[get_list, add_item, update_item],
dependencies={"transaction": provide_transaction},
plugins=[
SQLAlchemySerializationPlugin(),
SQLAlchemyInitPlugin(db_config),
],
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/full_app_with_plugin.py 0000664 0000000 0000000 00000004731 15070515525 0032124 0 ustar 00root root 0000000 0000000 from typing import AsyncGenerator, List, Optional
from sqlalchemy import select
from sqlalchemy.exc import IntegrityError, NoResultFound
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, get, post, put
from litestar.exceptions import ClientException, NotFoundException
from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyPlugin
from litestar.status_codes import HTTP_409_CONFLICT
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_items"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
async def provide_transaction(db_session: AsyncSession) -> AsyncGenerator[AsyncSession, None]:
try:
async with db_session.begin():
yield db_session
except IntegrityError as exc:
raise ClientException(
status_code=HTTP_409_CONFLICT,
detail=str(exc),
) from exc
async def get_todo_by_title(todo_name: str, session: AsyncSession) -> TodoItem:
query = select(TodoItem).where(TodoItem.title == todo_name)
result = await session.execute(query)
try:
return result.scalar_one()
except NoResultFound as e:
raise NotFoundException(detail=f"TODO {todo_name!r} not found") from e
async def get_todo_list(done: Optional[bool], session: AsyncSession) -> List[TodoItem]:
query = select(TodoItem)
if done is not None:
query = query.where(TodoItem.done.is_(done))
result = await session.execute(query)
return list(result.scalars().all())
@get("/")
async def get_list(transaction: AsyncSession, done: Optional[bool] = None) -> List[TodoItem]:
return await get_todo_list(done, transaction)
@post("/")
async def add_item(data: TodoItem, transaction: AsyncSession) -> TodoItem:
transaction.add(data)
return data
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoItem, transaction: AsyncSession) -> TodoItem:
todo_item = await get_todo_by_title(item_title, transaction)
todo_item.title = data.title
todo_item.done = data.done
return todo_item
db_config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///todo.sqlite",
metadata=Base.metadata,
create_all=True,
before_send_handler="autocommit",
)
app = Litestar(
[get_list, add_item, update_item],
dependencies={"transaction": provide_transaction},
plugins=[SQLAlchemyPlugin(db_config)],
)
full_app_with_serialization_plugin.py 0000664 0000000 0000000 00000005771 15070515525 0035007 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial from contextlib import asynccontextmanager
from typing import AsyncGenerator, List, Optional
from sqlalchemy import select
from sqlalchemy.exc import IntegrityError, NoResultFound
from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, get, post, put
from litestar.datastructures import State
from litestar.exceptions import ClientException, NotFoundException
from litestar.plugins.sqlalchemy import SQLAlchemySerializationPlugin
from litestar.status_codes import HTTP_409_CONFLICT
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_items"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@asynccontextmanager
async def db_connection(app: Litestar) -> AsyncGenerator[None, None]:
engine = getattr(app.state, "engine", None)
if engine is None:
engine = create_async_engine("sqlite+aiosqlite:///todo.sqlite", echo=True)
app.state.engine = engine
async with engine.begin() as conn:
await conn.run_sync(Base.metadata.create_all)
try:
yield
finally:
await engine.dispose()
sessionmaker = async_sessionmaker(expire_on_commit=False)
async def provide_transaction(state: State) -> AsyncGenerator[AsyncSession, None]:
async with sessionmaker(bind=state.engine) as session:
try:
async with session.begin():
yield session
except IntegrityError as exc:
raise ClientException(
status_code=HTTP_409_CONFLICT,
detail=str(exc),
) from exc
async def get_todo_by_title(todo_name: str, session: AsyncSession) -> TodoItem:
query = select(TodoItem).where(TodoItem.title == todo_name)
result = await session.execute(query)
try:
return result.scalar_one()
except NoResultFound as e:
raise NotFoundException(detail=f"TODO {todo_name!r} not found") from e
async def get_todo_list(done: Optional[bool], session: AsyncSession) -> List[TodoItem]:
query = select(TodoItem)
if done is not None:
query = query.where(TodoItem.done.is_(done))
result = await session.execute(query)
return list(result.scalars().all())
@get("/")
async def get_list(transaction: AsyncSession, done: Optional[bool] = None) -> List[TodoItem]:
return await get_todo_list(done, transaction)
@post("/")
async def add_item(data: TodoItem, transaction: AsyncSession) -> TodoItem:
transaction.add(data)
return data
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoItem, transaction: AsyncSession) -> TodoItem:
todo_item = await get_todo_by_title(item_title, transaction)
todo_item.title = data.title
todo_item.done = data.done
return todo_item
app = Litestar(
[get_list, add_item, update_item],
dependencies={"transaction": provide_transaction},
lifespan=[db_connection],
plugins=[SQLAlchemySerializationPlugin()],
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/plugins/tutorial/full_app_with_session_di.py 0000664 0000000 0000000 00000006263 15070515525 0032767 0 ustar 00root root 0000000 0000000 from contextlib import asynccontextmanager
from typing import Any, AsyncGenerator, Dict, List, Optional
from sqlalchemy import select
from sqlalchemy.exc import IntegrityError, NoResultFound
from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from litestar import Litestar, get, post, put
from litestar.datastructures import State
from litestar.exceptions import ClientException, NotFoundException
from litestar.status_codes import HTTP_409_CONFLICT
TodoType = Dict[str, Any]
TodoCollectionType = List[TodoType]
class Base(DeclarativeBase): ...
class TodoItem(Base):
__tablename__ = "todo_items"
title: Mapped[str] = mapped_column(primary_key=True)
done: Mapped[bool]
@asynccontextmanager
async def db_connection(app: Litestar) -> AsyncGenerator[None, None]:
engine = getattr(app.state, "engine", None)
if engine is None:
engine = create_async_engine("sqlite+aiosqlite:///todo.sqlite")
app.state.engine = engine
async with engine.begin() as conn:
await conn.run_sync(Base.metadata.create_all)
try:
yield
finally:
await engine.dispose()
sessionmaker = async_sessionmaker(expire_on_commit=False)
async def provide_transaction(state: State) -> AsyncGenerator[AsyncSession, None]:
async with sessionmaker(bind=state.engine) as session:
try:
async with session.begin():
yield session
except IntegrityError as exc:
raise ClientException(
status_code=HTTP_409_CONFLICT,
detail=str(exc),
) from exc
def serialize_todo(todo: TodoItem) -> TodoType:
return {"title": todo.title, "done": todo.done}
async def get_todo_by_title(todo_name, session: AsyncSession) -> TodoItem:
query = select(TodoItem).where(TodoItem.title == todo_name)
result = await session.execute(query)
try:
return result.scalar_one()
except NoResultFound as e:
raise NotFoundException(detail=f"TODO {todo_name!r} not found") from e
async def get_todo_list(done: Optional[bool], session: AsyncSession) -> List[TodoItem]:
query = select(TodoItem)
if done is not None:
query = query.where(TodoItem.done.is_(done))
result = await session.execute(query)
return result.scalars().all()
@get("/")
async def get_list(transaction: AsyncSession, done: Optional[bool] = None) -> TodoCollectionType:
return [serialize_todo(todo) for todo in await get_todo_list(done, transaction)]
@post("/")
async def add_item(data: TodoType, transaction: AsyncSession) -> TodoType:
new_todo = TodoItem(title=data["title"], done=data["done"])
transaction.add(new_todo)
return serialize_todo(new_todo)
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoType, transaction: AsyncSession) -> TodoType:
todo_item = await get_todo_by_title(item_title, transaction)
todo_item.title = data["title"]
todo_item.done = data["done"]
return serialize_todo(todo_item)
app = Litestar(
[get_list, add_item, update_item],
dependencies={"transaction": provide_transaction},
lifespan=[db_connection],
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_async_repository.py 0000664 0000000 0000000 00000015731 15070515525 0030225 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from datetime import date
from typing import TYPE_CHECKING
from uuid import UUID
from pydantic import BaseModel as _BaseModel
from pydantic import TypeAdapter
from sqlalchemy import ForeignKey, select
from sqlalchemy.orm import Mapped, mapped_column, relationship, selectinload
from litestar import Litestar, get
from litestar.controller import Controller
from litestar.di import Provide
from litestar.handlers.http_handlers.decorators import delete, patch, post
from litestar.pagination import OffsetPagination
from litestar.params import Parameter
from litestar.plugins.sqlalchemy import (
AsyncSessionConfig,
SQLAlchemyAsyncConfig,
SQLAlchemyInitPlugin,
base,
filters,
repository,
)
if TYPE_CHECKING:
from sqlalchemy.ext.asyncio import AsyncSession
class BaseModel(_BaseModel):
"""Extend Pydantic's BaseModel to enable ORM mode"""
model_config = {"from_attributes": True}
# The SQLAlchemy base includes a declarative model for you to use in your models.
# The `UUIDBase` class includes a `UUID` based primary key (`id`)
class AuthorModel(base.UUIDBase):
# we can optionally provide the table name instead of auto-generating it
__tablename__ = "author" # type: ignore[assignment]
name: Mapped[str]
dob: Mapped[date | None]
books: Mapped[list[BookModel]] = relationship(back_populates="author", lazy="noload")
# The `UUIDAuditBase` class includes the same UUID` based primary key (`id`) and 2
# additional columns: `created_at` and `updated_at`. `created_at` is a timestamp of when the
# record created, and `updated_at` is the last time the record was modified.
class BookModel(base.UUIDAuditBase):
__tablename__ = "book" # type: ignore[assignment]
title: Mapped[str]
author_id: Mapped[UUID] = mapped_column(ForeignKey("author.id"))
author: Mapped[AuthorModel] = relationship(lazy="joined", innerjoin=True, viewonly=True)
# we will explicitly define the schema instead of using DTO objects for clarity.
class Author(BaseModel):
id: UUID | None
name: str
dob: date | None = None
class AuthorCreate(BaseModel):
name: str
dob: date | None = None
class AuthorUpdate(BaseModel):
name: str | None = None
dob: date | None = None
class AuthorRepository(repository.SQLAlchemyAsyncRepository[AuthorModel]):
"""Author repository."""
model_type = AuthorModel
async def provide_authors_repo(db_session: AsyncSession) -> AuthorRepository:
"""This provides the default Authors repository."""
return AuthorRepository(session=db_session)
# we can optionally override the default `select` used for the repository to pass in
# specific SQL options such as join details
async def provide_author_details_repo(db_session: AsyncSession) -> AuthorRepository:
"""This provides a simple example demonstrating how to override the join options for the repository."""
return AuthorRepository(
statement=select(AuthorModel).options(selectinload(AuthorModel.books)),
session=db_session,
)
def provide_limit_offset_pagination(
current_page: int = Parameter(ge=1, query="currentPage", default=1, required=False),
page_size: int = Parameter(
query="pageSize",
ge=1,
default=10,
required=False,
),
) -> filters.LimitOffset:
"""Add offset/limit pagination.
Return type consumed by `Repository.apply_limit_offset_pagination()`.
Parameters
----------
current_page : int
LIMIT to apply to select.
page_size : int
OFFSET to apply to select.
"""
return filters.LimitOffset(page_size, page_size * (current_page - 1))
class AuthorController(Controller):
"""Author CRUD"""
dependencies = {"authors_repo": Provide(provide_authors_repo)}
@get(path="/authors")
async def list_authors(
self,
authors_repo: AuthorRepository,
limit_offset: filters.LimitOffset,
) -> OffsetPagination[Author]:
"""List authors."""
results, total = await authors_repo.list_and_count(limit_offset)
type_adapter = TypeAdapter(list[Author])
return OffsetPagination[Author](
items=type_adapter.validate_python(results),
total=total,
limit=limit_offset.limit,
offset=limit_offset.offset,
)
@post(path="/authors")
async def create_author(
self,
authors_repo: AuthorRepository,
data: AuthorCreate,
) -> Author:
"""Create a new author."""
obj = await authors_repo.add(
AuthorModel(**data.model_dump(exclude_unset=True, exclude_none=True)),
)
await authors_repo.session.commit()
return Author.model_validate(obj)
# we override the authors_repo to use the version that joins the Books in
@get(path="/authors/{author_id:uuid}", dependencies={"authors_repo": Provide(provide_author_details_repo)})
async def get_author(
self,
authors_repo: AuthorRepository,
author_id: UUID = Parameter(
title="Author ID",
description="The author to retrieve.",
),
) -> Author:
"""Get an existing author."""
obj = await authors_repo.get(author_id)
return Author.model_validate(obj)
@patch(
path="/authors/{author_id:uuid}",
dependencies={"authors_repo": Provide(provide_author_details_repo)},
)
async def update_author(
self,
authors_repo: AuthorRepository,
data: AuthorUpdate,
author_id: UUID = Parameter(
title="Author ID",
description="The author to update.",
),
) -> Author:
"""Update an author."""
raw_obj = data.model_dump(exclude_unset=True, exclude_none=True)
raw_obj.update({"id": author_id})
obj = await authors_repo.update(AuthorModel(**raw_obj))
await authors_repo.session.commit()
return Author.from_orm(obj)
@delete(path="/authors/{author_id:uuid}")
async def delete_author(
self,
authors_repo: AuthorRepository,
author_id: UUID = Parameter(
title="Author ID",
description="The author to delete.",
),
) -> None:
"""Delete a author from the system."""
_ = await authors_repo.delete(author_id)
await authors_repo.session.commit()
session_config = AsyncSessionConfig(expire_on_commit=False)
sqlalchemy_config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///test.sqlite", session_config=session_config
) # Create 'db_session' dependency.
sqlalchemy_plugin = SQLAlchemyInitPlugin(config=sqlalchemy_config)
async def on_startup() -> None:
"""Initializes the database."""
async with sqlalchemy_config.get_engine().begin() as conn:
await conn.run_sync(base.UUIDBase.metadata.create_all)
app = Litestar(
route_handlers=[AuthorController],
on_startup=[on_startup],
plugins=[SQLAlchemyInitPlugin(config=sqlalchemy_config)],
dependencies={"limit_offset": Provide(provide_limit_offset_pagination)},
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_declarative_models.py 0000664 0000000 0000000 00000004572 15070515525 0030440 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import uuid
from datetime import date
from typing import List
from uuid import UUID
from sqlalchemy import ForeignKey, func, select
from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession
from sqlalchemy.orm import Mapped, mapped_column, relationship
from litestar import Litestar, get
from litestar.plugins.sqlalchemy import AsyncSessionConfig, SQLAlchemyAsyncConfig, SQLAlchemyPlugin, base
# The SQLAlchemy base includes a declarative model for you to use in your models.
# The `UUIDBase` class includes a `UUID` based primary key (`id`)
class Author(base.UUIDBase):
__tablename__ = "author"
name: Mapped[str]
dob: Mapped[date]
books: Mapped[List[Book]] = relationship(back_populates="author", lazy="selectin")
# The `UUIDAuditBase` class includes the same UUID` based primary key (`id`) and 2
# additional columns: `created_at` and `updated_at`. `created_at` is a timestamp of when the
# record created, and `updated_at` is the last time the record was modified.
class Book(base.UUIDAuditBase):
__tablename__ = "book"
title: Mapped[str]
author_id: Mapped[UUID] = mapped_column(ForeignKey("author.id"))
author: Mapped[Author] = relationship(lazy="joined", innerjoin=True, viewonly=True)
session_config = AsyncSessionConfig(expire_on_commit=False)
sqlalchemy_config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///test.sqlite", session_config=session_config, create_all=True
) # Create 'async_session' dependency.
async def on_startup(app: Litestar) -> None:
"""Adds some dummy data if no data is present."""
async with sqlalchemy_config.get_session() as session:
statement = select(func.count()).select_from(Author)
count = await session.execute(statement)
if not count.scalar():
author_id = uuid.uuid4()
session.add(Author(name="Stephen King", dob=date(1954, 9, 21), id=author_id))
session.add(Book(title="It", author_id=author_id))
await session.commit()
@get(path="/authors")
async def get_authors(db_session: AsyncSession, db_engine: AsyncEngine) -> List[Author]:
"""Interact with SQLAlchemy engine and session."""
return list(await db_session.scalars(select(Author)))
app = Litestar(
route_handlers=[get_authors],
on_startup=[on_startup],
debug=True,
plugins=[SQLAlchemyPlugin(config=sqlalchemy_config)],
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_repository_bulk_operations.py 0000664 0000000 0000000 00000005364 15070515525 0032311 0 ustar 00root root 0000000 0000000 import json
from pathlib import Path
from typing import Any
from rich import get_console
from sqlalchemy import create_engine
from sqlalchemy.orm import Mapped, Session, sessionmaker
from litestar.plugins.sqlalchemy import base, repository
from litestar.repository.filters import LimitOffset
here = Path(__file__).parent
console = get_console()
class USState(base.UUIDBase):
# you can optionally override the generated table name by manually setting it.
__tablename__ = "us_state_lookup" # type: ignore[assignment]
abbreviation: Mapped[str]
name: Mapped[str]
class USStateRepository(repository.SQLAlchemySyncRepository[USState]):
"""US State repository."""
model_type = USState
engine = create_engine(
"duckdb:///:memory:",
future=True,
)
session_factory: sessionmaker[Session] = sessionmaker(engine, expire_on_commit=False)
def open_fixture(fixtures_path: Path, fixture_name: str) -> Any:
"""Loads JSON file with the specified fixture name
Args:
fixtures_path (Path): The path to look for fixtures
fixture_name (str): The fixture name to load.
Raises:
FileNotFoundError: Fixtures not found.
Returns:
Any: The parsed JSON data
"""
fixture = Path(fixtures_path / f"{fixture_name}.json")
if fixture.exists():
with fixture.open(mode="r", encoding="utf-8") as f:
f_data = f.read()
return json.loads(f_data)
raise FileNotFoundError(f"Could not find the {fixture_name} fixture")
def run_script() -> None:
"""Load data from a fixture."""
# Initializes the database.
with engine.begin() as conn:
USState.metadata.create_all(conn)
with session_factory() as db_session:
# 1) Load the JSON data into the US States table.
repo = USStateRepository(session=db_session)
fixture = open_fixture(here, USStateRepository.model_type.__tablename__) # type: ignore
objs = repo.add_many([USStateRepository.model_type(**raw_obj) for raw_obj in fixture])
db_session.commit()
console.print(f"Created {len(objs)} new objects.")
# 2) Select paginated data and total row count.
created_objs, total_objs = repo.list_and_count(LimitOffset(limit=10, offset=0))
console.print(f"Selected {len(created_objs)} records out of a total of {total_objs}.")
# 3) Let's remove the batch of records selected.
deleted_objs = repo.delete_many([new_obj.id for new_obj in created_objs])
console.print(f"Removed {len(deleted_objs)} records out of a total of {total_objs}.")
# 4) Let's count the remaining rows
remaining_count = repo.count()
console.print(f"Found {remaining_count} remaining records after delete.")
if __name__ == "__main__":
run_script()
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_repository_crud.py 0000664 0000000 0000000 00000006533 15070515525 0030045 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from contextlib import asynccontextmanager
from datetime import date, datetime
from typing import AsyncIterator
from uuid import UUID
import anyio
from rich import get_console
from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
from sqlalchemy.orm import Mapped
from litestar.plugins.sqlalchemy import base, repository
console = get_console()
# the SQLAlchemy base includes a declarative model for you to use in your models.
# The `Base` class includes a `UUID` based primary key (`id`)
class Author(base.UUIDBase):
name: Mapped[str]
dob: Mapped[date]
dod: Mapped[date | None]
class AuthorRepository(repository.SQLAlchemyAsyncRepository[Author]):
"""Author repository."""
model_type = Author
engine = create_async_engine(
"sqlite+aiosqlite:///test.sqlite",
future=True,
)
session_factory = async_sessionmaker(engine, expire_on_commit=False)
# let's make a simple context manager as an example here.
@asynccontextmanager
async def repository_factory() -> AsyncIterator[AuthorRepository]:
async with session_factory() as db_session:
try:
yield AuthorRepository(session=db_session)
except Exception: # noqa: BLE001
await db_session.rollback()
else:
await db_session.commit()
async def create_author() -> Author:
async with repository_factory() as repo:
obj = await repo.add(
Author(
name="F. Scott Fitzgerald",
dob=datetime.strptime("1896-09-24", "%Y-%m-%d").date(),
)
)
console.print(f"Created Author record for {obj.name} with primary key {obj.id}.")
return obj
async def update_author(obj: Author) -> Author:
async with repository_factory() as repo:
obj = await repo.update(obj)
console.print(f"Updated Author record for {obj.name} with primary key {obj.id}.")
return obj
async def remove_author(id: UUID) -> Author:
async with repository_factory() as repo:
obj = await repo.delete(id)
console.print(f"Deleted Author record for {obj.name} with primary key {obj.id}.")
return obj
async def get_author_if_exists(id: UUID) -> Author | None:
async with repository_factory() as repo:
obj = await repo.get_one_or_none(id=id)
if obj is not None:
console.print(f"Found Author record for {obj.name} with primary key {obj.id}.")
else:
console.print(f"Could not find Author with primary key {id}.")
return obj
async def run_script() -> None:
"""Load data from a fixture."""
async with engine.begin() as conn:
await conn.run_sync(base.UUIDBase.metadata.create_all)
# 1) create a new Author record.
console.print("1) Adding a new record")
author = await create_author()
author_id = author.id
# 2) Let's update the Author record.
console.print("2) Updating a record.")
author.dod = datetime.strptime("1940-12-21", "%Y-%m-%d").date()
await update_author(author)
# 3) Let's delete the record we just created.
console.print("3) Removing a record.")
await remove_author(author_id)
# 4) Let's verify the record no longer exists.
console.print("4) Select one or none.")
_should_be_none = await get_author_if_exists(author_id)
if __name__ == "__main__":
anyio.run(run_script)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_repository_extension.py 0000664 0000000 0000000 00000013642 15070515525 0031123 0 ustar 00root root 0000000 0000000 from __future__ import annotations
import random
import re
import string
import unicodedata
from typing import TYPE_CHECKING, Any
from uuid import UUID
from pydantic import BaseModel as _BaseModel
from pydantic import TypeAdapter
from sqlalchemy.orm import Mapped, declarative_mixin, mapped_column
from sqlalchemy.types import String
from litestar import Litestar, get, post
from litestar.di import Provide
from litestar.plugins.sqlalchemy import (
AsyncSessionConfig,
SQLAlchemyAsyncConfig,
SQLAlchemyInitPlugin,
base,
repository,
)
if TYPE_CHECKING:
from sqlalchemy.ext.asyncio import AsyncSession
class BaseModel(_BaseModel):
"""Extend Pydantic's BaseModel to enable ORM mode"""
model_config = {"from_attributes": True}
# we are going to add a simple "slug" to our model that is a URL safe surrogate key to
# our database record.
@declarative_mixin
class SlugKey:
"""Slug unique Field Model Mixin."""
__abstract__ = True
slug: Mapped[str] = mapped_column(String(length=100), nullable=False, unique=True, sort_order=-9)
# this class can be re-used with any model that has the `SlugKey` Mixin
class SQLAlchemyAsyncSlugRepository(repository.SQLAlchemyAsyncRepository[repository.ModelT]):
"""Extends the repository to include slug model features.."""
async def get_available_slug(
self,
value_to_slugify: str,
**kwargs: Any,
) -> str:
"""Get a unique slug for the supplied value.
If the value is found to exist, a random 4 digit character is appended to the end.
There may be a better way to do this, but I wanted to limit the number of
additional database calls.
Args:
value_to_slugify (str): A string that should be converted to a unique slug.
**kwargs: stuff
Returns:
str: a unique slug for the supplied value. This is safe for URLs and other
unique identifiers.
"""
slug = self._slugify(value_to_slugify)
if await self._is_slug_unique(slug):
return slug
# generate a random 4 digit alphanumeric string to make the slug unique and
# avoid another DB lookup.
random_string = "".join(random.choices(string.ascii_lowercase + string.digits, k=4))
return f"{slug}-{random_string}"
@staticmethod
def _slugify(value: str) -> str:
"""slugify.
Convert to ASCII if 'allow_unicode' is False. Convert spaces or repeated
dashes to single dashes. Remove characters that aren't alphanumerics,
underscores, or hyphens. Convert to lowercase. Also strip leading and
trailing whitespace, dashes, and underscores.
Args:
value (str): the string to slugify
Returns:
str: a slugified string of the value parameter
"""
value = unicodedata.normalize("NFKD", value).encode("ascii", "ignore").decode("ascii")
value = re.sub(r"[^\w\s-]", "", value.lower())
return re.sub(r"[-\s]+", "-", value).strip("-_")
async def _is_slug_unique(
self,
slug: str,
**kwargs: Any,
) -> bool:
return await self.get_one_or_none(slug=slug) is None
# The `UUIDAuditBase` class includes the same UUID` based primary key (`id`) and 2
# additional columns: `created_at` and `updated_at`. `created_at` is a timestamp of when the
# record created, and `updated_at` is the last time the record was modified.
class BlogPost(base.UUIDAuditBase, SlugKey):
title: Mapped[str]
content: Mapped[str]
class BlogPostRepository(SQLAlchemyAsyncSlugRepository[BlogPost]):
"""Blog Post repository."""
model_type = BlogPost
class BlogPostDTO(BaseModel):
id: UUID | None
slug: str
title: str
content: str
class BlogPostCreate(BaseModel):
title: str
content: str
# we can optionally override the default `select` used for the repository to pass in
# specific SQL options such as join details
async def provide_blog_post_repo(db_session: AsyncSession) -> BlogPostRepository:
"""This provides a simple example demonstrating how to override the join options
for the repository."""
return BlogPostRepository(session=db_session)
session_config = AsyncSessionConfig(expire_on_commit=False)
sqlalchemy_config = SQLAlchemyAsyncConfig(
connection_string="sqlite+aiosqlite:///test.sqlite", session_config=session_config
) # Create 'async_session' dependency.
sqlalchemy_plugin = SQLAlchemyInitPlugin(config=sqlalchemy_config)
async def on_startup() -> None:
"""Initializes the database."""
async with sqlalchemy_config.get_engine().begin() as conn:
await conn.run_sync(base.UUIDAuditBase.metadata.create_all)
@get(path="/")
async def get_blogs(
blog_post_repo: BlogPostRepository,
) -> list[BlogPostDTO]:
"""Interact with SQLAlchemy engine and session."""
objs = await blog_post_repo.list()
type_adapter = TypeAdapter(list[BlogPostDTO])
return type_adapter.validate_python(objs)
@get(path="/{post_slug:str}")
async def get_blog_details(
post_slug: str,
blog_post_repo: BlogPostRepository,
) -> BlogPostDTO:
"""Interact with SQLAlchemy engine and session."""
obj = await blog_post_repo.get_one(slug=post_slug)
return BlogPostDTO.model_validate(obj)
@post(path="/")
async def create_blog(
blog_post_repo: BlogPostRepository,
data: BlogPostCreate,
) -> BlogPostDTO:
"""Create a new blog post."""
_data = data.model_dump(exclude_unset=True, by_alias=False, exclude_none=True)
_data["slug"] = await blog_post_repo.get_available_slug(_data["title"])
obj = await blog_post_repo.add(BlogPost(**_data))
await blog_post_repo.session.commit()
return BlogPostDTO.model_validate(obj)
app = Litestar(
route_handlers=[create_blog, get_blogs, get_blog_details],
dependencies={"blog_post_repo": Provide(provide_blog_post_repo, sync_to_thread=False)},
on_startup=[on_startup],
plugins=[SQLAlchemyInitPlugin(config=sqlalchemy_config)],
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/sqlalchemy_sync_repository.py 0000664 0000000 0000000 00000015505 15070515525 0030063 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from datetime import date
from typing import TYPE_CHECKING
from uuid import UUID
from pydantic import BaseModel as _BaseModel
from pydantic import TypeAdapter
from sqlalchemy import ForeignKey, select
from sqlalchemy.orm import Mapped, mapped_column, relationship, selectinload
from litestar import Litestar, get
from litestar.controller import Controller
from litestar.di import Provide
from litestar.handlers.http_handlers.decorators import delete, patch, post
from litestar.pagination import OffsetPagination
from litestar.params import Parameter
from litestar.plugins.sqlalchemy import (
SQLAlchemyInitPlugin,
SQLAlchemySyncConfig,
base,
repository,
)
from litestar.repository.filters import LimitOffset
if TYPE_CHECKING:
from sqlalchemy.orm import Session
class BaseModel(_BaseModel):
"""Extend Pydantic's BaseModel to enable ORM mode"""
model_config = {"from_attributes": True}
# The SQLAlchemy base includes a declarative model for you to use in your models.
# The `UUIDBase` class includes a `UUID` based primary key (`id`)
class AuthorModel(base.UUIDBase):
# we can optionally provide the table name instead of auto-generating it
__tablename__ = "author" # type: ignore[assignment]
name: Mapped[str]
dob: Mapped[date | None]
books: Mapped[list[BookModel]] = relationship(back_populates="author", lazy="noload")
# The `UUIDAuditBase` class includes the same UUID` based primary key (`id`) and 2
# additional columns: `created_at` and `updated_at`. `created_at` is a timestamp of when the
# record created, and `updated_at` is the last time the record was modified.
class BookModel(base.UUIDAuditBase):
__tablename__ = "book" # type: ignore[assignment]
title: Mapped[str]
author_id: Mapped[UUID] = mapped_column(ForeignKey("author.id"))
author: Mapped[AuthorModel] = relationship(lazy="joined", innerjoin=True, viewonly=True)
# we will explicitly define the schema instead of using DTO objects for clarity.
class Author(BaseModel):
id: UUID | None
name: str
dob: date | None = None
class AuthorCreate(BaseModel):
name: str
dob: date | None = None
class AuthorUpdate(BaseModel):
name: str | None = None
dob: date | None = None
class AuthorRepository(repository.SQLAlchemySyncRepository[AuthorModel]):
"""Author repository."""
model_type = AuthorModel
async def provide_authors_repo(db_session: Session) -> AuthorRepository:
"""This provides the default Authors repository."""
return AuthorRepository(session=db_session)
# we can optionally override the default `select` used for the repository to pass in
# specific SQL options such as join details
async def provide_author_details_repo(db_session: Session) -> AuthorRepository:
"""This provides a simple example demonstrating how to override the join options
for the repository."""
return AuthorRepository(
statement=select(AuthorModel).options(selectinload(AuthorModel.books)),
session=db_session,
)
def provide_limit_offset_pagination(
current_page: int = Parameter(ge=1, query="currentPage", default=1, required=False),
page_size: int = Parameter(
query="pageSize",
ge=1,
default=10,
required=False,
),
) -> LimitOffset:
"""Add offset/limit pagination.
Return type consumed by `Repository.apply_limit_offset_pagination()`.
Parameters
----------
current_page : int
LIMIT to apply to select.
page_size : int
OFFSET to apply to select.
"""
return LimitOffset(page_size, page_size * (current_page - 1))
class AuthorController(Controller):
"""Author CRUD"""
dependencies = {"authors_repo": Provide(provide_authors_repo, sync_to_thread=False)}
@get(path="/authors")
def list_authors(
self,
authors_repo: AuthorRepository,
limit_offset: LimitOffset,
) -> OffsetPagination[Author]:
"""List authors."""
results, total = authors_repo.list_and_count(limit_offset)
type_adapter = TypeAdapter(list[Author])
return OffsetPagination[Author](
items=type_adapter.validate_python(results),
total=total,
limit=limit_offset.limit,
offset=limit_offset.offset,
)
@post(path="/authors")
def create_author(
self,
authors_repo: AuthorRepository,
data: AuthorCreate,
) -> Author:
"""Create a new author."""
obj = authors_repo.add(
AuthorModel(**data.model_dump(exclude_unset=True, exclude_none=True)),
)
authors_repo.session.commit()
return Author.model_validate(obj)
# we override the authors_repo to use the version that joins the Books in
@get(
path="/authors/{author_id:uuid}",
dependencies={"authors_repo": Provide(provide_author_details_repo, sync_to_thread=False)},
)
def get_author(
self,
authors_repo: AuthorRepository,
author_id: UUID = Parameter(
title="Author ID",
description="The author to retrieve.",
),
) -> Author:
"""Get an existing author."""
obj = authors_repo.get(author_id)
return Author.model_validate(obj)
@patch(
path="/authors/{author_id:uuid}",
dependencies={"authors_repo": Provide(provide_author_details_repo, sync_to_thread=False)},
)
def update_author(
self,
authors_repo: AuthorRepository,
data: AuthorUpdate,
author_id: UUID = Parameter(
title="Author ID",
description="The author to update.",
),
) -> Author:
"""Update an author."""
raw_obj = data.model_dump(exclude_unset=True, exclude_none=True)
raw_obj.update({"id": author_id})
obj = authors_repo.update(AuthorModel(**raw_obj))
authors_repo.session.commit()
return Author.model_validate(obj)
@delete(path="/authors/{author_id:uuid}")
def delete_author(
self,
authors_repo: AuthorRepository,
author_id: UUID = Parameter(
title="Author ID",
description="The author to delete.",
),
) -> None:
"""Delete a author from the system."""
_ = authors_repo.delete(author_id)
authors_repo.session.commit()
sqlalchemy_config = SQLAlchemySyncConfig(connection_string="sqlite:///test.sqlite") # Create 'db_session' dependency.
sqlalchemy_plugin = SQLAlchemyInitPlugin(config=sqlalchemy_config)
def on_startup() -> None:
"""Initializes the database."""
with sqlalchemy_config.get_engine().begin() as conn:
base.UUIDBase.metadata.create_all(conn)
app = Litestar(
route_handlers=[AuthorController],
on_startup=[on_startup],
plugins=[SQLAlchemyInitPlugin(config=sqlalchemy_config)],
dependencies={"limit_offset": Provide(provide_limit_offset_pagination)},
)
litestar-2.18.0/docs/examples/contrib/sqlalchemy/us_state_lookup.json 0000664 0000000 0000000 00000006135 15070515525 0026126 0 ustar 00root root 0000000 0000000 [
{
"name": "Alabama",
"abbreviation": "AL"
},
{
"name": "Alaska",
"abbreviation": "AK"
},
{
"name": "Arizona",
"abbreviation": "AZ"
},
{
"name": "Arkansas",
"abbreviation": "AR"
},
{
"name": "California",
"abbreviation": "CA"
},
{
"name": "Colorado",
"abbreviation": "CO"
},
{
"name": "Connecticut",
"abbreviation": "CT"
},
{
"name": "Delaware",
"abbreviation": "DE"
},
{
"name": "District Of Columbia",
"abbreviation": "DC"
},
{
"name": "Florida",
"abbreviation": "FL"
},
{
"name": "Georgia",
"abbreviation": "GA"
},
{
"name": "Guam",
"abbreviation": "GU"
},
{
"name": "Hawaii",
"abbreviation": "HI"
},
{
"name": "Idaho",
"abbreviation": "ID"
},
{
"name": "Illinois",
"abbreviation": "IL"
},
{
"name": "Indiana",
"abbreviation": "IN"
},
{
"name": "Iowa",
"abbreviation": "IA"
},
{
"name": "Kansas",
"abbreviation": "KS"
},
{
"name": "Kentucky",
"abbreviation": "KY"
},
{
"name": "Louisiana",
"abbreviation": "LA"
},
{
"name": "Maine",
"abbreviation": "ME"
},
{
"name": "Maryland",
"abbreviation": "MD"
},
{
"name": "Massachusetts",
"abbreviation": "MA"
},
{
"name": "Michigan",
"abbreviation": "MI"
},
{
"name": "Minnesota",
"abbreviation": "MN"
},
{
"name": "Mississippi",
"abbreviation": "MS"
},
{
"name": "Missouri",
"abbreviation": "MO"
},
{
"name": "Montana",
"abbreviation": "MT"
},
{
"name": "Nebraska",
"abbreviation": "NE"
},
{
"name": "Nevada",
"abbreviation": "NV"
},
{
"name": "New Hampshire",
"abbreviation": "NH"
},
{
"name": "New Jersey",
"abbreviation": "NJ"
},
{
"name": "New Mexico",
"abbreviation": "NM"
},
{
"name": "New York",
"abbreviation": "NY"
},
{
"name": "North Carolina",
"abbreviation": "NC"
},
{
"name": "North Dakota",
"abbreviation": "ND"
},
{
"name": "Ohio",
"abbreviation": "OH"
},
{
"name": "Oklahoma",
"abbreviation": "OK"
},
{
"name": "Oregon",
"abbreviation": "OR"
},
{
"name": "Palau",
"abbreviation": "PW"
},
{
"name": "Pennsylvania",
"abbreviation": "PA"
},
{
"name": "Puerto Rico",
"abbreviation": "PR"
},
{
"name": "Rhode Island",
"abbreviation": "RI"
},
{
"name": "South Carolina",
"abbreviation": "SC"
},
{
"name": "South Dakota",
"abbreviation": "SD"
},
{
"name": "Tennessee",
"abbreviation": "TN"
},
{
"name": "Texas",
"abbreviation": "TX"
},
{
"name": "Utah",
"abbreviation": "UT"
},
{
"name": "Vermont",
"abbreviation": "VT"
},
{
"name": "Virginia",
"abbreviation": "VA"
},
{
"name": "Washington",
"abbreviation": "WA"
},
{
"name": "West Virginia",
"abbreviation": "WV"
},
{
"name": "Wisconsin",
"abbreviation": "WI"
},
{
"name": "Wyoming",
"abbreviation": "WY"
}
]
litestar-2.18.0/docs/examples/data_transfer_objects/ 0000775 0000000 0000000 00000000000 15070515525 0022532 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024631 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/defining_dtos_on_layers.py 0000664 0000000 0000000 00000002537 15070515525 0030002 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass, field
from typing import List
from uuid import UUID, uuid4
from litestar import Controller, delete, get, post, put
from litestar.app import Litestar
from litestar.dto import DataclassDTO
from litestar.dto.config import DTOConfig
@dataclass
class User:
name: str
email: str
age: int
id: UUID = field(default_factory=uuid4)
class UserWriteDTO(DataclassDTO[User]):
config = DTOConfig(exclude={"id"})
class UserReadDTO(DataclassDTO[User]): ...
class UserController(Controller):
dto = UserWriteDTO
return_dto = UserReadDTO
@post("/", sync_to_thread=False)
def create_user(self, data: User) -> User:
return data
@get("/", sync_to_thread=False)
def get_users(self) -> List[User]:
return [User(name="Mr Sunglass", email="mr.sunglass@example.com", age=30)]
@get("/{user_id:uuid}", sync_to_thread=False)
def get_user(self, user_id: UUID) -> User:
return User(id=user_id, name="Mr Sunglass", email="mr.sunglass@example.com", age=30)
@put("/{user_id:uuid}", sync_to_thread=False)
def update_user(self, data: User) -> User:
return data
@delete("/{user_id:uuid}", return_dto=None, sync_to_thread=False)
def delete_user(self, user_id: UUID) -> None:
return None
app = Litestar([UserController])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/ 0000775 0000000 0000000 00000000000 15070515525 0024201 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/factory/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0026300 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/factory/dto_data_problem_statement.py 0000664 0000000 0000000 00000001671 15070515525 0032143 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass, field
from uuid import UUID, uuid4
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class User:
name: str
email: str
age: int
id: UUID = field(default_factory=uuid4)
class UserWriteDTO(DataclassDTO[User]):
"""Don't allow client to set the id."""
config = DTOConfig(exclude={"id"})
# We need a dto for the handler to parse the request data per the configuration, however,
# we don't need a return DTO as we are returning a dataclass, and Litestar already knows
# how to serialize dataclasses.
@post("/users", dto=UserWriteDTO, return_dto=None, sync_to_thread=False)
def create_user(data: User) -> User:
"""Create an user."""
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Peter","email": "peter@example.com", "age":41}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/dto_data_usage.py 0000664 0000000 0000000 00000001313 15070515525 0027514 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from uuid import UUID, uuid4
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class User:
name: str
email: str
age: int
id: UUID
class UserWriteDTO(DataclassDTO[User]):
"""Don't allow client to set the id."""
config = DTOConfig(exclude={"id"})
@post("/users", dto=UserWriteDTO, return_dto=None, sync_to_thread=False)
def create_user(data: DTOData[User]) -> User:
"""Create an user."""
return data.create_instance(id=uuid4())
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Peter", "email": "peter@example.com", "age":41}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/enveloping_return_data.py 0000664 0000000 0000000 00000001712 15070515525 0031312 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from datetime import datetime
from typing import Generic, List, TypeVar
from sqlalchemy.orm import Mapped
from litestar import Litestar, get
from litestar.dto import DTOConfig
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
T = TypeVar("T")
@dataclass
class WithCount(Generic[T]):
count: int
data: List[T]
class User(Base):
name: Mapped[str]
password: Mapped[str]
created_at: Mapped[datetime]
class UserDTO(SQLAlchemyDTO[User]):
config = DTOConfig(exclude={"password", "created_at"})
@get("/users", dto=UserDTO, sync_to_thread=False)
def get_users() -> WithCount[User]:
return WithCount(
count=1,
data=[
User(
id=1,
name="Litestar User",
password="xyz",
created_at=datetime.now(),
),
],
)
app = Litestar(route_handlers=[get_users])
# run: /users
litestar-2.18.0/docs/examples/data_transfer_objects/factory/excluding_fields.py 0000664 0000000 0000000 00000003351 15070515525 0030065 0 ustar 00root root 0000000 0000000 from datetime import datetime
from typing import List
from uuid import UUID
from sqlalchemy import ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.dto import DTOConfig, dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class Address(Base):
street: Mapped[str]
city: Mapped[str]
state: Mapped[str]
zip: Mapped[str]
class Pets(Base):
name: Mapped[str]
user_id: Mapped[UUID] = mapped_column(ForeignKey("user.id"))
class User(Base):
name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
address_id: Mapped[UUID] = mapped_column(ForeignKey("address.id"), info=dto_field("private"))
address: Mapped[Address] = relationship(info=dto_field("read-only"))
pets: Mapped[List[Pets]] = relationship(info=dto_field("read-only"))
UserDTO = SQLAlchemyDTO[User]
config = DTOConfig(
exclude={
"id",
"address.id",
"address.street",
"pets.0.id",
"pets.0.user_id",
}
)
ReadUserDTO = SQLAlchemyDTO[Annotated[User, config]]
@post("/users", dto=UserDTO, return_dto=ReadUserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
data.created_at = datetime.min
data.address = Address(street="123 Main St", city="Anytown", state="NY", zip="12345")
data.pets = [Pets(id=1, name="Fido"), Pets(id=2, name="Spot")]
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Litestar User","password":"xyz","created_at":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/included_fields.py 0000664 0000000 0000000 00000003255 15070515525 0027675 0 ustar 00root root 0000000 0000000 from datetime import datetime
from typing import List
from uuid import UUID
from sqlalchemy import ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.dto import DTOConfig, dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class Address(Base):
street: Mapped[str]
city: Mapped[str]
state: Mapped[str]
zip: Mapped[str]
class Pets(Base):
name: Mapped[str]
user_id: Mapped[UUID] = mapped_column(ForeignKey("user.id"))
class User(Base):
name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
address_id: Mapped[UUID] = mapped_column(ForeignKey("address.id"), info=dto_field("private"))
address: Mapped[Address] = relationship(info=dto_field("read-only"))
pets: Mapped[List[Pets]] = relationship(info=dto_field("read-only"))
UserDTO = SQLAlchemyDTO[User]
config = DTOConfig(
include={
"address.street",
"pets.0.name",
}
)
ReadUserDTO = SQLAlchemyDTO[Annotated[User, config]]
@post("/users", dto=UserDTO, return_dto=ReadUserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
data.created_at = datetime.min
data.address = Address(street="123 Main St", city="Anytown", state="NY", zip="12345")
data.pets = [Pets(id=1, name="Fido"), Pets(id=2, name="Spot")]
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Litestar User","password":"xyz","created_at":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/leading_underscore_private.py 0000664 0000000 0000000 00000000635 15070515525 0032145 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO
@dataclass
class Foo:
this_will: str
_this_will: str = "Mars"
@post("/", dto=DataclassDTO[Foo], sync_to_thread=False)
def handler(data: Foo) -> Foo:
return data
app = Litestar(route_handlers=[handler])
# run: / -H "Content-Type: application/json" -d '{"bar":"stay","_baz":"go_away!"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/leading_underscore_private_override.py 0000664 0000000 0000000 00000001012 15070515525 0034032 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Foo:
this_will: str
_this_will: str = "not_go_away!"
class DTO(DataclassDTO[Foo]):
config = DTOConfig(underscore_fields_private=False)
@post("/", dto=DTO, sync_to_thread=False)
def handler(data: Foo) -> Foo:
return data
app = Litestar(route_handlers=[handler])
# run: / -H "Content-Type: application/json" -d '{"this_will":"stay","_this_will":"not_go_away!"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/marking_fields.py 0000664 0000000 0000000 00000002436 15070515525 0027536 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped, mapped_column
from litestar import Litestar, post
from litestar.dto import dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
# `Base` defines `id` field as:
# id: Mapped[UUID] = mapped_column(default=uuid4, primary_key=True)
name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
UserDTO = SQLAlchemyDTO[User]
@post("/users", dto=UserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
# even though the client did not send the id field,
# since it is a primary key it is autogenerated
assert "id" in vars(data)
# even though the client sent the password and created_at field, it is not in the data object
assert "password" not in vars(data)
assert "created_at" not in vars(data)
# normally the database would set the created_at timestamp
data.created_at = datetime.min
return data # the response includes the created_at field
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Litestar User","password":"xyz","created_at":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/my_lib.py 0000664 0000000 0000000 00000001166 15070515525 0026032 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import Any
from sqlalchemy.orm import DeclarativeBase
from litestar.plugins.sqlalchemy import base, mixins
class _Base(base.CommonTableAttributes, mixins.UUIDPrimaryKey, DeclarativeBase):
"""Fake base SQLAlchemy model for typing purposes."""
Base: _Base
def __getattr__(name: str) -> Any:
if name == "Base":
return type(
"Base",
(base.CommonTableAttributes, mixins.UUIDPrimaryKey, DeclarativeBase),
{"registry": base.create_registry()},
)
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
litestar-2.18.0/docs/examples/data_transfer_objects/factory/paginated_return_data.py 0000664 0000000 0000000 00000001630 15070515525 0031077 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped
from litestar import Litestar, get
from litestar.dto import DTOConfig
from litestar.pagination import ClassicPagination
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
name: Mapped[str]
password: Mapped[str]
created_at: Mapped[datetime]
class UserDTO(SQLAlchemyDTO[User]):
config = DTOConfig(exclude={"password", "created_at"})
@get("/users", dto=UserDTO, sync_to_thread=False)
def get_users() -> ClassicPagination[User]:
return ClassicPagination(
page_size=10,
total_pages=1,
current_page=1,
items=[
User(
id=1,
name="Litestar User",
password="xyz",
created_at=datetime.now(),
),
],
)
app = Litestar(route_handlers=[get_users])
# run: /users
litestar-2.18.0/docs/examples/data_transfer_objects/factory/patch_requests.py 0000664 0000000 0000000 00000001713 15070515525 0027607 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from uuid import UUID
from litestar import Litestar, patch
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
id: UUID
name: str
age: int
class PatchDTO(DataclassDTO[Person]):
"""Don't allow client to set the id, and allow partial updates."""
config = DTOConfig(exclude={"id"}, partial=True)
peter_uuid = UUID("f32ff2ce-e32f-4537-9dc0-26e7599f1380")
database = {peter_uuid: Person(id=peter_uuid, name="Peter", age=40)}
@patch("/person/{person_id:uuid}", dto=PatchDTO, return_dto=None, sync_to_thread=False)
def update_person(person_id: UUID, data: DTOData[Person]) -> Person:
"""Partially update a person."""
return data.update_instance(database[person_id])
app = Litestar(route_handlers=[update_person])
# run: /person/f32ff2ce-e32f-4537-9dc0-26e7599f1380 -X PATCH -H "Content-Type: application/json" -d '{"name":"Peter Pan"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/providing_values_for_nested_data.py 0000664 0000000 0000000 00000001537 15070515525 0033342 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Address:
id: int
street: str
@dataclass
class Person:
id: int
name: str
age: int
address: Address
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig()
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id", "address.id"})
@post("/person", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def create_person(data: DTOData[Person]) -> Person:
# Logic for persisting the person goes here
return data.create_instance(id=1, address__id=2)
app = Litestar(route_handlers=[create_person])
# run: /person -H "Content-Type: application/json" -d '{"name":"Peter","age":41, "address": {"street": "Fake Street"}}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/related_items.py 0000664 0000000 0000000 00000002606 15070515525 0027400 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from uuid import UUID
from sqlalchemy import ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship
from typing_extensions import Annotated
from litestar import Litestar, put
from litestar.dto import DTOConfig
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class A(Base):
b_id: Mapped[UUID] = mapped_column(ForeignKey("b.id"))
b: Mapped[B] = relationship(back_populates="a")
class B(Base):
a: Mapped[A] = relationship(back_populates="b")
data_config = DTOConfig(max_nested_depth=0)
DataDTO = SQLAlchemyDTO[Annotated[A, data_config]]
# default config sets max_nested_depth to 1
ReturnDTO = SQLAlchemyDTO[A]
@put("/a", dto=DataDTO, return_dto=ReturnDTO, sync_to_thread=False)
def update_a(data: A) -> A:
# this shows that "b" was not parsed out of the inbound data
assert "b" not in vars(data)
# Now we'll create an instance of B and assign it"
# This includes a reference back to ``a`` which is not serialized in the return data
# because default ``max_nested_depth`` is set to 1
data.b = B(id=data.b_id, a=data)
return data
app = Litestar(route_handlers=[update_a])
# run: /a -H "Content-Type: application/json" -X PUT -d '{"id": "6955e63c-c2bc-4707-8fa4-2144d1764746", "b_id": "9cf3518d-7e19-4215-9ec2-e056cac55bf7", "b": {"id": "9cf3518d-7e19-4215-9ec2-e056cac55bf7"}}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/renaming_all_fields.py 0000664 0000000 0000000 00000002034 15070515525 0030530 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped, mapped_column
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.dto import DTOConfig, dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
first_name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
config = DTOConfig(rename_strategy="camel")
# another rename strategy with a custom callback:
# config = DTOConfig(rename_strategy=lambda x: f"-{x}-")
UserDTO = SQLAlchemyDTO[Annotated[User, config]]
@post("/users", dto=UserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
assert data.first_name == "Litestar User"
data.created_at = datetime.min
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"firstName":"Litestar User","password":"xyz","createdAt":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/renaming_fields.py 0000664 0000000 0000000 00000001660 15070515525 0027704 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped, mapped_column
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.dto import DTOConfig, dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
config = DTOConfig(rename_fields={"name": "userName"})
UserDTO = SQLAlchemyDTO[Annotated[User, config]]
@post("/users", dto=UserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
assert data.name == "Litestar User"
data.created_at = datetime.min
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"userName":"Litestar User","password":"xyz","created_at":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/response_return_data.py 0000664 0000000 0000000 00000001426 15070515525 0031004 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped
from litestar import Litestar, Response, get
from litestar.dto import DTOConfig
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
name: Mapped[str]
password: Mapped[str]
created_at: Mapped[datetime]
class UserDTO(SQLAlchemyDTO[User]):
config = DTOConfig(exclude={"password", "created_at"})
@get("/users", dto=UserDTO, sync_to_thread=False)
def get_users() -> Response[User]:
return Response(
content=User(
id=1,
name="Litestar User",
password="xyz",
created_at=datetime.now(),
),
headers={"X-Total-Count": "1"},
)
app = Litestar(route_handlers=[get_users])
# run: /users
litestar-2.18.0/docs/examples/data_transfer_objects/factory/simple_dto_factory_example.py 0000664 0000000 0000000 00000001306 15070515525 0032154 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped
from litestar import Litestar, post
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
# `Base` defines `id` field as:
# id: Mapped[UUID] = mapped_column(default=uuid4, primary_key=True)
name: Mapped[str]
password: Mapped[str]
created_at: Mapped[datetime]
UserDTO = SQLAlchemyDTO[User]
@post("/users", dto=UserDTO, sync_to_thread=False)
def create_user(data: User) -> User:
return data
app = Litestar(route_handlers=[create_user])
# run: /users -H "Content-Type: application/json" -d '{"name":"Litestar User","password":"xyz","created_at":"2023-04-24T00:00:00Z"}'
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/ 0000775 0000000 0000000 00000000000 15070515525 0026044 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0030143 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/controller.py 0000664 0000000 0000000 00000003016 15070515525 0030601 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Controller, Litestar, patch, post, put
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"})
class PatchDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"}, partial=True)
class PersonController(Controller):
dto = WriteDTO
return_dto = ReadDTO
@post("/person", sync_to_thread=False)
def create_person(self, data: DTOData[Person]) -> Person:
# Logic for persisting the person goes here
return data.create_instance(id=1)
@put("/person/{person_id:int}", sync_to_thread=False)
def update_person(self, person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
@patch("/person/{person_id:int}", dto=PatchDTO, sync_to_thread=False)
def patch_person(self, person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
app = Litestar(route_handlers=[PersonController])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/dto_data.py 0000664 0000000 0000000 00000001234 15070515525 0030175 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"})
@post("/person", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def create_person(data: DTOData[Person]) -> Person:
# Logic for persisting the person goes here
return data.create_instance(id=1)
app = Litestar(route_handlers=[create_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/explicit_field_renaming.py 0000664 0000000 0000000 00000002432 15070515525 0033263 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Address:
street: str
city: str
country: str
@dataclass
class Person:
name: str
age: int
email: str
address: Address
children: List[Person]
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(
exclude={"email", "address.street", "children.0.email", "children.0.address"},
rename_fields={"address": "location"},
)
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
address = Address(street="123 Main St", city="Cityville", country="Countryland")
child1 = Person(name="Child1", age=10, email="child1@example.com", address=address, children=[])
child2 = Person(name="Child2", age=8, email="child2@example.com", address=address, children=[])
return Person(
name=name,
age=30,
email=f"email_of_{name}@example.com",
address=address,
children=[child1, child2],
)
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/field_renaming_strategy.py 0000664 0000000 0000000 00000002414 15070515525 0033304 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Address:
street: str
city: str
country: str
@dataclass
class Person:
name: str
age: int
email: str
address: Address
children: List[Person]
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(
exclude={"email", "address.street", "children.0.email", "children.0.address"},
rename_strategy="upper",
)
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
address = Address(street="123 Main St", city="Cityville", country="Countryland")
child1 = Person(name="Child1", age=10, email="child1@example.com", address=address, children=[])
child2 = Person(name="Child2", age=8, email="child2@example.com", address=address, children=[])
return Person(
name=name,
age=30,
email=f"email_of_{name}@example.com",
address=address,
children=[child1, child2],
)
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/initial_pattern.py 0000664 0000000 0000000 00000000776 15070515525 0031616 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, get
@dataclass
class Person:
name: str
age: int
email: str
@get("/person/{name:str}", sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
return Person(name=name, age=30, email=f"email_of_{name}@example.com")
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/max_nested_depth.py 0000664 0000000 0000000 00000002407 15070515525 0031734 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Address:
street: str
city: str
country: str
@dataclass
class Person:
name: str
age: int
email: str
address: Address
children: List[Person]
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(
exclude={"email", "address.street", "children.0.email", "children.0.address"},
max_nested_depth=2,
)
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
address = Address(street="123 Main St", city="Cityville", country="Countryland")
child1 = Person(name="Child1", age=10, email="child1@example.com", address=address, children=[])
child2 = Person(name="Child2", age=8, email="child2@example.com", address=address, children=[])
return Person(
name=name,
age=30,
email=f"email_of_{name}@example.com",
address=address,
children=[child1, child2],
)
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/multiple_handlers.py 0000664 0000000 0000000 00000002733 15070515525 0032136 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, patch, post, put
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"})
class PatchDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"}, partial=True)
@post("/person", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def create_person(data: DTOData[Person]) -> Person:
# Logic for persisting the person goes here
return data.create_instance(id=1)
@put("/person/{person_id:int}", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def update_person(person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
@patch("/person/{person_id:int}", dto=PatchDTO, return_dto=ReadDTO, sync_to_thread=False)
def patch_person(person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
app = Litestar(route_handlers=[create_person, update_person, patch_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/nested_collection_exclude.py 0000664 0000000 0000000 00000002334 15070515525 0033626 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Address:
street: str
city: str
country: str
@dataclass
class Person:
name: str
age: int
email: str
address: Address
children: List[Person]
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email", "address.street", "children.0.email", "children.0.address"})
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
address = Address(street="123 Main St", city="Cityville", country="Countryland")
child1 = Person(name="Child1", age=10, email="child1@example.com", address=address, children=[])
child2 = Person(name="Child2", age=8, email="child2@example.com", address=address, children=[])
return Person(
name=name,
age=30,
email=f"email_of_{name}@example.com",
address=address,
children=[child1, child2],
)
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/nested_exclude.py 0000664 0000000 0000000 00000001554 15070515525 0031416 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Address:
street: str
city: str
country: str
@dataclass
class Person:
name: str
age: int
email: str
address: Address
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email", "address.street"})
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
address = Address(street="123 Main St", city="Cityville", country="Countryland")
return Person(name=name, age=30, email=f"email_of_{name}@example.com", address=address)
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/patch_handlers.py 0000664 0000000 0000000 00000001464 15070515525 0031402 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, patch
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class PatchDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"}, partial=True)
@patch("/person/{person_id:int}", dto=PatchDTO, return_dto=ReadDTO, sync_to_thread=False)
def update_person(person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
app = Litestar(route_handlers=[update_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/put_handlers.py 0000664 0000000 0000000 00000001442 15070515525 0031107 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, put
from litestar.dto import DataclassDTO, DTOConfig, DTOData
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"})
@put("/person/{person_id:int}", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def update_person(person_id: int, data: DTOData[Person]) -> Person:
# Usually the Person would be retrieved from a database
person = Person(id=person_id, name="John", age=50, email="email_of_john@example.com")
return data.update_instance(person)
app = Litestar(route_handlers=[update_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/read_only_fields_error.py 0000664 0000000 0000000 00000001164 15070515525 0033133 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Person:
name: str
age: int
email: str
id: int
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
class WriteDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"id"})
@post("/person", dto=WriteDTO, return_dto=ReadDTO, sync_to_thread=False)
def create_person(data: Person) -> Person:
# Logic for persisting the person goes here
return data
app = Litestar(route_handlers=[create_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/simple_dto_exclude.py 0000664 0000000 0000000 00000001224 15070515525 0032265 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, get
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Person:
name: str
age: int
email: str
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
@get("/person/{name:str}", return_dto=ReadDTO, sync_to_thread=False)
def get_person(name: str) -> Person:
# Your logic to retrieve the person goes here
# For demonstration purposes, a placeholder Person instance is returned
return Person(name=name, age=30, email=f"email_of_{name}@example.com")
app = Litestar(route_handlers=[get_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/tutorial/simple_receiving_data.py 0000664 0000000 0000000 00000001013 15070515525 0032726 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class Person:
name: str
age: int
email: str
class ReadDTO(DataclassDTO[Person]):
config = DTOConfig(exclude={"email"})
@post("/person", return_dto=ReadDTO, sync_to_thread=False)
def create_person(data: Person) -> Person:
# Logic for persisting the person goes here
return data
app = Litestar(route_handlers=[create_person])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/type_checking.py 0000664 0000000 0000000 00000001253 15070515525 0027370 0 ustar 00root root 0000000 0000000 from datetime import datetime
from sqlalchemy.orm import Mapped, mapped_column
from litestar import Litestar, post
from litestar.dto import dto_field
from litestar.plugins.sqlalchemy import SQLAlchemyDTO
from .my_lib import Base
class User(Base):
name: Mapped[str]
password: Mapped[str] = mapped_column(info=dto_field("private"))
created_at: Mapped[datetime] = mapped_column(info=dto_field("read-only"))
class Foo(Base):
foo: Mapped[str]
UserDTO = SQLAlchemyDTO[User]
@post("/users", dto=UserDTO)
def create_user(data: Foo) -> Foo:
return data
# This will raise an exception at handler registration time.
app = Litestar(route_handlers=[create_user])
litestar-2.18.0/docs/examples/data_transfer_objects/factory/unknown_fields.py 0000664 0000000 0000000 00000001013 15070515525 0027573 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.dto import DataclassDTO, DTOConfig
@dataclass
class User:
id: str
UserDTO = DataclassDTO[Annotated[User, DTOConfig(forbid_unknown_fields=True)]]
@post("/users", dto=UserDTO)
async def create_user(data: User) -> User:
return data
app = Litestar([create_user])
# run: /users -H "Content-Type: application/json" -d '{"id": "1", "name": "Peter"}'
litestar-2.18.0/docs/examples/data_transfer_objects/models.py 0000664 0000000 0000000 00000000371 15070515525 0024370 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from uuid import UUID
from litestar.dto import DataclassDTO
@dataclass
class User:
id: UUID
name: str
UserDTO = DataclassDTO[User]
UserReturnDTO = DataclassDTO[User]
litestar-2.18.0/docs/examples/data_transfer_objects/overriding_implicit_return_dto.py 0000664 0000000 0000000 00000000717 15070515525 0031420 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass, field
from uuid import UUID, uuid4
from litestar import Litestar, post
from litestar.dto import DataclassDTO
@dataclass
class User:
name: str
email: str
age: int
id: UUID = field(default_factory=uuid4)
UserDTO = DataclassDTO[User]
@post(dto=UserDTO, return_dto=None, sync_to_thread=False)
def create_user(data: User) -> bytes:
return data.name.encode(encoding="utf-8")
app = Litestar([create_user])
litestar-2.18.0/docs/examples/data_transfer_objects/the_dto_parameter.py 0000664 0000000 0000000 00000000207 15070515525 0026571 0 ustar 00root root 0000000 0000000 from litestar import post
from .models import User, UserDTO
@post(dto=UserDTO)
def create_user(data: User) -> User:
return data
litestar-2.18.0/docs/examples/data_transfer_objects/the_return_dto_parameter.py 0000664 0000000 0000000 00000000260 15070515525 0030167 0 ustar 00root root 0000000 0000000 from litestar import post
from .models import User, UserDTO, UserReturnDTO
@post(dto=UserDTO, return_dto=UserReturnDTO)
def create_user(data: User) -> User:
return data
litestar-2.18.0/docs/examples/datastructures/ 0000775 0000000 0000000 00000000000 15070515525 0021261 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023360 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/headers/ 0000775 0000000 0000000 00000000000 15070515525 0022674 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/headers/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024773 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/headers/cache_control.py 0000664 0000000 0000000 00000001762 15070515525 0026057 0 ustar 00root root 0000000 0000000 import time
from litestar import Controller, Litestar, get
from litestar.datastructures import CacheControlHeader
class MyController(Controller):
cache_control = CacheControlHeader(max_age=86_400, public=True)
@get("/chance_of_rain", sync_to_thread=False)
def get_chance_of_rain(self) -> float:
"""This endpoint uses the cache control value defined in the controller which overrides the app value."""
return 0.5
@get("/timestamp", cache_control=CacheControlHeader(no_store=True), sync_to_thread=False)
def get_server_time(self) -> float:
"""This endpoint overrides the cache control value defined in the controller."""
return time.time()
@get("/population", sync_to_thread=False)
def get_population_count() -> int:
"""This endpoint will use the cache control defined in the app."""
return 100000
app = Litestar(
route_handlers=[MyController, get_population_count],
cache_control=CacheControlHeader(max_age=2_628_288, public=True),
)
litestar-2.18.0/docs/examples/datastructures/headers/etag.py 0000664 0000000 0000000 00000002772 15070515525 0024176 0 ustar 00root root 0000000 0000000 import random
import time
from litestar import Controller, Litestar, get
from litestar.datastructures import ETag
from litestar.enums import MediaType
from litestar.response import Response
class MyController(Controller):
etag = ETag(value="foo")
@get("/chance_of_rain")
def get_chance_of_rain(self) -> float:
"""This endpoint uses the etag value in the controller which overrides the app value.
The returned header will be `etag: "foo"`
"""
return 0.5
@get("/timestamp", etag=ETag(value="bar"))
def get_server_time(self) -> float:
"""This endpoint overrides the etag defined in the controller.
The returned header will be `etag: W/"bar"`
"""
return time.time()
@get("/population")
def get_population_count() -> int:
"""This endpoint will use the etag defined in the app.
The returned header will be `etag: "bar"`
"""
return 100000
@get("/population-dynamic", etag=ETag(documentation_only=True))
def get_population_count_dynamic() -> Response[str]:
"""The etag defined in this route handler will not be returned, and does not need a value.
It will only be used for OpenAPI generation.
"""
population_count = random.randint(0, 1000)
return Response(
content=str(population_count),
headers={"etag": str(population_count)},
media_type=MediaType.TEXT,
status_code=200,
)
app = Litestar(route_handlers=[MyController, get_population_count], etag=ETag(value="bar"))
litestar-2.18.0/docs/examples/datastructures/headers/etag_parsing.py 0000664 0000000 0000000 00000000243 15070515525 0025710 0 ustar 00root root 0000000 0000000 from litestar.datastructures import ETag
assert ETag.from_header('"foo"') == ETag(value="foo")
assert ETag.from_header('W/"foo"') == ETag(value="foo", weak=True)
litestar-2.18.0/docs/examples/datastructures/secrets/ 0000775 0000000 0000000 00000000000 15070515525 0022731 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/secrets/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0025030 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/datastructures/secrets/secret_body.py 0000664 0000000 0000000 00000000420 15070515525 0025601 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import post
from litestar.datastructures.secret_values import SecretString
@dataclass
class Sensitive:
value: SecretString
@post(sync_to_thread=False)
def post_handler(data: Sensitive) -> Sensitive:
return data
litestar-2.18.0/docs/examples/datastructures/secrets/secret_header.py 0000664 0000000 0000000 00000001351 15070515525 0026100 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from secrets import compare_digest
from typing_extensions import Annotated
from litestar import get
from litestar.datastructures.secret_values import SecretString
from litestar.exceptions import NotAuthorizedException
from litestar.params import Parameter
SECRET_VALUE = "super-secret" # An example secret value - this should be stored securely in production.
@dataclass
class Sensitive:
value: str
@get(sync_to_thread=False)
def get_handler(secret: Annotated[SecretString, Parameter(header="x-secret")]) -> Sensitive:
if not compare_digest(secret.get_secret(), SECRET_VALUE):
raise NotAuthorizedException
return Sensitive(value="sensitive data")
litestar-2.18.0/docs/examples/dependency_injection/ 0000775 0000000 0000000 00000000000 15070515525 0022364 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/dependency_injection/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024463 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/dependency_injection/dependency_non_optional_not_provided.py 0000664 0000000 0000000 00000001222 15070515525 0032404 0 ustar 00root root 0000000 0000000 from typing import Any
from typing_extensions import Annotated
from litestar import Litestar, get
from litestar.params import Dependency
@get("/")
def hello_world(non_optional_dependency: Annotated[int, Dependency()]) -> dict[str, Any]:
"""Notice we haven't provided the dependency to the route.
This is not great, however by explicitly marking dependencies, Litestar won't let the app start.
"""
return {"hello": non_optional_dependency}
app = Litestar(route_handlers=[hello_world])
# ImproperlyConfiguredException: 500: Explicit dependency 'non_optional_dependency' for 'hello_world' has no default
# value, or provided dependency.
litestar-2.18.0/docs/examples/dependency_injection/dependency_skip_validation.py 0000664 0000000 0000000 00000001103 15070515525 0030307 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from typing_extensions import Annotated
from litestar import Litestar, get
from litestar.di import Provide
from litestar.params import Dependency
async def provide_str() -> str:
"""Returns a string."""
return "whoops"
@get("/", dependencies={"injected": Provide(provide_str)}, sync_to_thread=False)
def hello_world(injected: Annotated[int, Dependency(skip_validation=True)]) -> Dict[str, Any]:
"""Handler expects an `int`, but we've provided a `str`."""
return {"hello": injected}
app = Litestar(route_handlers=[hello_world])
litestar-2.18.0/docs/examples/dependency_injection/dependency_validation_error.py 0000664 0000000 0000000 00000000706 15070515525 0030502 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, get
from litestar.di import Provide
async def provide_str() -> str:
"""Returns a string."""
return "whoops"
@get("/", dependencies={"injected": Provide(provide_str)}, sync_to_thread=False)
def hello_world(injected: int) -> Dict[str, Any]:
"""Handler expects an `int`, but we've provided a `str`."""
return {"hello": injected}
app = Litestar(route_handlers=[hello_world])
litestar-2.18.0/docs/examples/dependency_injection/dependency_with_default.py 0000664 0000000 0000000 00000000630 15070515525 0027612 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, get
@get("/", sync_to_thread=False)
def hello_world(optional_dependency: int = 3) -> Dict[str, Any]:
"""Notice we haven't provided the dependency to the route.
This is OK, because of the default value, but the parameter shows in the docs.
"""
return {"hello": optional_dependency}
app = Litestar(route_handlers=[hello_world])
litestar-2.18.0/docs/examples/dependency_injection/dependency_with_dependency_fn_and_default.py 0000664 0000000 0000000 00000001022 15070515525 0033311 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from typing_extensions import Annotated
from litestar import Litestar, get
from litestar.params import Dependency
@get("/", sync_to_thread=False)
def hello_world(optional_dependency: Annotated[int, Dependency(default=3)]) -> Dict[str, Any]:
"""Notice we haven't provided the dependency to the route.
This is OK, because of the default value, and now the parameter is excluded from the docs.
"""
return {"hello": optional_dependency}
app = Litestar(route_handlers=[hello_world])
litestar-2.18.0/docs/examples/dependency_injection/dependency_yield_exceptions.py 0000664 0000000 0000000 00000001612 15070515525 0030503 0 ustar 00root root 0000000 0000000 from typing import Dict, Generator
from litestar import Litestar, get
from litestar.di import Provide
STATE = {"result": None, "connection": "closed"}
def generator_function() -> Generator[str, None, None]:
"""Set the connection state to open and close it after the handler returns.
If an error occurs, set `result` to `"error"`, else set it to `"OK"`.
"""
try:
STATE["connection"] = "open"
yield "hello"
STATE["result"] = "OK"
except ValueError:
STATE["result"] = "error"
finally:
STATE["connection"] = "closed"
@get("/{name:str}", dependencies={"message": Provide(generator_function)})
def index(name: str, message: str) -> Dict[str, str]:
"""If `name` is "John", return a message, otherwise raise an error."""
if name == "John":
return {name: message}
raise ValueError()
app = Litestar(route_handlers=[index])
litestar-2.18.0/docs/examples/dependency_injection/dependency_yield_simple.py 0000664 0000000 0000000 00000001103 15070515525 0027606 0 ustar 00root root 0000000 0000000 from typing import Dict, Generator
from litestar import Litestar, get
from litestar.di import Provide
CONNECTION = {"open": False}
def generator_function() -> Generator[Dict[str, bool], None, None]:
"""Set connection to open and close it after the handler returns."""
CONNECTION["open"] = True
yield CONNECTION
CONNECTION["open"] = False
@get("/", dependencies={"conn": Provide(generator_function)})
def index(conn: Dict[str, bool]) -> Dict[str, bool]:
"""Return the current connection state."""
return conn
app = Litestar(route_handlers=[index])
litestar-2.18.0/docs/examples/deployment/ 0000775 0000000 0000000 00000000000 15070515525 0020364 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/deployment/nginx-unit/ 0000775 0000000 0000000 00000000000 15070515525 0022464 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/deployment/nginx-unit/install-macos.sh 0000664 0000000 0000000 00000000101 15070515525 0025556 0 ustar 00root root 0000000 0000000 brew install unit-python311
brew install nginx/unit/unit-python3
litestar-2.18.0/docs/examples/deployment/nginx-unit/unit.json 0000664 0000000 0000000 00000000644 15070515525 0024342 0 ustar 00root root 0000000 0000000 {
"listeners": {
"*:8080": {
"pass": "applications/litestar"
}
},
"applications": {
"litestar": {
"type": "python 3.11",
"home": "/Users/user/project/litestar/.venv/",
"path": "/Users/user/project/litestar/src/app",
"module": "run",
"callable": "app",
"stderr": "/Users/user/project/litestar/error.log",
"user": "user",
"processes": 1
}
}
}
litestar-2.18.0/docs/examples/encoding_decoding/ 0000775 0000000 0000000 00000000000 15070515525 0021626 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/encoding_decoding/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023725 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/encoding_decoding/custom_type_encoding_decoding.py 0000664 0000000 0000000 00000004037 15070515525 0030261 0 ustar 00root root 0000000 0000000 from typing import Any, Type
from msgspec import Struct
from litestar import Litestar, post
class TenantUser:
"""Custom Type that represents a user associated to a tenant
Parsed from / serialized to a combined tenant + user id string of the form
TENANTPREFIX_USERID
i.e. separated by underscore.
"""
tenant_prefix: str
user_id: str
def __init__(self, tenant_prefix: str, user_id: str) -> None:
self.tenant_prefix = tenant_prefix
self.user_id = user_id
@classmethod
def from_string(cls, s: str) -> "TenantUser":
splits = s.split("_", maxsplit=1)
if len(splits) < 2:
raise ValueError(
"Could not split up tenant user id string. "
"Expecting underscore for separation of tenant prefix and user id."
)
return cls(tenant_prefix=splits[0], user_id=splits[1])
def to_combined_str(self) -> str:
return self.tenant_prefix + "_" + self.user_id
def tenant_user_type_predicate(type: Type) -> bool:
return type is TenantUser
def tenant_user_enc_hook(u: TenantUser) -> Any:
return u.to_combined_str()
def tenant_user_dec_hook(tenant_user_id_str: str) -> TenantUser:
return TenantUser.from_string(tenant_user_id_str)
def general_dec_hook(type: Type, obj: Any) -> Any:
if tenant_user_type_predicate(type):
return tenant_user_dec_hook(obj)
raise NotImplementedError(f"Encountered unknown type during decoding: {type!s}")
class UserAsset(Struct):
user: TenantUser
name: str
@post("/asset", sync_to_thread=False)
def create_asset(
data: UserAsset,
) -> UserAsset:
assert isinstance(data.user, TenantUser)
return data
app = Litestar(
[create_asset],
type_encoders={TenantUser: tenant_user_enc_hook}, # tell litestar how to encode TenantUser
type_decoders=[(tenant_user_type_predicate, general_dec_hook)], # tell litestar how to decode TenantUser
)
# run: /asset -X POST -H "Content-Type: application/json" -d '{"name":"SomeAsset","user":"TenantA_Somebody"}'
litestar-2.18.0/docs/examples/encoding_decoding/custom_type_pydantic.py 0000664 0000000 0000000 00000003343 15070515525 0026451 0 ustar 00root root 0000000 0000000 from pydantic import BaseModel, BeforeValidator, ConfigDict, PlainSerializer, WithJsonSchema
from typing_extensions import Annotated
from litestar import Litestar, post
class TenantUser:
"""Custom Type that represents a user associated to a tenant
Parsed from / serialized to a combined tenant + user id string of the form
TENANTPREFIX_USERID
i.e. separated by underscore.
"""
tenant_prefix: str
user_id: str
def __init__(self, tenant_prefix: str, user_id: str) -> None:
self.tenant_prefix = tenant_prefix
self.user_id = user_id
@classmethod
def from_string(cls, s: str) -> "TenantUser":
splits = s.split("_", maxsplit=1)
if len(splits) < 2:
raise ValueError(
"Could not split up tenant user id string. "
"Expecting underscore for separation of tenant prefix and user id."
)
return cls(tenant_prefix=splits[0], user_id=splits[1])
def to_combined_str(self) -> str:
return self.tenant_prefix + "_" + self.user_id
PydAnnotatedTenantUser = Annotated[
TenantUser,
BeforeValidator(lambda x: TenantUser.from_string(x)),
PlainSerializer(lambda x: x.to_combined_str(), return_type=str),
WithJsonSchema({"type": "string"}, mode="serialization"),
]
class UserAsset(BaseModel):
model_config = ConfigDict(arbitrary_types_allowed=True)
user: PydAnnotatedTenantUser
name: str
@post("/asset", sync_to_thread=False)
def create_asset(
data: UserAsset,
) -> UserAsset:
assert isinstance(data.user, TenantUser)
return data
app = Litestar(
[create_asset],
)
# run: /asset -X POST -H "Content-Type: application/json" -d '{"name":"SomeAsset","user":"TenantA_Somebody"}'
litestar-2.18.0/docs/examples/exceptions/ 0000775 0000000 0000000 00000000000 15070515525 0020365 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/exceptions/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022464 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/exceptions/implicit_media_type.py 0000664 0000000 0000000 00000000147 15070515525 0024753 0 ustar 00root root 0000000 0000000 from litestar import get
@get(sync_to_thread=False)
def handler(q: int) -> str:
raise ValueError
litestar-2.18.0/docs/examples/exceptions/layered_handlers.py 0000664 0000000 0000000 00000002035 15070515525 0024244 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request, Response, get
from litestar.exceptions import HTTPException, ValidationException
def app_exception_handler(request: Request, exc: HTTPException) -> Response:
return Response(
content={
"error": "server error",
"path": request.url.path,
"detail": exc.detail,
"status_code": exc.status_code,
},
status_code=500,
)
def router_handler_exception_handler(request: Request, exc: ValidationException) -> Response:
return Response(
content={"error": "validation error", "path": request.url.path},
status_code=400,
)
@get("/")
async def index() -> None:
raise HTTPException("something's gone wrong")
@get(
"/greet",
exception_handlers={ValidationException: router_handler_exception_handler},
)
async def greet(name: str) -> str:
return f"hello {name}"
app = Litestar(
route_handlers=[index, greet],
exception_handlers={HTTPException: app_exception_handler},
)
# run: /
# run: /greet
litestar-2.18.0/docs/examples/exceptions/override_default_handler.py 0000664 0000000 0000000 00000001436 15070515525 0025763 0 ustar 00root root 0000000 0000000 from litestar import Litestar, MediaType, Request, Response, get
from litestar.exceptions import HTTPException
from litestar.status_codes import HTTP_500_INTERNAL_SERVER_ERROR
def plain_text_exception_handler(_: Request, exc: Exception) -> Response:
"""Default handler for exceptions subclassed from HTTPException."""
status_code = getattr(exc, "status_code", HTTP_500_INTERNAL_SERVER_ERROR)
detail = getattr(exc, "detail", "")
return Response(
media_type=MediaType.TEXT,
content=detail,
status_code=status_code,
)
@get("/")
async def index() -> None:
raise HTTPException(detail="an error occurred", status_code=400)
app = Litestar(
route_handlers=[index],
exception_handlers={HTTPException: plain_text_exception_handler},
)
# run: /
litestar-2.18.0/docs/examples/exceptions/per_exception_handlers.py 0000664 0000000 0000000 00000002716 15070515525 0025471 0 ustar 00root root 0000000 0000000 from litestar import Litestar, MediaType, Request, Response, get
from litestar.exceptions import HTTPException, ValidationException
from litestar.status_codes import HTTP_500_INTERNAL_SERVER_ERROR
def validation_exception_handler(request: Request, exc: ValidationException) -> Response:
return Response(
media_type=MediaType.TEXT,
content=f"validation error: {exc.detail}",
status_code=400,
)
def internal_server_error_handler(request: Request, exc: Exception) -> Response:
return Response(
media_type=MediaType.TEXT,
content=f"server error: {exc}",
status_code=500,
)
def value_error_handler(request: Request, exc: ValueError) -> Response:
return Response(
media_type=MediaType.TEXT,
content=f"value error: {exc}",
status_code=400,
)
@get("/validation-error")
async def validation_error(some_query_param: str) -> str:
return some_query_param
@get("/server-error")
async def server_error() -> None:
raise HTTPException()
@get("/value-error")
async def value_error() -> None:
raise ValueError("this is wrong")
app = Litestar(
route_handlers=[validation_error, server_error, value_error],
exception_handlers={
ValidationException: validation_exception_handler,
HTTP_500_INTERNAL_SERVER_ERROR: internal_server_error_handler,
ValueError: value_error_handler,
},
)
# run: /validation-error
# run: /server-error
# run: /value-error
litestar-2.18.0/docs/examples/hello_world.py 0000664 0000000 0000000 00000000411 15070515525 0021064 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, get
@get("/")
async def hello_world() -> Dict[str, str]:
"""Handler function that returns a greeting dictionary."""
return {"hello": "world"}
app = Litestar(route_handlers=[hello_world])
# run: /
litestar-2.18.0/docs/examples/lifecycle_hooks/ 0000775 0000000 0000000 00000000000 15070515525 0021346 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/lifecycle_hooks/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023445 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/lifecycle_hooks/after_request.py 0000664 0000000 0000000 00000001025 15070515525 0024567 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, MediaType, Response, get
async def after_request(response: Response) -> Response:
if response.media_type == MediaType.TEXT:
return Response({"message": response.content})
return response
@get("/hello")
async def hello() -> str:
return "Hello, world"
@get("/goodbye")
async def goodbye() -> Dict[str, str]:
return {"message": "Goodbye"}
app = Litestar(route_handlers=[hello, goodbye], after_request=after_request)
# run: /hello
# run: /goodbye
litestar-2.18.0/docs/examples/lifecycle_hooks/after_response.py 0000664 0000000 0000000 00000000635 15070515525 0024743 0 ustar 00root root 0000000 0000000 from collections import defaultdict
from typing import Dict
from litestar import Litestar, Request, get
COUNTER: Dict[str, int] = defaultdict(int)
async def after_response(request: Request) -> None:
COUNTER[request.url.path] += 1
@get("/hello")
async def hello() -> Dict[str, int]:
return COUNTER
app = Litestar(route_handlers=[hello], after_response=after_response)
# run: /hello
# run: /hello
litestar-2.18.0/docs/examples/lifecycle_hooks/before_request.py 0000664 0000000 0000000 00000001205 15070515525 0024730 0 ustar 00root root 0000000 0000000 from typing import Dict, Optional
from litestar import Litestar, Request, get
async def before_request_handler(request: Request) -> Optional[Dict[str, str]]:
name = request.query_params["name"]
if name == "Ben":
return {"message": "These are not the bytes you are looking for"}
request.state["message"] = f"Use the handler, {name}"
return None
@get("/")
async def handler(request: Request, name: str) -> Dict[str, str]:
message: str = request.state["message"]
return {"message": message}
app = Litestar(route_handlers=[handler], before_request=before_request_handler)
# run: /?name=Luke
# run: /?name=Ben
litestar-2.18.0/docs/examples/lifecycle_hooks/layered_hooks.py 0000664 0000000 0000000 00000001124 15070515525 0024546 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Response, get
def after_request_app(response: Response) -> Response:
return Response(content=b"app after request")
def after_request_handler(response: Response) -> Response:
return Response(content=b"handler after request")
@get("/")
async def handler() -> str:
return "hello, world"
@get("/override", after_request=after_request_handler)
async def handler_with_override() -> str:
return "hello, world"
app = Litestar(
route_handlers=[handler, handler_with_override],
after_request=after_request_app,
)
# run: /
# run: /override
litestar-2.18.0/docs/examples/middleware/ 0000775 0000000 0000000 00000000000 15070515525 0020321 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/middleware/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022420 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/middleware/abstract_middleware_migration_new.py 0000664 0000000 0000000 00000001007 15070515525 0027613 0 ustar 00root root 0000000 0000000 import anyio
from litestar import Litestar
from litestar.middleware import ASGIMiddleware
from litestar.types import ASGIApp, Receive, Scope, Send
class TimeoutMiddleware(ASGIMiddleware):
def __init__(self, timeout: float):
self.timeout = timeout
async def handle(self, scope: Scope, receive: Receive, send: Send, next_app: ASGIApp) -> None:
with anyio.move_on_after(self.timeout):
await next_app(scope, receive, send)
app = Litestar(middleware=[TimeoutMiddleware(timeout=5)])
litestar-2.18.0/docs/examples/middleware/abstract_middleware_migration_old.py 0000664 0000000 0000000 00000001563 15070515525 0027607 0 ustar 00root root 0000000 0000000 import anyio
from litestar import Litestar
from litestar.middleware import AbstractMiddleware, DefineMiddleware
from litestar.types import ASGIApp, Receive, Scope, Scopes, Send
class TimeoutMiddleware(AbstractMiddleware):
def __init__(
self,
app: ASGIApp,
timeout: float,
exclude: str | list[str] | None = None,
exclude_opt_key: str | None = None,
scopes: Scopes | None = None,
):
self.timeout = timeout
super().__init__(app=app, exclude=exclude, exclude_opt_key=exclude_opt_key, scopes=scopes)
async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
with anyio.move_on_after(self.timeout):
await self.app(scope, receive, send)
app = Litestar(
middleware=[
DefineMiddleware(
TimeoutMiddleware,
timeout=5,
)
]
)
litestar-2.18.0/docs/examples/middleware/base.py 0000664 0000000 0000000 00000004530 15070515525 0021607 0 ustar 00root root 0000000 0000000 import time
from typing import Dict
from litestar import Litestar, WebSocket, get, websocket
from litestar.datastructures import MutableScopeHeaders
from litestar.enums import ScopeType
from litestar.middleware import ASGIMiddleware
from litestar.types import ASGIApp, Message, Receive, Scope, Send
class MyMiddleware(ASGIMiddleware):
scopes = (ScopeType.HTTP,)
exclude_path_pattern = ("first_path", "second_path")
exclude_opt_key = "exclude_from_my_middleware"
async def handle(self, scope: Scope, receive: Receive, send: Send, next_app: ASGIApp) -> None:
start_time = time.monotonic()
async def send_wrapper(message: "Message") -> None:
if message["type"] == "http.response.start":
process_time = time.monotonic() - start_time
headers = MutableScopeHeaders.from_message(message=message)
headers["X-Process-Time"] = str(process_time)
await send(message)
await next_app(scope, receive, send_wrapper)
@websocket("/my-websocket")
async def websocket_handler(socket: WebSocket) -> None:
"""
Websocket handler - is excluded because the middleware scopes includes 'ScopeType.HTTP'
"""
await socket.accept()
await socket.send_json({"hello": "websocket"})
await socket.close()
@get("/first_path", sync_to_thread=False)
def first_handler() -> Dict[str, str]:
"""Handler is excluded due to regex pattern matching "first_path"."""
return {"hello": "first"}
@get("/second_path", sync_to_thread=False)
def second_handler() -> Dict[str, str]:
"""Handler is excluded due to regex pattern matching "second_path"."""
return {"hello": "second"}
@get("/third_path", exclude_from_my_middleware=True, sync_to_thread=False)
def third_handler() -> Dict[str, str]:
"""Handler is excluded due to the opt key 'exclude_from_my_middleware' matching the middleware 'exclude_opt_key'."""
return {"hello": "third"}
@get("/greet", sync_to_thread=False)
def not_excluded_handler() -> Dict[str, str]:
"""This handler is not excluded, and thus the middleware will execute on every incoming request to it."""
return {"hello": "world"}
app = Litestar(
route_handlers=[
websocket_handler,
first_handler,
second_handler,
third_handler,
not_excluded_handler,
],
middleware=[MyMiddleware()],
)
litestar-2.18.0/docs/examples/middleware/call_order.py 0000664 0000000 0000000 00000002676 15070515525 0023014 0 ustar 00root root 0000000 0000000 from typing import TYPE_CHECKING, List, Type
from litestar import Controller, Litestar, Router, get
from litestar.datastructures import State
from litestar.middleware import MiddlewareProtocol
if TYPE_CHECKING:
from litestar.types import ASGIApp, Receive, Scope, Send
def create_test_middleware(middleware_id: int) -> Type[MiddlewareProtocol]:
class TestMiddleware(MiddlewareProtocol):
def __init__(self, app: "ASGIApp") -> None:
self.app = app
async def __call__(self, scope: "Scope", receive: "Receive", send: "Send") -> None:
litestar_app = scope["app"]
litestar_app.state.setdefault("middleware_calls", [])
litestar_app.state["middleware_calls"].append(middleware_id)
await self.app(scope, receive, send)
return TestMiddleware
class MyController(Controller):
path = "/controller"
middleware = [create_test_middleware(4), create_test_middleware(5)]
@get(
"/handler",
middleware=[create_test_middleware(6), create_test_middleware(7)],
)
async def my_handler(self, state: State) -> List[int]:
return state["middleware_calls"]
router = Router(
path="/router",
route_handlers=[MyController],
middleware=[create_test_middleware(2), create_test_middleware(3)],
)
app = Litestar(
route_handlers=[router],
middleware=[create_test_middleware(0), create_test_middleware(1)],
)
# run: /router/controller/handler
litestar-2.18.0/docs/examples/middleware/logging_middleware.py 0000664 0000000 0000000 00000000731 15070515525 0024517 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, get
from litestar.logging.config import LoggingConfig
from litestar.middleware.logging import LoggingMiddlewareConfig
logging_middleware_config = LoggingMiddlewareConfig()
@get("/", sync_to_thread=False)
def my_handler() -> Dict[str, str]:
return {"hello": "world"}
app = Litestar(
route_handlers=[my_handler],
logging_config=LoggingConfig(),
middleware=[logging_middleware_config.middleware],
)
litestar-2.18.0/docs/examples/middleware/middleware_protocol_migration_new.py 0000664 0000000 0000000 00000000461 15070515525 0027654 0 ustar 00root root 0000000 0000000 from litestar.middleware import ASGIMiddleware
from litestar.types import ASGIApp, Receive, Scope, Send
class MyMiddleware(ASGIMiddleware):
async def handle(self, scope: Scope, receive: Receive, send: Send, next_app: ASGIApp) -> None:
# do stuff
await next_app(scope, receive, send)
litestar-2.18.0/docs/examples/middleware/middleware_protocol_migration_old.py 0000664 0000000 0000000 00000000556 15070515525 0027646 0 ustar 00root root 0000000 0000000 from litestar.middleware import MiddlewareProtocol
from litestar.types import ASGIApp, Receive, Scope, Send
class MyMiddleware(MiddlewareProtocol):
def __init__(self, app: ASGIApp) -> None:
self.app = app
async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
# do stuff
await self.app(scope, receive, send)
litestar-2.18.0/docs/examples/middleware/rate_limit.py 0000664 0000000 0000000 00000000700 15070515525 0023021 0 ustar 00root root 0000000 0000000 from litestar import Litestar, MediaType, get
from litestar.middleware.rate_limit import RateLimitConfig
rate_limit_config = RateLimitConfig(rate_limit=("minute", 1), exclude=["/schema"])
@get("/", media_type=MediaType.TEXT, sync_to_thread=False)
def handler() -> str:
"""Handler which should not be accessed more than once per minute."""
return "ok"
app = Litestar(route_handlers=[handler], middleware=[rate_limit_config.middleware])
litestar-2.18.0/docs/examples/middleware/request_timing.py 0000664 0000000 0000000 00000001517 15070515525 0023736 0 ustar 00root root 0000000 0000000 import time
from litestar.datastructures import MutableScopeHeaders
from litestar.enums import ScopeType
from litestar.middleware import ASGIMiddleware
from litestar.types import ASGIApp, Message, Receive, Scope, Send
class ProcessTimeHeader(ASGIMiddleware):
scopes = (ScopeType.HTTP, ScopeType.ASGI)
async def handle(self, scope: Scope, receive: Receive, send: Send, next_app: ASGIApp) -> None:
start_time = time.monotonic()
async def send_wrapper(message: Message) -> None:
if message["type"] == "http.response.start":
process_time = time.monotonic() - start_time
headers = MutableScopeHeaders.from_message(message=message)
headers["X-Process-Time"] = str(process_time)
await send(message)
await next_app(scope, receive, send_wrapper)
litestar-2.18.0/docs/examples/middleware/session/ 0000775 0000000 0000000 00000000000 15070515525 0022004 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/middleware/session/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024103 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/middleware/session/cookie_backend.py 0000664 0000000 0000000 00000000400 15070515525 0025270 0 ustar 00root root 0000000 0000000 from os import urandom
from litestar import Litestar
from litestar.middleware.session.client_side import CookieBackendConfig
session_config = CookieBackendConfig(secret=urandom(16)) # type: ignore
app = Litestar(middleware=[session_config.middleware])
litestar-2.18.0/docs/examples/middleware/session/cookies_full_example.py 0000664 0000000 0000000 00000002325 15070515525 0026551 0 ustar 00root root 0000000 0000000 from os import urandom
from typing import Dict
from litestar import Litestar, Request, delete, get, post
from litestar.middleware.session.client_side import CookieBackendConfig
# we initialize to config with a 16 byte key, i.e. 128 a bit key.
# in real world usage we should inject the secret from the environment
session_config = CookieBackendConfig(secret=urandom(16)) # type: ignore[arg-type]
@get("/session", sync_to_thread=False)
def check_session_handler(request: Request) -> Dict[str, bool]:
"""Handler function that accesses request.session."""
return {"has_session": request.session != {}}
@post("/session", sync_to_thread=False)
def create_session_handler(request: Request) -> None:
"""Handler to set the session."""
if not request.session:
# value can be a dictionary or pydantic model
request.set_session({"username": "moishezuchmir"})
@delete("/session", sync_to_thread=False)
def delete_session_handler(request: Request) -> None:
"""Handler to clear the session."""
if request.session:
request.clear_session()
app = Litestar(
route_handlers=[check_session_handler, create_session_handler, delete_session_handler],
middleware=[session_config.middleware],
)
litestar-2.18.0/docs/examples/middleware/session/file_store.py 0000664 0000000 0000000 00000000470 15070515525 0024512 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.stores.file import FileStore
app = Litestar(
middleware=[ServerSideSessionConfig().middleware],
stores={"sessions": FileStore(path=Path("session_data"))},
)
litestar-2.18.0/docs/examples/middleware/using_asgi_middleware.py 0000664 0000000 0000000 00000003777 15070515525 0025236 0 ustar 00root root 0000000 0000000 import anyio
from litestar import Litestar, get
from litestar.enums import ScopeType
from litestar.exceptions import ClientException
from litestar.middleware import ASGIMiddleware
from litestar.types import ASGIApp, Receive, Scope, Send
class TimeoutMiddleware(ASGIMiddleware):
# we can configure some things on the class level here, related to when our
# middleware should be applied.
# if the requests' 'scope["type"]' is not "http", the middleware will be skipped
scopes = (ScopeType.HTTP,)
# if the handler for a request has set an opt of 'no_timeout=True', the middleware
# will be skipped
exclude_opt_key = "no_timeout"
# the base class does not define an '__init__' method, so we're free to overwrite
# this, which we're making use of to add some configuration
def __init__(
self,
timeout: float,
exclude_path_pattern: str | tuple[str, ...] | None = None,
) -> None:
self.timeout = timeout
# we can also dynamically configure the options provided by the base class on
# the instance level
self.exclude_path_pattern = exclude_path_pattern
async def handle(self, scope: Scope, receive: Receive, send: Send, next_app: ASGIApp) -> None:
try:
with anyio.fail_after(self.timeout):
# call the next app in the chain
await next_app(scope, receive, send)
except TimeoutError:
# if the request has timed out, raise an exception. since the whole
# application is wrapped in an exception handling middleware, it will
# transform this exception into a response for us
raise ClientException(status_code=408) from None
@get("/", no_timeout=True)
async def handler_with_opt_skip() -> None:
pass
@get("/not-this-path")
async def handler_with_path_skip() -> None:
pass
app = Litestar(
route_handlers=[
handler_with_opt_skip,
handler_with_path_skip,
],
middleware=[TimeoutMiddleware(timeout=5)],
)
litestar-2.18.0/docs/examples/openapi/ 0000775 0000000 0000000 00000000000 15070515525 0017637 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/openapi/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0021736 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/openapi/customize_openapi_types.py 0000664 0000000 0000000 00000000334 15070515525 0025172 0 ustar 00root root 0000000 0000000 from typing import Literal, Union
from litestar import Litestar, post
@post("/")
async def query_type_test(param: Union[Literal["1"], None]) -> None:
return None
app = Litestar(route_handlers=[query_type_test])
litestar-2.18.0/docs/examples/openapi/customize_operation_class.py 0000664 0000000 0000000 00000003242 15070515525 0025501 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass, field
from typing import Dict, List, Optional
from litestar import Litestar, MediaType, Request, post
from litestar.exceptions import HTTPException
from litestar.openapi.spec import OpenAPIMediaType, OpenAPIType, Operation, RequestBody, Schema
from litestar.status_codes import HTTP_400_BAD_REQUEST
@dataclass
class CustomOperation(Operation):
"""Custom Operation class which includes a non-standard field which is part of an OpenAPI extension."""
x_code_samples: Optional[List[Dict[str, str]]] = field(default=None, metadata={"alias": "x-codeSamples"})
def __post_init__(self) -> None:
self.tags = ["ok"]
self.description = "Requires OK, Returns OK"
self.request_body = RequestBody(
content={
"text": OpenAPIMediaType(
schema=Schema(
title="Body",
type=OpenAPIType.STRING,
example="OK",
)
),
},
description="OK is the only accepted value",
)
self.x_codeSamples = [
{"lang": "Python", "source": "import requests; requests.get('localhost/example')", "label": "Python"},
{"lang": "cURL", "source": "curl -XGET localhost/example", "label": "curl"},
]
@post("/", operation_class=CustomOperation, media_type=MediaType.TEXT)
async def route(request: Request) -> str:
"""
Returns: OK
"""
if (await request.body()) == b"OK":
return "OK"
raise HTTPException(status_code=HTTP_400_BAD_REQUEST, detail="request payload must be OK")
app = Litestar(route_handlers=[route])
litestar-2.18.0/docs/examples/openapi/customize_path.py 0000664 0000000 0000000 00000000644 15070515525 0023253 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, get
from litestar.openapi.config import OpenAPIConfig
@get("/")
def hello_world() -> Dict[str, str]:
return {"message": "Hello World"}
app = Litestar(
route_handlers=[hello_world],
openapi_config=OpenAPIConfig(
title="My API",
description="This is the description of my API",
version="0.1.0",
path="/docs",
),
)
litestar-2.18.0/docs/examples/openapi/customize_pydantic_model_name.py 0000664 0000000 0000000 00000000571 15070515525 0026311 0 ustar 00root root 0000000 0000000 from uuid import UUID, uuid4
from pydantic import BaseModel
from litestar import Litestar, get
class IdModel(BaseModel):
__schema_name__ = "IdContainer"
id: UUID
@get("/id", sync_to_thread=False)
def retrieve_id_handler() -> IdModel:
"""
Returns: An IdModel
"""
return IdModel(id=uuid4())
app = Litestar(route_handlers=[retrieve_id_handler])
litestar-2.18.0/docs/examples/openapi/plugins/ 0000775 0000000 0000000 00000000000 15070515525 0021320 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/openapi/plugins/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023417 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/openapi/plugins/custom_plugin.py 0000664 0000000 0000000 00000003222 15070515525 0024561 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from collections.abc import Sequence
from typing import Any
from litestar.connection import Request
from litestar.openapi.plugins import OpenAPIRenderPlugin
class ScalarRenderPlugin(OpenAPIRenderPlugin):
def __init__(
self,
*,
version: str = "1.19.5",
js_url: str | None = None,
css_url: str | None = None,
path: str | Sequence[str] = "/scalar",
**kwargs: Any,
) -> None:
self.js_url = js_url or f"https://cdn.jsdelivr.net/npm/@scalar/api-reference@{version}"
self.css_url = css_url
super().__init__(path=path, **kwargs)
def render(self, request: Request, openapi_schema: dict[str, Any]) -> bytes:
style_sheet_link = f'<link rel="stylesheet" type="text/css" href="{self.css_url}">' if self.css_url else ""
head = f"""
<head>
<title>{openapi_schema["info"]["title"]}
{self.style}
Flash Message Example
{% for message in get_flashes() %}
{{ message.message }} (Category:{{ message.category }})
{% endfor %}
"""
)
app = Litestar(
plugins=[flash_plugin],
route_handlers=[index],
template_config=template_config,
middleware=[ServerSideSessionConfig().middleware],
)
litestar-2.18.0/docs/examples/plugins/init_plugin_protocol.py 0000664 0000000 0000000 00000001171 15070515525 0024501 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, get
from litestar.config.app import AppConfig
from litestar.di import Provide
from litestar.plugins import InitPlugin
@get("/", sync_to_thread=False)
def route_handler(name: str) -> Dict[str, str]:
return {"hello": name}
def get_name() -> str:
return "world"
class MyPlugin(InitPlugin):
def on_app_init(self, app_config: AppConfig) -> AppConfig:
app_config.dependencies["name"] = Provide(get_name, sync_to_thread=False)
app_config.route_handlers.append(route_handler)
return app_config
app = Litestar(plugins=[MyPlugin()])
# run: /
litestar-2.18.0/docs/examples/plugins/problem_details/ 0000775 0000000 0000000 00000000000 15070515525 0023032 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/problem_details/basic_usage.py 0000664 0000000 0000000 00000001743 15070515525 0025656 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import Litestar, post
from litestar.plugins.problem_details import ProblemDetailsConfig, ProblemDetailsException, ProblemDetailsPlugin
@dataclass
class PurchaseItem:
item_id: int
quantity: int
@post("/purchase")
async def purchase(data: PurchaseItem) -> None:
# Logic to check if the user has enough credit to buy the item.
# We assume the user does not have enough credit.
raise ProblemDetailsException(
type_="https://example.com/probs/out-of-credit",
title="You do not have enough credit.",
detail="Your current balance is 30, but that costs 50.",
instance="/account/12345/msgs/abc",
extra={"balance": 30},
)
problem_details_plugin = ProblemDetailsPlugin(ProblemDetailsConfig())
app = Litestar(route_handlers=[purchase], plugins=[problem_details_plugin])
# run: /purchase --header "Content-Type: application/json" --request POST --data '{"item_id": 1234, "quantity": 2}'
litestar-2.18.0/docs/examples/plugins/problem_details/convert_exceptions.py 0000664 0000000 0000000 00000003011 15070515525 0027320 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from dataclasses import dataclass
from litestar import Litestar, post
from litestar.plugins.problem_details import ProblemDetailsConfig, ProblemDetailsException, ProblemDetailsPlugin
@dataclass
class PurchaseItem:
item_id: int
quantity: int
class PurchaseNotAllowedError(Exception):
def __init__(self, account_id: int, balance: int, detail: str) -> None:
self.account_id = account_id
self.balance = balance
self.detail = detail
@post("/purchase")
async def purchase(data: PurchaseItem) -> None:
raise PurchaseNotAllowedError(
account_id=12345,
balance=30,
detail="Your current balance is 30, but that costs 50.",
)
def convert_purchase_not_allowed_to_problem_details(exc: PurchaseNotAllowedError) -> ProblemDetailsException:
return ProblemDetailsException(
type_="https://example.com/probs/out-of-credit",
title="You do not have enough credit.",
detail=exc.detail,
instance=f"/account/{exc.account_id}/msgs/abc",
extra={"balance": exc.balance},
)
problem_details_plugin = ProblemDetailsPlugin(
ProblemDetailsConfig(
enable_for_all_http_exceptions=True,
exception_to_problem_detail_map={PurchaseNotAllowedError: convert_purchase_not_allowed_to_problem_details},
)
)
app = Litestar(route_handlers=[purchase], plugins=[problem_details_plugin])
# run: /purchase --header "Content-Type: application/json" --request POST --data '{"item_id": 1234, "quantity": 2}'
litestar-2.18.0/docs/examples/plugins/problem_details/convert_http_exceptions.py 0000664 0000000 0000000 00000001574 15070515525 0030373 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import Litestar, post
from litestar.exceptions.http_exceptions import NotFoundException
from litestar.plugins.problem_details import ProblemDetailsConfig, ProblemDetailsPlugin
@dataclass
class PurchaseItem:
item_id: int
quantity: int
@post("/purchase")
async def purchase(data: PurchaseItem) -> None:
# Logic to check if the user has enough credit to buy the item.
# We assume the user does not have enough credit.
raise NotFoundException(detail="No item with the given ID was found", extra={"item_id": data.item_id})
problem_details_plugin = ProblemDetailsPlugin(ProblemDetailsConfig(enable_for_all_http_exceptions=True))
app = Litestar(route_handlers=[purchase], plugins=[problem_details_plugin])
# run: /purchase --header "Content-Type: application/json" --request POST --data '{"item_id": 1234, "quantity": 2}'
litestar-2.18.0/docs/examples/plugins/prometheus/ 0000775 0000000 0000000 00000000000 15070515525 0022060 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/prometheus/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0024157 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/prometheus/using_prometheus_exporter.py 0000664 0000000 0000000 00000001244 15070515525 0027763 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.plugins.prometheus import PrometheusConfig, PrometheusController
def create_app(group_path: bool = False):
# Default app name and prefix is litestar.
prometheus_config = PrometheusConfig(group_path=group_path)
# By default the metrics are available in prometheus format and the path is set to '/metrics'.
# If you want to change the path and format you can do it by subclassing the PrometheusController class.
# Creating the litestar app instance with our custom PrometheusConfig and PrometheusController.
return Litestar(route_handlers=[PrometheusController], middleware=[prometheus_config.middleware])
litestar-2.18.0/docs/examples/plugins/prometheus/using_prometheus_exporter_with_extra_configs.py 0000664 0000000 0000000 00000003152 15070515525 0033731 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, Request
from litestar.plugins.prometheus import PrometheusConfig, PrometheusController
# We can modify the path of our custom handler and override the metrics format by subclassing the PrometheusController.
class CustomPrometheusController(PrometheusController):
path = "/custom-path"
openmetrics_format = True
# Let's assume this as our extra custom labels which we want our metrics to have.
# The values can be either a string or a callable that returns a string.
def custom_label_callable(request: Request[Any, Any, Any]) -> str:
return "v2.0"
extra_labels = {
"version_no": custom_label_callable,
"location": "earth",
}
# Customizing the buckets for the histogram.
buckets = [0.1, 0.2, 0.3, 0.4, 0.5]
# Adding exemplars to the metrics.
# Note that this supported only in openmetrics format.
def custom_exemplar(request: Request[Any, Any, Any]) -> Dict[str, str]:
return {"trace_id": "1234"}
# Creating the instance of PrometheusConfig with our own custom options.
# The given options are not necessary, you can use the default ones
# as well by just creating a raw instance PrometheusConfig()
prometheus_config = PrometheusConfig(
app_name="litestar-example",
prefix="litestar",
labels=extra_labels,
buckets=buckets, # pyright: ignore[reportArgumentType]
exemplars=custom_exemplar,
excluded_http_methods=["POST"],
)
# Creating the litestar app instance with our custom PrometheusConfig and PrometheusController.
app = Litestar(route_handlers=[CustomPrometheusController], middleware=[prometheus_config.middleware])
litestar-2.18.0/docs/examples/plugins/sqlalchemy/ 0000775 0000000 0000000 00000000000 15070515525 0022027 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/sqlalchemy/configure.py 0000664 0000000 0000000 00000000344 15070515525 0024363 0 ustar 00root root 0000000 0000000 from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyPlugin
sqlalchemy_config = SQLAlchemyAsyncConfig(connection_string="sqlite+aiosqlite:///test.sqlite")
plugin = SQLAlchemyPlugin(config=sqlalchemy_config)
litestar-2.18.0/docs/examples/plugins/sqlalchemy/modelling.py 0000664 0000000 0000000 00000000237 15070515525 0024355 0 ustar 00root root 0000000 0000000 from sqlalchemy.orm import Mapped
from litestar.plugins.sqlalchemy import base
class TodoItem(base.UUIDBase):
title: Mapped[str]
done: Mapped[bool]
litestar-2.18.0/docs/examples/plugins/sqlalchemy_init_plugin/ 0000775 0000000 0000000 00000000000 15070515525 0024430 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/sqlalchemy_init_plugin/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0026527 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/plugins/sqlalchemy_init_plugin/sqlalchemy_async.py 0000664 0000000 0000000 00000001610 15070515525 0030337 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import text
from litestar import Litestar, get
from litestar.plugins.sqlalchemy import SQLAlchemyAsyncConfig, SQLAlchemyInitPlugin
if TYPE_CHECKING:
from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession
@get(path="/sqlalchemy-app")
async def async_sqlalchemy_init(db_session: AsyncSession, db_engine: AsyncEngine) -> str:
"""Interact with SQLAlchemy engine and session."""
one = (await db_session.execute(text("SELECT 1"))).scalar_one()
async with db_engine.begin() as conn:
two = (await conn.execute(text("SELECT 2"))).scalar_one()
return f"{one} {two}"
sqlalchemy_config = SQLAlchemyAsyncConfig(connection_string="sqlite+aiosqlite:///test.sqlite")
app = Litestar(
route_handlers=[async_sqlalchemy_init],
plugins=[SQLAlchemyInitPlugin(config=sqlalchemy_config)],
)
litestar-2.18.0/docs/examples/plugins/sqlalchemy_init_plugin/sqlalchemy_sync.py 0000664 0000000 0000000 00000001565 15070515525 0030207 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from typing import TYPE_CHECKING
from sqlalchemy import text
from litestar import Litestar, get
from litestar.plugins.sqlalchemy import SQLAlchemyInitPlugin, SQLAlchemySyncConfig
if TYPE_CHECKING:
from sqlalchemy import Engine
from sqlalchemy.orm import Session
@get(path="/sqlalchemy-app", sync_to_thread=True)
def async_sqlalchemy_init(db_session: Session, db_engine: Engine) -> str:
"""Interact with SQLAlchemy engine and session."""
one = db_session.execute(text("SELECT 1")).scalar_one()
with db_engine.connect() as conn:
two = conn.execute(text("SELECT 2")).scalar_one()
return f"{one} {two}"
sqlalchemy_config = SQLAlchemySyncConfig(connection_string="sqlite:///test.sqlite")
app = Litestar(
route_handlers=[async_sqlalchemy_init],
plugins=[SQLAlchemyInitPlugin(config=sqlalchemy_config)],
)
litestar-2.18.0/docs/examples/request_data/ 0000775 0000000 0000000 00000000000 15070515525 0020665 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/request_data/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022764 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/request_data/custom_request.py 0000664 0000000 0000000 00000001664 15070515525 0024330 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request, get
from litestar.connection.base import empty_receive, empty_send
from litestar.enums import HttpMethod
from litestar.types import Receive, Scope, Send
KITTEN_NAMES_MAP = {
HttpMethod.GET: "Whiskers",
}
class CustomRequest(Request):
"""Enrich request with the kitten name."""
__slots__ = ("kitten_name",)
def __init__(self, scope: Scope, receive: Receive = empty_receive, send: Send = empty_send) -> None:
"""Initialize CustomRequest class."""
super().__init__(scope=scope, receive=receive, send=send)
self.kitten_name = KITTEN_NAMES_MAP.get(scope["method"], "Mittens")
@get(path="/kitten-name", sync_to_thread=False)
def get_kitten_name(request: CustomRequest) -> str:
"""Get kitten name based on the HTTP method."""
return request.kitten_name
app = Litestar(
route_handlers=[get_kitten_name],
request_class=CustomRequest,
debug=True,
)
litestar-2.18.0/docs/examples/request_data/msgpack_request.py 0000664 0000000 0000000 00000001015 15070515525 0024431 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.enums import RequestEncodingType
from litestar.params import Body
@post(path="/", sync_to_thread=False)
def msgpack_handler(
data: Annotated[Dict[str, Any], Body(media_type=RequestEncodingType.MESSAGEPACK)],
) -> Dict[str, Any]:
# This will try to parse the request body as `MessagePack` regardless of the
# `Content-Type`
return data
app = Litestar(route_handlers=[msgpack_handler])
litestar-2.18.0/docs/examples/request_data/request_data_1.py 0000664 0000000 0000000 00000000301 15070515525 0024132 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, post
@post(path="/")
async def index(data: Dict[str, str]) -> Dict[str, str]:
return data
app = Litestar(route_handlers=[index])
litestar-2.18.0/docs/examples/request_data/request_data_10.py 0000664 0000000 0000000 00000001211 15070515525 0024213 0 ustar 00root root 0000000 0000000 from typing import Any, Dict, List, Tuple
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
@post(path="/")
async def handle_file_upload(
data: Annotated[List[UploadFile], Body(media_type=RequestEncodingType.MULTI_PART)],
) -> Dict[str, Tuple[str, str, Any]]:
result = {}
for file in data:
content = await file.read()
result[file.filename] = (len(content), file.content_type, file.headers)
return result
app = Litestar(route_handlers=[handle_file_upload])
litestar-2.18.0/docs/examples/request_data/request_data_2.py 0000664 0000000 0000000 00000000352 15070515525 0024141 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from litestar import Litestar, post
@dataclass
class User:
id: int
name: str
@post(path="/")
async def index(data: User) -> User:
return data
app = Litestar(route_handlers=[index])
litestar-2.18.0/docs/examples/request_data/request_data_3.py 0000664 0000000 0000000 00000000617 15070515525 0024146 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.params import Body
@dataclass
class User:
id: int
name: str
@post(path="/")
async def create_user(
data: Annotated[User, Body(title="Create User", description="Create a new user.")],
) -> User:
return data
app = Litestar(route_handlers=[create_user])
litestar-2.18.0/docs/examples/request_data/request_data_4.py 0000664 0000000 0000000 00000000663 15070515525 0024150 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.enums import RequestEncodingType
from litestar.params import Body
@dataclass
class User:
id: int
name: str
@post(path="/")
async def create_user(
data: Annotated[User, Body(media_type=RequestEncodingType.URL_ENCODED)],
) -> User:
return data
app = Litestar(route_handlers=[create_user])
litestar-2.18.0/docs/examples/request_data/request_data_5.py 0000664 0000000 0000000 00000001312 15070515525 0024141 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import Dict
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
@dataclass
class User:
id: int
name: str
form_input_name: UploadFile
@post(path="/")
async def create_user(
data: Annotated[User, Body(media_type=RequestEncodingType.MULTI_PART)],
) -> Dict[str, str]:
content = await data.form_input_name.read()
filename = data.form_input_name.filename
return {"id": data.id, "name": data.name, "filename": filename, "size": len(content)}
app = Litestar(route_handlers=[create_user])
litestar-2.18.0/docs/examples/request_data/request_data_6.py 0000664 0000000 0000000 00000001041 15070515525 0024141 0 ustar 00root root 0000000 0000000 from typing_extensions import Annotated
from litestar import Litestar, MediaType, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
@post(path="/", media_type=MediaType.TEXT)
async def handle_file_upload(
data: Annotated[UploadFile, Body(media_type=RequestEncodingType.MULTI_PART)],
) -> str:
content = await data.read()
filename = data.filename
return f"{filename},length: {len(content)}"
app = Litestar(route_handlers=[handle_file_upload])
litestar-2.18.0/docs/examples/request_data/request_data_7.py 0000664 0000000 0000000 00000001060 15070515525 0024143 0 ustar 00root root 0000000 0000000 from typing_extensions import Annotated
from litestar import Litestar, MediaType, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
@post(path="/", media_type=MediaType.TEXT, sync_to_thread=False)
def handle_file_upload(
data: Annotated[UploadFile, Body(media_type=RequestEncodingType.MULTI_PART)],
) -> str:
content = data.file.read()
filename = data.filename
return f"{filename},length: {len(content)}"
app = Litestar(route_handlers=[handle_file_upload])
litestar-2.18.0/docs/examples/request_data/request_data_8.py 0000664 0000000 0000000 00000001402 15070515525 0024144 0 ustar 00root root 0000000 0000000 from typing import Dict
from pydantic import BaseModel, ConfigDict
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
class FormData(BaseModel):
model_config = ConfigDict(arbitrary_types_allowed=True)
cv: UploadFile
diploma: UploadFile
@post(path="/")
async def handle_file_upload(
data: Annotated[FormData, Body(media_type=RequestEncodingType.MULTI_PART)],
) -> Dict[str, str]:
cv_content = await data.cv.read()
diploma_content = await data.diploma.read()
return {"cv": cv_content.decode(), "diploma": diploma_content.decode()}
app = Litestar(route_handlers=[handle_file_upload])
litestar-2.18.0/docs/examples/request_data/request_data_9.py 0000664 0000000 0000000 00000001152 15070515525 0024147 0 ustar 00root root 0000000 0000000 from typing import Dict
from typing_extensions import Annotated
from litestar import Litestar, post
from litestar.datastructures import UploadFile
from litestar.enums import RequestEncodingType
from litestar.params import Body
@post(path="/")
async def handle_file_upload(
data: Annotated[Dict[str, UploadFile], Body(media_type=RequestEncodingType.MULTI_PART)],
) -> Dict[str, str]:
file_contents = {}
for name, file in data.items():
content = await file.read()
file_contents[file.filename] = len(content)
return file_contents
app = Litestar(route_handlers=[handle_file_upload])
litestar-2.18.0/docs/examples/responses/ 0000775 0000000 0000000 00000000000 15070515525 0020225 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/responses/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022324 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/responses/background_tasks_1.py 0000664 0000000 0000000 00000001071 15070515525 0024342 0 ustar 00root root 0000000 0000000 import logging
from typing import Dict
from litestar import Litestar, Response, get
from litestar.background_tasks import BackgroundTask
logger = logging.getLogger(__name__)
async def logging_task(identifier: str, message: str) -> None:
logger.info("%s: %s", identifier, message)
@get("/", sync_to_thread=False)
def greeter(name: str) -> Response[Dict[str, str]]:
return Response(
{"hello": name},
background=BackgroundTask(logging_task, "greeter", message=f"was called with name {name}"),
)
app = Litestar(route_handlers=[greeter])
litestar-2.18.0/docs/examples/responses/background_tasks_2.py 0000664 0000000 0000000 00000000754 15070515525 0024352 0 ustar 00root root 0000000 0000000 import logging
from typing import Dict
from litestar import Litestar, get
from litestar.background_tasks import BackgroundTask
logger = logging.getLogger(__name__)
async def logging_task(identifier: str, message: str) -> None:
logger.info("%s: %s", identifier, message)
@get("/", background=BackgroundTask(logging_task, "greeter", message="was called"), sync_to_thread=False)
def greeter() -> Dict[str, str]:
return {"hello": "world"}
app = Litestar(route_handlers=[greeter])
litestar-2.18.0/docs/examples/responses/background_tasks_3.py 0000664 0000000 0000000 00000001317 15070515525 0024347 0 ustar 00root root 0000000 0000000 import logging
from typing import Dict
from litestar import Litestar, Response, get
from litestar.background_tasks import BackgroundTask, BackgroundTasks
logger = logging.getLogger(__name__)
greeted = set()
async def logging_task(name: str) -> None:
logger.info("%s was greeted", name)
async def saving_task(name: str) -> None:
greeted.add(name)
@get("/", sync_to_thread=False)
def greeter(name: str) -> Response[Dict[str, str]]:
return Response(
{"hello": name},
background=BackgroundTasks(
[
BackgroundTask(logging_task, name),
BackgroundTask(saving_task, name),
]
),
)
app = Litestar(route_handlers=[greeter])
litestar-2.18.0/docs/examples/responses/custom_responses.py 0000664 0000000 0000000 00000000536 15070515525 0024216 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Response, get
from litestar.datastructures import MultiDict
class MultiDictResponse(Response):
type_encoders = {MultiDict: lambda d: d.dict()}
@get("/")
async def index() -> MultiDict:
return MultiDict([("foo", "bar"), ("foo", "baz")])
app = Litestar([index], response_class=MultiDictResponse)
# run: /
litestar-2.18.0/docs/examples/responses/json_suffix_responses.py 0000664 0000000 0000000 00000000771 15070515525 0025242 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
import litestar.status_codes
from litestar import Litestar, get
@get(
"/resources",
status_code=litestar.status_codes.HTTP_418_IM_A_TEAPOT,
media_type="application/vnd.example.resource+json",
)
async def retrieve_resource() -> Dict[str, Any]:
return {
"title": "Server thinks it is a teapot",
"type": "Server delusion",
"status": litestar.status_codes.HTTP_418_IM_A_TEAPOT,
}
app = Litestar(route_handlers=[retrieve_resource])
litestar-2.18.0/docs/examples/responses/response_content.py 0000664 0000000 0000000 00000001477 15070515525 0024200 0 ustar 00root root 0000000 0000000 from litestar import Litestar, MediaType, Request, Response, get
@get("/resource", sync_to_thread=False)
def retrieve_resource(request: Request) -> Response[bytes]:
provided_types = [MediaType.TEXT, MediaType.HTML, "application/xml"]
preferred_type = request.accept.best_match(provided_types, default=MediaType.TEXT)
content = None
if preferred_type == MediaType.TEXT:
content = b"Hello World!"
elif preferred_type == MediaType.HTML:
content = b"Hello World! "
elif preferred_type == "application/xml":
content = b"Hello World! Hello, world! ")
HTML_DIR.joinpath("404.html").write_text("Not found ")
app = Litestar(
route_handlers=[
create_static_files_router(
path="/",
directories=["html"],
html_mode=True,
)
],
on_startup=[on_startup],
)
# run: /
# run: /index.html
# run: /something
litestar-2.18.0/docs/examples/static_files/passing_options.py 0000664 0000000 0000000 00000000523 15070515525 0024446 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.static_files import create_static_files_router
app = Litestar(
route_handlers=[
create_static_files_router(
path="/",
directories=["assets"],
opt={"some": True},
include_in_schema=False,
tags=["static"],
)
]
)
litestar-2.18.0/docs/examples/static_files/route_reverse.py 0000664 0000000 0000000 00000000464 15070515525 0024124 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.static_files import create_static_files_router
app = Litestar(
route_handlers=[
create_static_files_router(path="/static", directories=["assets"]),
]
)
print(app.route_reverse(name="static", file_path="/some_file.txt")) # /static/some_file.txt
litestar-2.18.0/docs/examples/static_files/send_as_attachment.py 0000664 0000000 0000000 00000000434 15070515525 0025054 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.static_files import create_static_files_router
app = Litestar(
route_handlers=[
create_static_files_router(
path="/static",
directories=["assets"],
send_as_attachment=True,
)
]
)
litestar-2.18.0/docs/examples/static_files/upgrade_from_static_1.py 0000664 0000000 0000000 00000000320 15070515525 0025463 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.static_files.config import StaticFilesConfig
app = Litestar(
static_files_config=[
StaticFilesConfig(directories=["assets"], path="/static"),
],
)
litestar-2.18.0/docs/examples/static_files/upgrade_from_static_2.py 0000664 0000000 0000000 00000000326 15070515525 0025472 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.static_files import create_static_files_router
app = Litestar(
route_handlers=[
create_static_files_router(directories=["assets"], path="/static"),
],
)
litestar-2.18.0/docs/examples/stores/ 0000775 0000000 0000000 00000000000 15070515525 0017523 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/stores/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0021622 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/stores/configure_integrations_set_names.py 0000664 0000000 0000000 00000001230 15070515525 0026676 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.config.response_cache import ResponseCacheConfig
from litestar.middleware.rate_limit import RateLimitConfig
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.stores.file import FileStore
from litestar.stores.redis import RedisStore
app = Litestar(
stores={"redis": RedisStore.with_client(), "file": FileStore(Path("data"))},
response_cache_config=ResponseCacheConfig(store="redis"),
middleware=[
ServerSideSessionConfig(store="file").middleware,
RateLimitConfig(rate_limit=("second", 10), store="redis").middleware,
],
)
litestar-2.18.0/docs/examples/stores/delete_expired_after_response.py 0000664 0000000 0000000 00000000773 15070515525 0026165 0 ustar 00root root 0000000 0000000 from datetime import datetime, timedelta
from litestar import Litestar, Request
from litestar.stores.memory import MemoryStore
memory_store = MemoryStore()
async def after_response(request: Request) -> None:
now = datetime.utcnow()
last_cleared = request.app.state.get("store_last_cleared", now)
if datetime.utcnow() - last_cleared > timedelta(seconds=30):
await memory_store.delete_expired()
app.state["store_last_cleared"] = now
app = Litestar(after_response=after_response)
litestar-2.18.0/docs/examples/stores/delete_expired_on_startup.py 0000664 0000000 0000000 00000000373 15070515525 0025340 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.stores.file import FileStore
file_store = FileStore(Path("data"))
async def on_startup() -> None:
await file_store.delete_expired()
app = Litestar(on_startup=[on_startup])
litestar-2.18.0/docs/examples/stores/expiry.py 0000664 0000000 0000000 00000000540 15070515525 0021414 0 ustar 00root root 0000000 0000000 from asyncio import sleep
from litestar.stores.memory import MemoryStore
store = MemoryStore()
async def main() -> None:
await store.set("foo", b"bar", expires_in=1)
value = await store.get("foo")
print(value)
await sleep(1)
value = await store.get("foo") # this will return 'None', since the key has expired
print(value)
litestar-2.18.0/docs/examples/stores/expiry_renew_on_get.py 0000664 0000000 0000000 00000001042 15070515525 0024145 0 ustar 00root root 0000000 0000000 from asyncio import sleep
from litestar.stores.memory import MemoryStore
store = MemoryStore()
async def main() -> None:
await store.set("foo", b"bar", expires_in=1)
await sleep(0.5)
await store.get("foo", renew_for=1) # this will reset the time to live to one second
await sleep(1)
# it has now been 1.5 seconds since the key was set with a life time of one second,
# so it should have expired however, since it was renewed for one second, it is still available
value = await store.get("foo")
print(value)
litestar-2.18.0/docs/examples/stores/get_set.py 0000664 0000000 0000000 00000000472 15070515525 0021532 0 ustar 00root root 0000000 0000000 from litestar.stores.memory import MemoryStore
store = MemoryStore()
async def main() -> None:
value = await store.get("key")
print(value) # this will print 'None', as no store with this key has been defined yet
await store.set("key", b"value")
value = await store.get("key")
print(value)
litestar-2.18.0/docs/examples/stores/namespacing.py 0000664 0000000 0000000 00000000527 15070515525 0022366 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.stores.redis import RedisStore
root_store = RedisStore.with_client()
cache_store = root_store.with_namespace("cache")
session_store = root_store.with_namespace("sessions")
async def before_shutdown() -> None:
await cache_store.delete_all()
app = Litestar(before_shutdown=[before_shutdown])
litestar-2.18.0/docs/examples/stores/registry.py 0000664 0000000 0000000 00000000645 15070515525 0021752 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.stores.memory import MemoryStore
app = Litestar([], stores={"memory": MemoryStore()})
memory_store = app.stores.get("memory")
# this is the previously defined store
some_other_store = app.stores.get("something_else")
# this will be a newly created instance
assert app.stores.get("something_else") is some_other_store
# but subsequent requests will return the same instance
litestar-2.18.0/docs/examples/stores/registry_access_integration.py 0000664 0000000 0000000 00000000321 15070515525 0025665 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.middleware.rate_limit import RateLimitConfig
app = Litestar(middleware=[RateLimitConfig(("second", 1)).middleware])
rate_limit_store = app.stores.get("rate_limit")
litestar-2.18.0/docs/examples/stores/registry_configure_integrations.py 0000664 0000000 0000000 00000000645 15070515525 0026601 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.stores.file import FileStore
from litestar.stores.redis import RedisStore
app = Litestar(
stores={
"sessions": RedisStore.with_client(),
"response_cache": FileStore(Path("response-cache")),
},
middleware=[ServerSideSessionConfig().middleware],
)
litestar-2.18.0/docs/examples/stores/registry_default_factory.py 0000664 0000000 0000000 00000000463 15070515525 0025203 0 ustar 00root root 0000000 0000000 from litestar import Litestar
from litestar.stores.memory import MemoryStore
from litestar.stores.registry import StoreRegistry
memory_store = MemoryStore()
def default_factory(name: str) -> MemoryStore:
return memory_store
app = Litestar([], stores=StoreRegistry(default_factory=default_factory))
litestar-2.18.0/docs/examples/stores/registry_default_factory_namespacing.py 0000664 0000000 0000000 00000001257 15070515525 0027552 0 ustar 00root root 0000000 0000000 from litestar import Litestar, get
from litestar.middleware.rate_limit import RateLimitConfig
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.stores.redis import RedisStore
from litestar.stores.registry import StoreRegistry
root_store = RedisStore.with_client()
@get(cache=True, sync_to_thread=False)
def cached_handler() -> str:
# this will use app.stores.get("response_cache")
return "Hello, world!"
app = Litestar(
[cached_handler],
stores=StoreRegistry(default_factory=root_store.with_namespace),
middleware=[
RateLimitConfig(("second", 1)).middleware,
ServerSideSessionConfig().middleware,
],
)
litestar-2.18.0/docs/examples/templating/ 0000775 0000000 0000000 00000000000 15070515525 0020350 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/templating/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022447 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/templating/engine_instance_jinja.py 0000664 0000000 0000000 00000000300 15070515525 0025217 0 ustar 00root root 0000000 0000000 from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.template.config import TemplateConfig
template_config = TemplateConfig(engine=JinjaTemplateEngine, directory="templates")
litestar-2.18.0/docs/examples/templating/engine_instance_mako.py 0000664 0000000 0000000 00000000275 15070515525 0025066 0 ustar 00root root 0000000 0000000 from litestar.contrib.mako import MakoTemplateEngine
from litestar.template.config import TemplateConfig
template_config = TemplateConfig(engine=MakoTemplateEngine, directory="templates")
litestar-2.18.0/docs/examples/templating/engine_instance_minijinja.py 0000664 0000000 0000000 00000000314 15070515525 0026101 0 ustar 00root root 0000000 0000000 from litestar.contrib.minijinja import MiniJinjaTemplateEngine
from litestar.template.config import TemplateConfig
template_config = TemplateConfig(engine=MiniJinjaTemplateEngine, directory="templates")
litestar-2.18.0/docs/examples/templating/returning_templates_jinja.py 0000664 0000000 0000000 00000001370 15070515525 0026171 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar, get
from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.response import Template
from litestar.template.config import TemplateConfig
@get(path="/{template_type: str}", sync_to_thread=False)
def index(name: str, template_type: str) -> Template:
if template_type == "file":
return Template(template_name="hello.html.jinja2", context={"name": name})
elif template_type == "string":
return Template(template_str="Hello Jinja using strings", context={"name": name})
app = Litestar(
route_handlers=[index],
template_config=TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=JinjaTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/returning_templates_mako.py 0000664 0000000 0000000 00000001426 15070515525 0026027 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from pathlib import Path
from litestar import Litestar, get
from litestar.contrib.mako import MakoTemplateEngine
from litestar.response import Template
from litestar.template.config import TemplateConfig
@get(path="/{template_type: str}", sync_to_thread=False)
def index(name: str, template_type: str) -> Template:
if template_type == "file":
return Template(template_name="hello.html.mako", context={"name": name})
elif template_type == "string":
return Template(template_str="Hello Mako using strings", context={"name": name})
app = Litestar(
route_handlers=[index],
template_config=TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=MakoTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/returning_templates_minijinja.py 0000664 0000000 0000000 00000001457 15070515525 0027054 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from pathlib import Path
from litestar import Litestar, get
from litestar.contrib.minijinja import MiniJinjaTemplateEngine
from litestar.response import Template
from litestar.template.config import TemplateConfig
@get(path="/{template_type: str}", sync_to_thread=False)
def index(name: str, template_type: str) -> Template:
if template_type == "file":
return Template(template_name="hello.html.minijinja", context={"name": name})
elif template_type == "string":
return Template(template_str="Hello Minijinja using strings", context={"name": name})
app = Litestar(
route_handlers=[index],
template_config=TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=MiniJinjaTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/template_engine_jinja.py 0000664 0000000 0000000 00000000501 15070515525 0025231 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.template.config import TemplateConfig
app = Litestar(
route_handlers=[],
template_config=TemplateConfig(
directory=Path("templates"),
engine=JinjaTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/template_engine_mako.py 0000664 0000000 0000000 00000000476 15070515525 0025100 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.contrib.mako import MakoTemplateEngine
from litestar.template.config import TemplateConfig
app = Litestar(
route_handlers=[],
template_config=TemplateConfig(
directory=Path("templates"),
engine=MakoTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/template_engine_minijinja.py 0000664 0000000 0000000 00000000515 15070515525 0026113 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar
from litestar.contrib.minijinja import MiniJinjaTemplateEngine
from litestar.template.config import TemplateConfig
app = Litestar(
route_handlers=[],
template_config=TemplateConfig(
directory=Path("templates"),
engine=MiniJinjaTemplateEngine,
),
)
litestar-2.18.0/docs/examples/templating/template_functions_jinja.py 0000664 0000000 0000000 00000001610 15070515525 0025776 0 ustar 00root root 0000000 0000000 from pathlib import Path
from typing import Any, Dict
from litestar import Litestar, get
from litestar.contrib.jinja import JinjaTemplateEngine
from litestar.response import Template
from litestar.template.config import TemplateConfig
def my_template_function(ctx: Dict[str, Any]) -> str:
return ctx.get("my_context_key", "nope")
def register_template_callables(engine: JinjaTemplateEngine) -> None:
engine.register_template_callable(
key="check_context_key",
template_callable=my_template_function,
)
template_config = TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=JinjaTemplateEngine,
engine_callback=register_template_callables,
)
@get("/", sync_to_thread=False)
def index() -> Template:
return Template(template_name="index.html.jinja2")
app = Litestar(
route_handlers=[index],
template_config=template_config,
)
litestar-2.18.0/docs/examples/templating/template_functions_mako.py 0000664 0000000 0000000 00000001602 15070515525 0025633 0 ustar 00root root 0000000 0000000 from pathlib import Path
from typing import Any, Dict
from litestar import Litestar, get
from litestar.contrib.mako import MakoTemplateEngine
from litestar.response import Template
from litestar.template.config import TemplateConfig
def my_template_function(ctx: Dict[str, Any]) -> str:
return ctx.get("my_context_key", "nope")
def register_template_callables(engine: MakoTemplateEngine) -> None:
engine.register_template_callable(
key="check_context_key",
template_callable=my_template_function,
)
template_config = TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=MakoTemplateEngine,
engine_callback=register_template_callables,
)
@get("/", sync_to_thread=False)
def index() -> Template:
return Template(template_name="index.html.mako")
app = Litestar(
route_handlers=[index],
template_config=template_config,
)
litestar-2.18.0/docs/examples/templating/template_functions_minijinja.py 0000664 0000000 0000000 00000001557 15070515525 0026665 0 ustar 00root root 0000000 0000000 from pathlib import Path
from litestar import Litestar, get
from litestar.contrib.minijinja import MiniJinjaTemplateEngine, StateProtocol
from litestar.response import Template
from litestar.template.config import TemplateConfig
def my_template_function(ctx: StateProtocol) -> str:
return ctx.lookup("my_context_key") or "nope"
def register_template_callables(engine: MiniJinjaTemplateEngine) -> None:
engine.register_template_callable(key="check_context_key", template_callable=my_template_function)
template_config = TemplateConfig(
directory=Path(__file__).parent / "templates",
engine=MiniJinjaTemplateEngine,
engine_callback=register_template_callables,
)
@get("/", sync_to_thread=False)
def index() -> Template:
return Template(template_name="index.html.minijinja")
app = Litestar(route_handlers=[index], template_config=template_config)
litestar-2.18.0/docs/examples/templating/templates/ 0000775 0000000 0000000 00000000000 15070515525 0022346 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/templating/templates/hello.html.jinja2 0000664 0000000 0000000 00000000042 15070515525 0025507 0 ustar 00root root 0000000 0000000 Hello {{ name }}
litestar-2.18.0/docs/examples/templating/templates/hello.html.mako 0000664 0000000 0000000 00000000041 15070515525 0025260 0 ustar 00root root 0000000 0000000 Hello ${ name }
litestar-2.18.0/docs/examples/templating/templates/hello.html.minijinja 0000664 0000000 0000000 00000000042 15070515525 0026302 0 ustar 00root root 0000000 0000000 Hello {{ name }}
litestar-2.18.0/docs/examples/templating/templates/index.html.jinja2 0000664 0000000 0000000 00000000076 15070515525 0025522 0 ustar 00root root 0000000 0000000 check_context_key: {{ check_context_key() }}
litestar-2.18.0/docs/examples/templating/templates/index.html.mako 0000664 0000000 0000000 00000000075 15070515525 0025273 0 ustar 00root root 0000000 0000000 check_context_key: ${ check_context_key() }
litestar-2.18.0/docs/examples/templating/templates/index.html.minijinja 0000664 0000000 0000000 00000000076 15070515525 0026315 0 ustar 00root root 0000000 0000000 check_context_key: {{ check_context_key() }}
litestar-2.18.0/docs/examples/testing/ 0000775 0000000 0000000 00000000000 15070515525 0017661 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/testing/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0021760 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/testing/subprocess_sse_app.py 0000664 0000000 0000000 00000001054 15070515525 0024135 0 ustar 00root root 0000000 0000000 """
Assemble components into an app that shall be tested
"""
from typing import AsyncGenerator
from litestar import Litestar, get
from litestar.response import ServerSentEvent
from litestar.types import SSEData
async def generator(topic: str) -> AsyncGenerator[SSEData, None]:
count = 0
while count < 2:
yield topic
count += 1
@get("/notify/{topic:str}")
async def get_notified(topic: str) -> ServerSentEvent:
return ServerSentEvent(generator(topic), event_type="Notifier")
app = Litestar(route_handlers=[get_notified])
litestar-2.18.0/docs/examples/testing/test_get_session_data.py 0000664 0000000 0000000 00000001117 15070515525 0024605 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request, post
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.testing import TestClient
session_config = ServerSideSessionConfig()
@post(path="/test", sync_to_thread=False)
def set_session_data(request: Request) -> None:
request.session["foo"] = "bar"
app = Litestar(route_handlers=[set_session_data], middleware=[session_config.middleware], debug=True)
with TestClient(app=app, session_config=session_config) as client:
client.post("/test").json()
assert client.get_session_data() == {"foo": "bar"}
litestar-2.18.0/docs/examples/testing/test_get_session_data_async.py 0000664 0000000 0000000 00000001234 15070515525 0026002 0 ustar 00root root 0000000 0000000 from litestar import Litestar, Request, post
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.testing import AsyncTestClient
session_config = ServerSideSessionConfig()
@post(path="/test", sync_to_thread=False)
def set_session_data(request: Request) -> None:
request.session["foo"] = "bar"
app = Litestar(route_handlers=[set_session_data], middleware=[session_config.middleware], debug=True)
async def test_set_session_data() -> None:
async with AsyncTestClient(app=app, session_config=session_config) as client:
await client.post("/test")
assert await client.get_session_data() == {"foo": "bar"}
litestar-2.18.0/docs/examples/testing/test_health_check_async.py 0000664 0000000 0000000 00000001414 15070515525 0025071 0 ustar 00root root 0000000 0000000 from typing import AsyncIterator
import pytest
from litestar import Litestar, MediaType, get
from litestar.status_codes import HTTP_200_OK
from litestar.testing import AsyncTestClient
@get(path="/health-check", media_type=MediaType.TEXT, sync_to_thread=False)
def health_check() -> str:
return "healthy"
app = Litestar(route_handlers=[health_check], debug=True)
@pytest.fixture(scope="function")
async def test_client() -> AsyncIterator[AsyncTestClient[Litestar]]:
async with AsyncTestClient(app=app) as client:
yield client
async def test_health_check_with_fixture(test_client: AsyncTestClient[Litestar]) -> None:
response = await test_client.get("/health-check")
assert response.status_code == HTTP_200_OK
assert response.text == "healthy"
litestar-2.18.0/docs/examples/testing/test_health_check_sync.py 0000664 0000000 0000000 00000001326 15070515525 0024732 0 ustar 00root root 0000000 0000000 from typing import Iterator
import pytest
from litestar import Litestar, MediaType, get
from litestar.status_codes import HTTP_200_OK
from litestar.testing import TestClient
@get(path="/health-check", media_type=MediaType.TEXT, sync_to_thread=False)
def health_check() -> str:
return "healthy"
app = Litestar(route_handlers=[health_check], debug=True)
@pytest.fixture(scope="function")
def test_client() -> Iterator[TestClient[Litestar]]:
with TestClient(app=app) as client:
yield client
def test_health_check_with_fixture(test_client: TestClient[Litestar]) -> None:
response = test_client.get("/health-check")
assert response.status_code == HTTP_200_OK
assert response.text == "healthy"
litestar-2.18.0/docs/examples/testing/test_set_session_data.py 0000664 0000000 0000000 00000001254 15070515525 0024623 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, Request, get
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.testing import TestClient
session_config = ServerSideSessionConfig()
@get(path="/test", sync_to_thread=False)
def get_session_data(request: Request) -> Dict[str, Any]:
return request.session
app = Litestar(route_handlers=[get_session_data], middleware=[session_config.middleware], debug=True)
def test_get_session_data() -> None:
with TestClient(app=app, session_config=session_config) as client:
client.set_session_data({"foo": "bar"})
assert client.get("/test").json() == {"foo": "bar"}
litestar-2.18.0/docs/examples/testing/test_set_session_data_async.py 0000664 0000000 0000000 00000001340 15070515525 0026014 0 ustar 00root root 0000000 0000000 from typing import Any, Dict
from litestar import Litestar, Request, get
from litestar.middleware.session.server_side import ServerSideSessionConfig
from litestar.testing import AsyncTestClient
session_config = ServerSideSessionConfig()
@get(path="/test", sync_to_thread=False)
def get_session_data(request: Request) -> Dict[str, Any]:
return request.session
app = Litestar(route_handlers=[get_session_data], middleware=[session_config.middleware], debug=True)
async def test_get_session_data() -> None:
async with AsyncTestClient(app=app, session_config=session_config) as client:
await client.set_session_data({"foo": "bar"})
res = await client.get("/test")
assert res.json() == {"foo": "bar"}
litestar-2.18.0/docs/examples/testing/test_subprocess_sse.py 0000664 0000000 0000000 00000002023 15070515525 0024331 0 ustar 00root root 0000000 0000000 """
Test the app running in a subprocess
"""
import asyncio
import pathlib
import sys
from typing import AsyncIterator
import httpx
import httpx_sse
import pytest
from litestar.testing import subprocess_async_client
if sys.platform == "win32":
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
ROOT = pathlib.Path(__file__).parent
@pytest.fixture(name="async_client")
async def fx_async_client() -> AsyncIterator[httpx.AsyncClient]:
async with subprocess_async_client(workdir=ROOT, app="subprocess_sse_app:app") as client:
yield client
async def test_subprocess_async_client(async_client: httpx.AsyncClient) -> None:
"""Demonstrates functionality of the async client with an infinite SSE source that cannot be tested with the
regular async test client.
"""
topic = "demo"
async with httpx_sse.aconnect_sse(async_client, "GET", f"/notify/{topic}") as event_source:
async for event in event_source.aiter_sse():
assert event.data == topic
break
litestar-2.18.0/docs/examples/testing/test_websocket.py 0000664 0000000 0000000 00000001236 15070515525 0023262 0 ustar 00root root 0000000 0000000 from typing import Any
from litestar import WebSocket, websocket
from litestar.datastructures import State
from litestar.testing import create_test_client
def test_websocket() -> None:
@websocket(path="/ws")
async def websocket_handler(socket: WebSocket[Any, Any, State]) -> None:
await socket.accept()
recv = await socket.receive_json()
await socket.send_json({"message": recv})
await socket.close()
with create_test_client(route_handlers=[websocket_handler]).websocket_connect("/ws") as ws:
ws.send_json({"hello": "world"})
data = ws.receive_json()
assert data == {"message": {"hello": "world"}}
litestar-2.18.0/docs/examples/testing/test_with_portal.py 0000664 0000000 0000000 00000001547 15070515525 0023635 0 ustar 00root root 0000000 0000000 from concurrent.futures import Future, wait
import anyio
from litestar.testing import create_test_client
def test_with_portal() -> None:
"""This example shows how to manage asynchronous tasks using a portal.
The test function itself is not async. Asynchronous functions are executed and awaited using the portal.
"""
async def get_float(value: float) -> float:
await anyio.sleep(value)
return value
with create_test_client(route_handlers=[]) as test_client, test_client.portal() as portal:
# start a background task with the portal
future: Future[float] = portal.start_task_soon(get_float, 0.25)
# do other work
assert portal.call(get_float, 0.1) == 0.1
# wait for the background task to complete
wait([future])
assert future.done()
assert future.result() == 0.25
litestar-2.18.0/docs/examples/todo_app/ 0000775 0000000 0000000 00000000000 15070515525 0020011 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022110 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/create/ 0000775 0000000 0000000 00000000000 15070515525 0021254 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/create/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023353 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/create/dataclass.py 0000664 0000000 0000000 00000000513 15070515525 0023564 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, post
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = []
@post("/")
async def add_item(data: TodoItem) -> List[TodoItem]:
TODO_LIST.append(data)
return TODO_LIST
app = Litestar([add_item])
litestar-2.18.0/docs/examples/todo_app/create/dict.py 0000664 0000000 0000000 00000000453 15070515525 0022553 0 ustar 00root root 0000000 0000000 from typing import Any, Dict, List, Union
from litestar import Litestar, post
TODO_LIST: List[Dict[str, Union[str, bool]]] = []
@post("/")
async def add_item(data: Dict[str, Any]) -> List[Dict[str, Union[str, bool]]]:
TODO_LIST.append(data)
return TODO_LIST
app = Litestar([add_item])
litestar-2.18.0/docs/examples/todo_app/full_app.py 0000664 0000000 0000000 00000002242 15070515525 0022165 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List, Optional
from litestar import Litestar, get, post, put
from litestar.exceptions import NotFoundException
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
def get_todo_by_title(todo_name) -> TodoItem:
for item in TODO_LIST:
if item.title == todo_name:
return item
raise NotFoundException(detail=f"TODO {todo_name!r} not found")
@get("/")
async def get_list(done: Optional[bool] = None) -> List[TodoItem]:
if done is None:
return TODO_LIST
return [item for item in TODO_LIST if item.done == done]
@post("/")
async def add_item(data: TodoItem) -> List[TodoItem]:
TODO_LIST.append(data)
return TODO_LIST
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoItem) -> List[TodoItem]:
todo_item = get_todo_by_title(item_title)
todo_item.title = data.title
todo_item.done = data.done
return TODO_LIST
app = Litestar([get_list, add_item, update_item])
litestar-2.18.0/docs/examples/todo_app/get_list/ 0000775 0000000 0000000 00000000000 15070515525 0021623 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/get_list/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0023722 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/todo_app/get_list/dataclass.py 0000664 0000000 0000000 00000000654 15070515525 0024141 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
@get("/")
async def get_list() -> List[TodoItem]:
return TODO_LIST
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/get_list/dict.py 0000664 0000000 0000000 00000000573 15070515525 0023125 0 ustar 00root root 0000000 0000000 from typing import Dict, List, Union
from litestar import Litestar, get
TODO_LIST: List[Dict[str, Union[str, bool]]] = [
{"title": "Start writing TODO list", "done": True},
{"title": "???", "done": False},
{"title": "Profit", "done": False},
]
@get("/")
async def get_list() -> List[Dict[str, Union[str, bool]]]:
return TODO_LIST
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/get_list/query_param.py 0000664 0000000 0000000 00000001046 15070515525 0024523 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
@get("/")
async def get_list(done: str) -> List[TodoItem]:
if done == "1":
return [item for item in TODO_LIST if item.done]
return [item for item in TODO_LIST if not item.done]
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/get_list/query_param_default.py 0000664 0000000 0000000 00000001047 15070515525 0026230 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List, Optional
from litestar import Litestar, get
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
@get("/")
async def get_list(done: Optional[bool] = None) -> List[TodoItem]:
if done is None:
return TODO_LIST
return [item for item in TODO_LIST if item.done == done]
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/get_list/query_param_validate.py 0000664 0000000 0000000 00000000736 15070515525 0026401 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
@get("/")
async def get_list(done: bool) -> List[TodoItem]:
return [item for item in TODO_LIST if item.done == done]
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/get_list/query_param_validate_manually.py 0000664 0000000 0000000 00000001301 15070515525 0030270 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, get
from litestar.exceptions import HTTPException
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
@get("/")
async def get_list(done: str) -> List[TodoItem]:
if done == "1":
return [item for item in TODO_LIST if item.done]
if done == "0":
return [item for item in TODO_LIST if not item.done]
raise HTTPException(f"Invalid query parameter value: {done!r}", status_code=400)
app = Litestar([get_list])
litestar-2.18.0/docs/examples/todo_app/hello_world.py 0000664 0000000 0000000 00000000212 15070515525 0022670 0 ustar 00root root 0000000 0000000 from litestar import Litestar, get
@get("/")
async def hello_world() -> str:
return "Hello, world!"
app = Litestar([hello_world])
litestar-2.18.0/docs/examples/todo_app/update.py 0000664 0000000 0000000 00000001514 15070515525 0021646 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from typing import List
from litestar import Litestar, put
from litestar.exceptions import NotFoundException
@dataclass
class TodoItem:
title: str
done: bool
TODO_LIST: List[TodoItem] = [
TodoItem(title="Start writing TODO list", done=True),
TodoItem(title="???", done=False),
TodoItem(title="Profit", done=False),
]
def get_todo_by_title(todo_name) -> TodoItem:
for item in TODO_LIST:
if item.title == todo_name:
return item
raise NotFoundException(detail=f"TODO {todo_name!r} not found")
@put("/{item_title:str}")
async def update_item(item_title: str, data: TodoItem) -> List[TodoItem]:
todo_item = get_todo_by_title(item_title)
todo_item.title = data.title
todo_item.done = data.done
return TODO_LIST
app = Litestar([update_item])
litestar-2.18.0/docs/examples/websockets/ 0000775 0000000 0000000 00000000000 15070515525 0020355 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/websockets/__init__.py 0000664 0000000 0000000 00000000000 15070515525 0022454 0 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/examples/websockets/custom_websocket.py 0000664 0000000 0000000 00000001033 15070515525 0024304 0 ustar 00root root 0000000 0000000 from __future__ import annotations
from litestar import Litestar, WebSocket, websocket_listener
from litestar.types.asgi_types import WebSocketMode
class CustomWebSocket(WebSocket):
async def receive_data(self, mode: WebSocketMode) -> str | bytes:
"""Return fixed response for every websocket message."""
await super().receive_data(mode=mode)
return "Fixed response"
@websocket_listener("/")
async def handler(data: str) -> str:
return data
app = Litestar([handler], websocket_class=CustomWebSocket)
litestar-2.18.0/docs/examples/websockets/dependency_injection_simple.py 0000664 0000000 0000000 00000000464 15070515525 0026464 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
from litestar.di import Provide
def some_dependency() -> str:
return "hello"
@websocket_listener("/", dependencies={"some": Provide(some_dependency)})
async def handler(data: str, some: str) -> str:
return data + some
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/dependency_injection_yield.py 0000664 0000000 0000000 00000001166 15070515525 0026301 0 ustar 00root root 0000000 0000000 from typing import TypedDict
from litestar import Litestar, websocket_listener
from litestar.datastructures import State
from litestar.di import Provide
class Message(TypedDict):
message: str
client_count: int
def socket_client_count(state: State) -> int:
if not hasattr(state, "count"):
state.count = 0
state.count += 1
yield state.count
state.count -= 1
@websocket_listener("/", dependencies={"client_count": Provide(socket_client_count)})
async def handler(data: str, client_count: int) -> Message:
return Message(message=data, client_count=client_count)
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/listener_class_based.py 0000664 0000000 0000000 00000000637 15070515525 0025105 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket
from litestar.handlers import WebsocketListener
class Handler(WebsocketListener):
path = "/"
def on_accept(self, socket: WebSocket) -> None:
print("Connection accepted")
def on_disconnect(self, socket: WebSocket) -> None:
print("Connection closed")
def on_receive(self, data: str) -> str:
return data
app = Litestar([Handler])
litestar-2.18.0/docs/examples/websockets/listener_class_based_async.py 0000664 0000000 0000000 00000000661 15070515525 0026277 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket
from litestar.handlers import WebsocketListener
class Handler(WebsocketListener):
path = "/"
async def on_accept(self, socket: WebSocket) -> None:
print("Connection accepted")
async def on_disconnect(self, socket: WebSocket) -> None:
print("Connection closed")
async def on_receive(self, data: str) -> str:
return data
app = Litestar([Handler])
litestar-2.18.0/docs/examples/websockets/mode_receive_binary.py 0000664 0000000 0000000 00000000265 15070515525 0024724 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/", receive_mode="binary")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/mode_receive_text.py 0000664 0000000 0000000 00000000263 15070515525 0024422 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/", receive_mode="text")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/mode_send_binary.py 0000664 0000000 0000000 00000000262 15070515525 0024230 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/", send_mode="binary")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/mode_send_text.py 0000664 0000000 0000000 00000000260 15070515525 0023726 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/", send_mode="text")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/receive_bytes.py 0000664 0000000 0000000 00000000260 15070515525 0023555 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: bytes) -> str:
return data.decode("utf-8")
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/receive_json.py 0000664 0000000 0000000 00000000315 15070515525 0023401 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: Dict[str, str]) -> Dict[str, str]:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/receive_str.py 0000664 0000000 0000000 00000000236 15070515525 0023242 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/sending_bytes.py 0000664 0000000 0000000 00000000260 15070515525 0023562 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: str) -> bytes:
return data.encode("utf-8")
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/sending_json_dataclass.py 0000664 0000000 0000000 00000000534 15070515525 0025430 0 ustar 00root root 0000000 0000000 from dataclasses import dataclass
from datetime import datetime
from litestar import Litestar, websocket_listener
@dataclass
class Message:
content: str
timestamp: float
@websocket_listener("/")
async def handler(data: str) -> Message:
return Message(content=data, timestamp=datetime.now().timestamp())
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/sending_json_dict.py 0000664 0000000 0000000 00000000317 15070515525 0024413 0 ustar 00root root 0000000 0000000 from typing import Dict
from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: str) -> Dict[str, str]:
return {"message": data}
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/sending_str.py 0000664 0000000 0000000 00000000236 15070515525 0023247 0 ustar 00root root 0000000 0000000 from litestar import Litestar, websocket_listener
@websocket_listener("/")
async def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/setting_custom_connection_headers.py 0000664 0000000 0000000 00000000507 15070515525 0027712 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket, websocket_listener
async def accept_connection(socket: WebSocket) -> None:
await socket.accept(headers={"Cookie": "custom-cookie"})
@websocket_listener("/", connection_accept_handler=accept_connection)
def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/socket_access.py 0000664 0000000 0000000 00000000364 15070515525 0023543 0 ustar 00root root 0000000 0000000 from litestar import Litestar, WebSocket, websocket_listener
@websocket_listener("/")
async def handler(data: str, socket: WebSocket) -> str:
if data == "goodbye":
await socket.close()
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/stream_and_receive_listener.py 0000664 0000000 0000000 00000001655 15070515525 0026462 0 ustar 00root root 0000000 0000000 from contextlib import asynccontextmanager
from typing import Any, AsyncGenerator
import anyio
from litestar import Litestar, WebSocket, websocket_listener
from litestar.exceptions import WebSocketDisconnect
from litestar.handlers import send_websocket_stream
@asynccontextmanager
async def listener_lifespan(socket: WebSocket) -> AsyncGenerator[None, Any]:
is_closed = anyio.Event()
async def handle_stream() -> AsyncGenerator[str, None]:
while not is_closed.is_set():
await anyio.sleep(0.1)
yield "ping"
async with anyio.create_task_group() as tg:
tg.start_soon(send_websocket_stream, socket, handle_stream())
try:
yield
except WebSocketDisconnect:
pass
finally:
is_closed.set()
@websocket_listener("/", connection_lifespan=listener_lifespan)
def handler(data: str) -> str:
return data
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/stream_and_receive_raw.py 0000664 0000000 0000000 00000001662 15070515525 0025424 0 ustar 00root root 0000000 0000000 from typing import Any, AsyncGenerator
import anyio
from litestar import Litestar, WebSocket, websocket
from litestar.exceptions import WebSocketDisconnect
from litestar.handlers import send_websocket_stream
@websocket("/")
async def handler(socket: WebSocket) -> None:
await socket.accept()
should_stop = anyio.Event()
async def handle_stream() -> AsyncGenerator[str, None]:
while not should_stop.is_set():
await anyio.sleep(0.5)
yield "ping"
async def handle_receive() -> Any:
await socket.send_json({"handle_receive": "start"})
async for event in socket.iter_json():
await socket.send_json(event)
try:
async with anyio.create_task_group() as tg:
tg.start_soon(send_websocket_stream, socket, handle_stream())
tg.start_soon(handle_receive)
except WebSocketDisconnect:
should_stop.set()
app = Litestar([handler])
litestar-2.18.0/docs/examples/websockets/stream_basic.py 0000664 0000000 0000000 00000000434 15070515525 0023364 0 ustar 00root root 0000000 0000000 import asyncio
import time
from typing import AsyncGenerator
from litestar import Litestar, websocket_stream
@websocket_stream("/")
async def ping() -> AsyncGenerator[float, None]:
while True:
yield time.time()
await asyncio.sleep(0.5)
app = Litestar([ping])
litestar-2.18.0/docs/examples/websockets/stream_di_hog.py 0000664 0000000 0000000 00000001037 15070515525 0023534 0 ustar 00root root 0000000 0000000 import asyncio
from typing import AsyncGenerator
from app.lib import ping_external_resource
from litestar import Litestar, websocket_stream
RESOURCE_LOCK = asyncio.Lock()
async def acquire_lock() -> AsyncGenerator[None, None]:
async with RESOURCE_LOCK:
yield
@websocket_stream("/")
async def ping(lock: asyncio.Lock) -> AsyncGenerator[float, None]:
while True:
alive = await ping_external_resource()
yield alive
await asyncio.sleep(1)
app = Litestar([ping], dependencies={"lock": acquire_lock})
litestar-2.18.0/docs/examples/websockets/stream_di_hog_fix.py 0000664 0000000 0000000 00000000650 15070515525 0024402 0 ustar 00root root 0000000 0000000 import asyncio
from typing import AsyncGenerator
from app.lib import ping_external_resource
from litestar import Litestar, websocket_stream
RESOURCE_LOCK = asyncio.Lock()
@websocket_stream("/")
async def ping() -> AsyncGenerator[float, None]:
while True:
async with RESOURCE_LOCK:
alive = await ping_external_resource()
yield alive
await asyncio.sleep(1)
app = Litestar([ping])
litestar-2.18.0/docs/examples/websockets/stream_socket_access.py 0000664 0000000 0000000 00000000551 15070515525 0025114 0 ustar 00root root 0000000 0000000 import asyncio
import time
from typing import Any, AsyncGenerator
from litestar import Litestar, WebSocket, websocket_stream
@websocket_stream("/")
async def ping(socket: WebSocket) -> AsyncGenerator[dict[str, Any], None]:
while True:
yield {"time": time.time(), "client": socket.client}
await asyncio.sleep(0.5)
app = Litestar([ping])
litestar-2.18.0/docs/examples/websockets/with_dto.py 0000664 0000000 0000000 00000000537 15070515525 0022555 0 ustar 00root root 0000000 0000000 from sqlalchemy.orm import Mapped
from litestar import Litestar, websocket_listener
from litestar.plugins.sqlalchemy import SQLAlchemyDTO, base
class User(base.UUIDBase):
name: Mapped[str]
UserDTO = SQLAlchemyDTO[User]
@websocket_listener("/", dto=UserDTO)
async def handler(data: User) -> User:
return data
app = Litestar([handler])
litestar-2.18.0/docs/images/ 0000775 0000000 0000000 00000000000 15070515525 0015633 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/images/benchmarks/ 0000775 0000000 0000000 00000000000 15070515525 0017750 5 ustar 00root root 0000000 0000000 litestar-2.18.0/docs/images/benchmarks/rps_dependency-injection.svg 0000664 0000000 0000000 00000054065 15070515525 0025465 0 ustar 00root root 0000000 0000000 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 sanic 23.6.0 dependencies sync dependencies async dependencies mixed 0 2k 4k 6k 8k 10k fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 sanic 23.6.0 dependencies sync dependencies async dependencies mixed framework fastapi 0.101.1 litestar 2.0.0 sanic 23.6.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 file response 100 bytes file response 1 kB file response 10 kB file response 100 kB file response 500 kB file response 1 MB 0 500 1000 1500 2000 2500 3000 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 file response 100 bytes file response 1 kB file response 10 kB file response 100 kB file response 500 kB file response 1 MB framework fastapi 0.101.1 litestar 2.0.0 quart 0.18.4 sanic 23.6.0 starlette 0.31.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 json 1 kB json 10 kB json 100 kB json 500 kB json 1 MB 0 5k 10k 15k fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 json 1 kB json 10 kB json 100 kB json 500 kB json 1 MB framework fastapi 0.101.1 litestar 2.0.0 quart 0.18.4 sanic 23.6.0 starlette 0.31.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 no params path params query params mixed params 0 5k 10k 15k 20k fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 no params path params query params mixed params framework fastapi 0.101.1 litestar 2.0.0 quart 0.18.4 sanic 23.6.0 starlette 0.31.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 plaintext 100 bytes plaintext 1 kB plaintext 10 kB plaintext 100 kB plaintext 500 kB plaintext 1 MB 0 5k 10k 15k 20k fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 quart 0.18.4 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 sanic 23.6.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 starlette 0.31.0 plaintext 100 bytes plaintext 1 kB plaintext 10 kB plaintext 100 kB plaintext 500 kB plaintext 1 MB framework fastapi 0.101.1 litestar 2.0.0 quart 0.18.4 sanic 23.6.0 starlette 0.31.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 serialize pydantic, 50 objects serialize pydantic, 100 objects serialize pydantic, 500 objects serialize dataclasses, 50 objects serialize dataclasses, 100 objects serialize dataclasses, 500 objects 0 2k 4k 6k 8k 10k fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 fastapi 0.101.1 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 litestar 2.0.0 serialize pydantic, 50 objects serialize pydantic, 100 objects serialize pydantic, 500 objects serialize dataclasses, 50 objects serialize dataclasses, 100 objects serialize dataclasses, 500 objects framework fastapi 0.101.1 litestar 2.0.0 Requests per second (higher is better) RPS mode=sync mode=async stat=mean [|Ն#G6'i}t |J~w 3kmq]%_}lWWn/6s=u|~b>ҼmOKqύjJ&XWiź;<쎥 Wڴkޅ;+$:YO'>.o[yo[ԻN|r4Cԙͭ_}? Y:t>UW2a^ym)w-,v~Sr9ֽ n(ײcnY`T~go')O|(V:뮛LiաQM
J{<Xu˩ ɚg3R|=7Y]fFU1˔|`MV~t1ݼw : BpU^?HQ'
\%^p$jk[
o6yD 誆'>)Ns 5ŗ#>O+TnwG,F}g- So=9v
r| uO>T@}&? 8.$?3ġ̤=YvQOvGsL8Φ7
*`*~
W NS1w7Ge8g-tȰom>|Jh{ O VA X$&"t,SSѨr+̖ %P) 0'U
'N 3m`\ Pp|$~ ]L7ں䍋qM. 8K_YaY hG:<4K=Cxc+|M@?іNY
t 0u d3'$I L
[) z$vn7*h8M1'1P&>g"N:cY* ,uw; R& Q8==*enn9@.uwAi<:dxMEiIՍ_=߬;#G^1%:mgZ]7}sm,~.bp煎 nIt^Ze=D:Z@zm/P1-_N@_l!x9MԚ:#)D) Dug}].w& ^ZX\3sdG1Da*sEL8 YTT,h/***rl&e쌱6EgQ3_K\/QT9bHIQQf`hPmʂlQ yrи 2ʡV/ ]C/[(|Fuy cGlSn=xȍw(
'XX_əFa+yU` 7>:A?x?YթXeemd+<W+~rsikGw>63TGGXyit!K=W˿wS+n:5'[;C ?SLk.{+ n+_lΟ'~f$M̰HNl'#yO9Dv</R&Is .\XmQ&l,-
__~AV$?%ჽ+ h_Y at[@@g,WcMzq
Yvt]@L!,J/a !H!t!B(;0: B(;0: B(;0: .Loga!YQ, j4"g˱ ~9DZYNõ/js > a9^qծܧ 9Mmᡨ j_8;r9) OЁ , Pvo?IIЛo.ɒ %PTlݿcW4fdlw}q C0N~ҬlMA] 0: B(;0: B(; K1CpˉF߅W aHxT.81S B(;Y .kt`_;Gt#q0: ʮ jaDRۯ+AYι:gXVd}odRczMegcO/U}Uc\PiOѣUM9_;/`yűU>͜}5pˣ_ TUop]C8ǨG~禾- }&̽ycį@py4 !&yZ) ~ <* в[=0I" SIL^t<؊pG ?D پ`@ ~XtQ9?Prx#7}x'Wh)_ izW _ dogɱ} XKd28dž .?^g^f$S]^{ &W25+^Y֓cZQf2 fsQOAv |HCZ zxj+_گꆺͯ}SLD ;yɘnmkDqxD4=cVa5g=Ljڒ!_3F5ɉ ZԾQ Pk}Ր
)E|ruIHXoFnz
:m$g;sO?} Ů %3?) @RaB[=Ws+{gn9Rk4BRcCt
(2.~ăB Xʜ}Iq }1CM'2''ɋU
Xngmy7gY,,|6]}Hxl~ÿ `o
z<P2#u S)q 0 ̱ymF3ESgO "W/oKyu>qȐDDX^u;sVӣwԯ:*H|Y f?F^)O 7&MRcgRty4@Et ls y Xi#e3-Ñh;)
)#m(, 1Ӄ9 :cqӢi \luFb=1lpq̱{a=ɀ6n"
_R#_kot wN۱Μ%Wsl 163U邊YRFce8xu R4CT96رϥ ~Q;KFM#J>kVGU_,b_e^kn_yx%? - RcS}˜{OLg _ZnPaR%_hF $5O5mz:[zZ kK J`M֝KX$T绩(dx[h?>®%Ezys .ZCwN"bPFS x;3TZMq xod§MOiL)F~iN@un(98Yy4f QwRm~i?k ;J+b ұX_pI]]4riwV>v-Ξz|A 5 gўmvBugo~~>fo^Vp\Ot hv/c͡οvSIr=/vCaB@HK>b| 69bD- ͙ xg`BU>m u$ p>xk ^YnP`yw(fnlHC 76&G{ybV$/Qj|l;& :F+iYjL
r$2 v&Q= @˭Mm1)kb#3R2r4ՔN1\gfo
7,n
Ќq-tC*"ϑ~Ign)4]e Ot4qɚ'U5L2o ^ d"% K&Du
`^e
ϰ DG[3A d Fh (ߜ @ '#\ϣݕ=?E U~G"m-CO5&&t#a 7ywRH}'SQ x
TH8WP_^Niy *d&2 HT2 h:8 T&2V~f<
#UȔL 筸#4v 8Tqw$to'%Xy_,S _:!r=Pݱj<
' Tccqсjb~~dwx]}P+'j
EkIpd>:|ƙ. i;aQ.
hDЈI>ȑ.
L
)A: EX U_ų:B, _%8VdrA?s|Ϗ6)UFa61o5Ϊ_7?bxmvp5y@ʄeb4*]tq^b gv ͕ \n.5VroK{4v1Qm㞲
]}d!X( -5-,%QvGOPSjF y"T'a_%O_]Թ|V\ ffTDgXn} GXh X"W)x,Rq?U =9 *){DJJ ]'Y\p?|B(;05 #g!0: .Y\z$5k4;LSo۸I YD^G6{3/*k>Txt3swtU5-^:Me@7+/&'5qQ$wF$kW%37 Pk*>#otv7lQ7|5Z[^M^2{ae,yz
;w
Q7nޑLDCq7} ~dXB ے іxġ9E 7P'?־0:OaU
1sc?dp?[ߓ:Yvɰ|
#d壒mM-Ho=o.VW. __ , W` V~#=,qu:S'vSHIoR0Tad|&ӃnyTP9y u+ +˄x@H$Ӏ,P^>
7ѳ|CKR#ڰ6$-qLuQ28s\*֬{8(n4jBL PZ7/XYvo)o3)g3vD7~h t~gO=E |>
J|<8'@04B SIDATO3Sdg Ҥe'u w,g6s9Y eUhPS Y\uV S gAa w00|OqN> 4`> ԡYt'?, ,y)E)g]3P |<u@FPv Bat@e,e Qw`> P`! FPvu@FPv #qh%h1`t@o#5lIYGf*ys o/ !=WZy1 [vn*Sg~+ uFŘfQgXC{\RN|g\x 9Kh=m<ֳ:I>,%oR_ʾx'*s||
R:*%5/%т:P_j.^糘|kD¾v)O[^2CxqoFmyӷYyʔfbT9}=%RqۚKW$OMJ=^ N%g5'У_ \Dɜ!19Q:ECq7} ~dXB>tϷO#6[P `yVk='KƴInTc jiE2XtL :˙ OzcǘxP&&9}+piHyS I2{10x?mn `!
)
Z$ m~_= 8
x?m& `AQ/8țDG v 7 1~7|&-sv »+" o8U'M_qT$e Pe 4Ƚ:G8 ÿ
};'x~yQ9qieIb;a / # ΪNx jw[Sz Tm&eHħ߱;@Kio (U0`^شv(JLJfTeߕYGz7pn> "I jlD)+d?ycRV 1+ I%WMK5/YVkVsVJ":^ Kf; (%NOh+܅ )e?pED_D]G, ~")
[ ;@SJ4豕 [ v,ZzxmCĨ鬿 @0W
qptwd XߥG_ uo) ?.ѿ,+a';: ݟ{h Ab{߿Kz?9ne m IH FN!DyVXkj>S~K+[CVwѣtJ
DDoX{=@U -ȔJ'jih?* *!u{ B{m$1C"H & :ͧp]T 1Ӗ\
>f T
L?ʼnsU31@%~i;=Q
H 0[VKߘ1l)^IqX#܁[UVD # +KбmM
,?O $ m+ {ߞ*CsL T&4ni\M2U RLbMPOW @o 'W'KrH.,`U 4*&n~Ӌs2b&`hG3 K}6% d͡Iݾ|]RNcD*9=i( a X$yc LlVOK.] id3%I @43 Ѝ
+
r OY@h )v (s^BL ,e@"-%U tASoUztI|#
zO
(۷#$D)t._2 / )y* r WkfJ1l|rowd"W{ h\&^L֜6*L,̥qҐ
^߁<"Baȗ/}1 ;xnQ_
]ťߦ? Ql$RaO#u't~GU-ᳶ4J[Q*e5SVo=qI#ͻW e/Ē7-
g
)
yKϹw|TP VK;vUAa B Ɣ*2 sq?*j rge\ґ7|ku |@@gXtj+4 0 T X aGt@rt5eg 2
}juHǵ7^Ȕz{\= 8^ 9Y\c p ~=!6zCD: )9% :B *N 9 |JȅL8u>8j(UX9.kև2[toSoHUq8fz"Dg,nZ4<ʌ3^`
z8^}djO; i#G5zH[xS]謠iH%< X3L g8L)qV`OAw %@_h5P~gd2d É ;Gy}⨑}4~%u)8Ċ剳Uڦ7ͥg#dWj&CԂRUH"&xE:$j8:{yZ5pd͓*S$PM ͨH;c&9i"{TxTG&&T3οlfŦHs\STkJMs}B?{2 /sU3;PA3;!l_Q *^]k µ٘)j+|wf ţwkNz,0PΖGPV]?
g#fa
o/MU9fS#5e@жF3I@f!_6/>$O6h]K# @|u6⌃ />* v2?Cd73 +Mό$ۺ6 ڍ[Ã\UQ69}]SC D,\ 0 }5 5;'рnK
aj>x[xlrwTa6scvAsqB-_Mʹ~Y 7|r1wVY-|%YGaUI__+.w]+fWCos}P_j^>"|2;0BggB(;gq
Y zB(;0: PˠF$_q%8~q}> Ke"pzMVU
;3l(;|5OwV@ @Tc ӿRemW?\t ]|)0 ֆE{=B4K@|7+/&'5q]S6 Hn窊fo>CC'Ot hv/c͡οvSIr*3 iw=&9d u>
;w
Q7nޑL*ȬQe"/q#
-~:nlxB[ƫ0lB?|s8W PCqt*ɺ r $0QO^EژgR/r<[λq%I$WoBM({ʳ @-ϥ:/*t|(HJ @9v#yr^Sjd`9ZRIR @ZC47 Ou mKŖ{kjz.,xȳrreyPe> H )y-W )]#/_mK r/:hnNJmpb_ja?1 ^ Z _=ЖWAqx^+埆3f$w*^9Cwu1wsݸvPEPF t?PKs)6;ɯZ hlqP i- Ԩr ljKZfuL 6SEI] z3*oZitOZx6 2V-ԓ3axOWdv
}T hBl,*j휥4K :ni
| s`D ȕC Rol*?;G900*'Guvf˻qJR D$2 v&Es pcK #5_ ᗣ) WiÑ\M376$`k |9"G5u\KXZɠV$~QFMen)8UC@-Y_t;롡-kt$)G^ U{d~ܬLJ^mkP6.arݸІh )X2%S(
-Sx :ޚ'LCU]]-! H' @B=SO
5e$4 1
~Ļ⹆daab]gL,G9Ю;) z11)c-_Ώɻj -GZ;0/<+2TH)ůލ;t]/`:Vh#LЪ 1r[g /r9 4TS ('P9`/0*_yndӵB+;b6aY7:!r=PϽPSi:3' Tccq|~i,ВTaEp6
@#Ɔ4zf0]P>kB*hlua\rb[67RlaLYbO; )Q%l EK/W9
)A: EX U_ų:B, _%8VdrA?s|Ϗ6)UFa61o5Ϊ_7?bxmvp5y@lOeb4*]tq^b gv ͕ \n.5VroK_./(O]{[:VZ]]9U;tJ׳Tg{bHƭkl f(k(k5@sKG\hl ƞ97 xގ ;˞v^G} @Jk *̒Ф+@w{aj&-%i5%9Grw3_\ * EhS DqٷYb = h{s W"EO]7]mPt@
(MЀ0ŵ #gY Y\4#7k
1C]| B(;0: B(;rM}1# 2eGUdY[|
¢ `@*8V
٣m^-N?aW4yr{ş`XX>+*LywDe0: B(;0: B(7J IENDB` litestar-2.18.0/docs/images/cli/litestar_routes.png 0000664 0000000 0000000 00000127316 15070515525 0022352 0 ustar 00root root 0000000 0000000 PNG
IHDR - sBITO tEXtSoftware gnome-screenshot> IDATxg|\ՙs4nY%[ni1&,BIv!KP@0BQ6%KHrҸ4Ȗe3gs9E3 @7P'@ KrH !"(@Tm*~Τ ĘWso3f_ ]ۏNtU}I|ʛKeg<Ͻ 0#of) ' g[O9 ;z7NOƣ>ׁv!r9㰉ܺprnNq4{?5qssu i,V8⇞Yݺ_;y(8UϸB9U_.[o!ߴbix^n8
GN25eaњ
o9 ZL| ŪVFm;~϶U_ p `?Wk
] (]λbfc; )R2MmYwTQla n,>n}/ fa]Or;5n~.n|2q /{4y&d(*xя)k]zm* 43g\w>C,W87=c63&c wݿ tb~7fwa jRB &2LG,~75>RS ,zr?]FBV @iw[?)6;7¿E͛Ƈ9~{W mi! Z'+v_ w?J{Z hݿײʂ?Wӯ1L9 XT
,#e`u`?qKoBrY.@19%@_uyyGO SFgĢVmΨLV(в鋑F}vED,+sM=fKjZ ru c ;Ι26+u (֊vIwN5"5u0q3{
@}
fH*C߁ծd-|vݎ?R%gkAlyI*[T}5S
?o vU%nrI6
.}* |8iCV Pb zj
|W,#e@Qێ7θxء-XeI tO30DZtMtQ0BW6 QK tI:#IԳ` `I]oX%`X&|y0dw
`~Zw_B
\^ >BD2\`Ǐ](m_wϛӾ^|o]뻿~E5G,Zt߽UM VOT#ۛ& ӟehŢү:Uf|oUJw}:R Ѩj[߯RM}gJg/>I.~r|E R>{ ˿]~~V7
UB!HoΟN#Yq<kb0qi<2r-{BAAm/7p[)Gׅ[Ҁ];Dg}+2ynp*ۉV8whG9&]^SO-rE[3o>NWp!J^#+_ !6#2&}] "uH]% rPԤ?_Gcu n9(0t 0!g H !"(@ !rH !"(@ ! !: l|~+!In 0!r(} Bc4ً~Ľq*ǕpXGV<ز|=J|P뱫QHl|v/ol{?뛿[_ P) |"s5-?) {+zM㤇 e_w 771(kſ wa+D_ʉc*?>=q$8z[C8$s4EO1oEŪ&Z+ U֪"6.z^ ڰgcƟa!fb+C s~͒nj!i1;천w# OwgGQ%7aN `UVіYd!u<j#9|19Wv.p .; {ki Dq }qV
, `bn[}x 1 Eᔣ $>v ZVY
@ϸoUJq(Ӽ 8 k>O^a8RΠ( }ߍⵚ
\D ~p/ZU;G4M"c' TbXhg } &.+n\AOsray : PvHi:}F+{/6~tq!Sw;%r`;rG9ϼB)3^>ՖN <"T8.9AŌ^Z{{Cx.kWux'tfIzmm
KՁg`n:15cڏvՓq7+ q""!"(@ !rH !"(@0ʡKz;B@B !rH !"(@!yOh5Lj33_y$m{W+/ *Ouxtsα": ڳ
a_l髩ҼL.R,M @9*W[> ŷL[E_q;[ " uvۈM2*T.~8FH*Zڔז(1CWSW/}K3㘰M L̤14' n?a/ Ջi Jb>R
!BN>O̵]>gͻJ=YT4EMo2[Surُ)O4rXqR>\9-e .nБf
3}ѕzϤDEqi;) JΟ`7qmՖ ;\͊gO~PՎ 4e{=&(C rry. =_}壏 8Cl/1zn&{R(*)}Ngki kG8MOߕY|)j\,}__4 WСTuCT*ZTDC(*9[1䢆?gw==Q.1c/&&n{ڳ}N*.϶ )/K~
:m}[w #s뱸'I/M,ϞȤ ng$ y\6tV@b[:kjp1"KJ0tP{כ/~|&BC# wzLLvZd |dRt3 K]LLF:zZhl qf9LZ;NhSImmJfPIcdb #R0%LQ贄ʇNIP,46 'F٣/FG[0t;8iS"'#&c-tC rwJ+ w|XDAg5rohN~ oluLZUʒ,@,YF*HLS 9-52 &4~.7S #h]vTm
5
@EEG>=e
]bV]&*9(>12U{tu(kiF1#{j_Z@ҜhB+rja,WުԿlNɀzłos\UsD,~&:%:G2 N! z ]+NK;:pXJoQʀD
ͨE>dZ1zEMzOw(KW @ <6gͲ] + cA]CXA1WrUnl
VpɉȐD4c Eg͠M12Bc܂
2)S7u!:.
jwP)9nw; 6U bң22)ndԇtp
%cOh7EW&Im
>l0gf q¸ɶ@ϫkO'y}*zMj湪W|E/i8Y/l|r{sߡ@k. \=g? Y
+ {[?vk jd!ڡҩSU uqB y 09sZou+)Tm.Os]==n10aSǿvU
&ts1"'U:E Grh Ў};?iC=Dz^lPBa[9y?L6
gxx+:9slQZcٶBG9!Qck+#m :(3}Q2 *{ⳬ){Z
+̞i
ґTiT{#c1 &.ta>ZNJk ٷ7o?"CӳK KL.=ׅoXgr(s< `_3
&XإO$<.%"76E{#+U /Neh^Q-=_v G-LCibOm?ێ 9/" Պ - ?2dP~n{zʽ\Wjꛥ¾]pr]Bu+ДmQX KM:'RF#u1_C7 |-}ʽTQ,?|]߬ (ʉ >j'}mI|
S,p|7)_ M_&+wBW_r'Miw>lvU!IVKYdijA 5Q(GʅE rH HZl }iJ~h u D2f Kmm ƲlV/3> } +Ղ )N
i > TT+S
s*t A 8B
Ga@oW[ ZΚf u_
A cq贄svߦ[ )֟:{tVm {S:̮K3p0~hK&Y `Q$#?瓦H7E-SFߣ{biT:N5_A ŗhf.eb AT´;P ~tj? P{+ ݘzi`PԊ"!R5~[19\ǂNӁ1rMGv5}Ä ϼk1cGceq (;3Ϻן f ;Ѡ~t_;:6~nAPS3t UV<3[,1{YVtRIl[x)0>f;(N@ '
Cr\Y(û Ys 0NNz@}ˏnz>
8G^;o⭶e6> >mQ)[2kcZ)+t(,ɡb)hF#9 d ʘ( `Qt:e̠b
eOzp*61Is&PȆ=~L8 Ō&LW-[P 0~t`ܚY])l۬ ~w IbF''Fگ:ͧezUu08Ė$$9f϶:v a|0n=G@??<Bٚ~kqa~'
Jp$r%/.ywݟnO x]}fbDcmt$ XR4!:p P'·-\?0~n7p2^~.s
J(#$4'i`n$Ne,
ۍ*9ڕG.yw<[5ԙ 56P[\6
BQNh BUuF ȡ@ !rH !"(@ !rH !" a8..6h}?~`V8D O@VA x Xtp;.>} IDATX䈏f?@\;u&&jݧ#Py ᔣ.A}5[FO: 86P,(B@`cs7$P[_? MvA{ Pt\[,E=»yh[e-* ?U)EL~\ @{pDVaKh0` p! 0%3nݸE%*
%?+?>+ }9ⵚ
\D ~p/ZU;D )Z!䡛JG1,/*D, \g'vj & @<$ clVU hm>
TՃzwD?ofE'F% ژl.k;at>&>+z6{M>#h<4&0@I {C\O6
bVU b
灎ۏ 9xB앿@ŅL麈:c ٚY_wڇ;碌[C^l AI Hh)nPbƃmSP sP `9rG'7}g~_˚bAOq1^=ڇ aX-B}쒇*{Y+@]3Qk$&|=BE`3#0]-a `:p[[,W` kLع]d͵q""!"(@ !rH !"(@0ʡKz;"y;4pC !rH !"(@P|eʧ?:tsα": ڳ
a_l髩ҼL.H,&ᯜa oi #1mswD ;zeUʩ \qT)-}Q c;r 0$ʡ Q#XFpy#" y N}/8A5vC_S7,[c0 %m| zR+N==Cb@r'TsRk2,uS; @:>u/R(.;rSyg?6'o۪-?w+yΛϞ hzVMQ $8yz (dgdG A3* X:=`mDɽM_Q߅NLMx\/ɭc{XЯ~Tr' O4W%[P+9[\mAT煨4ǒݺ9 Z F~N Isg5ge,G'qM
$uݚK?x J!ZE _{+R I0>'.+qc:͋ڽ?k'c
z&(XHUO
5]L˻j y˪Y:GQ`mo)kŞ N[%B\7ɩhpJ)@Tr):hri&N< ZP 2zޕv Gz@_T~vO
Пoo oؔNS*],LCD/ ( 0|˽Vâ9]3 ͆1jU2*Kԛ#˨_)i
0ǀ RfW HcEn kLi jwadKd3LC9X5TV( 'Amݧ4[5Yi4=_/c iN49n0uyv`oUZU6}d@Ko7aU.ݯ3dZ_ PWWQiE\:I>!s٘h`g*>KE6gZ rYe_ֆ=iv.^i&qc[R{/մ.!@*ɧf6工5ߊMGh[}c3ԩ~z-
?§zFRB⪺J?5u9M< %S`ەK@F5!rH ~kB$>@ !rH&570c FӅiKg͒<إgg3juQǿc Iz+ 眳sLl{UN@kѶ +-zߎcf*ㆠs>}~dϱ7P~ؖiN^
ab}/ފu* )jTX-QNH 沣 y]IxP2 a-ߏri</ɯ.) '> ߰Yw , YJEKF?>V SQh2BSuhں6N',h_}{CL!RNp_5=
ғ]!~]hqUԗS a6~5ǥā㘰M `sqYYN>m\Q.xQ :+yE +Z|rُ)O46bz5eb&=9I(/uׅb|2M-g 1X Z ߵ%!G \SwxOOjUM}T0ZطΗTKnE 2=
q \ar蟠YMB)#ߺ!wX>>P(i >.}oV rnVa'gzI_[`M
S,p|7BPOs=[{Bv];+/ôK դmO{oԉT Wj5q)r4a>냞Gpz|˒$No k ֝9 ݽs
\Ϫ'I/M,ϞȤw9'첋sЭ^;$Z/]f15;jQ Ww9䌑>
7nپ
=?=hRo
O ;N' 'ʔ1KXZUU ?~pɕjDZ'4p M
k'f ;h=Rr?]eP1 'rŴ)LtJZg^81 MdbժW% #[XZԿ*U;YG`mzPG j::-\ݷ)!ֆG
gNŞ{&}p#>eޔR o-RM X) ((e{wOS,JI ? /q ŗhf.eb AT´"_g=#P_AB2ľsA)VNߧ=1+Pj+ECBkbRs\+[7Sd8xj y c2#яczKWuF7Iyֽ, 17>؉'_k \T HU(.Ke {]TVml6 mi|p5tJcl7:'B.PG HCφ!M,]IxgItrS=iI
e@[ChCEtg}z>
8G^;o⭶e6> >mQ)[2kcZ)+t(?-ɡb)hFWE1C(AY/nY&S1t
ٰgߢقIǣq܄)(U1[Qwpi7~E (:kmʠA*76Q+Ddd[PM
\U 3+7şm5n#T} XhP sUl_ϲuز4v]U `t4[?OOPF>wy#+ytt tS8 j-F4yj1B-V~H'ţ a(G^G=/zO SF{sߡ@k.+>͢4v]r|H}t ;o\id:en]$P|GIhrOBY :ד#yܮ[WIXmUr+]xνj3 e[SʪZg sCppl~T!,ڇ&+F!;D9Qk ߹-w/5a@-B$@C DQ D9B$@C DQ P us <6h}?~`V8!OT4V @
ᦦ3͒9贘 HpJXvY{C C(ݒ0'ONWS*\sFh,o}:A\ 5ؘ|JM\w t .VH[ޟ0Uuld 4Qvtnĕ.H_ b{б 9! n ]u{3TP 40$SVH.Ap'>W [5Z n}$v;X
:X%Lazց}J@qqнU
pcg;*v|DO=cE@ -\6ݎtp;!*U ~PT x $ ^P} CU N,D: !DCُ 2fl p@B7 [>ÂX䈏f?@\w>`bn[}xh1 5G86_
Q+l?=
q0o;es7$P[_? MvA[NY(:~Agyi?s;8>v ZVY
@ϸoUJdQ (Ӽ 8 k> Ʒa8B1lcC&a J u bgDܻqɋJ1DUKW~
yw__3hA'A >XW(RK+k5+ $X9_*wt_@4MAPCo !T:aVQ!bI:=?S1 4 !cõJ@kiЦƏ
л؋_>C6/:ą9jn7;, hcBbr(': Pv\|=
& HCjn4J gTj ŧ 1SP^
g* 1@@u g*H^e#h@ ,>FBϰ(Mybҏ..dNEtqlM ,pnUÝsQƭAc/ pR$$ m 7r(e1JA쀶)]Ƌs(`ގ9 @y X?
@m> `>Bnq=*BZa >QfMߙײbPSfܽ|Wa`-![
'C%Ubb9P1=x=Pq r~@ !rHV*'j<7n&Ml߀=˔O*tF8&n $iۃگ
ɣ4%.GK_mϺ˃y%tsα": ڳ
a_l髩ҼL.:Nb? >Fn
Wr1ʑgݕ4Py^9oFip`WP 1ih+.16}gA nW&X
IEK7 1&1DasqYYN> oXX KY* _Hqj+d7x?KOwuŁm @`khzK jg%pSٙ?fR~ tێi3(D/W}2nK5'EV-sZR7# $O]>##Zg+I+7wXlsr&q\GYlg_ e @X.^ (dg1 bcc ,y q0ET|E*cflE' O4W%[PK kr]%uuk (2okv=7sH4ӵK^iFH_Kdv=:DB^=3凚+*! E}\;ſ)٧~_ _B Q ʳWtpKJe2S]G!Khہ<ۂ$fG Qi%c[u'; s;ڵ" 2x
* $ j$YOH(5 ͳ;>1
2ފT }W]_YR81 E拟5٣(1lnRUP On;h0Ug %g2qBc 6wab* u D2f K˖;Ϭ gG⳿ lZf+ -F dHq3dgUJ G*E7ӱ⇡ ؉}*:gǪ$Bhqr`b%$
mmktoZ~~'VMr6f ǬTM+ן&&kjTqьOh2zEm;G~pe[CeE PQQ1hZ?9dGУ ǎL*E>=eF
4~][5Yi4=_/c iN49n0uyv`oUZU6}d#[WÐ5/-J2%o{#t1 qrmEҚe[Su>Zg!>x䌶7v- \c"F$ ȱЦF 8{?*Y탔pCkR6@ a罨Ic 쪒v}1ehT/vyO4[Z!Z9 i}c:$FトơNrr J>+6tN9mW.aAH !"@ !rH !"PO#\q蛐`O,ELuQǿ6>l:9ga meq"vm94 VhG[ IT
A}F}^P4!cYo6(mw-Ӝ &Ć3^ U96SԨLgl[|swᣜ\-iŵÆ)o|?ʥL_Ծ|&L ʞ,k' Fʞ~
guZCp4*td+-m՞/X%||L)&Gɸ ]Oֱih;ퟰ}B
1ۏH9O C B_K} Neh^Q-=_v n#|v
+=5#j.o$[#oO]>i&Ԗo,Y Yڒ#sA Fy3:TuU%Kxll`!& B.L&LBr/aH`X&$`!`J0UXV[wrm wBT>z[֩S
.}vA1ongBr,7,
WؙHRIQ?pp~fv(XhӞ~+В|?ݹ]y|»ɠM ݷ۬bʣw],KOvv\b&V?
CqX~q+*IJ1eم'}{v#{HS=ll{:Wp.r#%9o ofW `ГF ,\57J8^{҈(2`uVR|iOc"7szf)oF@O @lOߵ'1nG2&-ڿ- Ʋ<.56F,?-v(15[ zd=%(r _M J4jQ ͡3TQ S#v8@47̡^Z)IJ Eq=@;gX/-T drC){F !^kVbsuݷbǏ gL^6] 0/GX:<Kv)>#bf&ٓ&ڥ 've*:<vyi3=%%k8*>*yvfXov Ons (`gx'իsH<{j${Ңpgw !xg3^U J]
rY[Gݘ؟+~T>1Kmt+0
&xy&ۓ6)i>{p_61 Osr1VǦy-sA8
:?- Lş;~S!ء2E /y#xۨC9ؙyL~aæy 9+JBAoϨRCK(:c82'(O:!00ʀUV: 3CU\ ShOʷqӮ
dTGe1jNV=bz#J႘ 5& 9̸aScR=iuo`ݱ9ZrONhVC #wBGݐܹW8?|@żs9J[xןv>瞴s gߦ?I/QoҟSlMCcڠ Z44A
x*GC# Јr44A
x*GC# ЈQTb$%~\#%i>{W8-?t¬$yḪ6>;³Z^3lXS:^Ɏ&`x`ڦUa^?S˿m[[}*t (mY oƞ?gp;
raΆϘ/nyO e^b/E8-y:BȜ?]tD].C(ÿS!\j͛ >V+vy`ٷ,K?>?AF }<`YM2
sg `X+ w\t $-&ٳ m36`
ᩡ(!I :ߣN"uɜc"e9΄#lm X@`p Pg_% :
zޢ]R!7/2:Hޘ_e}UWG_R ^ycwmrTػPD@@O~tbݙCzM3
Uvߔ ub^"H#0d[ѻ־NN¸@V`ڰv;s+IDK99a$ , bѮ>Jt @t #=;h q/BnZ#{P < IA)ݏ
i&qz܄$ J쫴Yc5~J m_hVZ+_}}'X;hܡrX {pz ŵN1XHj*?|/uw# u! Zj
) fPMu#z c4m6ILOH~(H
c
Oӌ
bLw@%O2҄^ z@\zr+_SJ&.re{
hdz衮460 Pd
/}%B3,X~E[ w%IJ ډ+˫d8( L=\@}n1^ #Nj"CǶTա L_}0i7 [< c
^9:g{WZǨ^ 0YH 1MoRw\_gy3ÖJSYD8Ok߆LAQzu-qG|WC%0. n`w([_K~WS~
²
c &$sp6[H8 ޢn=- `YJbNի"5Dڳ0d#`0ۂ
K:jR> +`Ax-~l#`*bl #4t,iMC:l6[-֕TF볒VwL)0 za @i?d̀>
If6$zV$
.KIi%U
!Grl22#;Y<)iH_A x.]YI )H[N!x]O.z3 )`Ȏz)Ek81TdA_lӬ%)|O2*gk ލO۪$Nc!0pڝ Q'ٖ$
] )@t@A j;f{l߹+k~[6b {7|Sn6XרGFX4NvgLøgȬ
o0) ק}54> hcFK˲__g#7~-8쭞]EWl{պya^T ַ- .7g77~e8`B3o7̾0}*g_r,,˝ -bPGo$9u%Vs~ ۆʄ*[&Sqmm];O"TI YƐ/A&
I-zHS :
Qtw. q7J ] l P:B;1d SQ'o4sC3CHi ǀ+W=0 &`m3XtN(
b?>po|pۣ|'C^ ۼy2m|tc/ l6t6+ȊHNjd_"֧ÃpT=,U0|H wDͼ5uX'xy<1Qo8a/&z WeM H6t/|F7I&ߢ YUU*`ΛJi<: GSŸ0 ҹ3[ :{`A I r vU v! %6H dS 0c
SAAV 2,*-S(t}O{hsJÒ o.~ 0fUO}Pȴx~o-UvCfgI&9&v
@Jl3qC#?'ȁ|~B4 9;+J~,cSǩv$ [.+}*%y~E=/R)8} uR˧c2=%'9 c)-UHc-;'%y7̕(,szIN I}HVΗz
j 1/
9jRhO:~ #,qG#JLWHcNҒ%?RY(tlT]ҿgܢRkS#v8@47!;tJ@H6\J RJ%ݮ_H#`S|XV$M%~&.ekd0KQOW;|0D ֦(P~=;o.?0tr Pt|ji>1i k"G%OnP U4 {KP( A| @]Xʩ'C- >|.e?ްxj|!k"lh^psR_\6\,0R n.ПN:Lc$h5+戮OZx= o1KmC!31
AH۬NI\sSci[w^iqHE/ÿt?X?%WtMRoNeF9(A.mSrCjmc7Y$!_;Ƶ RtYs cΈiyHR.ccS 34 QR 3KiD|6pLr.[!NS@ R{)"0rn|6 ?p5%/bx$,%qN2ie)/~l"]4'yA úCv9ohqb AEu-\JƂ%54osEǺ7sVYC\תEP)*$,iS~U@xHz^Rz>STaÊ4-\ C.0$`zƛ9wwߏ}Dt|Y:2|&~
" z%R ('
pWP%h?Jt6cWiNV=bz#Jz. ~h_p|dkz%b;|QZ270T%bυ
G1ݰ.Ⱥƌ {#wʋ%R?4/c<>qc>qz&ԍ/nb
zrgÓ(
3'Kqt] )/5Fn_7B]!9]NHLj$b¤\0̂%Tz6 \_ J!"Z
$7ߧ ;Oxwne{7n2hY>3Ox}{Ř{~@Wv3 LŃ )p.K}Đ
ҷ!W~(^/wOB}BX6F,Qond/9U }P4~ ϶}
">\BZafvţ|Fpεꪬ~͙ 5e $_nյ֔)g=MZr ;K#e+fW +a Hxh&E^
#Q2c3>iLfX,7 8FcIZ[2ey\|k$-so
@:]%ϹMa%o
^T*G~uTڍIΉ"WxL"G 2V?gl{&R`X7 ${829'~` &f| Iu._Y"t=/}!hGA'rb*b&[
7ʮHD{SzϨC9ؙyL~az6-11 ƱT;4Y#5aO_]I`;؛j 1ԘTq][u7Xw7sNȝQw7$wOmi; yEgo1cvc& w O'; ǫ6L3d9x3cxƗ=,Qgxƕi=,ٚƴA;hhăV9UF^v>_ayرE[E_{
J@۩;vV)dgn?NGD3ۦCB'B2/1Z`] IZx" }ewlTj !I{dN ~P :.߿Tթ.lMg <[kkʟ #TPB>t^r p&9^ P 0H^J ^
;HF. zJ{ Y6~eH P$Q`dΌG1dXgBvb
R@,y ^v|08fDҳ篒Z|
Rv =o.U)
.>A&EF7v 2Gu%⅏G1vv !H%{hE_Nt d_oO lGw/֝9;4 N4PeMQ'uAj)B49Ih$K9 Ha>
i9$~Ot
oPJ~>),F.ZC$A DQz0RJгvY"uo.;7 QS/@Ll" g_MXKX $\MϾJ:?F>QO eC
IB mC &뎢8w )^)\^iq`D,$5 ]JaRrѺӃXp-] ՔvP[3(wM X`= 16$'
$? $R c1P §iF1&;'Ab BuVӔd@}=# )pEk :저,
FOv(~it'
YI
A NP>n8 U:U>2҄^3etɥ.Wmb5`r+L8*X:./ 4Rl2s |=Py r(`}y˗ joZA,"r̭Z$ G+˫d8( L=\@}n1^ #NJBn$R ^t%}lKU
_an3B}my8.@rt0π(Q.Fa9$c ޤg-!f,*p־
$+,Z㒏*oBL}H1ùtbdY^]a qW:tʊ w? , 0vzbrI2g9z-# VX Ȫ$X*"XC= C6>b-ڠܰ橈`.Áb( 3hcä % ,{!Ye۩=r
:]$K?r[cl fKtzu$сUd]$%B
L3APx"Y3Oz
ɯ'|9IKDRRZIbiUC\A wN%O
O
}WKEV5B
Җc^8%>K C
2>)R` w;HNKnXfNccLiЛ TdA_lӬ%)|O2*gk ލO۪$Nc!0pڝ 8s`2PίԢEtb#7~kzȄr(;hSg\$AGd/| 51n(B|e+"/Fn> $rZp[=-_v79i Qp~MqZ;7/\wCԞeaf4lƯ, o){OY>K^e3k~e
?8ٹĆ|sN(7J]W?L sawmCeB-Z])J8Үܝ'Jt*T,WSQc^ė RTRl=$TayQ xM`[(^ PvE%.ia6 ( G7Qϡ!$ c
P_Tj`,'aI
}7t\Q>nj}/m^z/u_ΝyRM }A LB [ۇ| a"|.D4u!|B&~ Hr iyۇ},0s 3
³`_~}: `ǿ l|Omz Y>3Ox}[ iR>*grZ%\Y bsj{ub* Ovv\"fw t?<_$_74џ!oOCB,' w`Kн/X~q+*q Ouȕ4r=Xq;fRKk3uUY/ 357k INnp1pQXWH-gCJ8`d0
ƾՈ6T#3?ixj.`0 q͊gm& G7vվ@ %y~WtW{A -ELWfӱOҲzG
^%4 QߨK!fe jՐUL.r @CIthȟPVIA% QSuc^6] 0!PMi>orD]qr7
gmN,s={&- K srfyfhoN.IdGȠ,:~'+IX^ @=m/Z /C+)QO rl=(sFulC
I:B%ؿ+ tppٿ.^0w+R:#B/w*Yء8Noyڿcl1eR[3 F 4z~24h'`uN⚛ Kۺ+(M쌴]42Kg1 %WtMRoNeF9(A.mSrCjmc7Y$!_;Ƶ RtYs c HR.ccS 34 QR 3KiD|6pLr.[!NS@ R{)"0rn|6 ?p5%/bx$, V'Ȗ/ Hha gs /~l"]4'yA úC}v9ohqb AEu-\JƂ%54osEǺ7sVYC\תEP)*$,iS~U@xHz^Rz>S TaÊ4-\ C.0$`v9wwߏ}Dt|Y:2|&~
" z%R ('
pWP%h?J|tcWiNV=bz#J#&^sv`o @kT 'G֯Y".)~.s q8K;oZ{O<C_R.\p ú
[사iر'1rV)Xra e9M dU~[À5Qn4}q3lSs? bW6f@:M|#7|Ԙ3MS'246N p|( Υ- ӢlUN<(~O .1$y73.' !71.cU(9O&Pk4-cy4&omj'-N?Rzx
i]0/q黫R{ÀGY 2;ЕthoIwKT i^nHdo>H⛜_]WHXy }Mq읛 +ދ݅OyM X!_OZG[{Ӎ+UFs^X6+9-ѽgpts8ݹ;j)ɱSFNH3 #WdcpGے\lpM븗w&n?a2e e RlC(:À!'Q͂\xoB 5U?B t3oM 7S '-L__
ԯ1Sש1Y4 |rrr
1: ܼA CK?hc9r?g+v|Vо+d | Ǣ}I } IQ,5Q YOφ 6C0ZDk[Dt\ ߚW-FiLfX,7 8FcIZ[2ey\|k$MK Mmr? ν^7 t{_SG瑽s=ݕ(2 B{m>W [+j0w5Ot>ʑ_gm vcRsT
CF !^2H㑇Ĉ 5OL2I
q
d&rO.'8M @\ܡEձn{^d B &vNF Ǿ2ie)^YBq1R-]φeWtԽj1GAœ6V+`g3i c6fjǓ=kw+3 +mFW넜*:WY, YrVr{Lt^W2)J+ 빰s џ"_=Pyis|k^5QQq+烉_TՅϜT
f\ϫ^qfy&3ū6L7dU:ū6L;d144
ڡEC# Јr44A
x*GC# Јr44A
xEp0/FRg52-g Z>,bZn_ Ɵ?@]ɝGȔ`I ix+
^t^r p&9^ P 0H^J ^
;HF. zJ{ Y6~eH P$Q`dΌG#e&t"\i< xXV"/zO"e9΄#lm _u}6t~IxQaH-Rc Cї #==?,]ugM3j=7(6T}ڨ3Nļ!H-E"G*a6ɶw}6q 1'~)'a;v V.s
jsZIX 'Ek_]}Ƚ$ ?J FJ zv.72A "_ݴ
eG8jy )екWh'0@2ck\Dr!=9#[E/@L뫶) &뎢w )^)2^Zg 5 IMEGW RrѺӃXp-] ՔvP[3(wM X`= 16$'
$? $R c1P §iF1&;' P(BM$Y@o~}H"XG{[@I"땇P m4+$1>gUݘU:U>2҄^bTKoY]4zżfJ),P!VR%FMfn :AcAEvl/!/D( aڛV˯ Se-]IRl yp >_~ʥVZr9FX1BǶTա L_}o &o? !vp뛇Rch<ޣ:F MȇB搌yhz:˻6UȪ$yZ6d
{hy~PB`9\UYWd- <" ut+98
~[AXATF^0$yB ul E+D@YĜWEkga G,`C <7,y_*#9\ў^ @Y_@%mˡ[cl fKtz?T+' g%"s")R`A >~ɚ}דlH~>)m:D{W;Ajw@$mIM$hG#OVX7 tnQImn"^C*y_ c3dF|;PZI 6@}r< ڽU5]j&zx>yA1&Hب.y$7spC_([o{xjDsR ]);N?В/v }FSXRik5 a `..mL¸eB _=E gVڕ@)S-R9 _ME!{_:H RKM [P1E:t5? |1BsWD=,U0|H ,'aI
}7[ʹ+D ~L
y`^~CZ{AO5tH5eȲG:wPM"-pTLa>z/_ΝyRM }A LB [ۇ}>0^H>n;}:>!ed?3Ir iyۇ},0s 3
³`_~}: ] ~ҷg7FG 1} C
mf 3;
A:c~ /߯) H-uUWeNsl|PL/-+)Iuu-Rǔ)g=MZr ;K#e+fWI a H82u.?_hHcNҒ%?RY(NFժ(^|-*3FpBi%:oeCv
E T< l
+9XE.4N
g I'C- >|.eLѺ .6PN+.pN~wuن%bP Fj?m `WI#il0F;>s4nY$7lp%)F6$!&$!MKdi
)A! b[
ے%˲F˭gόAdߏ\=;s|3)ޖw 8Ef Ueڬu'G*q=}L%F˜P㫛s PVYY@_P$9t@
vqJ_25 OXJ嘤Cv%痋HsjG Gr3{p[wNE e;=XojӪWc0oU%#jDe T Hlzdbw|eMhɂN `ZO{csUC6SQ2Ɔ
.N $gaz |}yҞl*+咙CKjuʀb:IWӇLa
ߣH6S)O\d-e9Si p<5Up lrËAKS0yB +swy%[YODpaK2g)ػm}Oӥlr1_EĻMk~nT}` U z4eq#b|^6}d# 6^Ϳhp/#ݦ*
>_zOj2 9uؾow͚%J?y~
sNvՐE\t oe&=@}/Wܸ%j\Ki1^YZyfHfݣE
"ɯ;~[F_\g|b5#!Si65ᣳi{Hs12gtm (R9S#;&STj`
I mx1BeNٰyb`pa R T0|k`9`dA*c`
IBe`gzˆ$
|`6|te>>l5đy8DFy+ q e=֏WYkV)mV5 fwV @5L߳#H SrC\\իmkm[j?#tmZV,'¶+l!MfW-M:7jߖ5֏9 Ѵ#K6 F wMv]&"-gV8{iShٚuō
}l /a}_hcQ{| .+o-|HT#<>e4a5HέϢ=seǛҽltuds4IߓfozBE 6>.uPpmMæ(3ω h@z_K~n]P z;KK?11WzPir_
aBY: z:6:6Z~~^ _|0c6+jk3+lDL_ #T/wg H/)z_u miIcB 14\ ]>j|֥TϒaO4O/>|mVIн <3O\e.%/M 9b~OK~Đ4"T-7a+ 0 ?X,k?DzI#u
~9( X:R22$O[*_E}j ҕu{{ !K ,Mo-'m Ey@=ZdUW 6n k%_~/pPNv ՋX| HKq
R
E~Z=ZrNI }ʹgVQ3yk9Wmn;tmmDW4C.1엋 ZYj-sZf~㞕 cnLuN"O r'JT!IDžթ.~"it%3TX6:+<D D$эI
:4&6'aݞ&i| C'#EL{g]%#rQ6:ȓ6L~XQdaK GLt6k/adؚ^K,BbF [K-wLF1[1! #|U y$y*$ȍ-u0fI7rsV VD=+Go*n͒rr$O9#mSXT nh`m2~9Onp *\]K*c
FZt[Ih~ bOBߜsm|p/ NE9W}vgķv7=! j ZoYǜ+zOB{'tˍ o{
Q;9d ~Q02'1zFSQc/)5Z30l0N-`dA*c`
F9`dA*c`
F2}!.~]>$K=={ٗG 7.Ǻ4漢V7^^T uc]Q
i>? eNmK= I_pUؿq[,mum⧻9B~?=NGt-g ~[ߣ>kl' ު8wnyo7_}l#s<'Q2G$z8x\Kr!Ђ ]ǡ`$Bq :8p&>ErA}; 0H_H
gA]:c:=
[9(*I:W' ZBbwA]Ari6IU5NI5ψ2 ⳰$3z Wc9
&.. ╤ȩ{v %ɹ2mcCeɯP5 -/' -44߯uo\Q ;>,Ms66^aw^'Isf@j؛,&J 4mnD҅ i/>
j [i9⛈ !܋JoN?A Ut/P 7W=/h81Q &/&%pIOn "s6~D@2i;|%_fe8 jB\
ڌk$$sHЛgRX^H:$/=qtx;An}@n* 2 n
A?mC =@ IZBC@
C@աF >@ @>Jskņo|$,mDdhF` b ( %P[h_;({Y#㗓
Pt
4xHZ>П!/8㓬lElښ,Ę2fpm~sASJ&%dždc az|gK"-4$ ǹ1Ʃg bCrԟy%Ğ`SD\D~-g&۫5Ƕga.G,lE #o$^QO "/t?E&1%O`clȥ@+4Fs 蛦t.H ='KxF$&a餾Y+ϐƿ?߿j4ziOo{-M kTRגb pCI
>6¤P nc/7`l30H#s R T02 10H$>nʷC|1 T02 10H#s.iW#1faٚ/Qç"o>)Ȃ6go 6 lg7̺G ZP9<@c~[.c̙p4/½&g
薞9=\dQmg~& sj۴;G҄_#twSB7wpo9,R2[0+
ee Ohzhc5C좟Xg =}m K:S/S15ݵO~ _5SeBnnYGr&,g Uw5sXAwK= EYi-k0c:QC ?xs5
2>mmK^.uA! Hі¥CJ4rXh>F\w;, Q;?CzGr5-`ڳ۱{`XΜ﹦2Hm?`q%\ {. %IDAT ];G[? /\4C` LP!jHpDcZ92 SsX_ q PʲW>`* +;~4X&~ef?) B(Q9yO~ E+L7ΝeT_wO6vBn
4O/>|%mlUy'_]k
Z
Йa܉va85O 如Wԕ+|, ܗ_镯[@XcKp
ſy6߰yEDp W|g92dCpש}
.vdd !ٵ7sV aTB@L
ap$(@8]_K_ @vUc:~\ M8 zfz^q .ӉӖ( lMmZUjs _5 *pdf\6! _Y oz oMF zZ4 hhhݺ_ ?+fOcg'Νۨ*}z2n͛#V2T7|9pp)JG+Rݱz |}~Ҍ]4OsMeE"\2shIMoVPLG;p^)48 pS{twBHW
nqC}T&yg!Smy]DxӪJ. ilQ|}O32V`*f,Cjg cw~d摨urT1ILU
URlΩ|w8ߚ*Ff8Vk(7*4Y(#+Vx'ޜj
*УKFՈa% '9◶[sbb>C<41BSWh 嫯bd/ ZOՎNzKlܢoYVզNj]dm
&{Z>)b^dd=͖8X=5ي=]))0?fZoYǜ+zOB{ONXݓA_\g|b5E{rC[ >DK?0w"=b~l2 _3Sh4Ф|IU =Lɺp CƔ)e9tHۆ8
DRGwLv% c R!IC
02&4\H̉:;/]U .#њA*c`
o > 10H#s R#9s̾1_oٰV{ܾ~4D:i:V _e (~_z`N,|oS0{>w >g yGzު^m^{oR)#enŷz>5gi_?9<_g{n
6ӿv`nlҹV{쮱~.IF wMv]&"-gV8{iShٚuō
}l /a}_hcQ{|.+o-|HT#<>e4a5HέϢ=seǛҽltuds4IKg0+b/\(GA~qۇlko^}9
([tф~ #U Y v>)QfI Eqp+T+ lv
a'
L&V} ;G|wU3
$no$1!. .Q 5njRgI{v#7"E9\ 9=0oW*j!cä\0o*
rtizv" )F(oDӄnxp݃-uR7 F~Kvę'Z?mKR\_ 妑8p˲ 7xm? m߆-0_TEamRiK_+8(O- 1 Pntu9$}cb1&ķF \I1m@:kM z^sɪ.>y҇Ήo<~ jnzk%?-ݯK oVy7` r_K @t/JωMA[ V-[F-o9'Nf3(gBݼ絜[6Jo:y17oϞ{ }k@pRSF,T-Q%'`HWMS 0$-l|5^ Kϯ_${ȋh\<\£TCŇB7763g-z_mFaEҷj-hfL9C;;?d/q& M-:|k~kLKge1#tMk;f{VKOtI1)92UYPG IDATxw| .Yenp/ai
\
]H.RHBOpfmʒޥUɲdeɲx㡝|[`Њ+ +c||}M+rÉH!`5z>Zgɯw-^d.~V浗gx< Lk>L8ܼѫr2.;m- 6 }M\uuTk_ȱ)غ{UGsb} 3->.jȫ*#/[k8uT]/Ǝ"͎sEg܌~`n
p[`&/ ,Lӆøuav[l\Xޖ~/X`1:H;< ?ů=} n
شm;?_;ۅlwて/z"jmyS&o>Q惽/~dlKT5FcԌ[yIٲxɟzF㍓m`61ǟt ŅWZOMoݜs` $4M.^¯~{\, u7s/x
ZuVDDY L?v (F6wὛS+';f ! 2K 3I4zR ML6[״p
#g}\vӂ'kOaaQ ? HIW,av-s9UUn6nn@R B2ȭp_I!sV/e.szS?!ݭ=5dđуr2,{l "+J'
hF`c 1!XQO?.VԳkI8lUferp&Uk+EgnopϽ6 Φ٥t|NJZڕED7ͻG7{F瑅m OoV~gU{*;1 {W7clc r7s 39z
sv]%Xf˟+:}ď~&'duTV$^Ho)2ɛV5{҄9{Q&M||d#ʏG,?Vj;w~ gczxg_9
_7iV1kxw~8us?&?3i1?%.}~>p?뗹!`3-h g]9k"{~2?IS.|/ϏqvxS%
w[ wcVEU(h铪*='/7 3g. v+c7mjN[DDzU_AA~߆HtpR
.a%R$:ЀZ"wA3yBKRjXV˸CUF:n Z}7suX-1q"I> L [iY4d#cEjrwA8% 7Py!mEͳmgQN^6noD&D}Bf~ 鹸EuI]EW>q L,f7,'^U9Wjmr|rOՓ9n('c:8x$̂\!ȵIuueJ*+(.8+ |s}g?Oq3k^)hNxҦ w=uR2iZ Q&a
G3)G9t bg-aZ$$\feѕ-6x5 =K!:_VhnP[ix]?&A!AyZ!ZECB;>Ys%yz2"fݟɺ= >MvN6fpho&_=(
rmMݳ} >*,4VK/_Y-7e)v }+r ?P_Dzp >@j\?Gq MC]-|Onu n |ȌIq6 9_9_g7$%30Ez ' fׁ<<8gxW&Dbm+Xevsr22g/ <=MI媥$ i.I v-Ų6m ,0|0 ӛmoe}nYTQ#p,w{%Ƭ Llo+ VՓUUDI8|g:3
seݟz饗^z]A95m*O +|f}R_|ث}$/""
[< ݧP)94N>z y6Z#;Ø[5ϰRї#/Xb`_[8 z<v?ȁ5}.ܚ 'Ҳ!Zŏq ᔒW2Ù``LY,U'TV1
:m25X,c lq{,`K7rv>*\J;&vz.>2[ן?NfæR$ 7ǿ1|wO=yr7W
VΡj ORlw?xMDDzaݍcgHUӘYӦ'Gf]} ZٹiWKEDX>dB|';>BEL^:kNQXȼG7RjC顃
#}[|r 4q Տs4~߇-8{ C Ţ2=ɷ|y ;
KeMLf K *RK<>^f O'U~I2*qo7̛ELs8mg` g쌹Zn/~>L^Oy
(O s&\[
n*uM,XβSB
(jAtiTOf`np}gs9}:ßȁ}},\{Lu54WW9=ΟKiq]}7N8
""ruYl~DE¢ 5:*?:rJy,HRWm+b~DEDDDDDDqӉ\Gjni8tKq^hH8t@tYDDDDDD=-""""""{v5˘9gj\v6DDDDD ug(pg{;WNo{r"""""""}u8^% 3;yaDaq=WP]S[Y.;p>jۗ[f{:lK/v{zt-YEiy.@"B8tu|5m1idv-yAxh(45]DDDDD+j5s&flh0 ;@BC}""""""׃>pn+h5ZWS[K`? q1xbqϛNȋ_ijw~ 7WK-}yr5I^Oͪ[do8 ~DEZqU"""""" 8_
CC
j˝T8++a NeUulWDDDDDzs]D`o+-NKrgegJUu
Wc ۇW8)wV^x"h6Mp *l6[oeSDDDDDO3fΙgv&z7-==8Zo8_ߪv6DDDDD몫vKY[U*PmF-=cA^sԙUqݶ8tU7_BogADD`""""""" P,""""""""""""" W;{;""CF
T_g佈t۽rGyyELy%*ݎ/ u4\==f>tM2Cn6_CxnS>O̤|{E ۞~]5sf|uטYwݘMtO)w$ǓOM]W
>Y,xVg}_MYRS=_z２Ӌ= KoeXel{%g||
*{8pEm9ec^p-}em4A{V=@M] vͫu|ieO/=9w߷[XsCiV^ߌn[e8~L;C7h,?c;ֳl]wwL
vŷ8ZрC\&8 74`S??jjqt7"%s?pt/Y |<8:J c .:cȤ1pϼpjG|xa7-aŜش3h2`|OL|WE.'v\J,-j2p#ܒb剉ͯbOŬq)qUsjf6ϥ AY0c$yj(Lc4_'5|s'
"!2l߸c%0GR#<0-QgʻEōeQo |Fna _cN'ܜY/Vm'~ 9fUq~1#`K_ݣN,X2kGD)
@"1Çl #r:_ S $~, {-M5 :a@d vw
ll/r8rw7;nceޤ$.!Fp&eo/ q/uϐ6>'Z
8մB{ l*
>Z i6 Deu5nꁳoX`LX1f>VAVQҥh|Qƚ ||x9\'le˹G;g89v#(h~_[HlF}FVv'/KqpLqmiLs6Nl-LϑwWlSif> W% -KɱSWN`L Oꪷ؛XrFQ>v *NeRRpt(j~$u:Cc{ߙ;kS]Dc\Ku =$O_R]JÿrFEܺ|9_| mH59!u5 L'
&)),nCMԇn0uMN&7eXa#m2o)hBڻ3 7%X,U8> +DTB,xܤY6Xonw]}?_OΪsNhb=MwdjYc<)dXj{Ǚ/)K:>LG <9{|y pěwr)oΩCK.k?ׇ //Ň?= *BCQ]xOTDXgU47jbrg!kC 0n²<(MMl?Sek#y`RV}vy}GY ظbzI_o8ϟH}l`q(hʂBӬMEA!u-@/q 2mzd@
iy1Sb|C[L3Oi&T`8|aedəit0!O(fϚp}m7,`QYR \D!7):wc{?xgR[4eW>+01m " IY$hn*& d@A^]"bXN م=̓upv85kIW~Ś7D;gJc%C\nKv `m Oˢ*(^xn!Lιu}XVF^~re{YoZDqn98z9Vd` ޅ}otaxs^\^7o'eO^?__fqP[WGU
9jN:~L [@ӇgKz ÎO0cԟ7gUȕqd1>w<7M.U*Bg nsw~v oY-ZYMڸk\\ԇu00a % 0a. Q U^ʳNgXmM:օSG+,o;}J,/h8WZj<՝3ioNgc6 6 S#)a_T$F2zL>o0`UЙBN 1ey-8cgo0>~6B7( Ϝ1aU^XM n~ Ld1lOMY|W He W<έ)>O=Nz@ƶ- }+OtXw5 $l|wf=U~a{.r6Us7v *)؎ 0"IL5=dwy*Favg0s<0(/r54`qs *&|t Hu6>9ꩮ.쾽eeQЪᢈ
qX\gԜbY|a-̨ȑƉ}fD}U慱M$g Vn& d7wU%,5]kH!f ę.*kO@bhEnkj DMb">ٟ1X:-ݟV}5}h]ڰ i%}B?!f* 9̘ fqtEzQI PZV٪/W{;YZϞL'FTxQ~:{;۾0#I/1cv2u3/ϣtj xjeyre츴 p:+/y hqTNg՝ ~9x^jr @s
eו³<`N= Z~<0 IJ,sxglK8,
&tR68?vâ<g/cXWvA _|
pmV)6k;DZJ&G`'ք{ NTZ@-u9>T;nN};㢥0opex+ M{_5{[~nUofgeEl~lno ?Hg)
k=xJSTZxຶ-?.4Vږ+ M5;)%a8(9y?`:on0=Takr6\se #»>\qYw,;Wi-?Buj3s7rd\V<6 ϾBiiW đizAV9筭874`K`]YC1n "7xv>f/!\U%d )oA|NIfٌB/Wsj-~qʗyԦ. _^4 tv<]rϋxrelg?^ٵںzlDbS[WOqin x:1sμNK~92"⒒
l ňNj۹ lPz?{e9iUr?~2,r֑f+y71VĖc]gnqT-/^Oya8b,r<ɀŏ#8.,#=YN@p/?yҫ 2ΆU7_Ol2j0n/bc9zDz,ڼWxz}n{Zyů5YyHXh eIhӳ+wVR^yՁ|Mobu4X釚P'Xw0沶q=\i 7?
x8:H=
z`3dx srψ LK7D% '+78vg\.rs{8W"}Ϋ>KpZ(.f:,c:\3hx Uuu
\٥xN*0
.YEW:((Hƕ>pܩp\Y`QZ\
6{֟"|^x;.iGhbٷ0e\Y.DDD{{w^Dg??ӛxhN!xMkphl诖rwplg5B/Lnbq|2
l`Z(Dw6'm C|ɡԖ
,o`>8x,U#՜e^+ìq)$G窦im]zƔ\oژBs;}5=ry^qN#*Ń'zӁ JbծxNͮ|O~ :ҽqCk1r8 -_d
3G`l7&2kh I"0< yBA\^y{xO\n 8a. u*gt""&""""_Wu3 """"""r-S,""""""s/{;"r~ """"'YDDDDDD
EDDDDDD:+ 6 ,/P쉈DmqvE}an`7g d- 3*D6ߋggf{i K֤bƇY[LY34EDDDDDjs]m Lw`%\|ʙ0p'E5Qaz w CS/""""""WC
&)~ {O,kgM 3R/:} Ur(ɚ VX
$X4T9zʏO٨nJ)_-wgPcPZ Ԍj;6Aq_a4NTVϬAe~j劜EDDDDD>8x׳<,i{f έ
M '*;GUpOzx=N ^L7;6`
s6 #l3M 58yܟ&uakgz %8= eN&'#* tyl=#;fu+*lt>8kGMsaw2ʓxkXWHc] NeΘ:6o6VX:\^m'e4e5 LDDDDDwQ]!C e^}瓴E
8{yF8O'ePZ`1^^ ȪR7&dI5. z^5O8zXc/ ֤-h~Qџ0b9T02`P^m")F lk4_""""ҡ>,"}A`fH},ټ(W<'AԸ9LtmO9̎u仮<]V y~;77.{?_]Ȥ1-^#"""r)p 8t)1 kyt-1|F }[0
kKO6MÃ粧V|HO\սQ[f. k+)
i$y53t0se0|<55{ɮh|!O}FE 4
ٵj%۲,Fe "ok gk} ,ec}h(?ǾNFc縕͏ݎO|țsƊNzpzIeG/a$}1< m~d2Bgs?ƭs݈̻ z U~I̹n"ʹK>;Ƀyy $fUZ=z w+=˫m'>L\}I;+C'uoNf)i
#>ܣ"""rM`"c 0Ȍبl?FIxjr!adCc#4J"ux3v#2پ N7x2ٲ47}H> 6zZX a
$`2ūQY:{m $:.P O]y
EDD䚢g1VM55#gۡD@}-z {*ʩ0
0EƆ$
)
\h9boB_<>A8 nW=2tVVnȇ9o竷*8þֱ9ɵР."""
Ey
8㼁#cRf0iUURO 4M %Ī{B'jh}ekqyLZhNH&k^ YhzuDZ$w:+Y7Ptl# @'w# pGDDDM-"=}kzg%.ݗ&/y6< .Ǵy#w
s{j'T%1}V
603c`|W(!Fx| lao ڲ|S9
>wnǪ6+gWx<= ϱqJ M5 [eRY]NtJ;h-.ǧ1餮BȏnlȝZe
G-aIT vԕfVk\Cs"rEv6>n
dyRH_"r]Ka`` 9y<n=Nu/"""}ju ̂ˈa+M]ۛqvƮ{U[:"""""]""""""" P,""""""""""""" P,""""""""""""" P,""""""=YDrvT|dogADDDQH,"r vvDDDDzE@phYDWc#C ]iぺjt@H8t@H8t@H8t@H8t@H콝Y^rԙ6DEGiݲ-eQ]]CQa! [gϯnGEGOeU
.[g
'*:nI-"""""".ߏ \.U55u[P,""""""4M/h>i^PVH8H gcز-)ؼc. л~Ηlߋ
v bcmg?߿m0>>37'OK9CENT8 9ԝ70z"MBDzt2!-ړ7k"o{l>ZU|zDypuz (OQg 7e,#\؟3i-c*8Þ
kzBf% O}9eo(f=e }v6}ƈ;-wh3\70u>'
&>ԁ"lj,Y V<ƴl30}X,AZru'( Ǣ QGcl^E
)\F3ol?<% h`MK;: w1'6䃽4t9Ͻ͇w= _s$ ;Î",aڄĄrfc=G- 6B]0] nF[i 1uqQag bO9Y|6}L(C G@j^ys'}! YD?{w y{{zѾE $60f
/11&qdnfI*ܺzܙVsߪN%3IĎ7 l'6`0$!!VwKjs?$@VTQϳ uOsN,ư=3i:'\KghWo`T/{7KNyazwe D3yzNÅ&-}5N87t6L߳'&g6O?of 36R, w&܋>W<6|t9R)X k_
HdֱwqNzuk^浂*;>bdݚx]z 5U~b~>'Zn}Jr
Xk IDAT榻#ba;
'O~ [vxΞgd_z+~O0~t;I 3 !봑I?q= ^dź Q8$ZBֶ3
KYDDDRmqʘŬ #isܜ)^<>;[8P@Sc ŻrНłyzn[Ȃ1U^|Mپ⻝^.`Xmh&_u%츏4z]@a,=g9]a0abNL\E8~F M
UvĩLk@Q6/!48ey8zL ;>[^jkݴfojnbӟ6o{OF(4=GScg*i(;M5$-W\Vo-OR(xp
wc>w9E;vSoye?\-"""gy)[Y\Řd2&L2l N״|jfapj]˕ 3{ rb߳sCf2&nN?Τ@Ξʕ >.(;687VmA|>cD]S>tu=a>4tԻ
ۈ%#:o-#oE Yfbe)Wʨt'2*{>/%?8V'o9m>c."""KYDFE}aR[B Wļe3!U`͓a`uz 67Z^DV[yk9
-]m0;a>bO>SUum۾`۶/rWu10rg^7qel!y'1~s}j_}Clgɺ)[>+I65`?DDDDRmG|` /V
4?TƍK L#+Z[:}^ʬN: :& $R~32(2wQ6Ɛ٣uH"3[>_xw^.\8 5F²fylLo-@yS/?-WStp 36m,uIȊұ"Z:{Cj6QaCYDUv__/R`,$95+ײ4SWzqAf<Eּ+U^RabF4Ys ']g 5:^7̔$Ҳ1e
.ȹJ͋;8#&E5 I7>;W70-6lm ܱMU r;GvΉ0!#;W]-E!e'>w OL_s/P裩P894UGq. nL"-k@Q6/!48ey8zL S$c)ڶ.|Mԕ>&ΞB1
\bIR[^37DmKm m? li9Ė}oESϲ8'd>찈3v ܮ:476kvngQx00WuDgaL N| X]NMZܞޥ7EZ@ ڃ\
t}r1hH!'&= iz*H09i[n {xr**)PJMK ]S f fs9Z XTzӘQ|W9w3%x DNAu4^ !5 gQf!~V3GsG c"^[ҭ.B^K2ݷz(ee{gpÖaaֱw B(Br_R6.IyLzd5]c7x+|\X
uwn@- ]kDDD hv`B|?Rpeunh_4Ɛ٣W ¯{/!W份vrjꍙ2srJ{OQayv?9 '`h|xyj /̛HfJiY2kh5wǸxbcptER.4[lV?9cINH$=o&f,ｹið Qܘ! ]dHJI'95Fh\Dh_DFKW ;>5o'5r.}rd*@ ^BW+W(>;lR}|E// .%poorYsIsluSq>>ՄqZ.fɕ}\QdI\i"""t-h }xb
}2hoi&.1ymZdֆx&' y//#ūX>gi 5ٿ %A Y|E?}B|]DDD]b&] ,ol.K"n?*8|Mne,"""ңݸ&߀- zZBxC{q6%SIptrN>yf q~D f7~Q_KoYVyNN9g xn~IZiL_&c*/9Xq}z٦a+{xǒ`z)=fgY>3Kzwۈ'_d'5. W鈨};/ ?-zvm5""""(8ȈYjIII|ч縸X֯
ǦM)seo}Jǫ}gj\-\y;)/덠1̜lPe1r?į4t:1hWo`T/{7KNyazweQz$~Yvm9)֭y
Z<̇ukw9 Om`t{=~brfm6niP~8"2bm_#..>?g _cE0_{ݞ001gR* L9q0,svͪ#8@7fl!ώl5XG tg`ބGټZS8ӘBn Qi!ηf2q|Ϙ]mrM&Jq gO!J""""2TqG }~klݺk6 8[;r&7KǙ Ar}~1%w3< S5`=-5 5}樭FjjZYAQϊ?=nv[ XFGcЎCNL2{ﭧ#n_DDDDJYDFT7Fakoβ\6_dfA,0+ Uݼv8T],b ?=}rq?YǮa{#h?i)RHi6ݳEd]ϫVb箝a\Io>213vWll!8cc;Wl2n\ ܷ{$z (w]Ĵf*{F$"""r5"rOwy˖!f#*lrLqrd< y鱱\,fk;J9~+ֲ4? \ O]%Н% <@SxaD2SHǔ+X g/| 1.9 ([DDDDngorq[( BZ
Tsu R;_wwԽe/+bMZ8ї P#-cł3Jc
aڤ ^^?\JbJDDDdPV@{K3qɣV^DDDDdgY- CYDDDDDD$ g0EDDDDDDPp CYDDDDDD$ g0EDDDDDDPp CYDDDDDD$ g0EDDDDDDPp CYDDDDDD$ g0EDDDDDDPp CYDQZS~L^ ;xS~rL2:"""2| )||{N,Fgx7pYюIceŝ Kul{7 xȃHYD (f! IYVw+aK]jNM-
LSA.-"""2Eb[p23 سCY,MkgvK46'߾b>ϳu5|pKTZ̼|fN6(2mW[:V47nߥk'wӼ~=ƻﲿތ?= g?ɬcּk-tU w|NYɺ5x Xܧ6a_Mn?19y|6z{K7O-ն"3G'凷ˑJgXj_&n /7pFTAҜe>oK5+~D0^3yX>7 2r^YWQlh EL}3?^_/k"P~/nYNWLӳM[)E̜DToGlQT9`fvk˂3gQ{ hjxVX0oBڣl_BMթCiL!7p͇˨4Pq[38>HtRm+G]4+g}L=$c(b13q }45Tqb2=ַ.[ 6 's\&ڱˈM$Jmy
V|:ʋP'Km`EDD䡦gy~EYƢ tvq&`tPzgAAL ŝLy$@ǔu
*-nOr L2l NieyvF%>+fsXrǥ ef Vg(>DVEkm-M}ZɊ7Z-^D<JJ.Rҳ>|G4`"""QpJkozβ\6_dfA,0+ U eO&} Q0n0;wR&9&5/[ih"h+䕟o]Ӡ8ro#//>%e)ǤGVK8=v^PFDDDT[D~+ 0)6qm9w%0x>i {A#qpoH02(rs
&L lA4ܸ HFZQCYu$b997v7 xu\su̞ EDD@DbD%MNٙI7L7/5q!/=6}n:R`,$95+ײ4SW"\}:K8x¼d$5)WvA^;c\r?Y@fR"OlܧJ`lYY,&I'9!i䧚4z g
ņ_DDD jZ-"[[ : { CHb.cQ}Bܤj0]W?cEIk}?w;bjo佶eX&ZiB!|ǴI=(Ş[OYW ;>5o'5r.}rq]39 Q}Eݍ=w!8V7g?SMXθqQ;IJrJfGhϲ< am'""""u,"b-9H
"""""""a(8,"""]n7 IDAT"""H
"""""""a(8,""""""H
"""""""a8F""C5phwADDDDFҲQiWYD HUWkG """"r T[DDDDDD$ g0EDDDDDD5""""""2bO*x#ؓ;,";KHLϏVF`ϡjyG'po7_@gI}ah='~*Kx_ -l ˙߿a'l 㘻pǐg'ĵ 9WZ~w:w]&ZX{,|/vTgW?Z~)"vaavw8y H b1qwYcpwۏ3K ЗAlSGeYNxb',`ż|dgoPt=,"#|m13Yi^u|;5ɏ3y 3-fsíoE8);i}7
GL ; ,FAڛL~6|6b&ej[Kۗ0u6b?yK1ka>1u} pcj;DDDn6y(ңAYD >46ziIl('knv{ϭaa w0U<}[AnhnhuKZ pJ:8/[Δ@ aUMmMɪӨmOkr&f6+d7>> GfAI x+w|>{ ʞ3'm/1j])Bbak1C ֲ,[ȃHYD r@lv_KӋ? i #|L &:;|+gm8sON%?O=ݗhA~UǬ% ;0k uݬ-1֭J | <˼xnA}fݱL$w, |٦O6>VN^ylxюKt~d)ϲ+ck$uE*ބ}DDDvqO\S_3ʦieb͒ڢ;n m`If
3҉ilySu'9xy.#} %Á`D8p}nm
ɢ`=P۽'8xh<4 z^xܷH
),_3-&o`K6;V"""!$,"aj;tVrge>79cAyG >co,`I~͇:qa+FBti Rx00pF9{jr v)3?hN g\Op=K$ۧIGBH(qڹw/S^[˯9xF?Q)㘹p ls ϲh6QhsExխ=SCs0X>Ÿ#55(L`#K
W흷{G$o:ir xgpiζ~Es*7DR7lD$9~*M!0 yG@[#X(2Rbٓ6 ldevcv6n9˃CQpafs1G -`WX ȵcaiZån b8o>; >Ԣ}m1 w6ڤ, +E*gm@pw=q^{[ :ǷS>Єj [7/neFCTt]uݞ
f}}'"9' 3koi&.1yiZ;\_ n9mrpe5,""""""#.o
*"""""""q/8,""""""HYD HycsG """"5,";>;"""""""a(8,""""""H
"""""""a(8,""""""H
"""""""a(8,""""""H
"""""""a(84,bcb1)˂ջܳvED䡗iZWV wo"""2 Rʤ{֪jC/.6:WBϢ{ڪ< ,""0W
"""""""aglsLjM2فUuxhNDDDFfEk, 3
/QZS~L^#S| QqIf3F o1?sAIN* QdL*`Bj,Q6,MW(#t
L&/3(L%7(:Y3
߃9~Z]xkbu
rs0\00Qp݆{۳'B>O_|FٍOT1xyϺVr7Y_@-+bHc,56W'v3n,lmKfZznŬj߇˶*ASBsǑJV/`Lbtw'ǜ3YTEk7?"SC7sƧ.)@eOB|vG'~Ky}q-6 X7R䵓;i^X w_9 ݲ>b>ߧHt/}pl{3_7oFʜl@Ĵ #Ӎ&˼w~{F;9rO,hTiK ηyڍH%Oɸ3?ԘڸrߋB3 ?h}tΏsL{y&־OM3l0FVv'凷ˑJgXj_F
}EK] m`PwTVn!c,
ZRg `uneYXE:w;$ajB='K<gSH|r!ӲUsrg.h=.Iƒ@;J*\$ Մ#5Zko)v i'>!E6 S {n
;))[C^
`D2a8[:\(Ѕ@l& z;nFt
&';)Iӵ*.ߘ]_#q44H'jrmAltf<9Ue0q#33` [H49Ĺ{|s%kv3iU`6>[M8)F*M&Xد\)Ǔ9\f}
kc{1
;f;vTI|pfkn}Ʋ"|Y!ACw*ڻD[zǦ>_?ehz<ə)kSV )$fg1W10jދqhl\B G ܴk+yg E0_{{zrb9/^'}: X^L;glf$qܗά9ci.Iu`jf ꦭ͏31;`fapOPieyvFegdƦ>װtvq&ip j rbT`LZܞ3-
oop7xJ_貑;.;!.}2
( t(ɤp:3sੲ僞Kw8[!^8p _&": sVSQUIɅRjZΞʕ >.(;68x tf vPo}7=7qF%]+_b쌰n p"v;f[e 4%3-
W {r:i/
nOm;pg%\>ndE5R^o]Te37= NjշFo]觡IiW l[Jށҍ}3L
ҷ[K#T'
ؒI3\ _;wdc빹p O&=hZ|Zo7n; Y`csIbbϿ94- g 'v} hV@h);+ bO͔6ng0FL\ L73OIT}ӉNNI O^v2qN,m Ꮫ3(Gg'/
͎
. Q8{~lg_[vqng|z
Q
SxJz}q[;wbcWcwl}Zk)τ錋htQUUK?Nr ~ ={>K4Wr~>ZšC!77㵵 :t k8>[
gyXݭB$pUxQ$O%ohbZ!B s?6 TƍK㚛B}0P09; kKqO$s; ~VY M2G<}4r{@ \q
~/o"jB:Fyרq'j.qQW,>WV4ܸ xb#-(#H E7Ttm`~r_7}tiwq\g=3 r&A0Kb)&hKdIlNZowCݺUU{ږe+ۦ(1g9` s<3D `TJtCSJ^U|Le1p]?sN|}kҺ =b)IT_k
Zrx;4q/{:.Ť4cvdfl#
Ddt]4ڛ1ݴic
'-=ʘ =/[O &wK ,ctR&399kfMz//>Zۣp6SK\z!
ߜg)͎ 1>a` '1Ҥa,6PlX>F$eۂc {k b`` Ca,mϲ~-4ݜ 0_ n'&MT1z0uFڷa' `xD3f- 8썷 q!1#6ϞFۂK'N3:rNBC|1 /=lہ3M߱ز :~'/"FȬL+Ww^w -!]Ԗr zkư#&*'0cvQWD䔹,Nw\K^hMRrԴLN{*rCi>%-\iDrJ ~VptXqlj8bT6`b89]McqIg%Δ{F||Bm sGCmj!Fj2sf`1 t˸ډVMqSٳvJˍzu;eW
aJ 2ᢷڲb: ]7ZHΚ$_貗q|##SiaǴmvJZF %x]7*Bf2?Z{n>:r[5_ڍrJ
tR|"܌9 k3MͶrlnSWgw)Ʋ r"ru68)!,|, {F|"ΕQz⠿9CPD-`$t 8>>x\6?|߿yy z -❷xrm
\~v.;= 7NMFisSp\ͥӜpwmbh^Ѹxg
{.+"2!Q_ M]c
YYri*Uٵ$Fv2!{{ĬP>5 >c>.Y`& >P`%Ĩd痧G-lǞmJHl4~uwVz˩j Eȸ})7Mrh\ (*EdB =/`IdO#- Ʊd_/O婸/|EB m'I%կ}wDžOܾ . ʛEǜv)|
dvcC S#6Ѷ˽qyh77fc%"""{=U[O@6))c-[y`&tvuRUS{OU,""^; 4U[DDDDDD""""""" p@*EDDDDDDXDDD䡣 dnk dx?s6iMx颱86LL$f AjxXWQx;A/)gä {*Ed
b?eqZfdZ,.=WivYd`2(ao`} )f C}pTq^vs`=ⱌj]a ?eq>Nd~R>TivyZ4yn{֡-+א3;N͑W1Ǒ=9?gMG\ckm`!lJșMJd 6g'͵9v.4ڶäI. {YD&0 as6~ 3r>Ͼ
|x~ɧ?#Fy~Fzm=enV o/,YHm:>>L_BxBb~if 6z淇kpx ikiv|v+ ֭ošq8}=ξ/ udP~]h+<(Kg;Hyy9QŴX
9U4'^1Esr> z ᠦ qo7y~Pp }fǡz뚮alXLֱXq
[w xÛ OėIAb)Z+9K8;)y=yY6ξby` Tmyp@GaxV'$nw;o sF49`@:$&Y_ϭGqx4_ԡ|쩎${F>DDD&O\b"6 t!"1-͝$D`?k 9QG܊yrBIdUlZś+jWd 2l^ Csz϶˛~Ftsb'64-8fҨZN) 0} 9/,1٬Y>HB'2pfL'm{y-FmJDDDHB':.Z ;,h<\O ^R|Z
wWjS> h)%XSMZ $7p1/(`ёQA{7 w
+>\ǻ9\3ph94/^ q:Bm8))iH}O3 !$,I&5UtuvXr~SImCW[53TT0DDDђR3nKSm= ,erW ^ve5U[DDDDDDӶ'
MnaT8xaU߄ EDDDFSEDDDDDDG9xc/)5cj+ь
gL{)%˘QZATr"YJj/_R0Pӿ-+א3;N͑WgXOYl , ˈ!v ޕ!QLX OeаC>̭ɚ %nӰ,K{dUo0V̌#Dљo&gEjh@άxMOeev|.a9 R Yćhꉽ㗻JpǦ`ajyi3dK]ˏ6X \w/W{Jqb!vwy!,EGoľlyക<>O؞ƴ~ʶmjo9r2G2vS}i&;g5Kl
ֳpHr g[
LwSIs҈dVCC;[EtIesRD#l?\BcczJ*/yql-4,Ί WT8દISG+A$'Q}
sY5%)I>ԟ+ ikiv|v+ ֭ošg,$a6~y N \yV"fou~._]k86g o_1#+P]·2n剔rv|9Z|I~t-3}Hf+k\n'uzz\gl$|g4pwV߃\66n[=oLlL^ ^Z˙⋲Vhc]Xp/4g?v_#m8+AS'tY;82&bҦWv
Ǎ͜KmU3fT? ÅMɩ oFU{j1M `|C5 @ f.!x 3*ux]%:m[639}.7Z[Csͯ' 'k! L'k_щ/)+ia3sـ *c$X^"0a2]8''e) &qrJ:]>b>s Ϭd SЊ )`:k ;?=Msx깁ˏXTžm;GₕJ3?)u *r͘ڈ_-=#{?拆^cff {eۥVLl/6[88sva "1ډH, g"" J
eEa46 z)/ČO&KbJ6jK+$%m#26JJdHv >pA M#1,<>CW1v]GOY~?,[ƥ?k- f|8
fw g Y\ٻSvZݽm RdQ?xJGgr` rw|ZZv'[=dɢpnc2ꛚ+BZF{y;U2dAL̹ifzƜ^# J gW^m8qdٳIr+kjs{S Ԙ>Z
9WG۩vbo1
ɱkzh'8r[E\ mV:k\,]/9O?o{ Wb>0 |HHYʂ&lo}~wVp?1]rךi%.pk{1w/p֖. A]]{l4U[D&W
eDN0J*͔w09m>ԖjA[$&Y_? 3?eƷ4r<4:]LGk,cF jALe,F-eEFz؈ W.{5(RSGXƅ \X8
\8_A,;\l5IK3k
3n;4>:MIqsL>5m8M0"ti2 mLr55
'!$@!?KżiL#]nMb !6/r* .啸37){y% 7
G돇i+Sc+3[()i53;I_iф1c&FrL? c;eϝ9YΤ8֬bvuN9b IK̋[x5#n<9
a!D$2u*6-PFVu
%2!ySAKs' )$v٤y
'-d\_t?O*Z¸S7"vqQD=E4\̥ f{#0R~,\1A֖NcI $7ܴۘ]NҖєHBBc| FqBEߘ{ȯ%J"˟Ks]:(/9 _g/eިw{ M^^I)*h*3bo:ј8_:BMW 'XYhlf9½]\1;m '%ؘwPyi_ɪEO nc7}tPqZͪ[Qv;c>.N'wK/t)F-ow;9wi酜6o`$\ßZ)imȷ^<8Vrɉھb;ظ9~0 IDATh M9͵ZpQq7,W ϨsTc][m|aX xӎ=Gg!dL)&`]=.ԝ5l|GF)LJyy AYyK߾[IYJJkoM|qԟ?7g*`7>eϪYXlg1>nʾ٘ݝ4Ld9G KY6 zi+ʩ[uOc2-'pt4Qu0xQ7MsSa^fpwcUOIm}Kkzyݓƽwik>>ԫnb m+<)W~G{1=,,,wH}0㛐H~&""_b^_OۻsY]q ߏy?.Dr,13XJaE#PRI; x,3;Kuw1\kzps1Vx$?Fw̝b܈6+貆2/ o4B ʜGw 3y GaiT8Ȅb &uDkZ}oiMV] l6ݻq(8}4R[8~w'{XHytb.Ch~&"طCSE!4U[F-"""ӽjxYDDDDDD""""""" `""29~ """
gy!""""Ci*EDDDDDD{{l I䢕>1ZFBl?W;{8㹊M*E
QRV6Kc .}x2#
]1'k73+@ggo12CA$/aՂ puةO]lXDpjnA,x,nQlL%E=|*.+L ^ \5 $լ^A|*Γtnۃ c , ˈ!v iZ7Û\_9I 줹:>΅A <>zlnh5~;cyyZ&q_䫯2M,+xU>d>} zjn$`]4P=hgnōZsn4__Gyi-u((eg80KRZ )xK%.< WfMwl^~Oy= `b Go~4&,V_y˩:'fur#TҸ2+ݗ')ZwNWYdr:gVT)Gupq%""2p bȂQU]C@@ +,0 9BwH0B5'ԛ`x(_id(˟/xI_uq~>&}7f3Y(=b־B[m> HWos _OWM _;wugr<%]2X m_pClϳr8 .
Y fLb+Է:6Z;~0Ya 꿒I/g'p>e=뇿હH"ݔ6JnVWG10 tz~@c oӛ*""rp חYӧ ?KυKTVU-#"՜pV{WL#y Kx4QNW ( z+)v,Yf(KD 1zΕk &Hyy9QŴmMԺ' +-,q߱hk"
ncm=
0okz 39U4'^1Esr>ޏp֔u߯ zi)9';nե] 9Uɼ- =Q;x]Gye>0+1^x"j p+̹gy,I^7xӛj,L"""GL(]]]\ǜYlٸ@:wn-Y"7oܺe`8
:q
ooK1>f00\8T?ʺcm{f` .;g>O
LM!u^YaOf$ʣE m.'=-4w/].&&ښOT4: ( 8: &C'vT g<3ƒX;ݦYD&3ϓ80 5̖ܬJ×~fgCuw&&
Ł%H Tӛer٫u, 5%aW]u949 +p鬪 t3.okq,"#=tm{y7#KsUN_1fouu [Ĕ c &[;ܭyYY2zGDDd,~#"r9N ?Ass˘Kff@9/S[Wwb5;D+ySyNfXBR3}zP] =Honv"D&3o~*!ЙɋҴhB㘱zKj9yt W 4wBbhغqD q+S !"& ViQ>ܴ=ʃo&?`x ٬Y>HB'2pvwɡNΥ{f֗6DEM/="|vqp \8 /Ǖ+"2! 8ε67=\V5د]&g!sSRV s\NqZ2\ǛerPqZͪ[Qv;@7?d[V>}Vh)ws:(;-9ӥ <ﴯdբxm} tXSJޱ1\
:oZ&?o Áƚ#$І ə&7 x?£ caM
gGy')jO/%Gs=IzX+=^[DD&cU1%
L5}55tvw0X.]z#ꊳLUU$ayp8( SEDDDDQ,"Bss˸e]z8*EDDDDDDƮ%m~A'xǨ m:^{.N2G5MN?ЃwO:`$/%s78Xwˤ-[̼"l8;T_Sȸ?l_jkn~cI^_ljyϥg@<# ?ټWOޕ\EDD5"PYɁڇݰX^dx/\yKäĹY$/>_"xjqo Oy
vfm䅅J &Φ1P0²xMur(wy|67
NE+}cεl/vpt]co{s T8Cх l E3Ƽi=\(eF8bɼO4sn gV<&'b nǛe6u%O&%2 t;ME0crf'o^[}9RWQ,Wzu8_ZfSϟşؾ>Y<CP>ӴD V- !WduL"լ^A|*Γ ]}YGFJ柰%GW
~&W<7 l =67v
P_<-vWp&* 2 @v >XF =]$`]4P=hnčZsn4__Gyi-u((eg80KRZ )xK%.< ?fMwx~%^ 1O/axDDDg ""<_'hn~
~i (rjnW[̹:fgh:s*KH
0 _b`^ԀOo͚I$4x)I whoNWmbiZ4qXQGO5۬Hdh( ̛Jt]ȉ:V<͓ BDL"SbӢ}pxW:hi$ ! 0˛~'v.5\GN&&*oﾣ|Oꪮ !@H!Pd#ٖ4#ϳGsfyͽ5{3y3IʒV5Q Mlcuyt):tU]:C,zTG;8uj[SLn"L w ˄FES?Kg1q8,gii"g7uspd} · ߿=JˁMl3N>jI&]]3r7r`ۼ ؿUL.`νf$\WחJa"ď j-aY?Ur|>nYNR G`oV9̫0uٹ.Q^Ko19q%;7˨gիko`_gA:J^Fe:$*װ껙Mm}""ry0fϙT"Wh V~8uuϾ3uZRUqDDDDb7kY8%qʇpk+JQUEDDDDz,"ֶ~,""""2PZ LDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$g ED)GKVDDD2
9qoLbt{%] Ұ x+GG00i>0M3EDDDE
,u>hOec]DO+&xѧ5ߣB7CDDDDST@?믿֧l%B!(lygVג iY 2|932$I87|̇rs7c,enhW֊}) cu͝v&$oK1qN 'f +~sȂ:F LSﱈWiH IDAT2>=pbTnjo>M PiMJ; ߺ """","T4_c
W|kw3 9܄o[3[ IMzElL)w-+yeku .`%f/MNS]L9e?7<z9vM_c< NbS+([&y/U0=zwȀLDDDDGYDιgv{--Kbyg_{)zV^^({,7ͥ?(?'mqTǑߖṈ~uy1,k;pK ><,$д-rR۫;MYDh4ҥKyGudY˜~E:%@spR6~YW5QJ;^Rɡῧq7 _JElyEښRrLMM%Y nn -% K x,"EVE * 921j !00Z>3n }zI¾Gs[Cե,"\Vŋ {p0랛./ blaKU0vL.k{ Q6ԧf0j`}8vp{\th#@^
O 1ln!=aC u6(/;xʪq>!"""r%7""4l).)?%E\ 8)nfv/8a)ˎ
a(=|[ #)
_\XTQKfͿS)ɡl Ӧ"` D8|(Hĩ2pS
{3.{cə|"l(U6>GǤ}vOgoik
8 | ^b
k]-حcĶ}q<3~@`Qb[;Eg3 scHT?Mg pO < 8}koŝftDCe4_cO0\u)QC57hn,o` 0Y!-gyx;k>ֶEX< c0g `!zO1'Ir /;\϶h,߽f^JވpTwvu|vDW)LwTRF&h_> kY31{i[垑طW㦊<,5 nu|n[Zhz zYUE*'_]'чֈH?QC y sO;FQ3_ok n|W?v u}亞e}Z7vl ג< C|Sv_(w"~kg0Nc c7d,M=HH}Ezgqg|9?ѲPhfFWIܡԆ|ϓhT'
D?)(w;G
h|m:.^%2_^M }ubwQ6֓UXoz=5XH;qO%ao] $~lh
nM/]VK.G %g-c {mlNm_s_J'e71(5&F0sK
i LBMLoݹK2~ jg[q§7t$ K xV~)ŎF>?ioH$pfw CYDDDo g ;M#DC_H!єXp ~H]#pj4uih-flñ[;˜eb&bY}qj7uHO'Ͻ&#.
l~ ¡] "D}?}U7wmKutˡ.u0SYmNgtsrfAq8>g <9ܻ~fu?Dʺ<+ˢEh
Y^9 g72pm 0k7ϰL{ Bm ۻ!N63z[}Y^UCl;78k4 \fԧAQ0zk+5r3X6o<}b`h]dgv[/> mC}؛8J"^4 ϐk>HxSziKZVŋ =_2p\ :R ˚ޯo67Аư^veQ^'vHS 0ch#"A㉝8vp{\t~l y96>+3XK}jF uEDDDDrf;.}:D,ÙrQ3)`adhNdz *,WQ fᓫcᎺ
GrV3 >F!_8\CDw!t=kM>~xga`+dذM~dO#o <*l4rF;/?\h ͆G~A
ɴ1 f=|[ #)
_\XTQz/^6n1f"f."'I1g:"A$wTFf`)6>~
Ragr
rr((ô\ @ #ΎByO4CZ79S $"v7cˡ#m
!Jb%"B&:F ~p]#x.0L}=ߤpȎ?G45d v۾G)|Gp_m<]wj!Q[cmxo (|;mP'vT rUG\cXӀ/'g9듞^Gh! ;,Q|=^c5U][ w;0{C ^5di`}؋Ȼa&Gw0rfN:܀q
&Vx|xfwy6vD
\Z ; NBmzml`in<wb{ )~#sWq/߹ as]$g^myMuլ}}kζ0WZ >znON4o:v
Na"ď j-aVoޣ^|ݲ"An_> GDDDDz>H#_%q3B|?Z
+F]5W?( {x U֟ј|ԟP`ŏ~ɱQ7`4fgVу%L|i7nOrZw?G!;}b9*_!y_yڛH z2CzZ+? !ScwA.;g?3=W}rkOh?J`SCTvb;cEEbQpx4о49{q 8FN v+v_в03W/Kv칓pe-g$ϱ6x>Jۋ]5 h|9dyۭ#|/_uv``{6}+Nmnl:eNfl:{gԶ^ CDDDDz͘=gMaW݅ne9 Syυn%+j%+;SNDDDD.>p"o6@㘶bÁ?KaQ
}*>>@ b zbI&S$I▅il6la4[b q'H_\, 48<},)НM*"z\V}|gW IDOS2MHNJ
4)"""""bH*4&Hc}f#Td2ͧ> ,Ϯ-8t:i
{=%LL%gyq: \DDDDd]ӳ{>+ѠrP$ɲ t:)戈 8{^~ZÑ^eYQA jױaF"
GDcq,"""""0'6"Kycm+ɥOyDX݆}Y>>.mGbhyoiٲ,v
rQp+gڔL IP[kY≠: (aEkyj- & VdӬj[r!g a@ ɳ BV|=?0@]%/
N"vB`3+*p a͚J fϾ̬`ŪI$x=.< U%""""W{ dXI9LQ~5U3 &10kc+4DzN d)L| ̮#(9"ebT}㙘M'}YY$ΰj[ii5V ]^i%_$LRp˟Y7lgǺ* &bs8 /gMtΆ'L"r.^n*{7f[U' >9fN䌹 Ii~6 ذf=S'ubzj>M`ƨ|v* s
/eW$ۉonz>\wЩ7r#(;IEٿu-1]%W9G'ٻt3njq̙P̦:\c ֲ1ʲړWe؛}N围GfyU :Cq |{8!8ꫧmz ORx<3.""""r0Ԏ ]pjV
Ɲ%6|Ënbkױ%G6QDy |.V5\ cprdaaok
0b̿3M۫8~k P+* sjY;8(y7_:Ŏ5 6_>e&t^Ƕw ]4m?*|ɏ{GMdT?6&hs)X%LBᲥ
c,Jk:W>_oau gb ?J hUm݁icz UUuLn K\lY
SΑ
BqJYcX RaV\ecO %4̶4i e'8͘ScOk% wZ^ =Sr8#V>Nsڃlq3}=Mh8 4noӥ3nP#hA G1y郛汭|4n͵_52[90;ӌ8Ɛ=fjv sPvy~ Ol>(O,F/eWDnƔs;GvMPLۓ8|nlS- IDATD"=u[nl.t{l!ˀ%n8=b<0i*\" uYX,po*EM^M`\ s8=]f \
鴉v|ݷʵk3kHx"A AQq6 _lVX0, 1|jbl8f,
Ǎq34.P iZ<ʬf3
Yq`$A6w$V/͗pB )rRsraNd|`7[ھЊ""""rel<;0ꛦr
a`3 ͵,+A 77j,l<{>]è~7mpcG1LW>bOd.Æm{3iwnR]!6oorsz-ۏEGYšG 䳭|b!|~OUr[ /װRYUK) fvm)'h]ܙA> ` Ǻt@o9Eh_oMR ΑhG,A/ { ?Yr:hnG[DDDD䒕n㕷LRƌJ8m0ԱzG#uE]ғxlrF[
8˓^>c_\wa j']6>rFXC[?g_IE kKQa)$nƊ;wR{ :_۴7b3m^X[s)| V {?ՀBIQ!T/f0 3})، % qOaL&i
fx}Rw1v[v xnZ>y|2z UWu
D1r~\NgʸNr~u
3Mr{9]vLF9(v=ӡ> DϮ-8Cs]C#.@Ǎnq͆nqrکkhH\t[d<\v1rxho
|4p(ep8yD}U}|gW^UL< 7, N
A:"6iljDz^\L3z<9:t2&&c ,e$e
GǰmƃtϮYp4y{q1lvlgߨW+ወfcej ð+?{I}<П])8AŶ,sO}|nf
EDDDDDD2Pp@YDDDDDD$g EDDDDDD2Pp@YDDDDDD$ @H IDATxwxj B!zތセ ؎q_ܛ$Mq/q;`LwP,BB|^ϳϣ={339s ?%K~pb( 40,.stro^7S@5GGGO\v }*+òn+HW3MӴϟ쬜f|9''gPj ~S :re]fna~`5#G!''g8r!ѵ5]Fn6;_y%K<~,r\.~UURP"""""""W0N5RNz.GwHDDDDDDJc:;`"""""""2
փEDDDDDDZ`y,sEDDDDDDZxg72įx?dȽw7DqLQ^_;SɯrA,ncz/DƸ\1 pKy7^@""-\>ŏya`ڜcȤ|)qvzKX_?9?_600LN@B#{3xTn~͎9S̚ej1R8C Y efAZ}6e cЄ!J"v_ ղϏm.|>ΫOge^ye+4[>Wht mz.+=rai⪩47A-Ik8 AnvQ]QLvE1)ٴq_cݑSv2?}., {egs&ۏ1Ɓm8|wq&X,
q9ټ9I-{,_fc(tVx< ~?0s͙g-'?Pܡ
EDÿ_<'unلGN敆ᵃ?ԢxG*e>qL! oúP] '[ »{Xɰ_O wyw!R
1bڍw5ğ;^g)am}3 u Ňx@>̿^zE6F~r~{ؚG,OYMa6n-%kỼ054n.=Or[m{]8]aɷxo5߾Cj[ɛio}+hW~ 䩻Ƴ+2*LzfyɟFjOsf1Ǟ_>{{nD|!m;tdz˨ EyфiLHb&,3.W Uk^{zzuVDDY L ~v NwK'#/q
rϗ;go s2.l]ӆKPx",~ʟǙ$ofS/a~ G&Rq;>'r5ɬy+ -ɝ'O?͛;O\Vӄ'};kO`awC<6?> +a,7'MX-O([ QqQdok M.?v5^nmHBL_S*uo/bUg*u+:]6O^' ?"[{H?rBG"F^#_ɰ~ W|1)dWIH {4&d 3g
zs=6[yi;Fŝ عt3a ,p8 s/wͼ3,/P qe^;t3w.+ x}~Z UMa^>|s .> )*²:y7{-0M۶mu.e[Y{-w]I2},ib j[*3ydUS?[xo0-9Cr^zוj4ϛ5S&ٗ;ozo^{:\)l[8
,ݳNðA,+#ѱ0NRh]\Upg|y;*_&K cy;;o qjX?B
8NVPq46ӗl$"K]XfS' lɖ8Wr?$xߏʢJ*73)|M67n.P 'm0gϚ10Lo a4f*7]?
a|'~ o<8Lxp揙ߦHa|ʿ Mdyx\@s}ۯŢǾEm6&}q͗n4Gp55;Nxώ呛L~P v2C0y)vXIj ?g-w0ڞ""r1M?ojvOseE3^usgSTKG~ߍ鿂\^V9kZT
$VkVeE?~zZ/N"""CCEDD.UEE<8 4x^ )1 w'Q6{# X'g($H_s=Ip ITEduxz/bDDD:qAKiO'&""""""rYDDDDDDuYDDDDDD
zB8AH49HX
EDDDDDDZ"""""""mg2\hU.H"""""""mP,"""""""""""""mP,""""""{wrn /CIDDDDDD/ޱ ed5.3 بv;nR*""""""=Eg{m{rlWb^z%nO)˲(*)@`"""""" p8_aۡ! ?۷wJ~qaԿ7M."""""Wm|͘>ӧYWbKp` !U 8z}&ߏ(1K^ (>scՕԷ|ڌN
"O#>6 jjJt '>;+}V}OM]:Rh/R;_︒Ӎǃ=ndΐhl~%r=忉~NBC(.4wr[OȽWA\d2a-+=n UZ3v6|`
۫)j_F8 gN= pueT7ٳ0(0?rs9u5OWm]q z 3@6Jpz ں:l6JKEU5n1MgS," >~c9/P{A
!s?y59̆k9,K eJ229z)Oxo ]q 8~) ʡg魯 ?,m_g;2\pQ߂! O.:[
3n3F'dUÉX'j LBOea 橦4/͟zrKyi ߟ Z3eF2 bb:vۇ2_y}_HSvFܷF0*rrup"}ǧ_5Kb1{t5IrA
P"{'AE[=B $[1R+n(hW%80А`jjkq|>FEPrN]mv1b0MIx nOfw"ʠC֢sCo 7Ծǟ%WGoz |R4Ma6x
'G
Vt JZ붺 lXo
6#:8@{5YVc
5 4go?vw%'Y
T9>ۻm~ g3g Bx* 8֜Hn[+'IC |0?e˱<2SO4$hm?{Eam Gۢp #< 5]q7 M9.(ߐj{sL_&VCٺ~c [?'3?}ǻii\^гp80M@++teރf:cB srSS/w.dD2ᇘ mRmQ*Qsjm94 2ޏ/c^
|9DX`Ui >0ڏ#fWZ}Jʶyx?ޟ{) $V,
@eEmd!vߗw66AQ:̝ !N"=Q (?K95 :Q$ׇywsB}2 mčύwމlL%6h $^SO_" B)HN>\XnN|7>?#/Hk6j ?>,
MKsW+<1i.$tD▾3b0;T@_<ky,pͺˋ& -ߐ ysL_ rq?=~1(xi+?->\XW Ը,ʪO??"z6~V^^ѩAs}/7` ? ] {<}][AQV
g˩/\I?ƽ6i?<"*a=LoS㏳ѣ;w"C aU~I*yT6YEE{S[,ɫwW&c+y&" K|hnֿɫ3ii0wf:& -_\/J Wspp0.W 4nwPZTFhlnR>KbͿ,$ : g<f(Ç=&O:&,bGXNͱ5ŌF#r:xr:GOƁ#abMH_ 't6^d67i3$UIaIvoZǎԊ > DDzJ䇦0s[-Xؿ(
F("}xSCk"1NaaY)%=~!l+,n^ufdoIn;gh6f^C_>v a/#4t]D LbG 'o
(Fgk[!75ڱ $D'Y2oob+qf ]ET>m4~
uҹD[s#O!;د/S櫬Jk!E\nsm J$/yسu#f?S'3x{ >0s_l67/|.|tx
Yf ~~͆j8 u:
^6k;߯r?.ZV2k - 3ϝMrtM
j x;Uɉ')$XuefdIAe g|v0~vl gТkG/ܗ>|*]d}61^Yi<䧥I΄P
Zjks F0a!m zX-_ 0.s;|+.>{oǰ䉑x a)3f;s12S 0;X*G_=x&87icao1/=6B3) ì5^XA/?%&3nH져i+s rܟqK ${c~_r#uFNg':9ʏX|ݽ|oz-Eܾ#gt\dnxW+f1g<j)Is0É={7qd4n$F^㨶ەӘ>z stgCŌѳ ( Ч| Z
֮8ȢYw5TVsz.L\I6g<& EUior80/ik9XT?ϴ\,K;wob}FS ++Ō+co
R ?|4W\CYL19]Tח|kV;fϢ,ߓQcY4% Ik.?6n[B>D@9̨Q lqd&e#H VKuOZȻtzOa7JH!ooi%%[5,?`;|Nv sa^줋.2ֽs3NUQHƁ5mGĩDƎɨY;ں]6ܧ|x G-E@{Ӆ.h,w!]VCޥ ;K+FxX( Z
q8 vA[zQPXxQA3mC} ;~&?$j[ey/9^ GdL@
GVn1Zs->I'n*`Kϲ*](M ƨ9[c K<҅*J
|ߞ*/~K^WO0d`R32"]q =q!ɡƻ$NzGGs..զY䯫zӒ9 W ?-f_V_]p` ! b&!
z>ҲNYW<_;ZV^uQA31pi21U.j 9ͮEҋAsf 99} GY.'<`0aCf&> M
\9Y{LZbyҳn EzVVJgqd@E"h>U?3fQUVVҥ Z,sZx0X\GI'S/gMdMKo,7g "TrċupP
W.`[pfꕔRRz+l g5'NBVrQW_M 2>*HQ9PǾ u dg4:#M7(9}gHc L_TTrWy`3F''ٽq S)ڴ0U w
]sY^ܙ&O g W l a#~^ }s ҃t=ҜqՕxHWi9?gΨ\zWaY0}x>Ewbl9:f !/ O S,""""""[n>Ӆk0̈A*s9iS;Jry/>T[Djt)pi}_ "@.HϤ g6(piC<3v;1Sԧ?@< 7*#w.|A !6;cb
A5ʷ|y掾Z|/""""""\
M '1z9ClIa־m}:1l> Fn._,p'2m&䋈Уc3vŇNyy]L+)}J3pgl;/O D^jؾf%/mȠ09oh *2+)_Rϳ>j. ĠV!hF yVc$7&4k*rlzT >bWƿ*l#pnͮx3?E_c
x_Tv
{xY~FǏvP $.!f_y$fߪy3*{c]7 IWquL&Lb[7s8(hzT l]SEuaVhґ'n|Uui+ K,;oAa@a2 M'
F vn$} +ѿ5k8iur /̣j..""""""rzT ʊd0~ň%|< V7:K ̝{0sٱ <wNf /q'1,&'kbX5 4շ0;a8t 8 ࢷx3~d%pgoݜ"V>Mϸ w a e^;BrG"~m}̯8EzI
uA|`7Ϲ}\ 8c)i#9nl?Q# &ѫ'/TW$ㆅXV ybrO/fBfX sYk
DDDDDD; 炃۩74=;"ߟAz'}3J1W>5n\fJ>>R7Io Y7%, gPFGzW< ɪŨaXO_,7.@^""""""rzT P}3'6.3
&q,˟:6 ]mGeWOǏ su~^6/ͼLe
Oo,|W^[ϳk)-+d-l;IDDDDDD:4tfzj|Ro|Pey/#TvSDL
b86gdߟww!:"IA N75u6"XyuwD8Z N.Hc{EYDDDDczԬ""-
Hb'%Ŵ>=#|dWhDDDDM=nr0i 2sŇY>
[[sG8f?{) |9u9K/~ ̓
Z_ `GO: =]^DDD6
EK Ză`缽;G0Y 1l/k!Gf㓆@ތ7?⸧ 'S ?@)+^@BK "ȉY[Lu|8 ɔ(_s,iky,ƞW2nȶYi{ Spb"a>xem=_^DDD,"]ƌL")#[HySlcʭwrϢJ* ϏWxj 8F,}La x2ٲn?5F2l*7i{vR89^1D;+=ailp27x*ظ$w{3Ry6Z#ARqcQwJx.GݻZ{uh--ȘB| <5dd*p+zEXUTћ@?Z@kK)i2SZBH 5M\76l^F 5֞[.+
PYYɹN^;Cg0v đ^
3 ujաw'>̚p3_)W)v[ņ2uP,"]ȓ̩k2,Y-VE9>Bd̠
+;'t*+tFT/`M1m:ljhOH7&뼟R PL2 gcBsmIʈ l=
\~T** $,աۗʴaϽl&V;uh^ W
5-,"""W8H*? /1Sgp[.!n6d˦w?gl X[ >ہy<9l|o7^ϣ 0Љ\+I\|F5%N(|=:ʨ'5-O ݺ/טR>8\$|}drET>ۮC;mo8z1dBF`MMQ{>m+1}֜1 PD.IeY A!]+22ԽyYEDDPm*$/gT ?N.NCE``ނa:9
EDDPmjtjAH8AH8AH gJ"H'(.H g6YD*RYVEA! gJۏ]ҏ\
EDDjt-"""""""""""""mP,"""""""""""""mP,"""""""""""""mP,"""""""""""""mP,"""""""""""""mwwDD2wADDDZ\n atʺ|oA_^|tuDDDhr0"6m4ڗ}'m̤ܯp<'7Qٍ%+Խ.2N)"""Ҍ.H @& 椬m咞Ep(Kgô9/"8H s crho9 ΤQ u fOh4IlY=2^عs6ndu =<w1)rlx : /l-j~jO˒i1\7;i.s 6ā4cWَ ZY <ʔl6G2up4jU(
Ƀ רa6\ˁ-c-c37BNl1څ GcѮ :\̈d
N?eNI|W98w~|Gd*6}t^ c/T㝽OO/DGEw--lepCh.>OgțKG7Ƶϯ'ވNfZk8IϳnWvʍc[tuAܼez-:ð 'm `+y 뾻k*Qk+83׀l;XDMř#K 3pmGKRvR:)rH}ZTUicފ9?o ܥ2E͞NL6PTǁ
EܿC5xDb, bsO.W_}' q9A[o xPXSp9yhYDF_K1JVj^&WZ1k֛L챉-1=nfQYĊrSI{8}GZu=[R|,)#ƀ>-{̤Տ3.;jbfe% ff V;zq&WY4jiX+dcЂ1>wUç>[/on ɧ>UjFH ~1L=@߽-iɎZ.]ks-1D[-U=7XFQhRWw{9<&m~ ؠe"""SpgSru/@"ehveA;^?G2q'0; tTV SYZ& 67_DzzX {bϰKE5v{ ]>=RC^vrMl&Q utO.V\&Rm .p1|}%f]-$&Mqm#Znm$Ғ{,%j #nG #_Lo
5r'h<2&U㗩HJ#5[>_|~.]<5V;X XK(*`YgBE MMQKyaTRHJ"oJ/ ۑHdՋH;>;W7232dm >}ӧO@5Que#k{DT^}ʓZET&2gx/xrH0ُc m8)7pZ L_RkAU|{: Rm3AkIjڱ/%+#MjJ8W ^R/>gzS([Xo狤㿁F/ Dt U^rV.~ < M\X?/?dyI?-u\=qKnCLVVsr+^fV[9uzm?)8,""""""84q:GNVAYDDDDDDF\KK+ё8 # ё]-A_G%""#bfGjjjHOK#&&aHeL˅aH,""L_E%"""YܼysT6lvF&8ݎ XٙGa`6lmg%wlChDDDDDDDBPp AYDDDDDD$gEDDDDDDBPp AYDDDDDD$} I9`ӟcf W|ޔfEDdEDDd Eƀ툈uȘq|Ӵ65
""2";ǻ """
a=]CwIh"VqspCj=, 3wqZ bē&Ves EDD䞄Gn"&FuUpW*Q_[](;_̊c|yv L[րl;XDMř#K 3pmGKRvR:)Hx/`S]t'}L#gPXڛ*[Mi9J:⥪MSk6 {禷g {f+/,#~{ȬTڎį~6\uO Nc# %:l a; gvUok_gu8ȨOy * Yj1c3 Q=өIӵmrrk^j%UK{Z!3< 2"IYܫMSF
}
cy/ql!"r.S tǂ&^99dTw>VV@řT=l |W[3HS9f틈<̺i {9PSUI0X5 gUf~&3GCk c*_]ˤ v\K2{ݷz(eefpaaVw8 C(w^|de;m
{+q|{@~ |֮\ȴeN MqcܾAZ v ?@Y1k_DDDnw v7G
"2&ܵ4ʒF2j92վ'4R y/ebzk ,&gzuĴf
\( 4T^TN :Β7 fM`﵊ye$\C5m yߌEDD `gf#HȠJ?3qa5{v$=='`Ddt"x'jxz#/,JjB IiY-Z]/|
DfN!+> )7[Z>k Ē EDD$dof@fЌ"4
k_'4q1.M|jt(@-_FB{u5(<5lr>
6 ?Abofut`\!.AMOL=`D%̓%9\52mܹ ˘ϲf
jmL\U ~ #ө wim"""2(q [kn|CPobǭ<5 Dc]6d'.&BpƜM91%:i.U:H7lbՄ5Ǥ_;#,""rץ=o*
imj *j8!" p?D[덓|wm_w0c:V$&ʁ|znLyl0!Iw+'};/
N f
{6jH(
"2jV^M\\ } 9**M^u{hFdn[yg]u% \hJ!W0wnJK"hD6s|v~|̝[ZN'Nlew)\ /lڄ 1՟NO1^_4n՜Fˏ;>"VqsgcE(_z -3<5sb
͝FXW9L7K((i]_^݂32(ٻC%USgi,^8yl;XDMř#K 3pmGKRvR:sERzyCi_DDDDJ3"2jZZZٴU6mz ;v~zfr5z qE`R|u&'¶hL!P1%JCϞSIy8[cڪ)D&Wn >W-= kp Z02Ȉ'?gqzʈ1a틈P)8ȨxAfB_Vr͉RE sUyO&=뷺 aaVw8 A?I #Rh֏Y[
"2UٽgBs(1!r6Y͗-0p ̺Zj 41]sF"YY1tq`zk ,&gzupomtN8ȘhiieC
FX,idwzڧ.G'xʡYn-V\٩'f0kzHqq̵_Vd<N%5!,d!59h"#plfEe\?XvcVyS<^ȥ,Mtsb0&NW c
_KVF4Քp8T3Pup 5/gD]5
5a}lXk?~0>} Ȁ';&obǭxZ-""""""H
"""""""!(8,""""""H
"""""""!(8,""""""H
"""""""!(8,""""""H
"""""""!(8,"""""" g@w4^?Y5!D G9}|g~$Fg5x뷇pY#юI]ymMHuokVx/cyߴ.{8^`+= q8n5fc5Pqvwk / yyn<$GOvrN |)8CFdn[yg]u% \hJ!W0wnJKXD6s|v~|̝[ZN'Nlew)\ /lڄ 1՟NO1^_4n՜Fˏ;>"VqsC"""p=SDb,[ң|Utxs`Ԍm)(s7wa]%r0,v͊c|yv \ ˏdvR_WM vx `U 7gp.9 -SK#\lJe"9<(];8^WOuAv15?8c(`13q Jj|Vpj!Jcg0+?3w#=Ⱥ lq*.ګvԅ
bXbMTVnl筦
AX-^4_DDD jq8[[빝e,.A[ g\v H+KYlr"(l&o So4=]y;SIy8[cڪ)D&Wn >W-= kp Z02Ȉ'?gqzʈ1ad1 OϪULt X휏9|8epuY4UUQ駥'qiSC߭Ae;wя:OpM? Z b::g.E '|| 0
r|O._/hil *6~ʋ{}/EOn?7<EDDDd`"""""""!(8,""""""H
"""""""!(8,""""""H
"""""""!(8 Kƥ]gy Uܨ.21sRmEDDDDDDBPp A8Ȩ4-g^/:=>gyؙ u(:ž#I5D ]*|J0gI|a5h:g~S!/ :Gu{ [
~퉜 u~ł%=(;zn^رd-wEgS9 9g~e=vY/ןr}5 7,̎6]e|} obCl7;X>N+=Gy?Qk}-
Tj.O_zO5E9}:]-rbV.fBz*%ïPDDDƜ *MUe-3)]Os."ǗLk1n}r""5Πv߄~>^/Ggɤۋ(y̆Zn+KT8ټ JxESqv \-\DDDA,"9@ 6;vZ+3K9͚m7|fNuR} z8u& Av%.tO=>|l%ǽfZfx&r{ }a S3- #PA`QsXMI^F?Wf+- ZI$۸آǪ^e\~MZr Z+9 eÜ=>̓^kxσE˅w\_m וa V YSWxMq4|wB:L|
"""}yBr_EsG"vBKm8u55qL퐯YuGٸ:v Qp< _]c% ] Kexa M |O5>&zN^ylkx7OїWhG> Fg z5Xz-o'"""wӌ};L&F|mw( y/KznzGh3}HN(5lL@]bu T٬{b.|&H vW ~}$r5^noxNk0\܌PMyQpSWHJ5hHuh p+nԃ,"[aj;s.` 7־
Rt4eo?lRW߆#3[ շdhH]+/g #V=Nغ'])#p8hce]w\P>MZEDDgC '5lxcT Kbeskߕ[wͪ;|6 /uk`Sb q`3$ 3 s`vt3\]owXbHIM%gڨw7{gpY7}2 7lEđ:i _svW/R"7 l)v`5n97˃,"2̆B>C#.&X RͲqY*B{Y8ȨE78(zPo֓fEDDDDDDBPp AYDDDDDD$],")3ǻ """"
,"~phH
"""""""!(8,""""""H
"""""""!(8,""""""H
"""""""!(8,""""""H
"""""""!8ƻ"""t0!=ȈH c{#"""eY 1kWYDD ziEiy #+"""# !>T߸9fj<"#v*4<, VEDgf1^)8kEDD ?e f87X4^?Y5a ^ ØgGlg݁u81¢0⒱[2e7f|'x
gO>w-"".8N?;#1
op1W?PokVx/cAC3+/ ke}ȃ_m 컟wzhkӞx | t ;?E8o]}`=-Lj|4 - s.ڇT1~d
+\kd踍,#ʛ`<Ǻ97.UOj&*Whr$1kV̛LRES{pY[4^1{vq6e3҉qqw=wcަaCyWu}G} pG1UZÄx'M'oڳݜpeiNѮ}<^,@s{ؾ=M#! f4&/րeb ~E6OLs 2*lK1q?kK~Nj]c~[tlryޞn%Ӈ}m$- #J*?E}Wp`5AlaqLeƔN]#H k\j G$1-/i(kuL P8 Udw1 üg> 9.I 1N8?Eff_t+=\n|::9&W>BAq1K?YAYpj? VBֿuՕ|p'{f6ۻxd.|6mx]tC01۷g^䅼{3(+>k d.Y {Ddx6[xH(;NL+ (nןc%6w!WW} ݑ/}Ʈ_ϩ{=F=gK~,wNQ1sAh5ff v2'M >:8 =6: -wƐf>봑Fshw$%@oRy+G}Ecu5͉cP}T AJs\jRUi$bShn@\^YtϓZQqs4,:0>}{ň"!!֚~i K˥@>ouJM\Gz8?}Yq;u X>#)5!ݖx4 yi ۄ7[$I ۫ixhL&HMp5i.:גI#rY.[L˴:.:D^Ta3L`\]0"HjkٳRGq03- Á^KwL/:mq$ƴPWNjͤ$J8WTO;NB1- Ә3%xB 7#lu3i3v+@ 1 +h'e5fZ=0
Y
yDDzĘV_F oz -^Z'$P l&^ǬW;F, ?=
q kOVd(=wGw(
c_hϤzp ?.zs|N>5JGƬc v0Ġ+rJ)(R1gժJ&:̎ vG< $ 3|8bH]ªU/{,od 6gT0vZJ;mHjR?d^.6
xn밀FǰbHyz4'xjt^N ]e'evLz1][>mILAR`s 5.ܾvHdbkn[lOݭm[7qge%TΟ?n)QZou\NgAr vgj<]OmM=S%}v TeC?VB}Kj05@8./LRv`K&r5ܽqw->EX(ihov }ꧽ> hl?Ϝ&"2oYZZ3(5>EbV ;
i2}4~c9<2'esO֚kYfᖻ: ìf[p e=6[mvlpǛݑH Xz t}A vk̆{a
vܠ˙lrMaڜ5|o2oy1կeRQJmc;A[.z%^pNxGB{om3PK͍)?%y .?CPuw6@B=`#ĸHMlJKX
# тG7 8
ec*qe61q;IL5.]3Oa´L0AAtB >og88-});1铘 O 4p*G #ea5۱aqWwEG# gS
uBlj+T:.wp w r@"1` RLEіLɒ,ٲXk{wouj}v {m˲mS$J̙b 0 @0T%b3uO}];IQZσ!۶?116|NfkʒHNAIGC
4v{_=1\nq40-\ùh&G ߟȑCqn5NT8ȄbRW[!Qf=ϕl\M#(n,e)Gj9`;E6"HL \j HP]Nd
0J;q @p{u ;3cDan^i` mFBm}ԛ}i9AO`T7 EQ=j{h*ɲ#7zs$i#!gpCs|O
1s 667ۥ֤(" Pv;4iZ1IOv@+ !t(IkuE ҧ9Enj=
oގ
W82|GABVܕ~ :HH!1, l\RąWmdiZ aqX58]r&k >^K܊xbbCMdUl\ś+z &4lZ K홳xJӛ~?^U|ŵLaQp]?sukҺ 'QPDYϮ IDATf4_ 7X2Bpbl͚I",8Eh7ainAZzT18 yt^_2J)v{EM8YƂLgrr& >Ś _*7 |GlB멻9܁auSf Ib|6 ObI}h~3-0lX>F&mۂc {k b}`` !,mϲ~a4ޜ 0_ڞH !EՊMG !:yu8HI ]װJDM V" ` frB{í/sݧ5Һ aT؆n -e^\uxj*$,m&zjC=n[/UХ&'k 0L']5\/n'*x6?4lK/6uvtkqowV fʉ D`H=[1BYXZ!k{=U{*G|"Ε҅O3}64^nI<({}|u~p
x0?\X[o~1m ǓLټާ bc,Bϓ0vn7Mq"%愻ۧ]ND.wo?osY]q _ F\_',u$szGf%tVeאՁ˄ kmWB{ ,h'Ժ}DKQOX؎>w I15`םeXi*y!c~ާ6Ѷݢqp %?)6S+Gk }>?'ㆾ`B -^ '1V f3O??rpJo uh [cJ]~nWمrYgO
D.w徢"__"nv:Tm=U[DDDDDD""3MMw'<(LNV,""bcQ,""21 +AIMIoي}4ꚻگ
gy8()a""""""" p@*EDDDDDDXDDD䁣 dn[ 1]ǟ9M ov%^wqh(HnE+=LDDD&R3w?SED`X,r(uݵDDDA @hx=="2A~;G,Y2mN*WirYc6g`"0fo_@] )f |p4Wr v( Xj\as?aq^Nd~R8>]TçhryZ-yN{-+א3;H|NW6
9?cMb\km`!|J ˙MJT 6gM567ڶȃ0qͽS,"9Ht+5o8xByJ=cgio1z6[f[Zkw>g! ۶Okq2} Ǎ3f~ ݺ#; /?z}ND_f}_leɖگDDDn'zR 5UwWR^Dk&/ٕk?ϙB)qX[/ 3Hյl;̔쩄U|j2sVUrݹ8 gev}YFy$[=;~;ޛ2y(;r(Ɔ*r|XO 0f}yކF@!V*
ʨki^Es4~+`۩e\"""r߱lDONhna
+"264}.:;
,q߳hkB
\M gKm-m^[Ck`Noӑlj Ҵ"☱z#Kk8qrtwy MWP :;o]z=kXwXࢵ:/?šӼG]aL}yf`Mx#4І FL"1їK4Bã 3}ƲC"_-Mݳ };\~rS f3).a|%fz X{jU7mO&""""""w\i{ pZ9uø
9jxYDDDDDD""""""" gJHpC J(oobN"cI*ƾ1}߀}c8;QWG#P1֍u s ۗ-|'{k?[Xx$5 : pUEQi7 HN# % knNK S|;[Bh?.
k1] &RguFgyvF=xue-|5;+ {8|Vڂ C$}+>)9}H0qq}!J)~TdQ o7&_;lb iS+=D g%fV 3l*~| fm
'u*=ƷRt5> oS sK>wmnjfݺ~k$?/)RSR%) QIR\\{5$ )kil"wg eB-]&8{#o\laƧKvzs yJ\o_,˕=9YbrC,'o +X {sHN~,^qF dۉfdO% 3Y(=[qFj8u^8ws沃9`6c6S:.swڀn;1$=-2U~Wp Φk 8QITl .
j[h/ce05vVOő<*v xĤIiOg
hQ=MM5\=c1N B_s6+xNEr5.t{߮e'ٗ[{!1UPZLbb8>$$Rw AI 670G۾ ?&7Wr?31]|}{i%sk{1w/ywsj. 8A ?y3?S4Uqq!vߋ1Me .ɩ:Z?ʮ3ͤJ' xh^8e>con9&*9{KF70֝.+HJJbӟ5~~~Ђ,y_rk$ED3,"F{I15>o*$vq^BE C,%%]#bsY@YY+9 2A-unķ9ֻ 8
c̾xNV;qtVS^${-1D[9U/
JМ,q߳hG?hƹshV63.r9s&tq7}W{
/%#"rN߶&uu}h
DtAIo,V,NRgvލ-+ 6,QDYPo4&**XI;bh[J/]uL^LK3gte?D{ngp-8$&&&xNR\e?_u$`g Kwy7@Ќ<̑ꑎihkllc\tu^fx;gk㬥,9n?;E訦4 K_(Q)-j(!ȀֈXv.y\{
i AMM
aaa?r )w2q""2>YD& ⦕'k$b+?@ ,v-Si{Po ߾5'j3}v"'
hӼq20<n UŞuS܍2wV$g
Ȏꑟt Rӈ@p2Xۼ$Vn^ iG1um]8-l /pBbF}[\.%kzg0+jqq;߸B?spbrQ[VNOV[[x$1I ֜Qwb&e2uFjxLn;G~a`9 ߣ/&0_ 9to`ҍ,ZG`i=yptvtHJMvj+c"2q)*"j fSY\{li H|g/3η֤tg|Z\QLG$&?PK3ب~X5pjG4~\U8IM f.s`ayls\9QhLB.p.<&--bά5#ܸ8:01B <[p`G=Yhih[z]$[7 :i7=g6pR%35\rM5_[Lx01yDTQpa/8I*h68? ylYB Ӎ]{5~ǫo &r uC
(RÆ?jsF42c%6.:3ff0J:}1 "_UM
v#"͗M
;(p AYQ9,)(Xgfp3ō"vqB64-8fN.'aL }4:Z::r{z= " #k*f{^d+` _1w^ZV< Jdl"Sb㢸7+=`p܁dB ~6&7mus:x8%аX._Q9_; kv⠹Rޭ\;hve"9 ×K7 bꪠ.i㱗U 8˨ ʌI}7{ HL ˟2uϝCGFph,3V,cF9wpi,b1tpt=7>;"bȘu& ] ?Hⲍ@dH(qdg=}lVu@<=ɟʼ"ZuY+ 4 t3PGG;ݝǴnM j#-e"(MFUOc`lY'ê |.Un" <aX~> XXh~ob9̽\!;m j$ǯ%ȨwPq=j[ɪEO jܣ7}tP=\ͪ[a6;c>.JO R|58qZ' 8sm(}4ΟZ)iuȷ\܀<8J/n5Bw>gݴ7RxkE\ް_~?Q:&wm×#c"c}O; \,"cJuMIX/Zv<<17[(+k8(-k{*(6 [AI͍;s|gFၱL"^(K6M?̱<=Eᾏٛ(3ΟQ})=ƷVCwMe\9y븮<ZƲśN
G{#u .tk6"_]MGDy}Ga@sC
je+WE[ gIgǛ~pe?`i݇8F^k3). Z|̯|O4ߥݍg/e0xc~l\{1=(,1,7IfW!AL Orr2%%?ۋ*5"ϤDhkjS&'p%/n\VWEdBQށHn%v Z((oFꢵ<R®_,G9.qU~q7/a GXwm5%z*s#[)hJʼ ?} s ٭ Jp"_aaXڤ"2!ܯEXI](9A=T] wsuZ}%կ|)ؿwo Ok}ylk0?/?T]3%W,<)_s МGbqiR
>Wdۡ"_-_eM;cTb {bCMDdTm{xYDDDDƕ9䱹L *EDDDdG?dч _ qd""cWB{ rU$%%QVVƲeˈjDdhAAAYD& ""CDdLmSZZ
@SSaaٱc._!4,\L8zW-""wCOO58 0 raZϗ_w{n\VWEDDDd0^!"24OFDDDDDD""""""" p@*EDDDDDD,vYf0#E9ZAB v;봚-+א3;H|N־39b͒iuRyn7 JJ 9W5{Iyh5d 惣D9 +}ws'G2b sH4:#VXlR9;hq~t94D fOzZLɎI8-/v`FɾJ 2 @vqg! ۶Okq2oecda Ws &:aC f}H؏pŊՀ;4er* Y y0=#4&J :US,|t9wg-]b+Ytu:0OXT8ȄbXxh|KK& Kc kkdn̚ L0K/s3dQ?yαLN&3o2gdQ͎ -jc#e|(;/P~ {>#" ̑ϋ8
dW`yiJ exA ~ƱBGߚ-&gO%I1= WQv^ F1!ʕ2Z@+* cY Jp]I o3OY/o%,Hke5MnaL!*^?̡r:gn\EDD4"22kt2'b9jˈbn|>i-,\Ks| %"hk==T9o,3%2X[ gODmLYlIE4
Ժ' +-,q߳hkB
nΣm=-u
0okz 29Y8^qr e-ޏP֔u? zh.>G;roեE >Y 9^3x]Gxwe?0+{,z s+}gx,I 7xӛj4'WۣYD&N_eN,6?8A9y([Eoqsz&+iگ}@!j#66 #> hF] Qq}Wgd\ M9/W;ML8ϝ#9q28 :k-Y}̕M`NV4j9(+4(&EY,3^Ec) j9`^iDLGe݀opSo]Mc k[m5ϻ1. ʮr*' Ȓ-) t7{Z P3 \,fEL9` I<`2=q\>pGC^ 6O/axDDDFcg;""/iko455
lfq|5)ln-ѳI 9d%$/W0/ۧ7 ֙Ǒ
$:f'FTB:j yA,M!,"74KFqAsS )$)?P"c`ōM#6ؓWK7z 8-lc S0qv4zS/n$"B{>)]'on\c-4Zg?l[}mr[!~qUDD^P,".$"1]Y:):<1 oBԕ<3@ljmo0ɌkșLI[M>'pako!jD/3ҫv82?Mb?a}7}x$#;h!E9ZAB v;봚DCY 0 ͕\= 'q? M?fs/juG~ on81rln=mi1n';&L_dY&*}|t=y@)&ttbԍivP]MՀλ7>kZ;)|]-e%5 ",=yXBEtpy[
)v1;i \EDD
"2%'&2}j& 8rdTN&2WwpML_N~ύ%H_U.7t=k3}h$(6ga Ws &:asH[,OM7h0 Olق Dc sm+.䅅=g>+m!yl$xggԳZ\6 _s&qɯ8pTlpc0Gچg +Vڮܗ˩2fupÔҘ2+ݗ'( ZW)GOYd^l{ߝ wOdy/VWQv^ gdQ͎ -Epc#e}+exA ~ƱBGߚ-&gO%I ;sc 2V<+}WR;9 lvRMU:S~ k "EYM/4LZkk0n[t PY9 f&<9~9W{EL(̚>̴4'X_DEe2"_ŹO:;+xL#9ZKD zN++z*(r,Yf0~y YX@aq.QmRϙ~U@YY+9 2Y.ZE8bmu-v? G/=V_H0ȥ՛|i 85e ю[uigOV0oe3G>^Wv̊ E+2`6qv zi9K"UDDP,"Jgg'<:\R4 !Ɔ-#M ̃T}W'd[i|L"5.Ajk4t fKl@ LcI뉓 _|#68cRE䚳snF 7'd2ɺM1 qu֑N2|̸̚^֍M4fPo`gX
Nٗmz;cVn~6u86S^taik~ On
.9}=6YƄ9ljhԪfŏ/ۀiO}Xuۥ=Y
]Bd_ef1fW \#e9pr_'z<{j DD䪗JPp$[gd{?_q>_OځQvO1mm9 ]/tc+ɲg0~x>پ,GOa\IS+z{_
-f/cΪ0U'LŘ 7EQV܇w41r,QJ~v6%=g,~ m/|{猡0O^Q).aEYq˱xD4; װ4}أ!=;b}Z5k9츑͓FPTPHĹxs{/8ujLi
ϟ FET Kg0Ɖ8Op4a8|7q
qWyw|7bEh>mGq˹2}٦[-grRl*ke,+,j+6[٢n*[g=9mG3ǟ/bl)K~'pS{q_"B[*o sҗmLNn_Ͼoe˛̻` vճ_=ņ{m0߿Uq IDATr[/,A* rv;'7qtLv|~\ h&ȧ@$BFV+?X7L̩Zmm6O -`e5,"ׄ3g( ^ѷd2Iu?W鍂\ZZZt-`iq04EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpr.f|5Z_""""ǕnHOv&]8ˋT~MYWa0ŁNb`t| c!fȀ)8%YvR~ "hʚywJV"DOIEn gYlV|W_}_ي%KP6|Sx9XCp+ϡyad,;Ng8}~s02U%s'Pƌ8w=;JnLþ9˹wJgacTl#gV%^oj^ t(8%7l sExJR@b-o xݘ%͋kpOֹ^ǒ[7 |}${vme\ l mn Xw"ffPT _MqQuT%+7f8@ v [}cFDDDD.7g,"(W ㎥wU-gTSll oh ?c+ؓMGY6 g@0"G xr )5:rAi j?PSs{hno)h ߃ EDDDg,22X@St8e.%/ǍQ oa/fcC;t%
0j(
r.ACDDDDnV\r^V|`Ȯq1N7y\~O& 3PKm s눲.9}=bqa
?6;L l plFBcȥGLCUr!"""iԷoDDh0peQ4lŝVe~V Ƕf,[q6 vS!3 ?yELe_~#hbY>lK3{X@rbLً(+ՙ%d4ٙdx=8HG}oKV0\!ٹL]ulY)""""W98%p8 >ζnË?[E<0ǯp]cW[O8%
/bI|./hbprS ċ,Yo$N]ǑڨۺwVo}Ajnfۑ?"׳|[qus4uiuk^2xMBl~u
ju)`ђK&\%"2Xy+e粚-""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H+ vD-W """""IFVn"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H
"""""""i(8,""""""\{ ̾ ~,+_e.f|5*d;K_m69.O5N '7sfN,~-3Y^ LFi:Sukz2ү=i'Y+|Қ 7/QEDDDD x?K X[">$k7u,gY R+ zl#DFZ6d
g^
zz9]/qy~ݱyH$گM<'-{F/Εw@{1|
abx
LS5gl$dd>+T~ٰebiki8^ _*d2A?+ W_Wxa-ytE~gyKY:wó$[phQ S @ oK0/sږEXTdJR
ʎdmc'bKvwlp>iwV{ߐW#fngxF)<\XmW>CӮmmugpM +g ;!sSdAFn?k m&e.z.`2ŏ=-P8uKfٷ蘎n$랟=m߉w&czG{&d_t,Yƨ=\مlu 6G{ ttq/T='`=-bvgw 7u螟|4gEu~sP o?k
q<3Y~J>v ~Jm7& BfGxhr|};%ssʕ<ڳ%6rfDɟ_I9EjtĨܼu9rp]|_:u tb#gV%^oj^ X )wA _!i6Ț;>g`a}+:CDDDD\㜉 3u&=pO/ /6eօk`r;W 7h-/D[ 8'5K~o=Iv6ǵz!8@ce3>GðQ R;F=:ʇG y?dWd_hϖnsݍe8maz,p75$W=MeC'}{\n i4D0$
%O_&o?cy7}_%r>8߇ Q|{'~ϱ^3ƀYLX{Oa9rq
4s=;h ;y33xwlh&wy(:~w;[O@<) }ԝ lbw2Oa̚#{ul1)ƾg"rr/xwo}L}u} 4l|L9~FDDDDo1ouzrG߮ut#shG$=oq'2rlDhfBıI۠|1yT'2|D6Й~2M{ #4=[O[_&<%_ }pUwasUXur=M[N%a_Ý v HjK/]W"(W ㎥wU-c.繎km,FZĝ{3WL'Ge35r )5:rAi 0 64v~=:sҥeL-'ef V{2" X4Xy9D(g$XWHqfCYDDDg :Mh $oL.8gi?I68mՄ[;5x}Q، r>g(FF?"o(jBNS$6$r -Ns [0@ 'ᗳOppϵtnj>ѩ f,1T\lj\l>N=נa_u3+ȹWxN$V1[G>]WgdxYb k_ۧ2]q:ᓾ-7u5`f
i66\i!1; GVJmlyct'To3#0zy?Z?v2?p2y9WDDDjU >.5$zΖ5[[;*4Ft_>]swFl[_'yU4BUu>ގðٻ=`ﲋ.܇}9S+bs gȺaBkKC_22\0q>r`jM1a|:TO}j6#Gx!Kiiv4: 8%zm"
]
g7bqa5f4@
uɹ < vM)xY3y1?]F7HӜ`Hr[ӭb\UV ;tV36Fn7qOٿD$C Ή/}v$R( N/V0.a/Do#h 8b O~@)c&^_fÙI^~> ;0葎|q1+*e%(+VFd[ԥ+_PU&Np@"qq[KQ7DrbLً(+p;A(%?;̞3
("""r lQ3w\J3H m㏑7aose2m z.A*܊-̓$ x d|+)rROm (&#;Im%T%
|3D\IV1 m 9&3,pBFkqc<8'>Nf .6=E2Y{D)'\]Ӏ{nIouo!x~@n7Nr(G\[; 3Õw797%q߉60<>qIHSHD dHVca`+* C,nxw# mo^Y?iV9v8[[t gۈ| l#p]of]e[INo|gËXRv?_ m!jؿ%=F嚗y-E%^Pm_]æڋ-5:;W(;ĉ8m Fi#x7o f ѩ>xcKYp%;Iڻ#ڏ+x{ `{43bf?pVT͛$#q 6*{ U Ӑx 2,Ӄ;EⷴOж?w0>"WV *!bB?1kh; LN~yhk$q§nJ [i)ܛ ψaNGvڨ>]R^=?>8)OR4&M{ z>OSOۑҴ`3>q$c3=n *~J h\s,ٱLE Ss Z[[kT#o >ljEm m@con'_
/xu^)
}ԦuDDDDό\7 q߸5jtk3 qtcY` YW v?v""""r ՟
|{i*?"
""""r-Sp (#b1Rp{EDDDDD䚣"WrȵloG%""""""r QpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpI \6eϻH92tDDDDDDDZ-""""""H
"""""""i(8,""""""H
"""""""i(8,""""""H+ a5?]M fʤx6,WYddx%jϴ,"(
Vʪ{Lvvɂ&3#ǃnpJ&ILb1Xۥ^DDDDdPܣ#Ha
z`t5-*_PXHK( %L^V^ /g a z`I$ bil6l&ӗJh&u3DDDDDŕKkKxĹ BL\%6GXzĹŗ_H|}"q_y녑Ǎv Vu? u8 W|fQLt7ؒ#;.4{ _d(uwsdb aaoj:4۳=v~&E[8sk SgPA V
װPp0l|vz}aly|
oN p2/ wϪk~;v
c#!NBNa {
֬5 /cE5^qr_9/\y.d-xgeh_ %4zz- 8xۙ>*ٲ23 ,]
ѥdd !]em^$4 ɞZBNw21kIUb@ܣ;#ӛc34[i9}' Yksfx8a= W5j 1rXL )#h:r39˴Q=7ӻh+) Z;kȻa%msN[+R2Ɛ5~2
sPvy|LV| |> b]4M!Kupd0sj.;h% \S֙/!e!s9Z[3ikKtcB
M? 5r
)peי9 𐳑3iE
xz ԱdV @:G=EgTMgI !d&f fw()Sh=\i1Jl7ϻǑG)96TSO3%`0(,CŭRQB]Әmb)7s&dP0q_'eOs͖zd[Id.cF{}I>No~^z*v
:91d Fqoad"V?jZr'Ocִ Up/A8bmn>|t8|:X1 cs3Ypi 0xS
o빢6e9y />rN6]WCuss nbKXv !LґI̸pD#Ggo)w!o|S] vm[s{j3{OKIʼn' M|l9K|\B#o*Xk&zj(?XCC7\4r)TΙro` >iʟʒnt6]Y %65+]< D2^$O >]NMMzk\R-g0waYNf`cl@muGT EqF2BsInFe8 = /&F[9c+gmIj-Zf - ±kwy:sx W2ng9WchyJq /i8
?jt۪lӋq 3nd] 72,Z2d8dxgӉa4IDDDDdrfEh_eƍ M؉~|}q? e 0|̸ g~tG}ߧƦfH&/xr_F
㦶aMk
Cț=} Ih
h`(/K0 x exBD߇\lE &NY^B(Y8 _D"Ac@60q-%-ebߠƬaó`àvi vTDp9}*r:DUSDDDDD4MNt1m&N琌]Nx
?; #ϵ
vYx=n v;;l6 v;^V&.4U%@߃e(+#.,@G"Q2^ t ^/H/aU 4lЫj_&3#ǃnpJ&ILb1,""""W-ӲOv>67]̔IkeVTD/e?ML"
S[WaߌqO.Ypy{u1lvlg@3ወfcej ð
(?H}<џ)8\@ɶ*KO}|ib
4EDDDDDDPpICYDDDDDD$
g4EDDDDDDPpICYDDDDDD$ Ot IENDB` litestar-2.18.0/docs/images/debugging/pycharm-debug.png 0000664 0000000 0000000 00000115120 15070515525 0023023 0 ustar 00root root 0000000 0000000 PNG
IHDR | x: iCCPICC profile (}=H@ _SKE* CdATQP
Vh/hҒ8
?.κ:
"ƃ~{*̾q@-#J|E QCXff}N _.9Ղ HZ'ͮ?uWS `.#i
"~Fߔn5>N ,ue{tPar3 bKGD pHYs tIME 0 tEXtComment Created with GIMPW IDATxwxTםwސU"Q
lljdx'fM}w|כ8qc\ ӻ *#Po3Ch$|^3ѝsO}>s= iʷN#@ =dQ@ _ =Y J*^hCøG~߯F7 C{?Nm*vT0E=sS6p-cUֳᗟỏD21e\g&bB7TQzQR|
[moV ӟ楥m|돸ծqL
4
s1^d
),[ʄ@PB zY->T.n!'G,QQf:Fvkۻ$7NSM
}U^΄J&ܨ-|V2^Ȅf.fUN)f>'-9\ Qb% {(iKmu%ŗ I]-'Xf{_ﱒ; CY~:Pj8fP })HuHD&'-;͙&+pz㑪P
xm y2m>:p. "gR f_3es]fyinR|^¯wC&.|-.sZ( @%,A\kgL%Ayen!&0-)ō q;#18'B&_Q<&-oKw%``̲'8#&QCyqh9}dVzc(h $2>FaMcJ5G{4nARffRa'P R :qh
ɱ$騿Po 2 ڮFԈ<XOcBꍽ 8w^0A,=Y/Үj ۼSPF"4E^|Ħ8*
e+tFi+̥6b^j$1YZΜ/9t+EMfɂIņ Hx8RC|46j,VSonܯ|v6lN^ hU5u!Rw:ӊ[*hSUUX31Ɓ8¶ST,:t/eњgYlRh)_p#9vM]FIQOŏ|ˢ 2gSfVV_My\
y_'f:8[B5cW`鱴{$8+Z7 =o̾)W.[#.s)Ld:6T&Xzw[T)RV$ԥԫ^n ;ș/7
n )\8Jq6OOB %A麿zO{=wۇz C}?zL!iO|95[xp fpon>U>bX-CfBH!OYTsnvvcݫ
|ϙ$czW-~-x`,^`vͻ~DXѲ!{ *^ w /!B++>!`DN_軖Pv'swEX~5UUyN~-}t
}z7_(@ y[ߥ..-ڌ_%,KYԆ@ [ފQzr LdN`֒\fef8[iRpb?J[wC"VwluK,i S1
4dMVN
+rN& qD~ \AGtRV-HRWwseRKM 8VGTJ1e h0E`r28x+Xxr˲!} {A \hBJH%*PWAX%C4]R]0Ά@cae3ʳ
zm8Y#rF4W_% S 3g֦qcZNؤetoq0)A2Ax \y(ᩎqEqY05XJ|ɢőkq9bԶSua? RnD. .m%}wyd9RHKY:# ^[N `ϙJ:&)29"%礥:?ڍs@inRD.+fQrTQѽT鞦>"sZ7 / D ֱI8uTZ0PCt1K*Rqa F!m[J?wlOԟdύ)JLS&:9Tkå
#cCyKkzw&;ut:u8es<؝2i^Jwpm ôC|^]UV\t/ : m>A
NtFM Iq25+h6,,@\H0
\33|7&e%?J@xWuRa[*ޒ+h.r4uh.@>AT!y3LoλvQ|+;yLAiZZbZ5VҟXڛ6v cK{kT,'{# 2 #j^F}U_Jek>/!8LJb?g&5w]5OWu+Q^9 9 m"": H#!#@qwvИeQy>ɫ;ZtFFlDwQXb!D~[R%hiB^tV? ƖPj)JV6C.ńd P]\4K{}N_ZTZLR|, SX;gsl 1Qx&BhMmyEX$![~+v0=v/
oC}]::*Vxtnw:mP/w{C5IBR9f:s[GqƦ6i9Ԗ?|U*˞XAR: dsR٬Ѽ|~n
4#`X m7n{izp|ҌBij<
Ȋgyy6GOJ"^ӘCvN0f[,˟!pC\ڐ3 Թ,vtȚą<4%_;KT %{Υ^^Ϸ lܸQȦ%#Zs/{PUC[O<'#@{/eF@ 9@ _ B@pߡg @ x@7a !@ Iv>= A7Y 5(k 5{ }p9
"ƽ\e[eb(*togĚ k|̞ m?7Y~~p69/Dꗼ4mfF ^g$ W>L
NcJu) fOEF>)dh}LΊ Dqu e$e[X ouWv\yQYcT'˓|(2\
t9vY4odζd
6t0MzVhjѱ 礁< κq ̒DC}9ozLgLfQB`8b!^e|$1qЙ09U>%R#[/hRa
j"Ԏb3ͺuK YÐ[+^M.x WL|9;ibHE^ >9[ ne]Z7&j<%⪆:U%i'9_l07kg8xnWIHEF6@
|'2aj5||6vǫP>\.f?W_9 V}ߩJҤ[
=B[CRp4!6D-2.Yax'wѸHw54yf~QQI Q}26JzpF>$Yl9A
q,'4i,@no 8`N0Ц mWm_, B"|Kμ)0hp;B >k 1 j pNqZ
id|~ıΡȶ`/?Lbߌ ಎzxqnҮGEHzsUO88/3nNC.M,KhuvX*[?.7Pn9qHvXnFLOzbgdj4T4jfsA-ʍa9 E{G;٦վ#u@]fXbl* .ET ҥZccs< u{ aב֑(9㑃|brl+͝5j:` 47j} @hIDSQ]P,Ro{v 'jl\fgBZ-W:,(1l7#|麖`I5mM# H+MHLp )n [b ^-tF5kpv IE % Z +${Mʜ8Ķ }+>rDl'/u
=2C۠z / "2%CKnCUUp7-wY@Fd?Ԉt 2Re|vr\ =κ//h'ěgԴKx%O?DSfU"(5u:jtfdbb=ڠۦ溙_ZS8Av]"UO ćm d {;d/C[^| B|:Kg!m
Gw FFT
m- . 4K[C۽`u.*t>XQ[ejU0 PjGS;V̹ehjyA IDATqAlj+
s&]闦lh9[5P@ &*4k KխQ^p;e[TrGqmzYxa4Ⱦ!(y%. h'ԠmpKa4wV~6Q.sP+^f3cJNP^e|MO -{
UR7 #cy5_e,I7nTK" L "q|d}sdly pO~0nC+ ?Eu 1v =eK%8 if]5ޯ{n]9ü`z6YaX' MW
~1Ogm E0vB;*$&-?3qM K(2Jĝ xD @ / -@P?Pa !@ _ .4CtL v1Q]Mmm-55Tpܧ֓,˯v[P xEUWT"<9#=?2Ʈ{:p;*:yX&l!Kw+|
[;߮52۸%q4*pL?iDx 4(%?
GsC@0\ w ͂G&+'qyžzSIIwRD6|u-E8 kxADN`4~H狮KEl!G[%%XUƆ*P_,^J
%>@d7'yjeָ?;Juvs\bT]χ2"!Ұ<2VW @korL,A\kLeg) VfaFsR{ ƹp47s)"s3I
(h(C\v4n2s3 =o6}
?xD|B|9 2q/3
Y P-]i)JXoYf&X$"y{7gruTWpcp&,'7+pOl}e%7w
40~wyDO0D VЎ[2D; hX≱}͔;DQ:r:M`<WΠv1dg"yKۼ 2xFԈ<ìfZ^?,9 E 4<ɓ8 ջ1fMlpɖ 6Ԁɬ~d2ꑏx.P| LtL;%'sֆKFƼXb,Lwnt(aRB9)_R
Qrjɡ4XqU f 4e1 FMgͺ5i 3 T 9M j::EOF5O_M(دP,)))a&Kz6/ }KHP`dMN{v
mzࡱ:ݝ˃@p )'TiMJ~jPuRa[*ޒ+hQpKEsx>AԔ!y3LoNvQ|+;yLAiZZbZ5VEm l>Ƙ3!0Q,'{CnYv+@&'!Ym$P iiITIiP#߷t 'f .DqamЙ2;L9V1p4 AX73=㟖s_&/.
3&Qq;>]!!Iz~v $>Yqk*-jpms)7Ύ 3qٹ,
:'yu#pG65!N7`##QXb!D~[R%hiB^tV? ƖPj)JV
1SXt#k:Ϫ..^ax.ՆFnJS&Lsl
mK&Qz8`ŃFt{.E)7pIڄJnL$R6IV=< c!dNJ[!.h u W#ZM /[u/%Ѝ~b V갫P[1gѹUl>- V們ջs$ I9:hFm ʼncBڤ<;S[j?eO hQB݅O Ɨ#yCBU;,*Z% m&IoHr SkKPu{CJK>Q!Hōh/ue 3L\d{%P$)@8]ƥB/i2?DU.{>ÏvPW"H5I !/,,+O?=pJ1 ݥypnbTASH5K ìػ-^l-NL)$`6Ѻ
t eTB N$s̊El/"=. "R3&Lu45m4z ]6RN?ɉ4X*pr*&29?<9+6=Yi$DGFy+"\rd
D˄kXY˙s=\E ._Õ:3_-~>t j{8hux!f&K
Y#σ@pqZwAlv;.@5<~=2F/:q sR˹3e]עR{j;{װ N.Jg]+ "\yqzCɑ[#%͇Ljx+ 6kSz#><
Ȋgyy6GOJ¢)jR n+*VTj2 lnaL[ ȞV*K0< .Jmeg99BkM1'DZyVpu:s9r g^n >* ).\MJoesx o# vw1kl 0rs p! jͿj<~k~ C7#Wytt=KTx(/_ z=^cS lVJG )ӟ_ ̌SRلS!m
fX_/?:|o{Dr7}h$m2rK 9~Y_:3l}패}X8 B@ _ B@ _ _ Ch4$%&J]}#
|^=@ xPܸLrsҹà,8 5hN\z^.?5=*$
jF 1$-@ xDe&Ʀ^ߍIOv* $̾} ⧳hr(nk9՝t3
^+ +;>YӓьMZmT eٙKx7xTяJoXwA/ɿ@ɠtuB?sJM: yQ4 }(@ 'Dǎ DlYNgaa7M3t.TU qsMJ~ )
3/+
6}Bf5k'K9)t:^/)))|kW\yH+7ΎZ ngo~E A7mz`H .d钎HW ~a/e#i~b? oparwM?!
~}} bM-eȔ'_bI_͞DZ ZˬxL g+M5V
NXTJ)hok'0C"VwluG!2Dmۯi9m +dMDLG`%wttDg/e$jq5X8p7
[F/HM 8VGTJ1e h0E`r28x+>$7vbԉHNREvn Y})?&ƬǞfEP1wڀPR
#o /3;v'L`H0kX m ; zD֨ da#s *3V4nW nB}- 1-
kkEoL㠱
s8.B"Yɼ:olD
6bG >̋kq9bԶSua? F*Y c:M(&*;c*85d
:$gs ɑ^գ fLflOvr:*-E\2Ktz
R+Ѿk4+]. ܶ_dǦ Z t)JIܘCߛg[A^x]f<Ĥ903@ݱ mñ
=2o#aCvF(ﰍ)߾W?mD=̪j+[/9D 0j\4Y?Õ\ t_CmH<؝2i^Jwpm ôC|^]UV\t/ : m>A
NnoCRL
nF QmXʛY>!(aڑgfn MJ~$*W`_AcpKEs{K CHLBԩVsŻ~Cpxg Qk6Ҥ6ꫪJ>W*[{y )>>t;@>85qh.^ڠI]ŏ~{<+7fR m=\F*m00ڻYxqQCc&.;EA${aTZ{LgڝntF4 _ Sz 1q\RA_:+?RL\ (NJ i]NޟPi7FTb2I$Na9V[mmg .tԆS=v/F.>u. J}] vj?s<:ǻE_ `1 蛘*z@pW"N AU=7Ia9oT{WtIq蒽CTgs sF*u;qKswwUE#!#i(݆-hF90 nx|m{D1C.ٗs
j;.0 7;a!2Ԋ&|h:9UU)u35+SGj0T$vڛnu#q.Wܴ4Q5:5j;
m5U
R0SSCqUZ
Ů<`yv{b5qΖ¹#rK#㧐j@2=-Y}B"l:\:ޡX !=I&+.XSSZ"H ,6s\*!MFõ
X5X"cIÆi) յ_ ClL(FIMlL \>u\J!*< W0gJx,oAj9w+0VZTjOmgO6pکzE,냣Ia9)*QoNkbj*[qiC.R
-s O
EiL!;'ܭ
TOtm4 yiviВ%*[|@=yRV/|oPH7nTo iIo@ ˗m@x@@ @@ @@ . V´,ML}MӲ @ B_Р b^&F&FyY0p-r v 34NLQ`7m/íWc^ |sh?lGiw?A=VnP|<Η"6 (Duq@☱l)'fa}8QC
c\رt\Ѷ b!&e"sb#8#.A[R:@RS yQeݶ
ѓɍ(o7WvXr"$KQ:M=C;y-7,E5-YEY] ^ąڪv {Tv }3dZFx,PQG shX≱}͔;DQ:rۺfO9U>n"~939{3 ,{4ip_d%3Sǩ A:T-
cY&6d˅/Sr>-֢FOa
<o 3l+6:)IHGYFRqz|J'$*U {[Au[3 ~ێ| 5 b^s' ^좾Р` vplG3 G9zuUvO>Ks|b7e()\x7y ewg}V "4yj
-`LQJZe/`f|_?Ō&.ӀE5DG2ɸ/9k !+?fV__WC)zF*-7n0 QG4e9,H |5T #"(: yd9` (*˜@xȼ*
!X7v mȨ`hiKHJ5^JoEw|4{/csMhܴJL}5w҉b xK6ܥ#_^4 ,2C9VtJ . $B h_@tQ IDATze* hjjbHրEt]`"~sN `j̍#Cǃ!@ OuS;:TL`F`UHI,"BSlSe['Vt 'λMr_Vʺ7/N\&Yձ$K,( $@A A![ 9{9gk"Ir6em%< |m }= f>t6a5)fvlS`u#=PՔ~n~ ]1HI KVx3Ic5X] Hz]sr{x`]5ebI>83Ge6:<Ϸ Y
&xueNw~2}|a tqu2 h;,M^x 9=HG?fwt3G8ֺص@B./\Fҩ| 8!?|yNL+1WW&FJBA?92Hk8fl31t!a@6Qt(T IĆ/
EoPrC[EvqwzE
U*oJ!3?$d,F˗|BH&[wmm Yi2VN :zns+Ɗjd9s S0xy4 eJk趵Zb\W9~.H3&#Bгzì//ߥ50A{ڸxFOZt:+v=f>U\ /8(:M240b^K*1Qm!FQH-o+o'OMFQ퓷9<&ʤ꾇(#?9-Z_kwE8oyۃdR K/ [7g ʼnϞ|Z* 2_X[`n>o /GND8wQu~1bl)H
kx5G䧗 d&FK3&,]%k 9I[`3$'
lD~;Y%7E>yḑp7sR bO/EĺCYl g
pscT|Aj`CZ57e}G?s:ݥޓe _Ucey(/!骹NOűD' 2K=J8nG
Qb(Xk̄m L y.%$=̾ꭝ]֥r͆ ˞5`!(2Tc'xsb3 );ȇ3!˥'戦$<fYI[
M~_<~ֳc&j,4ĕ >ѣ+Q99ӴJ 8FxT~6+`yٖAVE,͟DCwIx~ه q_YꝒ$ĩ
6+9KHC;vP__??h4<<:Il x]Ë1 ST GKYO ;c}n\)ok< p57CŹ7mz mOPZ *s/7)&l eڜ%28A08 U:/ os^[Gq
JLj'NwdRQiA
HiyFrvyxǓ^[%#KA%7c})l*aKAYpm܍I"~M8$nʟ5 j?sq˽ PD{ڸ\$IW-zin]r:2i(>m_Yby~8O#+˂cd^{{﹇i@p Ўkaꫯy `y2/ "!qC|k7r@pD~?{Iez@ X@ _ "@ _ "@ _ wx+Y_T$K~p.ǿ__ͳ,H5}@ _4-Upv%6p =b"HGzO]*. X>#pN6;,bm5ÁJ;B4 'o\S"I8/o`9őrD}.9W2 +-|r,!F)l#e1r
{Ðy`n) yt)n ʺ]mu>3i'հvߟ*Ccwgݬ/ү~?Ccȣ1 Ƨ8XUAU_ZPv;qqDZ|qgkrذ \>aZ2-:6bR6i)?;1z%O=&3ZI3VlA>F}|9&0]\Ke2B} ?ɕFUƩ?T|
Ti;bdHE M:?~ׁly?wW\G8,SwR6n
%i:S%U3Iާk;
k'|&&B|.܁,{ۇ-$Fj6Iw9ٙxQXV-` Yٌ2)emp0ζocUl\TWB p_n>See0=r.NuB|.q?y_&p#)Vsg0{"N%=
O}|זSc% ٝ#RF~ӗ"0wgǚYk _N%ʦ?2ٗ=[6Q@pM(
6l N ߦ%GC~{gO) ?].6l /F i{GbTE_ݏ gpu/Tɷy?k '|Rɖ6 jNA>U۽
-J3Hх\ XAtsR_k;P~S@ X4f nprC[EvqwzS]4@ FmY4ROU g]E x'K7M "@ _ *H, b @ ܾŔ@ !@ ]HD a`LgOY fˍόV(.Ki#ݽ)IUFK3HSK#a~/}\@IΊps)a@I2}S+3 1݈-6g@pǣ6[OnF7$9YU 1,k@[)K&1m6zݑCK~
4.: ĐZFz2 8<1,IRY[IE
NzzhGKjYt] _sN w#ӫt9Lns>{ǠPfca>?]M㇝ a}9Y&5 #9 90ҋ>=tl*WS`k;[Jӣ xtr7B^7h{#QЫP R.'6F-A(ߕC:2].\n7OxQ`8Kzj"y?Ơz Qq K眄h5uv$ )ͥג &QQRCU&y^/ Eww0K*
쿊=MKɤTJ@yiorgz&%).%:#0QZSΥ6pdzc%'A
Z$gp^9U;FOV%Ye+x[j')D'X~\ZÊ0 M uqBDmd6DЏ_a2*^a2Hc4v[%-݈: Yfb>|q f, KgN44Kj1"MMIc0O^IDԅØGT\wy9Tc2pAsK,+YU G4̢jueyYdddQ]dB:7QCQFZ5jEI= ZKq9 }ʺ *5*p/@xŝ0UQkBՐ7[Le VJ1Ъ5Ld۔A42̺4_A`.eruuX Y bs}Jb%5q;)t z =:{nq.ZAX$wF@愌PU$X %U)Uʄ.z;OPvU>
0V.OBg>)fBcJʔ{K܈b1|*rKѪȑ ΡV$ݹLfXғB 5) G>[#ms7'o'ץ8%a*f:sF3֒iIG K(IW*7@UZ=a$^N]AmgeGȨ,rS~ f e%'F=aŪr}^.Sn*3t^i Ra.,lrz8mA"g"|֜ZDNd}c}{i|X5l/QNU]!1Ots'OیR6]HH
" qƮwDJŕf
sx.nO~;c^5+
6_ V<GkĎݤkN'JU'Gp0AWU$Ye&?[H{;ɲvtcXA , < |2ͷ^%n
b9Q
>}\v$FՁ z,V*G%nK!1 Pn\Ҙ×s($|Ex63`P&&U0틍x(QKB89Dq%
>/}}x|({J 'ꧥA$yͧ^Y}yynNcL q"
uX;!1p6,/9C
z}sFob5sˠx73 l w\:ֶa"L,&ߠz; (.y۾C9KSyn~[!1kJ̕DR'did360ȕnBYU.@}t:Iޣ>rh*Q4 堟A;ƠK0ybϷ^bH{E--#37o1^BbVb.)դLcUGq&nʑ1'!K*)6jd*/w 8Y%ekh
dNK}AҲd%@ZD~(rZ
IW% }N&)kv-L2LBi
֬'~^,C)xJ9x_/!1_Td,dm}B
,c [ks ]J IDAT)ZLIQ
!)b+%Vb5Wit1L[i+R.p
ذ*(u$sѮ+~={wf075z:XQA }#,Jfk8ޅH53 m$Z=&|9̤)+"DḨߺ$撞bѶ@ X466!߳ӅqzBD%
R5 :FD CH|5%(5w1 ^ ˭/1}\8 F@pCG@ /@ /@ v}/#b[ `,#r`
v$wdήn|PF}) ՚z9X\-S/Ot\n+P2(*-<K5M*,K9E ȭr6VJmIW@]]˜nwGX5~N7
M( ݆lrL$NEBewY[$ DX_ ³˭^^E! GF.%nB'ӵ\^fPe`5k!b>ꁙgnM]>ot8W ;$I._\-7#$)1 a &hlT2M']245h-H3ՁF3csx\}ޟt K,3) qr#ayd*wc*!n4aқHWxqxsALZv kWQ.!<)1gpR׃G2gBs':-䙴ܩߏ ^'" bo\_>pIBVŒ GSG=,Fn/@yh#9cB&ӓ
HbR>)JOt2{ e} -+oPr. VC\3 M:?~ׁlyGmrѷ킾*o1،ro eGzh\X
_+; $8
b8a^_ + y48lC/h Z=
kx5G䧗 d$1vLf26hx N
t;o)tb ʠc
)Qk]Wk{rvps|3D>%a 2|%ey(]R Mev7p)Zú1X57eɐӧp:UswCosuH?>|9lP2zJtҕ^zl=^~{`1CwC; Z#Dt遲K kŦ c 2^qc̾_El0*b ƨ{ |%aԦ4k6md1s=c&Noo?Ku{ 47`DY*,z={0ppÃ9d[MIνKH~>>'?kأXukX_zI:d^͘qg^7Z*./|Nٶ/?8SE}Xs\GWq ;n1 #T cAfGN/}2A!ЦiKA!
Lf:
&~̥0G g>k֭1uymse YKԯGC F7R^j3EƉˠP(f,Pl=Ņ:p$GR&EEF}v|sW"lW8e©c'esm>:T@Da2.ԍ@Bv*?-d cgD0! Pl"+ٳ)oLe֍<@VS:֪ٻ%st |tu:0L/%gV6卩r*/EXa*$=#5;3 ]mE t6.^184t`.
"%lw>r TX̣v dٙ.Rڄ"2B1 KJ*28\b@@T*5 +_~rh0ū/s\kSQz?z}[پqB^Ft7&$d?p OwtY曼@2dOY{s?ӖJ\F_ݏ gpu/Ry|vXW ɓX+ luGnse^
`IM!Z#6~n i?yq v^db.wO^;r$ ۸^Ekq)_ X n߾F'|R +;P~iFF[ 5LccXsS=, zF(2(ߴӻ8p}-pSyύڷ@ ,)!eHd`X~`3IK>Ѱ1z^8Bg, 118*f%lVlͮ}pMSP@<~uBr.,rI 0 #OLY,t|NQ>zcvk%$2Dߎ|^ýU9//l\Pd5&G =2M$ҫvǫ>
o\yUl(6W=?FRUԮzTqtH<:B X n9uRf(x4fW`s (:?z{ZM\VQu}JUA>yÃnBL{=_2CbV5ov (Ȭ߽̏t"k<UR|"3 ̧ [*% OY>e.x6ǯH{_ \ "$C4 !> 6 +6F8:91WPa%Lo^b{\ƻNr(s6q٣哮of % [FbI7H:8}2㼐Wh)ʮ/>痯q_6>Ue<.[w)y#)o\[ĩIIZ,Ʊ, xm5IHkfے_SIlgLڷch6UfAh437}J|
C\8y~w RVV俈ڋp>wV`ƗXP@tgsaF ON*K7>쯍MSf(x)ByTn`/c5z20M) 8"TTZPRZ > i^{0UOcB_& ?r/|2)YIE}㩊ӧ1bvdCxݜ; j 3+]_F
~CyEx/u~ IߏҠN8FebY@Xy) %H ~'F
w ,3---Mۛ) [[o͔ - m蔎X/'w"@@ D @@ 'sZlHӐ9p v$Æ4J*IPs4k6,CTQ aS )>W|oG PY_vܚgP#|R=&cRı(WRb^ah{Y>tvsե?\O+[me/!" !"L/d{PS5#
epo
>Ҩ>~
w$HB6mƦ2u>9ȱv_I{<=5?{FwhXRR]ϟQd'C튃Jݎزlg +8Ӕ/UOBQUQAquZ4ʹv58Un
V%w& 7C-D<մ'ˊh3?z?<0fP\#('B3Kyq^icc q@Eَxb<0<<?>:0،/구ת* ^\a \}VN ^Hu Ve`?{!g(fVr-# Y6n%Kӻ PVgt(Ds 趵Zb\W9~.9wzV~^廴^{2 =m\<'-|gO? |c pOu.__[@ҠRL3VBuַsJri eu+w<Ȏ
%/+8S:N+a/ժBw;O~o=O8:(^kfh``UNJ k'8G8zOYQ3@h_"1g_BBZ 9}&= }Ms
#_cN^h+Q}ovx *h` bUt/SRbfF*tBDPW0a\| UZmǰ?w?
ĩG s>-N`ċ' seT/> xoh7wW^~ 2nT$f5+l\rDeuA69U S %3Ή]l`+=Jw[0
e_OUQ]
pmtYSdsSTgחS. *4OaǴT D)of#]9{䄈|Vܜzڼ#z.Oݯo^PLjq6qz| Xku~
% cr m<[IN6vO vPdd 34Ǎ;O1Xqd){>WMkSM=1Dz{ ~Wճ, 八KbV=_#~| rC/v ?|!&P?xs^>mi3}k$; ys-l䃶˄2jYWL9)n:l+-FNYa38 寮Hi Eq ~
D䲣SxRF{gM-` FBOG^?2+ W?ZTBqA e|-se~Q݃\?S"}!F| ; ~CbrAu˥: $_v_U !G7}yR ܻ1M[}'#o@s5+X6w:"3Jjrho'=bVm*# [4Fd5wJm~<'E\+}^ů8o6_Sp5L{MqܧIǏ,'Wg7P0L3|wCxf\ +
ez-cQV=y<&##)´
̥) qO1΅ =3_*OZSpg7 EO*y"D30E:v>| t,+Ȍ3p!#n/$2ς[
%E=O}IUPk%-{ =L*yn^[o]VQU5;5[lWi-Ζ^QaJ6?AYp7m܍I"~M8DFƔCqA Rgj?sq˽ PD{ڸ\$Osx?mA#
p' Z[jBwxOe m`~*ڇi3l)t^|yN8 x5:|z)"r@0Yfg╜ o4/H$J4 :w>N?8-B , NB D @@ n9TX#; [/[A;@ _ ~JPn4KӢV% F Cx>qd@ _K#lFeh,\FJ&]M ޖ?֚
9ouidge"2NϏ|$Id>U٬PA G˜j_h*YNwzٖDfzVjln xQTƕ 44Oumg8^} T*df0<$}eW(dȲ̠A(4m q{}r2 މ9ikh@|RΪ M6\d#eq< "IҵU fFFTma>LN%П2uiZdYϺCOF]vCjL?ҐMYE
ձ PQea% IDAT[+tF= l=ONyJ5dnP@1hmLGfvsmd(#%e䘻p:rBu&9fU{@0П2UJ%X|)2x&plM8SWwwXl&tv;е9`,? v! hK+)H!K+ x1'J.ԙ`")--,^ztbts# (^Z: I3LAs U Ƨ>ĥ!ҭ SC=bV L nr
S0@!@ /!@ /YE^|ʛݻw-2yf'yĿYF
/s o 1G-&% ;wIIbދ-?gW@ 9:|gn`?>HҨ^/2]aqgr'vrdouG3_UUz2t
/_x 7`? H
c*ko^}AIģ , ~;}@=&n'O@ JS9u \t.g[;?G+^y<2ɽtD? Y*/h
k'L٣|]H
W@N:!*=t=$ ._wISqoW0 s>Ɵ=G|z ߉ɛ;Zw̼
)),&33 jbm//cg_>c%ƮNN 3kxh,{mC (c察e6vɫ: x2s#<4H7(1*wDz
N:N`|_cww_ ޓ+ 5j#<2ܯC?^ߴ'!}w%4* vjT#'m?6J?-K WgHYv5_^S{WѦQXJE{b? 4DMm4Oq=(%MOm)J$^5/26nZB%N x'(CE/ȯcjo藜4p^ o)=ɞMɡ/)a2h8B3 K y좩F Kt8n?j9e9_(6oÿn\B45yS B"+3ZMb8Ȑ{t1̽{@'C~2z=:TH UqA;a$v TY 8~햔Dx_pY+A
ExgIVSGŕJBqn?ZG"|Mz9bD
_vb(/LwI,SʹC6
ňŵ_oZh{8a-*# 13IόԵG͑}|b]˪OAWk5?8B~X`
)ٖ!8>|Zh:,Xp+Oo.[);cheb6_
{˟y2G(ęLQv%W;jb> 6/ m>@c95{@ L)2s u|@ /!@ /!@ ?:>+~&R<A_xq&Ǵ×T,Ył(%=]Z9J~Jbl&ǠBiTKIi
*7ވ\RD \c\+Mް]po!l cJNs܈/2 9ům?ej}2#Y멉Q7kV0/1wF
~Dv>#R >k9vp/5m}(}QG'끄YVOa d9ډ͏9,XSFſ]#q4R,( <>E9'+%w_`boc[mԉgu%,a ׯ@[k+Oҿ,Y=]t3L7R."9 u!ɶBJdc;vOTnرGbIUR z4N g^5s ^O)w٠mf~MSa)d)O?
uQOD>[O|kPzZk(>J ~ M{+jl^m Gx4vf~?{ ٫Y$?^R
e8|bðƼuYnq* e@cՂmĠISII' _ n- P 3 1T@|w88醵?%[c{;
3- }e uϱxni,N
Ww?S5~1xIգ(7b6Pr_i ( Wt^0~E@0A>84g2%u&R2i+^[C Wld%zV AJI0÷惓:B A[üZuuL,1$de,[M:ecb % dmF`&'>U>4K1E/bF'qh92[5 *Kkظ)D
z}HNV)}tՐ۹ٺgx&k,dNL> J qY%]cQK߰G+:;Cq Lq9|qi0;F 7rS մ7S\YrqulIB$>?~u`X5_$ b[8H nrr.\hf~Lɠ.]o
/Nn qa*b=57<>< :Ttta{ @6Nz`*I&= hqr`<[%~Y" oEOxM= UCGD㜪]raZ T5c@_!/_>fos?}e=&Ƿ"NG?g6j{&A9.M:BAшY7ڑ}Sw__dBVz.
mMHYKps Zz-,
I ~]̋m³^W(d"S\%~` c2ܒ$Q*= 2x'Ha=$ repd >20%ht p\
ZOTa]әqk 9zj(g̼xp';Y8Q K;kEd
R[ YihW}GƖJWSsv8c;t44 (? L(88RK9-O<)$Ɔ
'!m%;V&`V4|W
)i1i4~?_sEǶ2}aj£gtO>DqāruA4W˾ ptɐ{ ňY!WKOjGOʬܷf b mj}L<݇BCD%2w6~e5sЀjN ەݮ'=, >D"]`ULbDD$cf
fsȄk-y [K%-:=\(Nyv1Qqƨl \HxP0)kش N*=MtZN`nJ2V6*N9 pp[6i0A~ٯE,&{t0o2/.k(>Ku q 2tcIҖao`r
Ŷu鶴Su WW Ws*~ `գz[;usɯR}' "z9O< Yv` ^\68qa?aV~/"wk _v}34Pq'Z9>Me&pʮ"X^NkBhc#e 9yj7EGՙ9tuB3F51܃(y1f\|v1 [:8_z}ÂNjQ0c:s,^ "1 >2c!Yl"o!^ /pB@0)!@ G$i{~y IENDB` litestar-2.18.0/docs/images/debugging/vs-code-add-config.png 0000664 0000000 0000000 00000057410 15070515525 0023634 0 ustar 00root root 0000000 0000000 PNG
IHDR I iCCPICC profile (}=H@ _SE*v:Y'B*ZUKIC( X:8* .N.RB 4*L5 Ut".fsb+ IR$<=||,s^%o2'2ݰ76->q$xԠ ?r]vsagLz8L,;X`V2TI⨢j/d]V8oqV+5ֺ'a(,sf ,b )QCXѪb"MqOK&W BwfabM
Łm ݻ@nǶ<W'=&;.#i
~Fߔo5>N u"e{;ۿgZ r=- bKGD pHYs tIME ;Wq tEXtComment Created with GIMPW IDATxwxTeԔI -$$ !.JPwVײ"bCB$RIi? 2
$$pRVY}ӧXl6[o۰Vޙx?ѯo_ tZm0[,h5fgBu05ek~nndB)T*U!YI4j5^^DcIJzy/<+ ~XA𗿽ʰ!C8r4ҲRwah͟;v5-z=9p0̜69 `Ҵ̞1[SQQ/dҴ졹|2rr=s:/wO"o_^ˋ8990m6%{Pַ-!b"#ӳ(;Ӆ]":vO~Q6t j4mｗ{b4?N3D@Jf(cǏӼ߈9wOW<#7uy_dʕܽGy̡#Gg*mߑ >fuWyOo)**b5nxI>z_|٧=۔ΝYlX7***Zm8vq>|crrXWrvQϹm(Mm6_,/VD]:u➉
Cǣ 9rEb]5iJX͔4N?zFC ӧLa˶bٸoTeTf
ww7DFBHn k(RRGƌST S) Uut̨+M{"/7ɛrlۻǡӦ(Ӧ#s 3B:ƂiY ,Z"\]]
ūIj1
n)!RKYYTVV] աu:舗rAwwsS~*nȷ˖F&'7Zx_>3
Nܽo}fkqm+Inn\䐶 V+*.;1lWU!Si2)5w7dx l Iu^}^W^;m6.^>CHU jֻlsuۥYǡ322
wm+$vl6 RV6'SRlt Sl6srI:~]KSH c4b69N҉N_f)S#t
fc.223\ύs]?o\P@AA!/Ç&_{L~^cp\,6n&,$wOo}xzz6
k?TQvͺ
! kE>y>fCc4ѹSG {aegZO}}\O
-/M@?! ^zm8èx')*.f̙9%D{V74TTU% ;fk]5 7UN lASg_kp9BJӷ^;!)#rc#Z!tc}$[: Z<%V gqg WLTwT*T 5IncMBVZ^3 P}F?*[:,-6 [e)Y,
! -@r$RA!$$BBR!$$BBR!$$BBR!$$BBR 0rRn'3'h[kCG GSh4Bvw5`̤y7+єuL5ӧQT51k Tl[I``rm%Kͳٳ+9}rO yxwX 9v즅lFm:%&Kn^ ü_@'MHƍ M ݯU{̨hfM
ɌL
y`l :J
yy< t_2yD>G\¢":wȳ<GaQ!cFOxN@x6Z7 x y ojZ/*gүo4xxxOI[cyVK/[mZwQk5(ᾴF//]PTTdsۋkW,W[,Y)[6qߌ<+ 8x/>^Z:"gO:vClt!~. !g|;-F o|KYY
.7aXh4L:GΞ;?{6z }}|(..TJ*iO-2羙lܼYy#w~GXaCq<9Fa@L b^g߇NE7p 'O^h+6o>>W~ '{Sܩ~XAn^^n&_xY sr+cޫ]2+W˯&77FCvN/'77772/eRi21m֕dG#~ρd6m9V_yoor{]<ތ
{]BCR= < 32HIMۻחio}eH Ԟ=w7~KXh( J; ^GS%<Ņ ZՅ|URV6«>At~>J#JvAaJgbZ"oy#㛷.!Z..>NVclqVn_?Lz:;o-#2//O_2689:ҹS' 'bFF۹z Ymfٸy O9F A^ CP>X,NhRgPPPHaa!,Zĸ1c ݻk _@ J[xϞY/X,ۿ{~lr{su L&N