Habiticalib 0.3.5__tar.gz → 0.3.7rc0__tar.gz

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/.github/release-drafter.yml

@@ -19,21 +19,21 @@ categories:
   - title: '📃 Documentation'
     labels:
       - 'documentation'
-  - title: '🧩 Dependency Updates'
-    labels:
-      - 'dependencies'
-      - 'github_actions'
     collapse-after: 5
   - title: '🧰 Maintenance'
     labels:
-      - 'perfomance'
-      - 'refactor'
       - 'ci'
       - 'build'
-  - title: '🔬 Other updates'
+  - title: '🔬 Other improvements'
     labels:
       - 'style'
       - 'testing'
+      - 'perfomance'
+      - 'code quality'
+  - title: '🧩 Dependency Updates'
+    labels:
+      - 'dependencies'
+      - 'github_actions'
 
 autolabeler:
   - label: 'feature'

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/.github/workflows/draft.yml

@@ -14,6 +14,6 @@ jobs:
       # Drafts your next Release notes as Pull Requests are merged into "main"
       - uses: release-drafter/release-drafter@v6
         with:
-          disable-autolabeler: true
+          disable-autolabeler: false
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/.github/workflows/labeler.yml

@@ -1,10 +1,6 @@
 name: Labeler
 
-on:
-  push:
-    branches:
-      - main
-      - master
+on: workflow_dispatch
 
 permissions:
   actions: read
@@ -20,6 +16,6 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Run Labeler
-        uses: crazy-max/ghaction-github-labeler@v5.0.0
+        uses: crazy-max/ghaction-github-labeler@v5.2.0
         with:
           skip-delete: true

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Habiticalib
-Version: 0.3.5
+Version: 0.3.7rc0
 Summary: Asynchronous Python client library for the Habitica API
 Project-URL: Documentation, https://tr4nt0r.github.io/habiticalib/
 Project-URL: Source, https://github.com/tr4nt0r/habiticalib

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/pyproject.toml

@@ -4,7 +4,7 @@ line-length = 88
 
 [tool.ruff.lint]
 select = ["ALL"]
-ignore = ["TRY003", "D202", "D213", "D417", "ANN003", "ANN401", "E501", "COM812", "ISC001", "A005"]
+ignore = ["TRY003", "D202", "D213", "D417", "ANN003", "ANN401", "E501", "COM812", "ISC001"]
 
 [tool.ruff.lint.isort]
 force-sort-within-sections = true
@@ -24,7 +24,7 @@ indent-style = "space"
 max-complexity = 25
 
 [tool.ruff.lint.per-file-ignores]
-"types.py" = ["N815", "TCH003"]
+"typedefs.py" = ["N815", "TC003"]
 "tests/*" = ["SLF001", "S101", "ARG001"]
 
 [tool.pytest.ini_options]

habiticalib-0.3.7rc0/src/habiticalib/__init__.py

