Coverage for functions \ flipdare \ generated \ model \ internal \ view_stats_model.py: 100%

1#!/usr/bin/env python 

2# 

3# Copyright (c) 2026 Flipdare Pty Ltd. All rights reserved. 

4# 

5# This file is part of Flipdare's proprietary software and contains 

6# confidential and copyrighted material. Unauthorised copying, 

7# modification, distribution, or use of this file is strictly 

8# prohibited without prior written permission from Flipdare Pty Ltd. 

9# 

10# This software includes third-party components licensed under MIT, 

11# BSD, and Apache 2.0 licences. See THIRD_PARTY_NOTICES for details. 

12# 

13# NOTE: THIS FILE IS AUTO GENERATED. DO NOT EDIT. 

14# 

15# Generated by codegen_models.py 

16# 

17# Modify 'codegen_models.py' 

18# and re-run the script above to update. 

19# 

20# pragma: no cover 

21from __future__ import annotations 

22from typing import Any, TypedDict, cast, Unpack 

23from enum import StrEnum 

24from pydantic import Field, ConfigDict, TypeAdapter 

25from flipdare.firestore.core.app_base_model import AppBaseModel 

26 

27 

28class ViewStatsKeys(StrEnum): 

29 BOOKMARKS = "bookmarks" 

30 VIEWS = "views" 

31 FLAGS = "flags" 

32 LIKES = "likes" 

33 DISLIKES = "dislikes" 

34 

35 

36class ViewStatsModel(AppBaseModel): 

37 """Stores view statistics for a dare, including counts of bookmarks, views, flags, likes, and dislikes.""" 

38 

39 model_config = ConfigDict(populate_by_name=True) 

40 

41 bookmarks: int = Field(default=0) 

42 views: int = Field(default=0) 

43 flags: int = Field(default=0) 

44 likes: int = Field(default=0) 

45 dislikes: int = Field(default=0) 

46 

47 @classmethod 

48 def validate_partial(cls, **data: Unpack[ViewStatsDict]) -> dict[str, Any]: 

49 """ 

50 Uses Unpack to give you autocomplete and static warnings 

51 if you pass an invalid key or type in your code. 

52 

53 Returns a dict with Firestore field names (aliases) for use with batch.update(). 

54 """ 

55 result: dict[str, Any] = {} 

56 for k, v in data.items(): 

57 if k in cls.__pydantic_fields__: 

58 field_info = cls.__pydantic_fields__[k] 

59 validated_value = cast( 

60 "Any", 

61 TypeAdapter(field_info.annotation).validate_python(v), 

62 ) 

63 # Use alias if defined, otherwise use field name 

64 output_key = field_info.alias or k 

65 result[output_key] = validated_value 

66 return result 

67 

68 # ---- Convenience predicates ----------------------------------------- 

69 def count(self) -> int: 

70 """Returns the total count of all stats combined.""" 

71 return self.bookmarks + self.views + self.flags + self.likes + self.dislikes 

72 

73 def increment(self, key: ViewStatsKeys, amount: int = 1) -> None: 

74 """Increment a specific stat by a given amount.""" 

75 if hasattr(self, key): 

76 current_value = getattr(self, key) 

77 setattr(self, key, current_value + amount) 

78 

79 

80VIEWSTATS_FIELD_NAMES: list[str] = list(ViewStatsModel.model_fields.keys()) 

81 

82 

83class ViewStatsDict(TypedDict, total=False): 

84 bookmarks: int | None 

85 views: int | None 

86 flags: int | None 

87 likes: int | None 

88 dislikes: int | None