warframe-market.py 1.0.0__tar.gz

warframe_market_py-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: publish
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Hatch
+        run: python -m pip install --upgrade hatch
+      - name: Build package
+        run: hatch build
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.9'
+      - name: Install Hatch
+        run: python -m pip install --upgrade hatch
+      - name: Build package
+        run: hatch build
+      - name: Publish to PyPI
+        env:
+          HATCH_INDEX_USER: "__token__"
+          HATCH_INDEX_AUTH: ${{ secrets.PYPI_TOKEN }}
+        run: hatch publish --yes

warframe_market_py-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+venv
+env
+**.ipynb
+__pycache__
+dist

warframe_market_py-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aldi Filopati
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

warframe_market_py-1.0.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: warframe-market.py
+Version: 1.0.0
+Summary: An asynchronous Python wrapper for Warframe.Market API
+Project-URL: Homepage, https://github.com/aldi-f/warframe-market.py
+Author: aldi-f
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: aiohttp==3.12.6
+Requires-Dist: msgspec==0.19.0

warframe_market_py-1.0.0/README.md

@@ -0,0 +1,32 @@
+# warframe-market.py
+> **Warning**: This project is still in development and is not yet ready for production use.
+
+Warframe Market API for Python
+
+# Installation
+```bash
+pip install warframe-market.py
+```
+
+# Usage
+```python
+import asyncio
+from warframe_market.client import WarframeMarketClient
+from warframe_market.api.item import Items, Item
+
+async def main():
+    async with WarframeMarketClient() as client:
+        # Get all items in English
+        items = await client.get(Items)
+        for item in items.data:
+            print(item.i18n["en"].name)
+        
+        # Get a single item 
+        item = await client.get(Item,"nova_prime_set")
+        print(item)
+
+if __name__ == "__main__":
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(main())
+    loop.close()
+```

warframe_market_py-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "warframe-market.py"
+description = "An asynchronous Python wrapper for Warframe.Market API"
+authors = [{ name = "aldi-f" }]
+dependencies = ["aiohttp==3.12.6", "msgspec==0.19.0"]
+dynamic = ["version"]
+requires-python = ">=3.9"
+
+[project.urls]
+Homepage = "https://github.com/aldi-f/warframe-market.py"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.metadata]
+allow-direct-url = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["warframe_market"]
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.pyright]
+venvPath = "."
+venv = "venv"

warframe_market_py-1.0.0/requirements.txt

@@ -0,0 +1,2 @@
+aiohttp==3.12.6
+msgspec==0.19.0

warframe_market_py-1.0.0/warframe_market/api/__init__.py

@@ -0,0 +1,40 @@
+from .item import (
+    Items,
+    Item,
+    ItemSet,
+)
+from .lich import (
+    LichWeapons,
+    LichWeapon,
+    LichEphemeras,
+    LichQuirks,
+)
+
+from .misc import (
+    Locations,
+    Missions,
+    NPCs,
+    Versions,
+)
+from .order import (
+    OrdersItem,
+    OrdersItemTop,
+    OrdersUser,
+    OrderId,
+)
+
+from .riven import (
+    Rivens,
+    Riven,
+    RivenAttributes,
+)
+
+from .sister import (
+    SisterWeapons,
+    SisterWeapon,
+    SisterEphemeras,
+    SisterQuirks,
+)
+from .user import (
+    User,
+)

warframe_market_py-1.0.0/warframe_market/api/item.py

@@ -0,0 +1,42 @@
+import msgspec
+from typing import List
+from ..common.base import BaseRequest
+from ..models.item import ItemShortModel, ItemModel
+
+
+class Items(BaseRequest):
+    """Get list of all tradable items"""
+
+    __endpoint__ = "/items"
+
+    data: List[ItemShortModel]
+
+
+class Item(BaseRequest):
+    """Get full info about one, particular item. Requires slug"""
+
+    __endpoint__ = "/item/{slug}"
+    __slug__ = True
+
+    data: ItemModel
+
+
+class _ItemSetData(msgspec.Struct):
+    """Internal model for ItemSet data
+
+    Attributes:
+        id (str): Unique identifier for the item set
+        items (List[ItemModel]): List of items in the set
+    """
+
+    id: str
+    items: List[ItemModel]
+
+
+class ItemSet(BaseRequest):
+    """Retrieve Information on Item Sets. Requires slug"""
+
+    __endpoint__ = "/item/{slug}/set"
+    __slug__ = True
+
+    data: _ItemSetData

warframe_market_py-1.0.0/warframe_market/api/lich.py