@@ -0,0 +1,320 @@
+"""Modern asynchronous Python client library for the Habitica API."""
+
+from .const import ASSETS_URL, DEFAULT_URL, __version__
+from .exceptions import (
+    BadRequestError,
+    HabiticaException,
+    NotAuthorizedError,
+    NotFoundError,
+    TooManyRequestsError,
+)
+from .helpers import deserialize_task, extract_avatar
+from .lib import Habitica
+from .typedefs import (
+    AchievementsUser,
+    AchievmentContent,
+    ActiveFilterTask,
+    AnimalColorAchievementContent,
+    AnimalSetAchievementContent,
+    Attributes,
+    AuthUser,
+    Avatar,
+    BackerUser,
+    BuffsStats,
+    BuffsStatsavatar,
+    CardTypes,
+    Challenge,
+    ChallengeAbortedReason,
+    ChangeClassData,
+    Checklist,
+    CommonTutorial,
+    CompletedBy,
+    ConsecutivePlan,
+    ContentData,
+    ContributorUser,
+    Direction,
+    DropTmpScore,
+    EggEntry,
+    EmailNotificationsPreferences,
+    EntryHistory,
+    EquippedGear,
+    FlagsUser,
+    Frequency,
+    GearClass,
+    GearContent,
+    GearEntry,
+    GearItems,
+    GearItemsAvatar,
+    GearType,
+    GroupTask,
+    HabiticaCastSkillResponse,
+    HabiticaClass,
+    HabiticaClassSystemResponse,
+    HabiticaContentResponse,
+    HabiticaErrorResponse,
+    HabiticaGroupMembersResponse,
+    HabiticaLoginResponse,
+    HabiticaQuestResponse,
+    HabiticaResponse,
+    HabiticaScoreResponse,
+    HabiticaSleepResponse,
+    HabiticaStatsResponse,
+    HabiticaTagResponse,
+    HabiticaTagsResponse,
+    HabiticaTaskOrderResponse,
+    HabiticaTaskResponse,
+    HabiticaTasksResponse,
+    HabiticaUserAnonymizedResponse,
+    HabiticaUserExport,
+    HabiticaUserResponse,
+    HairPreferences,
+    HatchingPotionEntry,
+    HistoryUser,
+    InboxUser,
+    InventoryItemEntry,
+    InvitationsUser,
+    IosTutorial,
+    ItemListContent,
+    ItemListEntry,
+    ItemsAvatar,
+    ItemsUser,
+    Language,
+    LastDropItems,
+    LocalAuth,
+    LocalTimestamps,
+    LoginData,
+    NotificationsUser,
+    PartyMember,
+    PartyUser,
+    PermissionsUser,
+    PetEntry,
+    PetSetCompleteAchievsContent,
+    PinnedItemsUser,
+    PlanPurchased,
+    PreferencesAvatar,
+    PreferencesUser,
+    ProfileUser,
+    ProgressQuest,
+    PurchasedUser,
+    PushDevicesUser,
+    PushNotificationsPreferences,
+    QuestBoss,
+    QuestBossRage,
+    QuestCollect,
+    QuestData,
+    QuestDrop,
+    QuestItem,
+    QuestParty,
+    QuestsAchievments,
+    QuestsContent,
+    QuestTmpScore,
+    QuestUnlockCondition,
+    Reminders,
+    Repeat,
+    ScoreData,
+    Skill,
+    SpecialItemEntry,
+    SpecialItems,
+    SpellEntry,
+    SpellsClass,
+    StableAchievementContent,
+    StatsAvatar,
+    StatsUser,
+    SuppressModalsPreferences,
+    TagsUser,
+    Task,
+    TaskData,
+    TaskFilter,
+    TaskPriority,
+    TasksOrderUser,
+    TasksPreferences,
+    TasksUserExport,
+    TaskType,
+    TmpScore,
+    TourFlags,
+    TrainingStats,
+    TutorialFlags,
+    UltimateGearSetsAchievments,
+    UserAnonymizedData,
+    UserData,
+    UserTasks,
+    WebhooksOptions,
+    WebhooksType,
+    WebhooksUser,
+)
+
+__all__ = [
+    "ASSETS_URL",
+    "DEFAULT_URL",
+    "AchievementsUser",
+    "AchievmentContent",
+    "ActiveFilterTask",
+    "AnimalColorAchievementContent",
+    "AnimalSetAchievementContent",
+    "Attributes",
+    "AuthUser",
+    "Avatar",
+    "BackerUser",
+    "BadRequestError",
+    "BuffsStats",
+    "BuffsStatsavatar",
+    "CardTypes",
+    "Challenge",
+    "ChallengeAbortedReason",
+    "ChangeClassData",
+    "ChangeClassData",
+    "Checklist",
+    "Checklist",
+    "CommonTutorial",
+    "CompletedBy",
+    "ConsecutivePlan",
+    "ContentData",
+    "ContentData",
+    "ContributorUser",
+    "Direction",
+    "DropTmpScore",
+    "EggEntry",
+    "EmailNotificationsPreferences",
+    "EntryHistory",
+    "EquippedGear",
+    "FlagsUser",
+    "Frequency",
+    "GearClass",
+    "GearContent",
+    "GearEntry",
+    "GearItems",
+    "GearItemsAvatar",
+    "GearType",
+    "GroupTask",
+    "Habitica",
+    "HabiticaCastSkillResponse",
+    "HabiticaCastSkillResponse",
+    "HabiticaClass",
+    "HabiticaClassSystemResponse",
+    "HabiticaClassSystemResponse",
+    "HabiticaContentResponse",
+    "HabiticaContentResponse",
+    "HabiticaErrorResponse",
+    "HabiticaErrorResponse",
+    "HabiticaException",
+    "HabiticaGroupMembersResponse",
+    "HabiticaGroupMembersResponse",
+    "HabiticaLoginResponse",
+    "HabiticaLoginResponse",
+    "HabiticaQuestResponse",
+    "HabiticaQuestResponse",
+    "HabiticaResponse",
+    "HabiticaResponse",
+    "HabiticaScoreResponse",
+    "HabiticaScoreResponse",
+    "HabiticaSleepResponse",
+    "HabiticaSleepResponse",
+    "HabiticaStatsResponse",
+    "HabiticaStatsResponse",
+    "HabiticaTagResponse",
+    "HabiticaTagResponse",
+    "HabiticaTagsResponse",
+    "HabiticaTagsResponse",
+    "HabiticaTaskOrderResponse",
+    "HabiticaTaskOrderResponse",
+    "HabiticaTaskResponse",
+    "HabiticaTaskResponse",
+    "HabiticaTasksResponse",
+    "HabiticaTasksResponse",
+    "HabiticaUserAnonymizedResponse",
+    "HabiticaUserAnonymizedResponse",
+    "HabiticaUserExport",
+    "HabiticaUserExport",
+    "HabiticaUserResponse",
+    "HabiticaUserResponse",
+    "HairPreferences",
+    "HatchingPotionEntry",
+    "HistoryUser",
+    "InboxUser",
+    "InventoryItemEntry",
+    "InvitationsUser",
+    "IosTutorial",
+    "ItemListContent",
+    "ItemListEntry",
+    "ItemsAvatar",
+    "ItemsUser",
+    "Language",
+    "LastDropItems",
+    "LocalAuth",
+    "LocalTimestamps",
+    "LoginData",
+    "LoginData",
+    "NotAuthorizedError",
+    "NotFoundError",
+    "NotificationsUser",
+    "PartyMember",
+    "PartyUser",
+    "PermissionsUser",
+    "PetEntry",
+    "PetSetCompleteAchievsContent",
+    "PinnedItemsUser",
+    "PlanPurchased",
+    "PreferencesAvatar",
+    "PreferencesUser",
+    "ProfileUser",
+    "ProgressQuest",
+    "PurchasedUser",
+    "PushDevicesUser",
+    "PushNotificationsPreferences",
+    "QuestBoss",
+    "QuestBossRage",
+    "QuestCollect",
+    "QuestData",
+    "QuestData",
+    "QuestDrop",
+    "QuestItem",
+    "QuestParty",
+    "QuestTmpScore",
+    "QuestUnlockCondition",
+    "QuestsAchievments",
+    "QuestsContent",
+    "Reminders",
+    "Repeat",
+    "Repeat",
+    "ScoreData",
+    "ScoreData",
+    "Skill",
+    "SpecialItemEntry",
+    "SpecialItems",
+    "SpellEntry",
+    "SpellsClass",
+    "StableAchievementContent",
+    "StatsAvatar",
+    "StatsUser",
+    "StatsUser",
+    "SuppressModalsPreferences",
+    "TagsUser",
+    "TagsUser",
+    "Task",
+    "TaskData",
+    "TaskData",
+    "TaskFilter",
+    "TaskPriority",
+    "TaskType",
+    "TasksOrderUser",
+    "TasksPreferences",
+    "TasksUserExport",
+    "TmpScore",
+    "TooManyRequestsError",
+    "TourFlags",
+    "TrainingStats",
+    "TutorialFlags",
+    "UltimateGearSetsAchievments",
+    "UserAnonymizedData",
+    "UserAnonymizedData",
+    "UserData",
+    "UserData",
+    "UserTasks",
+    "UserTasks",
+    "WebhooksOptions",
+    "WebhooksType",
+    "WebhooksUser",
+    "__version__",
+    "deserialize_task",
+    "extract_avatar",
+]

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/src/habiticalib/const.py

