Coverage for docs_src/tutorial/fastapi/teams/tutorial001.py: 100%
118 statements
« prev ^ index » next coverage.py v7.11.0, created at 2025-10-27 00:03 +0000
« prev ^ index » next coverage.py v7.11.0, created at 2025-10-27 00:03 +0000
1from typing import List, Optional 1abcdefghij
3from fastapi import Depends, FastAPI, HTTPException, Query 1abcdefghij
4from sqlmodel import Field, Relationship, Session, SQLModel, create_engine, select 1abcdefghij
7class TeamBase(SQLModel): 1abcdefghij
8 name: str = Field(index=True) 1abcdefghij
9 headquarters: str 1abcdefghij
12class Team(TeamBase, table=True): 1abcdefghij
13 id: Optional[int] = Field(default=None, primary_key=True) 1abcdefghij
15 heroes: List["Hero"] = Relationship(back_populates="team") 1abcdefghij
18class TeamCreate(TeamBase): 1abcdefghij
19 pass 1abcdefghij
22class TeamPublic(TeamBase): 1abcdefghij
23 id: int 1abcdefghij
26class TeamUpdate(SQLModel): 1abcdefghij
27 name: Optional[str] = None 1abcdefghij
28 headquarters: Optional[str] = None 1abcdefghij
31class HeroBase(SQLModel): 1abcdefghij
32 name: str = Field(index=True) 1abcdefghij
33 secret_name: str 1abcdefghij
34 age: Optional[int] = Field(default=None, index=True) 1abcdefghij
36 team_id: Optional[int] = Field(default=None, foreign_key="team.id") 1abcdefghij
39class Hero(HeroBase, table=True): 1abcdefghij
40 id: Optional[int] = Field(default=None, primary_key=True) 1abcdefghij
42 team: Optional[Team] = Relationship(back_populates="heroes") 1abcdefghij
45class HeroPublic(HeroBase): 1abcdefghij
46 id: int 1abcdefghij
49class HeroCreate(HeroBase): 1abcdefghij
50 pass 1abcdefghij
53class HeroUpdate(SQLModel): 1abcdefghij
54 name: Optional[str] = None 1abcdefghij
55 secret_name: Optional[str] = None 1abcdefghij
56 age: Optional[int] = None 1abcdefghij
57 team_id: Optional[int] = None 1abcdefghij
60sqlite_file_name = "database.db" 1abcdefghij
61sqlite_url = f"sqlite:///{sqlite_file_name}" 1abcdefghij
63connect_args = {"check_same_thread": False} 1abcdefghij
64engine = create_engine(sqlite_url, echo=True, connect_args=connect_args) 1abcdefghij
67def create_db_and_tables(): 1abcdefghij
68 SQLModel.metadata.create_all(engine) 1abcdefghij
71def get_session(): 1abcdefghij
72 with Session(engine) as session: 1abcdefghij
73 yield session 1abcdefghij
76app = FastAPI() 1abcdefghij
79@app.on_event("startup") 1abcdefghij
80def on_startup(): 1abcdefghij
81 create_db_and_tables() 1abcdefghij
84@app.post("/heroes/", response_model=HeroPublic) 1abcdefghij
85def create_hero(*, session: Session = Depends(get_session), hero: HeroCreate): 1abcdefghij
86 db_hero = Hero.model_validate(hero) 1abcdefghij
87 session.add(db_hero) 1abcdefghij
88 session.commit() 1abcdefghij
89 session.refresh(db_hero) 1abcdefghij
90 return db_hero 1abcdefghij
93@app.get("/heroes/", response_model=List[HeroPublic]) 1abcdefghij
94def read_heroes( 1abcdefghij
95 *,
96 session: Session = Depends(get_session),
97 offset: int = 0,
98 limit: int = Query(default=100, le=100),
99):
100 heroes = session.exec(select(Hero).offset(offset).limit(limit)).all() 1abcdefghij
101 return heroes 1abcdefghij
104@app.get("/heroes/{hero_id}", response_model=HeroPublic) 1abcdefghij
105def read_hero(*, session: Session = Depends(get_session), hero_id: int): 1abcdefghij
106 hero = session.get(Hero, hero_id) 1abcdefghij
107 if not hero: 1abcdefghij
108 raise HTTPException(status_code=404, detail="Hero not found") 1abcdefghij
109 return hero 1abcdefghij
112@app.patch("/heroes/{hero_id}", response_model=HeroPublic) 1abcdefghij
113def update_hero( 1abcdefghij
114 *, session: Session = Depends(get_session), hero_id: int, hero: HeroUpdate
115):
116 db_hero = session.get(Hero, hero_id) 1abcdefghij
117 if not db_hero: 1abcdefghij
118 raise HTTPException(status_code=404, detail="Hero not found") 1abcdefghij
119 hero_data = hero.model_dump(exclude_unset=True) 1abcdefghij
120 db_hero.sqlmodel_update(hero_data) 1abcdefghij
121 session.add(db_hero) 1abcdefghij
122 session.commit() 1abcdefghij
123 session.refresh(db_hero) 1abcdefghij
124 return db_hero 1abcdefghij
127@app.delete("/heroes/{hero_id}") 1abcdefghij
128def delete_hero(*, session: Session = Depends(get_session), hero_id: int): 1abcdefghij
129 hero = session.get(Hero, hero_id) 1abcdefghij
130 if not hero: 1abcdefghij
131 raise HTTPException(status_code=404, detail="Hero not found") 1abcdefghij
132 session.delete(hero) 1abcdefghij
133 session.commit() 1abcdefghij
134 return {"ok": True} 1abcdefghij
137@app.post("/teams/", response_model=TeamPublic) 1abcdefghij
138def create_team(*, session: Session = Depends(get_session), team: TeamCreate): 1abcdefghij
139 db_team = Team.model_validate(team) 1abcdefghij
140 session.add(db_team) 1abcdefghij
141 session.commit() 1abcdefghij
142 session.refresh(db_team) 1abcdefghij
143 return db_team 1abcdefghij
146@app.get("/teams/", response_model=List[TeamPublic]) 1abcdefghij
147def read_teams( 1abcdefghij
148 *,
149 session: Session = Depends(get_session),
150 offset: int = 0,
151 limit: int = Query(default=100, le=100),
152):
153 teams = session.exec(select(Team).offset(offset).limit(limit)).all() 1abcdefghij
154 return teams 1abcdefghij
157@app.get("/teams/{team_id}", response_model=TeamPublic) 1abcdefghij
158def read_team(*, team_id: int, session: Session = Depends(get_session)): 1abcdefghij
159 team = session.get(Team, team_id) 1abcdefghij
160 if not team: 1abcdefghij
161 raise HTTPException(status_code=404, detail="Team not found") 1abcdefghij
162 return team 1abcdefghij
165@app.patch("/teams/{team_id}", response_model=TeamPublic) 1abcdefghij
166def update_team( 1abcdefghij
167 *,
168 session: Session = Depends(get_session),
169 team_id: int,
170 team: TeamUpdate,
171):
172 db_team = session.get(Team, team_id) 1abcdefghij
173 if not db_team: 1abcdefghij
174 raise HTTPException(status_code=404, detail="Team not found") 1abcdefghij
175 team_data = team.model_dump(exclude_unset=True) 1abcdefghij
176 db_team.sqlmodel_update(team_data) 1abcdefghij
177 session.add(db_team) 1abcdefghij
178 session.commit() 1abcdefghij
179 session.refresh(db_team) 1abcdefghij
180 return db_team 1abcdefghij
183@app.delete("/teams/{team_id}") 1abcdefghij
184def delete_team(*, session: Session = Depends(get_session), team_id: int): 1abcdefghij
185 team = session.get(Team, team_id) 1abcdefghij
186 if not team: 1abcdefghij
187 raise HTTPException(status_code=404, detail="Team not found") 1abcdefghij
188 session.delete(team) 1abcdefghij
189 session.commit() 1abcdefghij
190 return {"ok": True} 1abcdefghij