@@ -0,0 +1,36 @@
+from typing import List
+from ..common.base import BaseRequest
+from ..models.lich import LichWeaponModel, LichEphemeraModel, LichQuirkModel
+
+
+class LichWeapons(BaseRequest):
+    """Get list of all tradable lich weapons"""
+
+    __endpoint__ = "/lich/weapons"
+
+    data: List[LichWeaponModel]
+
+
+class LichWeapon(BaseRequest):
+    """Get full info about one, particular lich weapon. Requires slug"""
+
+    __endpoint__ = "/lich/weapon/{slug}"
+    __slug__ = True
+
+    data: LichWeaponModel
+
+
+class LichEphemeras(BaseRequest):
+    """Get list of all tradable lich ephemeras"""
+
+    __endpoint__ = "/lich/ephemeras"
+
+    data: List[LichEphemeraModel]
+
+
+class LichQuirks(BaseRequest):
+    """Get list of all tradable lich quirks"""
+
+    __endpoint__ = "/lich/quirks"
+
+    data: List[LichQuirkModel]

warframe_market_py-1.0.0/warframe_market/api/misc.py

@@ -0,0 +1,62 @@
+import msgspec
+from datetime import datetime
+from typing import List
+from ..common.base import BaseRequest
+from ..models.location import LocationModel
+from ..models.npc import NpcModel
+from ..models.mission import MissionModel
+
+
+class _AppsData(msgspec.Struct):
+    ios: str
+    android: str
+    minIos: str
+    minAndroid: str
+
+
+class _CollectionsData(msgspec.Struct):
+    items: str
+    rivens: str
+    liches: str
+    sisters: str
+    missions: str
+    npcs: str
+    locations: str
+
+
+class _VersionData(msgspec.Struct):
+    apps: _AppsData
+    collections: _CollectionsData
+    updatedAt: datetime
+
+
+class Versions(BaseRequest):
+    """Get current API version"""
+
+    __endpoint__ = "/versions"
+
+    data: _VersionData
+
+
+class Locations(BaseRequest):
+    """Get list of all tradable lich weapons"""
+
+    __endpoint__ = "/locations"
+
+    data: List[LocationModel]
+
+
+class NPCs(BaseRequest):
+    """Get list of all NPCs"""
+
+    __endpoint__ = "/npcs"
+
+    data: List[NpcModel]
+
+
+class Missions(BaseRequest):
+    """Get list of all missions"""
+
+    __endpoint__ = "/missions"
+
+    data: List[MissionModel]

warframe_market_py-1.0.0/warframe_market/api/order.py

@@ -0,0 +1,96 @@
+import msgspec
+from typing import List
+from ..common.base import BaseRequest
+from ..models.order import OrderModel, OrderWithUserModel
+
+
+class OrdersRecent(BaseRequest):
+    """Get the most recent orders.
+    500 max, for the last 4 hours, sorted by createdAt
+    """
+
+    __endpoint__ = "/orders/recent"
+
+    data: List[OrderWithUserModel]
+
+
+class OrdersItem(BaseRequest):
+    """Get a list of all orders for an item from users
+    who was online within the last 7 days.
+
+    Requires slug of the item.
+    """
+
+    __endpoint__ = "/orders/item/{slug}"
+    __slug__ = True
+
+    data: List[OrderWithUserModel]
+
+
+class _OrdersItemData(msgspec.Struct):
+    """Internal model for OrdersItemTop data
+
+    Attributes:
+        buy (List[OrderWithUserModel]): List of top buy orders
+        sell (List[OrderWithUserModel]): List of top sell orders
+    """
+
+    buy: List[OrderWithUserModel]
+    sell: List[OrderWithUserModel]
+
+
+class OrdersItemTop(BaseRequest):
+    """This endpoint is designed to fetch the top 5 buy
+    and top 5 sell orders for a specific item, exclusively from online users.
+    Orders are sorted by price.
+
+    Available query parameters:
+    - rank: Filter by rank (e.g., 0, 1, 2, etc.)
+    - rankLt: Filter by rank less than specified value
+    - charges: Filter by charges (e.g., 0, 1, 2, etc.)
+    - chargesLt: Filter by charges less than specified value
+    - amberStars: Filter by amber stars (e.g., 0, 1, 2, etc.)
+    - amberStarsLt: Filter by amber stars less than specified value
+    - cyanStars: Filter by cyan stars (e.g., 0, 1, 2, etc.)
+    - cyanStarsLt: Filter by cyan stars less than specified value
+    - subtype: Filter by Item subtype (e.g. "blueprint", "crafted)
+
+    Requires slug of the item.
+    """
+
+    __endpoint__ = "/orders/item/{slug}/top"
+    __params__ = [
+        "rank",
+        "rankLt",
+        "charges",
+        "chargesLt",
+        "amberStars",
+        "amberStarsLt",
+        "cyanStars",
+        "cyanStarsLt",
+        "subtype",
+    ]
+    __slug__ = True
+
+    data: _OrdersItemData
+
+
+class OrdersUser(BaseRequest):
+    """Getting public orders from specified user.
+
+    Requires user ID (same as slug)
+    """
+
+    __endpoint__ = "/orders/user/{slug}"
+    __slug__ = True
+
+    data: List[OrderModel]
+
+
+class OrderId(BaseRequest):
+    """Get full info about one, particular order. Requires order ID (same as slug)"""
+
+    __endpoint__ = "/order/{slug}"
+    __slug__ = True
+
+    data: OrderWithUserModel

