Habiticalib 0.1.0a0__tar.gz → 0.1.0a2__tar.gz

{habiticalib-0.1.0a0 → habiticalib-0.1.0a2}/.github/labels.yml

@@ -25,9 +25,10 @@
 - name: duplicate
   description: This issue or pull request already exists
   color: cfd3d7
-- name: enhancement
+- name: feature
   description: New feature or request
   color: a2eeef
+  from_name: enhancement
 - name: github_actions
   description: Pull requests that update Github_actions code
   color: "000000"
@@ -49,17 +50,19 @@
 - name: question
   description: Further information is requested
   color: d876e3
-- name: refactoring
-  description: Refactoring
+- name: code quality
+  description: Code quality improvements
   color: ef67c4
-- name: removal
+  from_name: refactor
+- name: deprecation
   description: Removals and Deprecations
   color: 9ae7ea
+  from_name: removal
 - name: style
   description: Style
   color: c120e5
 - name: testing
-  description: Testing
+  description: Pull request that adds tests
   color: b1fc6f
 - name: wontfix
   description: This will not be worked on

habiticalib-0.1.0a2/.github/release-drafter.yml

@@ -0,0 +1,94 @@
+name-template: '$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+
+
+categories:
+  - title: '⚠️ Breaking changes'
+    labels:
+      - 'breaking'
+  - title: '🚀 Features'
+    labels:
+      - 'feature'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'bug'
+  - title: '⏳ Deprecations'
+    labels:
+      - 'deprecation'
+  - title: '📃 Documentation'
+    labels:
+      - 'documentation'
+  - title: '🧩 Dependency Updates'
+    labels:
+      - 'dependencies'
+      - 'github_actions'
+    collapse-after: 5
+  - title: '🧰 Maintenance'
+    labels:
+      - 'perfomance'
+      - 'refactor'
+      - 'ci'
+      - 'build'
+  - title: '🔬 Other updates'
+    labels:
+      - 'style'
+      - 'testing'
+
+autolabeler:
+  - label: 'feature'
+    title:
+      - '/adds/i'
+  - label: 'bug'
+    title:
+      - '/fix/i'
+  - label: 'code quality'
+    title:
+      - '/Refactor/i'
+  - label: 'testing'
+    title:
+      - '/test:/i'
+    files:
+      - 'test_*'
+      - 'conftest.py'
+  - label: 'documentation'
+    title:
+      - '/docs:/i'
+    files:
+      - '*.md'
+      - 'mkdocs.yml'
+  - label: 'ci'
+    title:
+      - '/ci:/i'
+    files:
+      - '.github/*'
+  - label: 'dependencies'
+    title:
+      - '/bump/i'
+  - label: 'deprecation'
+    title:
+      - '/Deprecate/i'
+
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+exclude-contributors:
+  - 'tr4nt0r'
+
+version-resolver:
+  major:
+    labels:
+      - 'major'
+  minor:
+    labels:
+      - 'minor'
+  patch:
+    labels:
+      - 'patch'
+  default: patch
+
+template: |
+  ## Changes
+
+  $CHANGES
+
+  Special thanks to: $CONTRIBUTORS

