Coverage for docs_src/tutorial/fastapi/teams/tutorial001.py: 100%

120 statements  

« prev     ^ index     » next       coverage.py v7.7.1, created at 2025-03-24 00:02 +0000

1from typing import List, Optional 1abcdef

2 

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

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

5 

6 

7class TeamBase(SQLModel): 1abcdef

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

9 headquarters: str 1abcdef

10 

11 

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

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

14 

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

16 

17 

18class TeamCreate(TeamBase): 1abcdef

19 pass 1abcdef

20 

21 

22class TeamPublic(TeamBase): 1abcdef

23 id: int 1abcdef

24 

25 

26class TeamUpdate(SQLModel): 1abcdef

27 name: Optional[str] = None 1abcdef

28 headquarters: Optional[str] = None 1abcdef

29 

30 

31class HeroBase(SQLModel): 1abcdef

32 name: str = Field(index=True) 1abcdef

33 secret_name: str 1abcdef

34 age: Optional[int] = Field(default=None, index=True) 1abcdef

35 

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

37 

38 

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

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

41 

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

43 

44 

45class HeroPublic(HeroBase): 1abcdef

46 id: int 1abcdef

47 

48 

49class HeroCreate(HeroBase): 1abcdef

50 pass 1abcdef

51 

52 

53class HeroUpdate(SQLModel): 1abcdef

54 name: Optional[str] = None 1abcdef

55 secret_name: Optional[str] = None 1abcdef

56 age: Optional[int] = None 1abcdef

57 team_id: Optional[int] = None 1abcdef

58 

59 

60sqlite_file_name = "database.db" 1abcdef

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

62 

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

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

65 

66 

67def create_db_and_tables(): 1abcdef

68 SQLModel.metadata.create_all(engine) 1abcdef

69 

70 

71def get_session(): 1abcdef

72 with Session(engine) as session: 1abcdef

73 yield session 1abcdef

74 

75 

76app = FastAPI() 1abcdef

77 

78 

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

80def on_startup(): 1abcdef

81 create_db_and_tables() 1abcdef

82 

83 

84@app.post("/heroes/", response_model=HeroPublic) 1abcdef

85def create_hero(*, session: Session = Depends(get_session), hero: HeroCreate): 1abcdef

86 db_hero = Hero.model_validate(hero) 1abcdef

87 session.add(db_hero) 1abcdef

88 session.commit() 1abcdef

89 session.refresh(db_hero) 1abcdef

90 return db_hero 1abcdef

91 

92 

93@app.get("/heroes/", response_model=List[HeroPublic]) 1abcdef

94def read_heroes( 1abcdef

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() 1abcdef

101 return heroes 1abcdef

102 

103 

104@app.get("/heroes/{hero_id}", response_model=HeroPublic) 1abcdef

105def read_hero(*, session: Session = Depends(get_session), hero_id: int): 1abcdef

106 hero = session.get(Hero, hero_id) 1abcdef

107 if not hero: 1abcdef

108 raise HTTPException(status_code=404, detail="Hero not found") 1abcdef

109 return hero 1abcdef

110 

111 

112@app.patch("/heroes/{hero_id}", response_model=HeroPublic) 1abcdef

113def update_hero( 1abcdef

114 *, session: Session = Depends(get_session), hero_id: int, hero: HeroUpdate 

115): 

116 db_hero = session.get(Hero, hero_id) 1abcdef

117 if not db_hero: 1abcdef

118 raise HTTPException(status_code=404, detail="Hero not found") 1abcdef

119 hero_data = hero.model_dump(exclude_unset=True) 1abcdef

120 for key, value in hero_data.items(): 1abcdef

121 setattr(db_hero, key, value) 1abcdef

122 session.add(db_hero) 1abcdef

123 session.commit() 1abcdef

124 session.refresh(db_hero) 1abcdef

125 return db_hero 1abcdef

126 

127 

128@app.delete("/heroes/{hero_id}") 1abcdef

129def delete_hero(*, session: Session = Depends(get_session), hero_id: int): 1abcdef

130 hero = session.get(Hero, hero_id) 1abcdef

131 if not hero: 1abcdef

132 raise HTTPException(status_code=404, detail="Hero not found") 1abcdef

133 session.delete(hero) 1abcdef

134 session.commit() 1abcdef

135 return {"ok": True} 1abcdef

136 

137 

138@app.post("/teams/", response_model=TeamPublic) 1abcdef

139def create_team(*, session: Session = Depends(get_session), team: TeamCreate): 1abcdef

140 db_team = Team.model_validate(team) 1abcdef

141 session.add(db_team) 1abcdef

142 session.commit() 1abcdef

143 session.refresh(db_team) 1abcdef

144 return db_team 1abcdef

145 

146 

147@app.get("/teams/", response_model=List[TeamPublic]) 1abcdef

148def read_teams( 1abcdef

149 *, 

150 session: Session = Depends(get_session), 

151 offset: int = 0, 

152 limit: int = Query(default=100, le=100), 

153): 

154 teams = session.exec(select(Team).offset(offset).limit(limit)).all() 1abcdef

155 return teams 1abcdef

156 

157 

158@app.get("/teams/{team_id}", response_model=TeamPublic) 1abcdef

159def read_team(*, team_id: int, session: Session = Depends(get_session)): 1abcdef

160 team = session.get(Team, team_id) 1abcdef

161 if not team: 1abcdef

162 raise HTTPException(status_code=404, detail="Team not found") 1abcdef

163 return team 1abcdef

164 

165 

166@app.patch("/teams/{team_id}", response_model=TeamPublic) 1abcdef

167def update_team( 1abcdef

168 *, 

169 session: Session = Depends(get_session), 

170 team_id: int, 

171 team: TeamUpdate, 

172): 

173 db_team = session.get(Team, team_id) 1abcdef

174 if not db_team: 1abcdef

175 raise HTTPException(status_code=404, detail="Team not found") 1abcdef

176 team_data = team.model_dump(exclude_unset=True) 1abcdef

177 for key, value in team_data.items(): 1abcdef

178 setattr(db_team, key, value) 1abcdef

179 session.add(db_team) 1abcdef

180 session.commit() 1abcdef

181 session.refresh(db_team) 1abcdef

182 return db_team 1abcdef

183 

184 

185@app.delete("/teams/{team_id}") 1abcdef

186def delete_team(*, session: Session = Depends(get_session), team_id: int): 1abcdef

187 team = session.get(Team, team_id) 1abcdef

188 if not team: 1abcdef

189 raise HTTPException(status_code=404, detail="Team not found") 1abcdef

190 session.delete(team) 1abcdef

191 session.commit() 1abcdef

192 return {"ok": True} 1abcdef