warframe_market_py-1.0.0/warframe_market/api/riven.py

@@ -0,0 +1,29 @@
+import msgspec
+from typing import List
+from ..common.base import BaseRequest
+from ..models.riven import RivenModel, RivenAttributeModel
+
+
+class Rivens(BaseRequest):
+    """Get list of all tradable riven items"""
+
+    __endpoint__ = "/riven/weapons"
+
+    data: List[RivenModel]
+
+
+class Riven(BaseRequest):
+    """Get full info about one, particular riven item. Requires slug"""
+
+    __endpoint__ = "/riven/weapon/{slug}"
+    __slug__ = True
+
+    data: RivenModel
+
+
+class RivenAttributes(BaseRequest):
+    """Get list of all attributes for riven weapons"""
+
+    __endpoint__ = "/riven/attributes"
+
+    data: List[RivenAttributeModel]

warframe_market_py-1.0.0/warframe_market/api/sister.py

@@ -0,0 +1,36 @@
+from typing import List
+from ..common.base import BaseRequest
+from ..models.sister import SisterWeaponModel, SisterEphemeraModel, SisterQuirkModel
+
+
+class SisterWeapons(BaseRequest):
+    """Get list of all tradable sister weapons"""
+
+    __endpoint__ = "/sister/weapons"
+
+    data: List[SisterWeaponModel]
+
+
+class SisterWeapon(BaseRequest):
+    """Get full info about one, particular sister weapon. Requires slug"""
+
+    __endpoint__ = "/sister/weapon/{slug}"
+    __slug__ = True
+
+    data: SisterWeaponModel
+
+
+class SisterEphemeras(BaseRequest):
+    """Get list of all tradable sister ephemeras"""
+
+    __endpoint__ = "/sister/ephemeras"
+
+    data: List[SisterEphemeraModel]
+
+
+class SisterQuirks(BaseRequest):
+    """Get list of all tradable sister quirks"""
+
+    __endpoint__ = "/sister/quirks"
+
+    data: List[SisterQuirkModel]

warframe_market_py-1.0.0/warframe_market/api/user.py

@@ -0,0 +1,16 @@
+import msgspec
+from typing import List
+from ..common.base import BaseRequest
+from ..models.user import UserModel
+
+
+class User(BaseRequest):
+    """Getting information about particular user
+
+    Requires user ID (same as slug)
+    """
+
+    __endpoint__ = "/userId/{slug}"
+    __slug__ = True
+
+    data: UserModel

warframe_market_py-1.0.0/warframe_market/client.py

@@ -0,0 +1,42 @@
+import aiohttp
+from typing import TypeVar, Type
+from .common import BASE_URL
+from .common.base import BaseRequest
+
+T = TypeVar("T", bound=BaseRequest)
+
+
+class WarframeMarketClient:
+    """Client for interacting with Warframe Market API."""
+
+    def __init__(self, base_url: str = BASE_URL):
+        self.base_url = base_url
+        self.response = None
+
+    async def get(self, request_class: Type[T], slug="", **kwargs) -> T:
+        """Perform a GET request using the specified request class.
+
+        Args:
+            request_class: The request class that defines the endpoint and response type
+            slug: Optional slug to append to the endpoint URL
+            **kwargs: Additional query parameters to include in the request
+
+        Returns:
+            The parsed API response
+        """
+        endpoint = request_class._get_endpoint(slug=slug, **kwargs)
+        url = f"{self.base_url}{endpoint}"
+        async with aiohttp.ClientSession() as session:
+            async with session.get(url) as response:
+                if response.status != 200:
+                    raise Exception(f"Error {response.status}: {await response.text()}")
+                data = await response.text()
+                return request_class._decode(data)
+
+    async def __aenter__(self):
+        """Enter async context manager."""
+        return self
+
+    async def __aexit__(self, exc_type, exc_value, traceback):
+        """Exit async context manager."""
+        pass

