Coverage for an_website/ping/ping.py: 100.000%

1# This program is free software: you can redistribute it and/or modify 

2# it under the terms of the GNU Affero General Public License as 

3# published by the Free Software Foundation, either version 3 of the 

4# License, or (at your option) any later version. 

5# 

6# This program is distributed in the hope that it will be useful, 

7# but WITHOUT ANY WARRANTY; without even the implied warranty of 

8# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

9# GNU Affero General Public License for more details. 

10# 

11# You should have received a copy of the GNU Affero General Public License 

12# along with this program. If not, see <https://www.gnu.org/licenses/>. 

13 

14"""The ping API of the website.""" 

15 

16from __future__ import annotations 

17 

18from typing import ClassVar 

19 

20from ..utils.request_handler import APIRequestHandler 

21from ..utils.utils import ModuleInfo 

22 

23 

24def get_module_info() -> ModuleInfo: 

25 """Create and return the ModuleInfo for this module.""" 

26 return ModuleInfo( 

27 handlers=((r"/api/ping", PingPong),), 

28 name="Ping Pong", 

29 description="🏓", 

30 path="/api/ping", 

31 hidden=True, 

32 ) 

33 

34 

35class PingPong(APIRequestHandler): 

36 """The request handler for the ping API.""" 

37 

38 POSSIBLE_CONTENT_TYPES: ClassVar[tuple[str, ...]] = ( 

39 "text/plain", 

40 *APIRequestHandler.POSSIBLE_CONTENT_TYPES, 

41 ) 

42 

43 async def get(self, *, head: bool = False) -> None: 

44 """Handle GET requests to the ping API.""" 

45 # pylint: disable=unused-argument 

46 if self.content_type == "text/plain": 

47 await self.finish("🏓") 

48 else: 

49 await self.finish({"success": True})