@@ -1,6 +1,6 @@
 """Constants for Habiticalib."""
 
-__version__ = "0.3.5"
+__version__ = "0.3.7rc0"
 
 DEFAULT_URL = "https://habitica.com/"
 ASSETS_URL = "https://habitica-assets.s3.amazonaws.com/mobileApp/images/"

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/src/habiticalib/exceptions.py

@@ -5,7 +5,7 @@ from typing import Self
 
 from multidict import CIMultiDictProxy
 
-from habiticalib.types import HabiticaErrorResponse
+from .typedefs import HabiticaErrorResponse
 
 
 class HabiticaException(Exception):  # noqa: N818

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/src/habiticalib/helpers.py

@@ -10,7 +10,7 @@ import uuid
 import aiohttp
 
 from .const import DEVELOPER_ID, __version__
-from .types import HabiticaUserResponse, UserData, UserStyles
+from .typedefs import Avatar, UserData
 
 
 def join_fields(user_fields: list[str] | str) -> str:
@@ -111,10 +111,10 @@ def get_x_client(x_client: str | None = None) -> str:
     return f"{DEVELOPER_ID} - Habiticalib/{__version__}"
 
 
-def extract_user_styles(user_data: HabiticaUserResponse) -> UserStyles:
-    """Extract user styles from a user data object."""
-    data: UserData = user_data.data
-    return UserStyles.from_dict(asdict(data))
+def extract_avatar(user_data: UserData) -> Avatar:
+    """Extract avatar defs from a user data object."""
+
+    return Avatar.from_dict(user_data.to_dict())
 
 
 def deserialize_task(value: Any) -> Any:  # noqa: PLR0911