warframe_market_py-1.0.0/warframe_market/common/__init__.py

@@ -0,0 +1,17 @@
+
+BASE_URL = "https://api.warframe.market/v2"
+BASE_STATIC_ASSETS_URL = "https://warframe.market/static/assets"
+
+from .enums import (
+    Language,
+    Platform,
+)
+
+from .base import (
+    Base,
+    BaseRequest,
+)
+
+from .options import (
+    LanguageCode,
+)

warframe_market_py-1.0.0/warframe_market/common/base.py

@@ -0,0 +1,57 @@
+import msgspec
+from datetime import datetime
+from typing import TypeVar, ClassVar, Type, Optional, Any, List
+
+
+def _dec_hook(type: Type, obj: Any) -> Any:
+
+    # Decode UTC dates
+    if isinstance(type, datetime) and isinstance(obj, str):
+        return datetime.fromisoformat(obj.strip("Z"))
+
+    # Will add more when needed
+
+    return obj
+
+
+class Base(msgspec.Struct, kw_only=True):
+    """Base model"""
+
+    api_version: str = msgspec.field(name="apiVersion")
+    error: Optional[Any] = None
+
+
+T = TypeVar("T", bound=Base)
+
+
+class BaseRequest(Base):
+    """Base model for all Warframe Market API requests.
+
+    Attributes:
+        __endpoint__: The API endpoint for the request.
+        __params__: List of query parameters that can be used in the request.
+        __slug__: Whether the request requires a slug in the endpoint.
+    """
+
+    __endpoint__: ClassVar[str]
+    __params__: ClassVar[List[str]] = []
+    __slug__: ClassVar[bool] = False
+
+    @classmethod
+    def _decode(cls: Type[T], response: str) -> T:
+        """Decode the response string into a BaseResponse object."""
+        return msgspec.json.decode(response, type=cls, dec_hook=_dec_hook)
+
+    @classmethod
+    def _get_endpoint(cls, slug: Optional[str] = None, **kwargs) -> str:
+        """Build the endpoint URL with optional slug and query parameters."""
+        endpoint = cls.__endpoint__
+        if cls.__slug__ and slug:
+            endpoint = endpoint.format(slug=slug)
+        if cls.__params__:
+            params = "&".join(
+                f"{k}={v}" for k, v in kwargs.items() if k in cls.__params__
+            )
+            if params:
+                endpoint += f"?{params}"
+        return endpoint

warframe_market_py-1.0.0/warframe_market/common/enums.py

@@ -0,0 +1,30 @@
+from enum import Enum
+
+
+class Language(Enum):
+    KOREAN = "ko"
+    RUSSIAN = "ru"
+    GERMAN = "de"
+    FRENCH = "fr"
+    PORTUGUESE = "pt"
+    CHINESE_SIMPLIFIED = "zh-hans"
+    CHINESE_TRADITIONAL = "zh-hant"
+    SPANISH = "es"
+    ITALIAN = "it"
+    POLISH = "pl"
+    UKRAINIAN = "uk"
+    ENGLISH = "en"
+
+    def __str__(self):
+        return self.value
+
+
+class Platform(Enum):
+    PC = "pc"
+    PS4 = "ps4"
+    XBOX = "xbox"
+    SWITCH = "switch"
+    MOBILE = "mobile"
+
+    def __str__(self):
+        return self.value

warframe_market_py-1.0.0/warframe_market/common/options.py

@@ -0,0 +1,3 @@
+from typing import Literal
+
+LanguageCode = Literal["en", "es", "fr", "de", "it", "ko", "pl", "pt", "ru", "zh-hans", "zh-hant", "uk"]

warframe_market_py-1.0.0/warframe_market/models/achievement.py

@@ -0,0 +1,34 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+class AchievementI18NModel(msgspec.Struct):
+    """
+    Localized information for an achievement.
+
+    Attributes:
+        name: Localized name of the achievement
+        description: Localized description of the achievement
+    """
+
+    name: str
+    description: str
+
+
+class AchievementModel(msgspec.Struct):
+    """
+    Model for site achievements.
+
+    Attributes:
+        id: Unique identifier for the achievement
+        icon: URL to the achievement's icon
+        thumb: URL to the achievement's thumbnail image
+        type: Type or category of the achievement
+        i18n: Localized text in various languages
+    """
+
+    id: str
+    icon: str
+    thumb: str
+    type: str
+    i18n: dict[LanguageCode, AchievementI18NModel]

warframe_market_py-1.0.0/warframe_market/models/activity.py

