python-xbox 0.1.0rc0__py3-none-any.whl

python_xbox-0.1.0rc0.dist-info/METADATA

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: python-xbox
+Version: 0.1.0rc0
+Summary: A library to authenticate with Xbox Network and use their API
+Project-URL: Homepage, https://github.com/tr4nt0r/python-xbox
+Author: OpenXbox
+License-Expression: MIT
+License-File: LICENSE
+Keywords: xbox one live api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: appdirs
+Requires-Dist: ecdsa
+Requires-Dist: httpx
+Requires-Dist: ms-cv
+Requires-Dist: pydantic==2.*
+Description-Content-Type: text/markdown
+
+# Xbox-WebAPI
+
+[![PyPi - latest](https://img.shields.io/pypi/v/xbox-webapi.svg)](https://pypi.python.org/pypi/xbox-webapi/)
+[![Documentation status](https://readthedocs.org/projects/xbox-webapi-python/badge/?version=latest)](http://xbox-webapi-python.readthedocs.io/en/latest/?badge=latest)
+[![Build status](https://img.shields.io/github/actions/workflow/status/OpenXbox/xbox-webapi-python/build.yml?branch=master)](https://github.com/OpenXbox/xbox-webapi-python/actions?query=workflow%3Abuild)
+[![Discord chat channel](https://img.shields.io/badge/discord-OpenXbox-blue.svg)](https://openxbox.org/discord)
+
+Xbox-WebAPI is a python library to authenticate with Xbox Live via your Microsoft Account and provides Xbox related Web-API.
+
+Authentication is supported via OAuth2.
+
+- Register a new application in [Azure AD](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)
+  - Name your app
+  - Select "Personal Microsoft accounts only" under supported account types
+  - Add <http://localhost/auth/callback> as a Redirect URI of type "Web"
+- Copy your Application (client) ID for later use
+- On the App Page, navigate to "Certificates & secrets"
+  - Generate a new client secret and save for later use
+
+## Dependencies
+
+- Python >= 3.8
+
+## How to use
+
+Install
+
+```text
+pip install xbox-webapi
+```
+
+Authentication
+
+**Note: You must use non child account (> 18 years old)**
+
+Token save location: If tokenfile is not provided via cmdline, fallback of `<appdirs.user_data_dir>/tokens.json` is used as save-location
+
+Specifically:
+
+Windows: `C:\\Users\\<username>\\AppData\\Local\\OpenXbox\\xbox`
+
+Mac OSX: `/Users/<username>/Library/Application Support/xbox/tokens.json`
+
+Linux: `/home/<username>/.local/share/xbox`
+
+For more information, see: <https://pypi.org/project/appdirs> and module: `xbox.webapi.scripts.constants`
+
+```
+xbox-authenticate --client-id <client-id> --client-secret <client-secret>
+```
+
+Example: Search Xbox Live via cmdline tool
+
+```text
+  # Search Xbox One Catalog
+  xbox-searchlive "Some game title"
+```
+
+API usage
+
+```py
+import asyncio
+import sys
+
+from httpx import HTTPStatusError
+
+from xbox.webapi.api.client import XboxLiveClient
+from xbox.webapi.authentication.manager import AuthenticationManager
+from xbox.webapi.authentication.models import OAuth2TokenResponse
+from xbox.webapi.common.signed_session import SignedSession
+from xbox.webapi.scripts import CLIENT_ID, CLIENT_SECRET, TOKENS_FILE
+
+"""
+This uses the global default client identification by OpenXbox
+You can supply your own parameters here if you are permitted to create
+new Microsoft OAuth Apps and know what you are doing
+"""
+client_id = CLIENT_ID
+client_secret = CLIENT_SECRET
+tokens_file = TOKENS_FILE
+
+"""
+For doing authentication, see xbox/webapi/scripts/authenticate.py
+"""
+
+
+async def async_main():
+    # Create a HTTP client session
+    async with SignedSession() as session:
+        """
+        Initialize with global OAUTH parameters from above
+        """
+        auth_mgr = AuthenticationManager(session, client_id, client_secret, "")
+
+        """
+        Read in tokens that you received from the `xbox-authenticate`-script previously
+        See `xbox/webapi/scripts/authenticate.py`
+        """
+        try:
+            with open(tokens_file) as f:
+                tokens = f.read()
+            # Assign gathered tokens
+            auth_mgr.oauth = OAuth2TokenResponse.model_validate_json(tokens)
+        except FileNotFoundError as e:
+            print(
+                f"File {tokens_file} isn`t found or it doesn`t contain tokens! err={e}"
+            )
+            print("Authorizing via OAUTH")
+            url = auth_mgr.generate_authorization_url()
+            print(f"Auth via URL: {url}")
+            authorization_code = input("Enter authorization code> ")
+            tokens = await auth_mgr.request_oauth_token(authorization_code)
+            auth_mgr.oauth = tokens
+
+        """
+        Refresh tokens, just in case
+        You could also manually check the token lifetimes and just refresh them
+        if they are close to expiry
+        """
+        try:
+            await auth_mgr.refresh_tokens()
+        except HTTPStatusError as e:
+            print(
+                f"""
+                Could not refresh tokens from {tokens_file}, err={e}\n
+                You might have to delete the tokens file and re-authenticate 
+                if refresh token is expired
+            """
+            )
+            sys.exit(-1)
+
+        # Save the refreshed/updated tokens
+        with open(tokens_file, mode="w") as f:
+            f.write(auth_mgr.oauth.json())
+        print(f"Refreshed tokens in {tokens_file}!")
+
+        """
+        Construct the Xbox API client from AuthenticationManager instance
+        """
+        xbl_client = XboxLiveClient(auth_mgr)
+
+        """
+        Some example API calls
+        """
+        # Get friendslist
+        friendslist = await xbl_client.people.get_friends_own()
+        print(f"Your friends: {friendslist}\n")
+
+        # Get presence status (by list of XUID)
+        presence = await xbl_client.presence.get_presence_batch(
+            ["2533274794093122", "2533274807551369"]
+        )
+        print(f"Statuses of some random players by XUID: {presence}\n")
+
+        # Get messages
+        messages = await xbl_client.message.get_inbox()
+        print(f"Your messages: {messages}\n")
+
+        # Get profile by GT
+        profile = await xbl_client.profile.get_profile_by_gamertag("SomeGamertag")
+        print(f"Profile under SomeGamertag gamer tag: {profile}\n")
+
+
+asyncio.run(async_main())
+```
+
+## Contribute
+
+- Report bugs/suggest features
+- Add/update docs
+- Add additional xbox live endpoints
+
+## Credits
+
+This package uses parts of [Cookiecutter](https://github.com/audreyr/cookiecutter)
+and the [audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage) project template.
+The authentication code is based on [joealcorn/xbox](https://github.com/joealcorn/xbox)
+
+Informations on endpoints gathered from:
+
+- [XboxLive REST Reference](https://docs.microsoft.com/en-us/windows/uwp/xbox-live/xbox-live-rest/atoc-xboxlivews-reference)
+- [XboxLiveTraceAnalyzer APIMap](https://github.com/Microsoft/xbox-live-trace-analyzer/blob/master/Source/XboxLiveTraceAnalyzer.APIMap.csv)
+- [Xbox Live Service API](https://github.com/Microsoft/xbox-live-api)
+
+## Disclaimer
+
+Xbox, Xbox One, Smartglass and Xbox Live are trademarks of Microsoft Corporation. Team OpenXbox is in no way endorsed by or affiliated with Microsoft Corporation, or any associated subsidiaries, logos or trademarks.

python_xbox-0.1.0rc0.dist-info/RECORD

@@ -0,0 +1,63 @@
+webapi/__init__.py,sha256=hYekEIvBVPT4y6hddaSD3v12UnsmPtrqP8J4oPEGSmI,102
+webapi/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webapi/api/client.py,sha256=xVqzgN_sCH-9rluDBAjNJoBJTZVMyc2dQKB1wEfAM8Y,5796
+webapi/api/language.py,sha256=ThovoFIkS7kv-S3dakcKU6xr5yLSb_kTMc4O4iCt744,3533
+webapi/api/provider/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webapi/api/provider/baseprovider.py,sha256=b5piCI4KenbJR2THin1zj3e-n72db7d10a4rXEdndXg,292
+webapi/api/provider/ratelimitedprovider.py,sha256=ucJfjgwFlWR182MeTi4cCpjMzn1RTwz_P_epUkA_ygc,3060
+webapi/api/provider/account/__init__.py,sha256=ZobvTwUnuD1kBj54Zx4rGrmzviJ6-e2n_OE2d3dNUH4,2249
+webapi/api/provider/account/models.py,sha256=noWqiSMBLJukNN5g3AHjieuO9el8dDbuDDrXQpmpTQc,197
+webapi/api/provider/achievements/__init__.py,sha256=mjz7l7taxAh3xtfloFNMCr3V4SJkdvukxvsjh2LVcVU,5243
+webapi/api/provider/achievements/models.py,sha256=6jruvUTkgrhZD1T7wkNNOHzczb89CH9MrBxcr-R_g_Y,2684
+webapi/api/provider/catalog/__init__.py,sha256=N_5JUOJDF-1dOMzPqoABiKOX0-vOtSJp1dFuV1RWbA4,2772
+webapi/api/provider/catalog/const.py,sha256=2PPKo6y5shXeCH44EQM0v5C5Z9UWqN3hNLnhnZszzJo,463
+webapi/api/provider/catalog/models.py,sha256=Z6NwiOXGtJPA3x47t6pj-N_tJ02iomtwyMRdGo0rTCQ,13029
+webapi/api/provider/cqs/__init__.py,sha256=ctn8tikEDAABWlszlAaHyC8Tn552DNvpnp2_QNT4sIk,2668
+webapi/api/provider/cqs/models.py,sha256=UbhyRu4W_vxpBAUnKIF30iNAenfpnEpxGe6kxFf3JiE,1161
+webapi/api/provider/gameclips/__init__.py,sha256=wtUpFlwJaOcZiXGKPOuqZKKnNSQMz1BnAldc1WfqrN4,5532
+webapi/api/provider/gameclips/models.py,sha256=neZ-XbEf5WmEVanbWmCn0ABFH1my1dGyaIA7S56cKR8,1220
+webapi/api/provider/lists/__init__.py,sha256=YHbsMdjJOTtJaI4MpIuDe2ZVZHeTmXCL5xlFDxu3idM,2338
+webapi/api/provider/lists/models.py,sha256=cXaL0_kd7FSnrLYSJZWDc6G615JXkOdi0A4vL7DTVLI,711
+webapi/api/provider/mediahub/__init__.py,sha256=FVXFHRfy8BqZDfCf0Y8rsUGZ95LD4L4Vpbqw9gIMcg4,1829
+webapi/api/provider/mediahub/models.py,sha256=dtyXa2WpYMXF58PZOIfmo059JEYp-uZMMrXz3uJE-rY,1911
+webapi/api/provider/message/__init__.py,sha256=JYCnYQP0f78kE0WlxW7jOBEY2Z2-Adi4ZphW5xfzUa4,4165
+webapi/api/provider/message/models.py,sha256=FwUwNjXUZ110v5a1Jtal08jtpQdbQ4juVf5tdh5q414,2070
+webapi/api/provider/people/__init__.py,sha256=9C1oxwMPkk-WZJ3cJ-fBkUFcwp71pi0-xIw9vKKUjvQ,6499
+webapi/api/provider/people/models.py,sha256=SCUvY0Fw4CC4Qu6KC-CxO8fGOILBp_kBxY5g5NAYVFM,6892
+webapi/api/provider/presence/__init__.py,sha256=1dyJUEpyejNNi-oMLGvO0HLlmsbDTq8uiW7OrZgfAs4,3307
+webapi/api/provider/presence/models.py,sha256=Ezw_kDHzDjAmOHPzIn_ZU1cXA6Ui3TXDdNw84lTbGcQ,1207
+webapi/api/provider/profile/__init__.py,sha256=VWTUN27cel4RgGQ41PlRSo44GpLcjJpBAYwIGZsf_Zs,4958
+webapi/api/provider/profile/models.py,sha256=wkX-A6dQeEiKO1v6MexXJcdvK4f_v3kG8TlwM5TxXoQ,1247
+webapi/api/provider/screenshots/__init__.py,sha256=r3GBgWG005gOFdctIRkgX7-BnNISCoKAfm00N3IGL5s,5722
+webapi/api/provider/screenshots/models.py,sha256=HWK6uYLeiL6u0-wVXzQkQ3ZFxzGImE4HRTI0Gc6R3Ko,1196
+webapi/api/provider/smartglass/__init__.py,sha256=IEbh7Jmg9Zn3_2u4BQrDuiSNE_Ph0xFH3EUq8Cz4_QA,11430
+webapi/api/provider/smartglass/models.py,sha256=APVcyhIUdhUZGGf658vot1RfexU0y7_7mcMUFH9OFCA,4365
+webapi/api/provider/titlehub/__init__.py,sha256=M81SIus7ISsYbtnrWnm4pSZbOKEaLVF08aQKOWhrrO0,4526
+webapi/api/provider/titlehub/models.py,sha256=m2k7rtqfdjfASvWySeZcYIR2XF13zcGALjFVU7UjkHc,2622
+webapi/api/provider/usersearch/__init__.py,sha256=o_tDaVteFceU_o9WrLbEyhUOJC9-Z65sYIconcMqVDA,914
+webapi/api/provider/usersearch/models.py,sha256=tYf261ko3T4H_ILMXauJjPtA3-ivAErZbCavJ12QgLE,333
+webapi/api/provider/userstats/__init__.py,sha256=mBi_1cIhfyBZBUeECHngt1-8wQCll7UXdKWe67f2Kzo,5373
+webapi/api/provider/userstats/models.py,sha256=qbJ4p1NhYLBHz6PlYSOdq7jA2JLdEMqomp4tw2VZY_U,1064
+webapi/authentication/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webapi/authentication/manager.py,sha256=9rflcoxOT42GZy9Srx27gJVY8AdSccI8x1s0U6f6UbE,5744
+webapi/authentication/models.py,sha256=L79hmSO9GJwcwLIZjS0c9KMnwLhzi9eEz1KX7RgchSk,3580
+webapi/authentication/xal.py,sha256=v4s9ILpd8AK6pkGO0dsHVdPcQdw0FCAnYsqwgEK_inM,11550
+webapi/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webapi/common/exceptions.py,sha256=9Ft-bUUeA0k_YKfltz94shVH1A9pAZZfpQsbH0k3ocs,1473
+webapi/common/filetimes.py,sha256=_Kjg8vEt3cBO_ChfHYXXL-hCP6bx10ooGHHzl0UjVo4,3610
+webapi/common/models.py,sha256=zIDOE7FnBKUmjcZ3FH8LSf3_OFaaZx1yHg7xUSHI844,816
+webapi/common/request_signer.py,sha256=4A3NI3as9nhiiP_ULvnpHpZbAMUcaPAlLTVPs8qwcrE,5494
+webapi/common/signed_session.py,sha256=fgilCUEnQKK5RHs28JhSbbZGA43HnHol33zC7te6onA,1758
+webapi/common/ratelimits/__init__.py,sha256=r6PpvKKmgcjRvtzIE0lozhdAduxJzIdlnGP_SpykhCU,10142
+webapi/common/ratelimits/models.py,sha256=UmvQGtLd_J33Idx3OlR7QepvhhGSUnKVIg1CvswNCho,358
+webapi/scripts/__init__.py,sha256=2z6UFqu9f7FYKZ20WB5cljDUwaY_w7kc6ajdfYtuNEc,450
+webapi/scripts/authenticate.py,sha256=Iy88ZLNPixjjN7-apqk9fM0ecL1Vnr_qKmdoNCRBi-U,5003
+webapi/scripts/change_gamertag.py,sha256=Grkkv7Kuy8Ffau6VetO-s1VP1F-r0egK9puwOMv3bgs,3309
+webapi/scripts/friends.py,sha256=E9x-wXJcs8jK0H2YS_QoMdWP8zzJ-D10rzQfz0Ihdxs,2128
+webapi/scripts/search.py,sha256=Bs5A3lBEmOQ77ya7A3z9rqV-WHDQS8933IDpAloqRU4,1061
+webapi/scripts/xal.py,sha256=ZAX8QtitSjVU1gABb6E8g5xzOEUhK0zVYX1rKRTpKkM,2940
+python_xbox-0.1.0rc0.dist-info/METADATA,sha256=IL3HizasigkP4-psk29VXKMDimuS3ZUjo-2K4gHd5FQ,7515
+python_xbox-0.1.0rc0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_xbox-0.1.0rc0.dist-info/entry_points.txt,sha256=_g3gfLC1KrQQbwsYdW_sLJnUEH8gSwLh9OzGqWNuQLo,272
+python_xbox-0.1.0rc0.dist-info/licenses/LICENSE,sha256=GZZiedLyfDqT3SWPU1LLYtMxEkij8MDzUgerPOS9Smo,1052
+python_xbox-0.1.0rc0.dist-info/RECORD,,

python_xbox-0.1.0rc0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

python_xbox-0.1.0rc0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+xbox-authenticate = xbox.webapi.scripts.authenticate:main
+xbox-change-gt = xbox.webapi.scripts.change_gamertag:main
+xbox-friends = xbox.webapi.scripts.friends:main
+xbox-searchlive = xbox.webapi.scripts.search:main
+xbox-xal = xbox.webapi.scripts.xal:main

python_xbox-0.1.0rc0.dist-info/licenses/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2020 OpenXbox
+
+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.

webapi/__init__.py

@@ -0,0 +1,4 @@
+"""Top-level package for xbox-webapi-python."""
+
+__author__ = """OpenXbox"""
+__version__ = "0.1.0rc0"

webapi/api/client.py

@@ -0,0 +1,166 @@
+"""
+Xbox Live Client
+
+Basic factory that stores :class:`XboxLiveLanguage`, User authorization data
+and available `Providers`
+"""
+
+import logging
+from typing import Any
+
+from httpx import Response
+from ms_cv import CorrelationVector
+
+from xbox.webapi.api.language import DefaultXboxLiveLanguages, XboxLiveLanguage
+from xbox.webapi.api.provider.account import AccountProvider
+from xbox.webapi.api.provider.achievements import AchievementsProvider
+from xbox.webapi.api.provider.catalog import CatalogProvider
+from xbox.webapi.api.provider.cqs import CQSProvider
+from xbox.webapi.api.provider.gameclips import GameclipProvider
+from xbox.webapi.api.provider.lists import ListsProvider
+from xbox.webapi.api.provider.mediahub import MediahubProvider
+from xbox.webapi.api.provider.message import MessageProvider
+from xbox.webapi.api.provider.people import PeopleProvider
+from xbox.webapi.api.provider.presence import PresenceProvider
+from xbox.webapi.api.provider.profile import ProfileProvider
+from xbox.webapi.api.provider.screenshots import ScreenshotsProvider
+from xbox.webapi.api.provider.smartglass import SmartglassProvider
+from xbox.webapi.api.provider.titlehub import TitlehubProvider
+from xbox.webapi.api.provider.usersearch import UserSearchProvider
+from xbox.webapi.api.provider.userstats import UserStatsProvider
+from xbox.webapi.authentication.manager import AuthenticationManager
+from xbox.webapi.common.exceptions import RateLimitExceededException
+from xbox.webapi.common.ratelimits import RateLimit
+
+log = logging.getLogger("xbox.api")
+
+
+class Session:
+    def __init__(self, auth_mgr: AuthenticationManager):
+        self._auth_mgr = auth_mgr
+        self._cv = CorrelationVector()
+
+    async def request(
+        self,
+        method: str,
+        url: str,
+        include_auth: bool = True,
+        include_cv: bool = True,
+        **kwargs: Any,
+    ) -> Response:
+        """Proxy Request and add Auth/CV headers."""
+        headers = kwargs.pop("headers", {})
+        params = kwargs.pop("params", None)
+        data = kwargs.pop("data", None)
+
+        # Extra, user supplied values
+        extra_headers = kwargs.pop("extra_headers", None)
+        extra_params = kwargs.pop("extra_params", None)
+        extra_data = kwargs.pop("extra_data", None)
+
+        # Rate limit object
+        rate_limits: RateLimit = kwargs.pop("rate_limits", None)
+
+        if include_auth:
+            # Ensure tokens valid
+            await self._auth_mgr.refresh_tokens()
+            # Set auth header
+            headers["Authorization"] = (
+                self._auth_mgr.xsts_token.authorization_header_value
+            )
+
+        if include_cv:
+            headers["MS-CV"] = self._cv.increment()
+
+        # Extend with optionally supplied values
+        if extra_headers:
+            headers.update(extra_headers)
+        if extra_params:
+            # query parameters
+            params = params or {}
+            params.update(extra_params)
+        if extra_data:
+            # form encoded post data
+            data = data or {}
+            data.update(extra_data)
+
+        if rate_limits:
+            # Check if rate limits have been exceeded for this endpoint
+            if rate_limits.is_exceeded():
+                raise RateLimitExceededException("Rate limit exceeded", rate_limits)
+
+        response = await self._auth_mgr.session.request(
+            method, url, **kwargs, headers=headers, params=params, data=data
+        )
+
+        if rate_limits:
+            rate_limits.increment()
+
+        return response
+
+    async def get(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("GET", url, **kwargs)
+
+    async def options(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("OPTIONS", url, **kwargs)
+
+    async def head(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("HEAD", url, **kwargs)
+
+    async def post(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("POST", url, **kwargs)
+
+    async def put(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("PUT", url, **kwargs)
+
+    async def patch(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("PATCH", url, **kwargs)
+
+    async def delete(self, url: str, **kwargs: Any) -> Response:
+        return await self.request("DELETE", url, **kwargs)
+
+
+class XboxLiveClient:
+    def __init__(
+        self,
+        auth_mgr: AuthenticationManager,
+        language: XboxLiveLanguage = DefaultXboxLiveLanguages.United_States,
+    ):
+        self._auth_mgr = auth_mgr
+        self.session = Session(auth_mgr)
+        self._language = language
+
+        self.cqs = CQSProvider(self)
+        self.lists = ListsProvider(self)
+        self.profile = ProfileProvider(self)
+        self.achievements = AchievementsProvider(self)
+        self.usersearch = UserSearchProvider(self)
+        self.gameclips = GameclipProvider(self)
+        self.people = PeopleProvider(self)
+        self.presence = PresenceProvider(self)
+        self.mediahub = MediahubProvider(self)
+        self.message = MessageProvider(self)
+        self.userstats = UserStatsProvider(self)
+        self.screenshots = ScreenshotsProvider(self)
+        self.titlehub = TitlehubProvider(self)
+        self.account = AccountProvider(self)
+        self.catalog = CatalogProvider(self)
+        self.smartglass = SmartglassProvider(self)
+
+    @property
+    def xuid(self) -> str:
+        """
+        Gets the Xbox User ID
+
+        Returns: Xbox user Id
+        """
+        return self._auth_mgr.xsts_token.xuid
+
+    @property
+    def language(self) -> XboxLiveLanguage:
+        """
+        Gets the active Xbox Live Language
+
+        Returns: Active Xbox Live language
+        """
+        return self._language

webapi/api/language.py

@@ -0,0 +1,70 @@
+"""
+Language definitions
+"""
+
+
+class XboxLiveLanguage:
+    def __init__(self, name, short_id, identifier, locale):
+        """
+        Initialize a new instance of :class:`XboxLiveLanguage`
+
+        Args:
+            name (str): Full name describing the language / country
+            short_id (str): Short Id (e.g. "AT" for Austria)
+            identifier (str): Identifier (e.g. "de_AT" for Austria)
+            locale (str): Locale (e.g. "de-AT" for Austria)
+        """
+        self.name = name
+        self.short_id = short_id
+        self.identifier = identifier
+        self.locale = locale
+
+
+class DefaultXboxLiveLanguages:
+    """
+    Collection of locales compatible with XBL
+    """
+
+    Argentina = XboxLiveLanguage("Argentina", "AR", "es_AR", "es-AR")
+    Australia = XboxLiveLanguage("Australia", "AU", "en_AU", "en-AU")
+    Austria = XboxLiveLanguage("Austria", "AT", "de_AT", "de-AT")
+    Belgium = XboxLiveLanguage("Belgium", "BE", "fr_BE", "fr-BE")
+    Belgium_NL = XboxLiveLanguage("Belgium (NL)", "NL", "nl_BE", "nl-BE")
+    Brazil = XboxLiveLanguage("Brazil", "BR", "pt_BR", "pt-BR")
+    Canada = XboxLiveLanguage("Canada", "CA", "en_CA", "en-CA")
+    Canada_FR = XboxLiveLanguage("Canada (FR)", "CA", "fr_CA", "fr-CA")
+    Czech_Republic = XboxLiveLanguage("Czech Republic", "CZ", "en_CZ", "en-CZ")
+    Denmark = XboxLiveLanguage("Denmark", "DK", "da_DK", "da-DK")
+    Finland = XboxLiveLanguage("Finland", "FI", "fi_FI", "fi-FI")
+    France = XboxLiveLanguage("France", "FR", "fr_FR", "fr-FR")
+    Germany = XboxLiveLanguage("Germany", "DE", "de_DE", "de-DE")
+    Greece = XboxLiveLanguage("Greece", "GR", "en_GR", "en-GR")
+    Hong_Kong = XboxLiveLanguage("Hong Kong", "HK", "en_HK", "en-HK")
+    Hungary = XboxLiveLanguage("Hungary", "HU", "en_HU", "en-HU")
+    India = XboxLiveLanguage("India", "IN", "en_IN", "en-IN")
+    Great_Britain = XboxLiveLanguage("Great Britain", "GB", "en_GB", "en-GB")
+    Israel = XboxLiveLanguage("Israel", "IL", "en_IL", "en-IL")
+    Italy = XboxLiveLanguage("Italy", "IT", "it_IT", "it-IT")
+    Japan = XboxLiveLanguage("Japan", "JP", "ja_JP", "ja-JP")
+    Mexico = XboxLiveLanguage("Mexico", "MX", "es_MX", "es-MX")
+    Chile = XboxLiveLanguage("Chile", "CL", "es_CL", "es-CL")
+    Colombia = XboxLiveLanguage("Colombia", "CO", "es_CO", "es-CO")
+    Netherlands = XboxLiveLanguage("Netherlands", "NL", "nl_NL", "nl-NL")
+    New_Zealand = XboxLiveLanguage("New Zealand", "NZ", "en_NZ", "en-NZ")
+    Norway = XboxLiveLanguage("Norway", "NO", "nb_NO", "nb-NO")
+    Poland = XboxLiveLanguage("Poland", "PL", "pl_PL", "pl-PL")
+    Portugal = XboxLiveLanguage("Portugal", "PT", "pt_PT", "pt-PT")
+    Russia = XboxLiveLanguage("Russia", "RU", "ru_RU", "ru-RU")
+    Saudi_Arabia = XboxLiveLanguage("Saudi Arabia", "SA", "en_SA", "en-SA")
+    Singapore = XboxLiveLanguage("Singapore", "SG", "en_SG", "en-SG")
+    Slovakia = XboxLiveLanguage("Slovakia", "SK", "en_SK", "en-SK")
+    South_Africa = XboxLiveLanguage("South Afrida", "ZA", "en_ZA", "en-ZA")
+    Korea = XboxLiveLanguage("Korea", "KR", "ko_KR", "ko-KR")
+    Spain = XboxLiveLanguage("Spain", "ES", "es_ES", "es-ES")
+    Switzerland = XboxLiveLanguage("Switzerland", "CH", "de_CH", "de-CH")
+    Switzerland_FR = XboxLiveLanguage("Switzerland (FR)", "CH", "fr_CH", "fr-CH")
+    United_Arab_Emirates = XboxLiveLanguage(
+        "United Arab Emirates", "AE", "en_AE", "en-AE"
+    )
+    United_States = XboxLiveLanguage("United States", "US", "en_US", "en-US")
+    Ireland = XboxLiveLanguage("Ireland", "IE", "en_IE", "en-IE")

webapi/api/provider/account/__init__.py

@@ -0,0 +1,71 @@
+from xbox.webapi.api.provider.account.models import (
+    ChangeGamertagResult,
+    ClaimGamertagResult,
+)
+from xbox.webapi.api.provider.baseprovider import BaseProvider
+
+
+class AccountProvider(BaseProvider):
+    BASE_URL_USER_MGT = "https://user.mgt.xboxlive.com"
+    BASE_URL_ACCOUNT = "https://accounts.xboxlive.com"
+
+    HEADERS_USER_MGT = {"x-xbl-contract-version": "1"}
+    HEADERS_ACCOUNT = {"x-xbl-contract-version": "2"}
+
+    async def claim_gamertag(self, xuid, gamertag, **kwargs) -> ClaimGamertagResult:
+        """
+        Claim gamertag
+
+        XLE error codes:
+            400 - Bad API request
+            401 - Unauthorized
+            409 - Gamertag unavailable
+            429 - Too many requests
+            200 - Gamertag available
+
+        Args:
+            xuid (int): Your xuid as integer
+            gamertag (str): Desired gamertag
+
+        Returns: ClaimGamertagResult
+        """
+        url = self.BASE_URL_USER_MGT + "/gamertags/reserve"
+        post_data = {"Gamertag": gamertag, "ReservationId": str(xuid)}
+        resp = await self.client.session.post(
+            url, json=post_data, headers=self.HEADERS_USER_MGT, **kwargs
+        )
+        try:
+            return ClaimGamertagResult(resp.status_code)
+        except ValueError:
+            resp.raise_for_status()
+
+    async def change_gamertag(
+        self, xuid, gamertag, preview=False, **kwargs
+    ) -> ChangeGamertagResult:
+        """
+        Change your gamertag.
+
+        XLE error codes:
+            200 - success
+            1020 - No free gamertag changes available
+
+        Args:
+            xuid (int): Your Xuid as integer
+            gamertag (str): Desired gamertag name
+            preview (bool): Preview the change
+
+        Returns: ChangeGamertagResult
+        """
+        url = self.BASE_URL_ACCOUNT + "/users/current/profile/gamertag"
+        post_data = {
+            "gamertag": gamertag,
+            "preview": preview,
+            "reservationId": int(xuid),
+        }
+        resp = await self.client.session.post(
+            url, json=post_data, headers=self.HEADERS_ACCOUNT, **kwargs
+        )
+        try:
+            return ChangeGamertagResult(resp.status_code)
+        except ValueError:
+            resp.raise_for_status()

webapi/api/provider/account/models.py

@@ -0,0 +1,11 @@
+from enum import Enum
+
+
+class ClaimGamertagResult(Enum):
+    NotAvailable = 409
+    Available = 200
+
+
+class ChangeGamertagResult(Enum):
+    ChangeSuccessful = 200
+    NoFreeChangesAvailable = 1020