{habiticalib-0.3.5 → habiticalib-0.3.7rc0}/src/habiticalib/lib.py

@@ -29,13 +29,14 @@ from .exceptions import (
 )
 from .helpers import (
     deserialize_task,
-    extract_user_styles,
+    extract_avatar,
     get_user_agent,
     get_x_client,
     join_fields,
 )
-from .types import (
+from .typedefs import (
     Attributes,
+    Avatar,
     Direction,
     HabiticaCastSkillResponse,
     HabiticaClass,
@@ -61,7 +62,6 @@ from .types import (
     Skill,
     Task,
     TaskFilter,
-    UserStyles,
 )
 
 if TYPE_CHECKING:
@@ -1845,12 +1845,12 @@ class Habitica:
     async def generate_avatar(  # noqa: PLR0912, PLR0915
         self,
         fp: str | IO[bytes],
-        user_styles: UserStyles | None = None,
+        avatar: Avatar | None = None,
         fmt: str | None = None,
-    ) -> UserStyles:
-        """Generate an avatar image based on the provided user styles or fetched user data.
+    ) -> Avatar:
+        """Generate an avatar image based on the provided avatar object or fetched user data.
 
-        If no `user_styles` object is provided, the method retrieves user preferences, items, and stats
+        If no `Avatar` object is provided, the method retrieves user preferences, items, and stats
         for the authenticated user and builds the avatar accordingly. The base image is initialized
         as a transparent RGBA image of size (141, 147). A mount offset is applied based on the user's
         current mount status.
@@ -1864,8 +1864,8 @@ class Habitica:
         ----------
         fp : str or IO[bytes]
             The file path or a bytes buffer to store or modify the avatar image.
-        user_styles : UserStyles, optional
-            The user style preferences, items, and stats. If not provided, the method will fetch
+        avatar : Avatar, optional
+            The user avatar preferences, items, and stats. If not provided, the method will fetch
             this data.
         fmt : str
             If a file object is used instead of a filename, the format
@@ -1873,8 +1873,8 @@ class Habitica:
 
         Returns
         -------
-        UserStyles
-            The user styles used to generate the avatar.
+        Avatar
+            The user avatar definitions used to generate the avatar.
 
         Examples
         --------
@@ -1885,13 +1885,15 @@ class Habitica:
         Using a file path:
         >>> await habitica.generate_avatar("/path/to/image/avatar.png")
         """
-        if not user_styles:
-            user_styles = extract_user_styles(
-                await self.get_user(user_fields=["preferences", "items", "stats"]),
+        if not avatar:
+            avatar = extract_avatar(
+                (
+                    await self.get_user(user_fields=["preferences", "items", "stats"])
+                ).data,
             )
-        preferences = user_styles.preferences
-        items = user_styles.items
-        stats = user_styles.stats
+        preferences = avatar.preferences
+        items = avatar.items
+        stats = avatar.stats
         mount_offset_y = 0 if items.currentMount else 24
 
         # Initializing the base image
@@ -2040,7 +2042,7 @@ class Habitica:
         else:
             image.save(fp, fmt)
 
-        return user_styles
+        return avatar
 
     async def habitipy(self) -> HabitipyAsync:
         """Create a Habitipy instance."""