@@ -0,0 +1,27 @@
+from typing import Optional
+import msgspec
+from enum import Enum
+
+
+class ActivityType(str, Enum):
+    """Types of activities a user can be engaged in."""
+
+    ON_MISSION = "on_mission"
+    DOJO = "dojo"
+    UNKNOWN = "unknown"
+    EMPTY = ""
+
+
+class ActivityModel(msgspec.Struct):
+    """
+    Model for user activity information.
+
+    Attributes:
+        type: Name of the activity (e.g., 'on mission', 'dojo')
+        details: Optional specifics about the activity
+        started_at: Timestamp of when the activity started
+    """
+
+    type: ActivityType
+    details: Optional[str] = None
+    started_at: Optional[str] = msgspec.field(default=None, name="startedAt")

warframe_market_py-1.0.0/warframe_market/models/item.py

@@ -0,0 +1,48 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+class ItemI18NModel(msgspec.Struct):
+    """Localization data for an item."""
+
+    name: str
+    icon: str
+    thumb: str
+    description: str | None = None
+    wiki_link: str | None = msgspec.field(default=None, name="wikiLink")
+    sub_icon: str | None = msgspec.field(default=None, name="subIcon")
+
+
+class ItemShortModel(msgspec.Struct):
+    """Short form item data model."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    tags: list[str] = msgspec.field(default_factory=list)
+    i18n: dict[LanguageCode, ItemI18NModel] = msgspec.field(default_factory=dict)
+    max_rank: int | None = msgspec.field(default=None, name="maxRank")
+    max_charges: int | None = msgspec.field(default=None, name="maxCharges")
+    vaulted: bool | None = None
+    ducats: int | None = None
+    amber_stars: int | None = msgspec.field(default=None, name="amberStars")
+    cyan_stars: int | None = msgspec.field(default=None, name="cyanStars")
+    base_endo: int | None = msgspec.field(default=None, name="baseEndo")
+    endo_multiplier: float | None = msgspec.field(default=None, name="endoMultiplier")
+    subtypes: list[str] = msgspec.field(default_factory=list)
+
+
+class ItemModel(ItemShortModel):
+    """Full item data model that extends ItemShortModel."""
+
+    tradable: bool | None = None
+    set_root: bool | None = msgspec.field(default=None, name="setRoot")
+    set_parts: list[str] | None = msgspec.field(default=None, name="setParts")
+    quantity_in_set: int | None = msgspec.field(default=None, name="quantityInSet")
+    rarity: str | None = None
+    bulk_tradable: bool | None = msgspec.field(default=None, name="bulkTradable")
+    max_amber_stars: int | None = msgspec.field(default=None, name="maxAmberStars")
+    max_cyan_stars: int | None = msgspec.field(default=None, name="maxCyanStars")
+    req_mastery_rank: int | None = msgspec.field(default=None, name="reqMasteryRank")
+    trading_tax: int | None = msgspec.field(default=None, name="tradingTax")
+    vosfor: int | None = None

warframe_market_py-1.0.0/warframe_market/models/lich.py

@@ -0,0 +1,63 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+# Lich Weapon
+class LichWeaponI18NModel(msgspec.Struct):
+    """Localization data for a Lich weapon."""
+
+    name: str = msgspec.field(name="itemName")  # Changed to match Go struct's json tag
+    icon: str
+    thumb: str
+    wiki_link: str | None = msgspec.field(default=None, name="wikiLink")
+
+
+class LichWeaponModel(msgspec.Struct):
+    """Model for Kuva/Sister Lich weapons."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    req_mastery_rank: int = msgspec.field(name="reqMasteryRank")
+    i18n: dict[LanguageCode, LichWeaponI18NModel] = msgspec.field(default_factory=dict)
+
+
+# Lich Ephemera
+class LichEphemeraI18NModel(msgspec.Struct):
+    """Localization data for a Lich ephemera."""
+
+    name: str = msgspec.field(name="itemName")
+    icon: str
+    thumb: str
+
+
+class LichEphemeraModel(msgspec.Struct):
+    """Model for Kuva/Sister Lich ephemeras."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    animation: str
+    element: str
+    i18n: dict[LanguageCode, LichEphemeraI18NModel] = msgspec.field(
+        default_factory=dict
+    )
+
+
+# Lich Quirk
+class LichQuirkI18NModel(msgspec.Struct):
+    """Localization data for a Lich quirk."""
+
+    name: str = msgspec.field(name="itemName")
+    description: str | None = None
+    icon: str | None = None
+    thumb: str | None = None
+
+
+class LichQuirkModel(msgspec.Struct):
+    """Model for Kuva/Sister Lich quirks."""
+
+    id: str
+    slug: str
+    group: str | None = None
+    i18n: dict[LanguageCode, LichQuirkI18NModel] = msgspec.field(default_factory=dict)

warframe_market_py-1.0.0/warframe_market/models/location.py

@@ -0,0 +1,23 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+class LocationI18NModel(msgspec.Struct):
+    """Localization data for a location."""
+
+    node_name: str = msgspec.field(name="nodeName")
+    icon: str
+    thumb: str
+    system_name: str | None = msgspec.field(default=None, name="systemName")
+
+
+class LocationModel(msgspec.Struct):
+    """Model for locations."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    faction: str | None = None
+    min_level: int | None = msgspec.field(default=None, name="minLevel")
+    max_level: int | None = msgspec.field(default=None, name="maxLevel")
+    i18n: dict[LanguageCode, LocationI18NModel] = msgspec.field(default_factory=dict)