habiticalib-0.1.0a2/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.3
+Name: Habiticalib
+Version: 0.1.0a2
+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
+Author-email: Manfred Dennerlein Rodelo <manfred@dennerlein.name>
+License: MIT License
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.12
+Requires-Dist: aiohttp~=3.9
+Requires-Dist: mashumaro~=3.13
+Requires-Dist: orjson~=3.10
+Requires-Dist: pillow~=10.4
+Description-Content-Type: text/markdown
+
+# Habiticalib
+
+<p align="center">
+    <em>Modern asynchronous Python client library for the Habitica API</em>
+</p>
+
+[![build](https://github.com/tr4nt0r/habiticalib/workflows/Build/badge.svg)](https://github.com/tr4nt0r/habiticalib/actions)
+[![codecov](https://codecov.io/gh/tr4nt0r/habiticalib/graph/badge.svg?token=iEsZ1Ktj7d)](https://codecov.io/gh/tr4nt0r/habiticalib)
+[![PyPI version](https://badge.fury.io/py/habiticalib.svg)](https://badge.fury.io/py/habiticalib)
+
+**Habiticalib** is a Python library for interacting with the [Habitica API](https://habitica.com). It provides an organized, typed interface to work with Habitica’s features, including tasks, user data, and avatars. The goal of this library is to simplify integration with Habitica.
+
+## Key features
+
+- **Asynchronous**: The library is fully asynchronous, allowing non-blocking API calls.
+- **Fully typed with Dataclasses**: The library is fully typed using Python `dataclasses`. It handles serialization with `mashumaro` and `orjson` for efficient conversion between Habitica API JSON data and Python objects.
+- **Dynamic avatar image generation**: Habiticalib can fetch all necessary assets (like equipped items, pets, and mounts) and combine them into a single avatar image. This image can be saved to disk or returned as a byte buffer for further processing.
+ **Fetch user data**: Retrieve and manage user data such as stats, preferences, and items. User data is structured with dataclasses to make it easy to work with.
+- **Task management**: Support for creating, updating, and retrieving Habitica tasks (to-dos, dailies, habits, rewards) is provided.
+- **Task status updates**: The library allows updates for task statuses, habit scoring, and daily completion.
+- **Tags**: Habiticalib supports the creation, updating and deletion of tags.
+-  **Stat allocation, class cystem and sleep**: The library offers methods for stat point allocation and switching between Habitica classes. It also provides the ability to disable the class system and pausing damage(resting in the inn)
+
+## Installation
+
+```bash
+pip install habiticalib
+```
+
+## Getting started
+Here’s an example to demonstrate basic usage:
+
+```python
+import asyncio
+
+from aiohttp import ClientSession
+
+from habiticalib import Habitica, TaskType
+
+
+async def main():
+    async with ClientSession() as session:
+       habitica = Habitica(session)
+
+       # Login to Habitica
+       habitica.login(username="your_username", password="your_password")
+
+       # Fetch user data
+       user_data = await habitica.user()
+       print(f"Your current health: {user_data.stats.hp}")
+
+        # Fetch all tasks (to-dos, dailies, habits, and rewards)
+        tasks = await habitica.get_tasks()
+        print("All tasks:")
+        for task in tasks:
+            print(f"- {task.text} (type: {task.type})")
+
+        # Fetch only to-dos
+        todos = await habitica.get_tasks(task_type=TaskType.TODO)
+        print("\nTo-Do tasks:")
+        for todo in todos:
+            print(f"- {todo.text} (due: {todo.date})")
+
+        # Fetch only dailies
+        dailies = await habitica.tasks(task_type=TaskType.DAILY)
+        print("\nDailies:")
+        for daily in dailies:
+            print(f"- {daily.text}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+For full documentation and detailed usage examples, please visit the [Habiticalib documentation](https://tr4nt0r.github.io/habiticalib/).
+
+## License
+
+This project is licensed under the terms of the MIT license.

habiticalib-0.1.0a2/README.md

@@ -0,0 +1,79 @@
+# Habiticalib
+
+<p align="center">
+    <em>Modern asynchronous Python client library for the Habitica API</em>
+</p>
+
+[![build](https://github.com/tr4nt0r/habiticalib/workflows/Build/badge.svg)](https://github.com/tr4nt0r/habiticalib/actions)
+[![codecov](https://codecov.io/gh/tr4nt0r/habiticalib/graph/badge.svg?token=iEsZ1Ktj7d)](https://codecov.io/gh/tr4nt0r/habiticalib)
+[![PyPI version](https://badge.fury.io/py/habiticalib.svg)](https://badge.fury.io/py/habiticalib)
+
+**Habiticalib** is a Python library for interacting with the [Habitica API](https://habitica.com). It provides an organized, typed interface to work with Habitica’s features, including tasks, user data, and avatars. The goal of this library is to simplify integration with Habitica.
+
+## Key features
+
+- **Asynchronous**: The library is fully asynchronous, allowing non-blocking API calls.
+- **Fully typed with Dataclasses**: The library is fully typed using Python `dataclasses`. It handles serialization with `mashumaro` and `orjson` for efficient conversion between Habitica API JSON data and Python objects.
+- **Dynamic avatar image generation**: Habiticalib can fetch all necessary assets (like equipped items, pets, and mounts) and combine them into a single avatar image. This image can be saved to disk or returned as a byte buffer for further processing.
+ **Fetch user data**: Retrieve and manage user data such as stats, preferences, and items. User data is structured with dataclasses to make it easy to work with.
+- **Task management**: Support for creating, updating, and retrieving Habitica tasks (to-dos, dailies, habits, rewards) is provided.
+- **Task status updates**: The library allows updates for task statuses, habit scoring, and daily completion.
+- **Tags**: Habiticalib supports the creation, updating and deletion of tags.
+-  **Stat allocation, class cystem and sleep**: The library offers methods for stat point allocation and switching between Habitica classes. It also provides the ability to disable the class system and pausing damage(resting in the inn)
+
+## Installation
+
+```bash
+pip install habiticalib
+```
+
+## Getting started
+Here’s an example to demonstrate basic usage:
+
+```python
+import asyncio
+
+from aiohttp import ClientSession
+
+from habiticalib import Habitica, TaskType
+
+
+async def main():
+    async with ClientSession() as session:
+       habitica = Habitica(session)
+
+       # Login to Habitica
+       habitica.login(username="your_username", password="your_password")
+
+       # Fetch user data
+       user_data = await habitica.user()
+       print(f"Your current health: {user_data.stats.hp}")
+
+        # Fetch all tasks (to-dos, dailies, habits, and rewards)
+        tasks = await habitica.get_tasks()
+        print("All tasks:")
+        for task in tasks:
+            print(f"- {task.text} (type: {task.type})")
+
+        # Fetch only to-dos
+        todos = await habitica.get_tasks(task_type=TaskType.TODO)
+        print("\nTo-Do tasks:")
+        for todo in todos:
+            print(f"- {todo.text} (due: {todo.date})")
+
+        # Fetch only dailies
+        dailies = await habitica.tasks(task_type=TaskType.DAILY)
+        print("\nDailies:")
+        for daily in dailies:
+            print(f"- {daily.text}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+For full documentation and detailed usage examples, please visit the [Habiticalib documentation](https://tr4nt0r.github.io/habiticalib/).
+
+## License
+
+This project is licensed under the terms of the MIT license.

{habiticalib-0.1.0a0 → habiticalib-0.1.0a2}/pyproject.toml

@@ -25,7 +25,7 @@ max-complexity = 25
 
 [tool.ruff.lint.per-file-ignores]
 "types.py" = ["N815"]
-"tests/*" = ["SLF001", "S101"]
+"tests/*" = ["SLF001", "S101", "ARG001"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
@@ -61,7 +61,7 @@ allow-direct-references = true
 [tool.hatch.version]
 source = "regex_commit"
 commit_extra_args = ["-e"]
-path = "src/habiticalib/__init__.py"
+path = "src/habiticalib/const.py"
 
 [tool.hatch.envs.default]
 python = "3.12"

habiticalib-0.1.0a2/src/habiticalib/__init__.py

@@ -0,0 +1,69 @@
+"""Modern asynchronous Python client library for the Habitica API."""
+
+from .const import ASSETS_URL, DEFAULT_URL, __version__
+from .exceptions import (
+    BadRequestError,
+    HabiticaException,
+    NotAuthorizedError,
+    NotFoundError,
+)
+from .lib import Habitica
+from .types import (
+    Attributes,
+    Class,
+    Direction,
+    Frequency,
+    HabiticaClassSystemResponse,
+    HabiticaErrorResponse,
+    HabiticaLoginResponse,
+    HabiticaResponse,
+    HabiticaScoreResponse,
+    HabiticaStatsResponse,
+    HabiticaTagResponse,
+    HabiticaTagsResponse,
+    HabiticaTaskOrderResponse,
+    HabiticaTaskResponse,
+    HabiticaTasksResponse,
+    HabiticaUserExport,
+    HabiticaUserResponse,
+    Language,
+    Skill,
+    Task,
+    TaskFilter,
+    TaskType,
+    UserStyles,
+)
+
+__all__ = [
+    "__version__",
+    "ASSETS_URL",
+    "Attributes",
+    "BadRequestError",
+    "Class",
+    "DEFAULT_URL",
+    "Direction",
+    "Frequency",
+    "Habitica",
+    "HabiticaClassSystemResponse",
+    "HabiticaErrorResponse",
+    "HabiticaException",
+    "HabiticaLoginResponse",
+    "HabiticaResponse",
+    "HabiticaScoreResponse",
+    "HabiticaStatsResponse",
+    "HabiticaTagResponse",
+    "HabiticaTagsResponse",
+    "HabiticaTaskOrderResponse",
+    "HabiticaTaskResponse",
+    "HabiticaTasksResponse",
+    "HabiticaUserExport",
+    "HabiticaUserResponse",
+    "Language",
+    "NotAuthorizedError",
+    "NotFoundError",
+    "Skill",
+    "Task",
+    "TaskFilter",
+    "TaskType",
+    "UserStyles",
+]

{habiticalib-0.1.0a0 → habiticalib-0.1.0a2}/src/habiticalib/const.py

@@ -1,5 +1,7 @@
 """Constants for Habiticalib."""
 
+__version__ = "0.1.0a2"
+
 DEFAULT_URL = "https://habitica.com/"
 ASSETS_URL = "https://habitica-assets.s3.amazonaws.com/mobileApp/images/"
 

{habiticalib-0.1.0a0 → habiticalib-0.1.0a2}/src/habiticalib/exceptions.py

@@ -2,15 +2,25 @@
 
 from typing import Self
 
+from multidict import CIMultiDictProxy
+
 from habiticalib.types import HabiticaErrorResponse
 
 
 class HabiticaException(Exception):  # noqa: N818
     """Base class for Habitica errors."""
 
-    def __init__(self: Self, error: HabiticaErrorResponse) -> None:
+    def __init__(
+        self: Self,
+        error: HabiticaErrorResponse,
+        headers: CIMultiDictProxy,
+    ) -> None:
         """Initialize the Exception."""
         self.error = error
+        self.rate_limit = headers.get("x-ratelimit-limit")
+        self.rate_limit_remaining = headers.get("x-ratelimit-remaining")
+        self.rate_limit_reset = headers.get("x-ratelimit-reset")
+        self.retry_after = headers.get("retry-after")
 
         super().__init__(error.message)
 
@@ -25,3 +35,7 @@ class NotFoundError(HabiticaException):
 
 class BadRequestError(HabiticaException):
     """BadRequest error."""
+
+
+class TooManyRequestsError(HabiticaException):
+    """TooManyRequests error."""

{habiticalib-0.1.0a0 → habiticalib-0.1.0a2}/src/habiticalib/helpers.py

@@ -1,13 +1,12 @@
 """Helper functions for Habiticalib."""
 
 from dataclasses import asdict
-from importlib.metadata import version
 import platform
 import uuid
 
 import aiohttp
 
-from .const import DEVELOPER_ID
+from .const import DEVELOPER_ID, __version__
 from .types import HabiticaUserResponse, UserData, UserStyles
 
 
@@ -58,7 +57,7 @@ def get_user_agent() -> str:
     os_info = f"{os_name} {os_release} ({os_version}); {arch}"
 
     return (
-        f"Habiticalib/{version("habiticalib")} ({os_info}) "
+        f"Habiticalib/{__version__} ({os_info}) "
         f"aiohttp/{aiohttp.__version__} Python/{platform.python_version()} "
         " +https://github.com/tr4nt0r/habiticalib)"
     )
@@ -106,7 +105,7 @@ def get_x_client(x_client: str | None = None) -> str:
 
         return x_client
 
-    return f"{DEVELOPER_ID} - Habiticalib/{version("habiticalib")}"
+    return f"{DEVELOPER_ID} - Habiticalib/{__version__}"
 
 
 def extract_user_styles(user_data: HabiticaUserResponse) -> UserStyles: