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

1from typing import List, Optional 1abcdefghij

2 

3from fastapi import Depends, FastAPI, HTTPException, Query 1abcdefghij

4from sqlmodel import Field, Relationship, Session, SQLModel, create_engine, select 1abcdefghij

5 

6 

7class TeamBase(SQLModel): 1abcdefghij

8 name: str = Field(index=True) 1abcdefghij

9 headquarters: str 1abcdefghij

10 

11 

12class Team(TeamBase, table=True): 1abcdefghij

13 id: Optional[int] = Field(default=None, primary_key=True) 1abcdefghij

14 

15 heroes: List["Hero"] = Relationship(back_populates="team") 1abcdefghij

16 

17 

18class TeamCreate(TeamBase): 1abcdefghij

19 pass 1abcdefghij

20 

21 

22class TeamPublic(TeamBase): 1abcdefghij

23 id: int 1abcdefghij

24 

25 

26class TeamUpdate(SQLModel): 1abcdefghij

27 name: Optional[str] = None 1abcdefghij

28 headquarters: Optional[str] = None 1abcdefghij

29 

30 

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

35 

36 team_id: Optional[int] = Field(default=None, foreign_key="team.id") 1abcdefghij

37 

38 

39class Hero(HeroBase, table=True): 1abcdefghij

40 id: Optional[int] = Field(default=None, primary_key=True) 1abcdefghij

41 

42 team: Optional[Team] = Relationship(back_populates="heroes") 1abcdefghij

43 

44 

45class HeroPublic(HeroBase): 1abcdefghij

46 id: int 1abcdefghij

47 

48 

49class HeroCreate(HeroBase): 1abcdefghij

50 pass 1abcdefghij

51 

52 

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

58 

59 

60sqlite_file_name = "database.db" 1abcdefghij

61sqlite_url = f"sqlite:///{sqlite_file_name}" 1abcdefghij

62 

63connect_args = {"check_same_thread": False} 1abcdefghij

64engine = create_engine(sqlite_url, echo=True, connect_args=connect_args) 1abcdefghij

65 

66 

67def create_db_and_tables(): 1abcdefghij

68 SQLModel.metadata.create_all(engine) 1abcdefghij

69 

70 

71def get_session(): 1abcdefghij

72 with Session(engine) as session: 1abcdefghij

73 yield session 1abcdefghij

74 

75 

76app = FastAPI() 1abcdefghij

77 

78 

79@app.on_event("startup") 1abcdefghij

80def on_startup(): 1abcdefghij

81 create_db_and_tables() 1abcdefghij

82 

83 

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

91 

92 

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

102 

103 

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

110 

111 

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

125 

126 

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

135 

136 

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

144 

145 

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

155 

156 

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

163 

164 

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

181 

182 

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