warframe_market_py-1.0.0/warframe_market/models/mission.py

@@ -0,0 +1,19 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+class MissionI18NModel(msgspec.Struct):
+    """Localization data for a mission."""
+
+    name: str
+    icon: str | None = None
+    thumb: str | None = None
+
+
+class MissionModel(msgspec.Struct):
+    """Model for missions."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    i18n: dict[LanguageCode, MissionI18NModel] = msgspec.field(default_factory=dict)

warframe_market_py-1.0.0/warframe_market/models/npc.py

@@ -0,0 +1,19 @@
+import msgspec
+from ..common.options import LanguageCode
+
+
+class NpcI18NModel(msgspec.Struct):
+    """Localization data for an NPC."""
+
+    name: str
+    icon: str
+    thumb: str
+
+
+class NpcModel(msgspec.Struct):
+    """Model for NPCs."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    i18n: dict[LanguageCode, NpcI18NModel] = msgspec.field(default_factory=dict)

warframe_market_py-1.0.0/warframe_market/models/order.py

@@ -0,0 +1,56 @@
+import msgspec
+from typing import Optional
+
+from .user import UserShortModel
+
+
+class OrderModel(msgspec.Struct):
+    """
+    Model for trade orders.
+
+    Attributes:
+        id: Unique identifier of the order
+        type: Type of order ('buy' or 'sell')
+        platinum: Total platinum currency involved
+        quantity: Number of items in the order
+        per_trade: Optional items quantity per transaction
+        rank: Optional rank/level of the item
+        charges: Optional number of charges left (for requiem mods)
+        subtype: Optional specific subtype/category of the item
+        amber_stars: Optional count of amber stars (for sculpture orders)
+        cyan_stars: Optional count of cyan stars (for sculpture orders)
+        visible: Whether the order is publicly visible
+        created_at: Creation timestamp of the order
+        updated_at: Last modification timestamp
+        item_id: Unique identifier of the involved item
+        group: User-defined group for the order
+    """
+
+    id: str
+    type: str
+    platinum: int
+    quantity: int
+    visible: bool
+    created_at: str = msgspec.field(name="createdAt")
+    updated_at: str = msgspec.field(name="updatedAt")
+    item_id: str = msgspec.field(name="itemId")
+    group: str
+    per_trade: Optional[int] = msgspec.field(default=None, name="perTrade")
+    rank: Optional[int] = None
+    charges: Optional[int] = None
+    subtype: Optional[str] = None
+    amber_stars: Optional[int] = msgspec.field(default=None, name="amberStars")
+    cyan_stars: Optional[int] = msgspec.field(default=None, name="cyanStars")
+
+
+class OrderWithUserModel(OrderModel, kw_only=True):
+    """
+    Model for trade orders with associated user information.
+
+    Extends the base Order model to include the user who created the order.
+
+    Additional Attributes:
+        user: Basic profile information of the order's creator
+    """
+
+    user: UserShortModel

warframe_market_py-1.0.0/warframe_market/models/riven.py

@@ -0,0 +1,56 @@
+import msgspec
+from typing import Literal
+
+from ..common.options import LanguageCode
+
+
+RivenType = Literal["rifle", "shotgun", "pistol", "melee", "kitgun", "zaw"]
+
+
+class RivenI18N(msgspec.Struct):
+    """Localization data for a Riven mod."""
+
+    name: str = msgspec.field(name="itemName")
+    icon: str
+    thumb: str
+    wiki_link: str | None = msgspec.field(default=None, name="wikiLink")
+
+
+class RivenAttributeI18N(msgspec.Struct):
+    """Localization data for a Riven attribute."""
+
+    name: str = msgspec.field(name="effect")
+    icon: str
+    thumb: str
+
+
+class RivenModel(msgspec.Struct):
+    """Model for Riven mods."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    disposition: float
+    req_mastery_rank: int = msgspec.field(name="reqMasteryRank")
+    group: str | None = None
+    riven_type: str | None = msgspec.field(default=None, name="rivenType")
+    i18n: dict[LanguageCode, RivenI18N] = msgspec.field(default_factory=dict)
+
+
+class RivenAttributeModel(msgspec.Struct):
+    """Model for Riven mod attributes."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    prefix: str
+    suffix: str
+    group: str | None = None
+    i18n: dict[LanguageCode, RivenAttributeI18N] = msgspec.field(default_factory=dict)
+    exclusive_to: list[str] | None = msgspec.field(default=None, name="exclusiveTo")
+    positive_is_negative: bool | None = msgspec.field(
+        default=None, name="positiveIsNegative"
+    )
+    unit: str | None = None
+    positive_only: bool | None = msgspec.field(default=None, name="positiveOnly")
+    negative_only: bool | None = msgspec.field(default=None, name="negativeOnly")

warframe_market_py-1.0.0/warframe_market/models/sister.py

@@ -0,0 +1,63 @@
+import msgspec
+
+from ..common.options import LanguageCode
+
+
+class SisterWeaponI18NModel(msgspec.Struct):
+    """Localization data for a Sister weapon."""
+
+    name: str = msgspec.field(name="itemName")
+    icon: str
+    thumb: str
+    wiki_link: str | None = msgspec.field(default=None, name="wikiLink")
+
+
+class SisterWeaponModel(msgspec.Struct):
+    """Model for Sister weapons."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    req_mastery_rank: int = msgspec.field(name="reqMasteryRank")
+    i18n: dict[LanguageCode, SisterWeaponI18NModel] = msgspec.field(
+        default_factory=dict
+    )
+
+
+class SisterEphemeraI18NModel(msgspec.Struct):
+    """Localization data for a Sister ephemera."""
+
+    name: str = msgspec.field(name="itemName")
+    icon: str
+    thumb: str
+
+
+class SisterEphemeraModel(msgspec.Struct):
+    """Model for Sister ephemeras."""
+
+    id: str
+    slug: str
+    game_ref: str = msgspec.field(name="gameRef")
+    animation: str
+    element: str
+    i18n: dict[LanguageCode, SisterEphemeraI18NModel] = msgspec.field(
+        default_factory=dict
+    )
+
+
+class SisterQuirkI18NModel(msgspec.Struct):
+    """Localization data for a Sister quirk."""
+
+    name: str = msgspec.field(name="itemName")
+    icon: str
+    thumb: str
+    description: str | None = None
+
+
+class SisterQuirkModel(msgspec.Struct):
+    """Model for Sister quirks."""
+
+    id: str
+    slug: str
+    group: str | None = None
+    i18n: dict[LanguageCode, SisterQuirkI18NModel] = msgspec.field(default_factory=dict)

warframe_market_py-1.0.0/warframe_market/models/user.py

@@ -0,0 +1,61 @@
+import msgspec
+from .activity import ActivityModel
+from .achievement import AchievementModel
+
+
+class UserShortModel(msgspec.Struct):
+    """
+    Short form user data model.
+
+    Attributes:
+        id: Unique identifier of the user
+        ingame_name: In-game name of the user
+        avatar: Optional avatar image URL
+        reputation: Reputation score
+        locale: Preferred communication language (e.g., 'en', 'ko', 'es')
+        platform: Gaming platform used by the user
+        crossplay: Whether the user has crossplay enabled
+        status: Current status of the user
+        activity: Current activity of the user
+        last_seen: Timestamp of the user's last online presence
+    """
+
+    id: str
+    ingame_name: str = msgspec.field(name="ingameName")
+    reputation: int
+    locale: str
+    platform: str
+    crossplay: bool
+    status: str
+    activity: ActivityModel
+    last_seen: str = msgspec.field(name="lastSeen")
+    avatar: str | None = None
+
+
+class UserModel(UserShortModel, kw_only=True):
+    """
+    Full user profile model that extends UserShortModel.
+
+    Additional Attributes:
+        background: Optional profile background image URL
+        about: Optional HTML-formatted user description
+        mastery_level: Optional in-game mastery level
+        achievement_showcase: List of showcased achievements
+        banned: Whether the user is currently banned
+        ban_until: Optional ban expiration timestamp
+        warned: Whether the user has been warned (mod/admin only)
+        warn_message: Optional warning message (mod/admin only)
+        ban_message: Optional ban reason (mod/admin only)
+    """
+
+    background: str | None = None
+    about: str | None = None
+    mastery_level: int | None = msgspec.field(default=None, name="masteryLevel")
+    achievement_showcase: list[AchievementModel] = msgspec.field(
+        default_factory=list, name="achievementShowcase"
+    )
+    banned: bool | None = None
+    ban_until: str | None = msgspec.field(default=None, name="banUntil")
+    warned: bool | None = None
+    warn_message: str | None = msgspec.field(default=None, name="warnMessage")
+    ban_message: str | None = msgspec.field(default=None, name="banMessage")

warframe_market_py-1.0.0/warframe_market/models/user_private.py

@@ -0,0 +1,112 @@
+import msgspec
+from enum import Enum
+from typing import List, Optional
+
+from .activity import ActivityModel
+from .achievement import AchievementModel
+
+
+class Role(str, Enum):
+    """User roles in the system."""
+
+    USER = "user"
+    MODERATOR = "moderator"
+    ADMIN = "admin"
+
+
+class Tier(str, Enum):
+    """Subscription tiers."""
+
+    NONE = "none"
+    BRONZE = "bronze"
+    SILVER = "silver"
+    GOLD = "gold"
+    DIAMOND = "diamond"
+
+
+class LinkedAccounts(msgspec.Struct):
+    """Model for linked external accounts."""
+
+    pass
+
+
+class UserPrivateModel(msgspec.Struct):
+    """
+    Private user profile with full details and sensitive information.
+
+    Attributes:
+        id: Unique identifier of the user
+        role: User's role in the system (e.g., user, moderator, admin)
+        ingame_name: In-game name of the user
+        reputation: Reputation score
+        locale: Preferred communication language (e.g., 'en', 'ko', 'es')
+        platform: Gaming platform used by the user
+        crossplay: Whether the user has crossplay enabled
+        status: Current status of the user
+        activity: Current activity of the user
+        last_seen: Timestamp of the user's last online presence
+        mastery_rank: In-game mastery rank
+        credits: User's credit balance
+        theme: User's selected theme
+        verification: Whether the user is verified
+        check_code: Verification check code
+        tier: Subscription tier of the user
+        subscription: Whether the user has an active subscription
+        linked_accounts: Linked external accounts information
+        has_email: Whether the user has an email address associated with their account
+        created_at: Account creation timestamp
+        reviews_left: Number of reviews left by the user
+        unread_messages: Count of unread messages in the user's inbox
+        avatar: Optional avatar image URL
+        achievement_showcase: List of achievements showcased by the user
+        ignore_list: List of user IDs that this user has ignored
+        about: Optional HTML-formatted user description
+        about_raw: Optional raw text version of the user's description
+        warned: Whether the user has been warned (mod/admin only)
+        warn_message: Optional warning message (mod/admin only)
+        banned: Whether the user is currently banned (mod/admin only)
+        ban_until: Optional timestamp until which the user is banned (mod/admin only)
+        ban_message: Optional reason for the ban (mod/admin only)
+        delete_in_progress: Whether the user account deletion is in progress (mod/admin only)
+        delete_at: Optional timestamp when the account deletion is scheduled (mod/admin only)
+    """
+
+    id: str
+    role: Role
+    ingame_name: str = msgspec.field(name="ingameName")
+    reputation: int
+    locale: str
+    platform: str
+    crossplay: bool
+    status: str
+    activity: ActivityModel
+    last_seen: str = msgspec.field(name="lastSeen")
+    mastery_rank: int = msgspec.field(name="masteryRank")
+    credits: int
+    theme: str
+    verification: bool
+    check_code: str = msgspec.field(name="checkCode")
+    tier: Tier
+    subscription: bool
+    linked_accounts: LinkedAccounts = msgspec.field(name="linkedAccounts")
+    has_email: bool = msgspec.field(name="hasEmail")
+    created_at: str = msgspec.field(name="createdAt")
+    reviews_left: int = msgspec.field(name="reviewsLeft")
+    unread_messages: int = msgspec.field(name="unreadMessages")
+    # Optional fields
+    avatar: str | None = None
+    achievement_showcase: List[AchievementModel] = msgspec.field(
+        default_factory=list, name="achievementShowcase"
+    )
+    ignore_list: List[str] = msgspec.field(default_factory=list, name="ignoreList")
+    about: Optional[str] = None
+    about_raw: Optional[str] = msgspec.field(default=None, name="aboutRaw")
+    warned: Optional[bool] = None
+    warn_message: Optional[str] = msgspec.field(default=None, name="warnMessage")
+    banned: Optional[bool] = None
+    ban_until: Optional[str] = msgspec.field(default=None, name="banUntil")
+    ban_message: Optional[str] = msgspec.field(default=None, name="banMessage")
+    delete_in_progress: Optional[bool] = msgspec.field(
+        default=None, name="deleteInProgress"
+    )
+    delete_at: Optional[str] = msgspec.field(default=None, name="deleteAt")