python-xbox 0.1.0__py3-none-any.whl

python_xbox-0.1.0.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: python-xbox
+Version: 0.1.0
+Summary: A library to authenticate with Xbox Network and use their API
+Project-URL: Source, https://github.com/tr4nt0r/python-xbox
+Author: OpenXbox
+Author-email: Manfred Dennerlein Rodelo <manfred@dennerlein.name>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: xbox one live api
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: ecdsa
+Requires-Dist: httpx
+Requires-Dist: ms-cv
+Requires-Dist: pydantic==2.*
+Provides-Extra: cli
+Requires-Dist: platformdirs>=4.5.0; extra == 'cli'
+Description-Content-Type: text/markdown
+
+# python-xbox
+
+[![PyPi - latest](https://img.shields.io/pypi/v/python-xbox.svg)](https://pypi.python.org/pypi/python-xbox/)
+[![Build](https://github.com/tr4nt0r/python-xbox/actions/workflows/build.yml/badge.svg)](https://github.com/tr4nt0r/python-xbox/actions/workflows/build.yml)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/python-xbox?style=flat&label=pypi%20downloads)
+[!["Buy Me A Coffee"](https://img.shields.io/badge/-buy_me_a%C2%A0coffee-gray?logo=buy-me-a-coffee)](https://www.buymeacoffee.com/tr4nt0r)
+[![GitHub Sponsor](https://img.shields.io/badge/GitHub-Sponsor-blue?logo=github)](https://github.com/sponsors/tr4nt0r)
+
+python-xbox is a python library to authenticate with Xbox Network 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.11
+
+## How to use
+
+### Install
+
+```bash
+pip install python-xbox
+```
+
+### Authentication
+
+> [!NOTE]
+> You must use non child account (> 18 years old)
+
+Token save location: If tokenfile is not provided via cmdline, fallback of `<platformdirs.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/platformdirs> and module: `python-xbox.scripts.constants`
+
+```bash
+xbox-authenticate --client-id <client-id> --client-secret <client-secret>
+```
+
+Example: Search Xbox Live via cmdline tool
+
+```bash
+  # Search Xbox One Catalog
+  xbox-searchlive "Some game title"
+```
+
+API usage
+
+```python
+import asyncio
+import sys
+
+from httpx import HTTPStatusError
+
+from pythonxbox.api.client import XboxLiveClient
+from pythonxbox.authentication.manager import AuthenticationManager
+from pythonxbox.authentication.models import OAuth2TokenResponse
+from pythonxbox.common.signed_session import SignedSession
+from pythonxbox.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 pythonxbox/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 `pythonxbox/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 library is derived from [xbox-webapi](https://github.com/OpenXbox/xbox-webapi-python) library from the [OpenXbox](https://github.com/openxbox) project
+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.0.dist-info/RECORD

@@ -0,0 +1,64 @@
+pythonxbox/__init__.py,sha256=LPdRHxT1lTECd7TwCZ7_ph8OOTMBcaIZJDw1ApvAQNU,91
+pythonxbox/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonxbox/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonxbox/api/client.py,sha256=ZPWWjF8si4knZn4kZR1Cb7E2Nb-6x_cLX_hGP5M9X2s,5792
+pythonxbox/api/language.py,sha256=fOmdHD9iIeosM0ePDR4d4veWm1uLujS2gNAyJw4kL9s,3608
+pythonxbox/api/provider/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonxbox/api/provider/baseprovider.py,sha256=Do8Si5cCi8asFk2dEnk3wbbfX0FQ4aevK3FP57JigOw,425
+pythonxbox/api/provider/ratelimitedprovider.py,sha256=BQvLvxGKYAs-hMqEQXDAENN9-aB6LI_XtskS4H_M8s8,3151
+pythonxbox/api/provider/account/__init__.py,sha256=XuErLJye-PMIgHKLK32IMHPq5JFDFN7GhsgbtR-QUuA,2289
+pythonxbox/api/provider/account/models.py,sha256=noWqiSMBLJukNN5g3AHjieuO9el8dDbuDDrXQpmpTQc,197
+pythonxbox/api/provider/achievements/__init__.py,sha256=Hw1nGwqwxzWHM-71Y9LweWdY9IgVhjpsecVCTOwEJwQ,5296
+pythonxbox/api/provider/achievements/models.py,sha256=fEmynni9sxtyZQY3cmhAxC40BGEyfDWhja-IqUZ7paI,2661
+pythonxbox/api/provider/catalog/__init__.py,sha256=gHyBgFrw7tXF4itJJDk4fYkv2GWq0YmyBk43OwoQCXc,2745
+pythonxbox/api/provider/catalog/const.py,sha256=A-1AuA_GxukEYskunzl1KOBDd-D6EueACknR4zx_ThY,462
+pythonxbox/api/provider/catalog/models.py,sha256=2E4vwRGkWRL0EEaQGgxZmME4fXhQjbcbCdCxgGu1mk0,12597
+pythonxbox/api/provider/cqs/__init__.py,sha256=8lx5KxTccs-Jv_xBIhEEdPDmz098mi49hVTPGhhnyno,2666
+pythonxbox/api/provider/cqs/models.py,sha256=2vywdEzLJr0WShHK83_9fTbjkPTLNQjUuXVG1vzraVQ,1123
+pythonxbox/api/provider/gameclips/__init__.py,sha256=ZNCf-pp5nsNmVFoEmTwp7BLtYGpEEoukidvI4ZOZ_V0,5530
+pythonxbox/api/provider/gameclips/models.py,sha256=bgOJL2TXvIsRnkuFFJi14VLzuv7YTQFuWd1LudsFCWM,1182
+pythonxbox/api/provider/lists/__init__.py,sha256=3f5newFaLS2EUgZmt4Sp1vHL-x3XRYaL88kwptX5jKk,2336
+pythonxbox/api/provider/lists/models.py,sha256=kr_KZZReIzzini-YZpfNJxdLmzRIThYq2yOIIFYzBKs,666
+pythonxbox/api/provider/mediahub/__init__.py,sha256=bY67pw-u1lxhHNUiRx-jN6mJ4Y3wgPKICqRGEv4Kxew,1827
+pythonxbox/api/provider/mediahub/models.py,sha256=0dqaUlDpRZVRLEQcgZIVmGT97Ya6T4ccqermXzwXavo,1863
+pythonxbox/api/provider/message/__init__.py,sha256=PqRPAIa_iHVOjbiBkrbNu3jn4wUtNZusamiHpAUi2n0,4163
+pythonxbox/api/provider/message/models.py,sha256=P1IJblzGUYYPXE04LHSVEUmXeUqm8g5FKrO0jnm9jNE,2026
+pythonxbox/api/provider/people/__init__.py,sha256=YHscpAknxIBMPJeXuuI_eZ0Dx9mqvkKnwxbxpE7ynJk,6496
+pythonxbox/api/provider/people/models.py,sha256=bjS4in0jE-6cVTnPvR8aVFE57KrxIEO_-dUDHWB72l4,6891
+pythonxbox/api/provider/presence/__init__.py,sha256=Gvfh7AY7HE6S_bYmvWfE2Skoa71BNnMediPH6cp2w7s,3285
+pythonxbox/api/provider/presence/models.py,sha256=MkH5Gf0khsm6856ndnYN6WYKfo2Zl-LJX_-GXuQB3jI,1133
+pythonxbox/api/provider/profile/__init__.py,sha256=x71ObWdrFw1VOohf_5b4Kas7-uSIHAs17Ha9Y4jI1Z8,4931
+pythonxbox/api/provider/profile/models.py,sha256=XHirnTYX0gBpvvOSygi1Uw19JkO2B78PWM__wNj4Yxo,1222
+pythonxbox/api/provider/screenshots/__init__.py,sha256=4t4hwjGCP80Hdb8R63eRy4l6uEk-cGMUZ7IWChqTLLI,5720
+pythonxbox/api/provider/screenshots/models.py,sha256=fLmliYx8yzGAiQlsnujCldHKDKjvUGYxEwUz_CUxWow,1176
+pythonxbox/api/provider/smartglass/__init__.py,sha256=TnwBhUZ_wgfHeSkaTOFvyBldLCdEgAFknbH6Sdogpig,11516
+pythonxbox/api/provider/smartglass/models.py,sha256=wgAfH98xnjPGjXKtr7a5NKZSkbjr4F0XvHOcqtQph5g,4264
+pythonxbox/api/provider/titlehub/__init__.py,sha256=uFSFK6huMHfeG_qlHTnsDYfByNyMM_m3XlGUm8obobU,4602
+pythonxbox/api/provider/titlehub/models.py,sha256=zQF3a87lMGpogt6MQhWwg-mTSzYr5PKGnE28Oj8jXD4,2556
+pythonxbox/api/provider/usersearch/__init__.py,sha256=Zn764HCku9_Nq36rkJPVcbx2Xacz4aaTiITTKDIYbz0,912
+pythonxbox/api/provider/usersearch/models.py,sha256=C2l8nJJpaHOwXLiUMpnndbhs_MQYiMQdEkWk0JxPbuc,307
+pythonxbox/api/provider/userstats/__init__.py,sha256=rVh7l_FcMQXXHtEeGJK-IwCdGm8KPsHdTUWhxxdHrkI,5324
+pythonxbox/api/provider/userstats/models.py,sha256=sw9lU0sAPIjg-v943y5c0JYGEIYiuD04rN9mrtXDrds,1001
+pythonxbox/authentication/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonxbox/authentication/manager.py,sha256=pZuk7UvwqALpgj_lWwZtk-dQFpn6JhYWjuwwrWv-HHs,5709
+pythonxbox/authentication/models.py,sha256=299uE2A7xv2ZF1eBWYcg8CPh_xRV9aQD9_viTOfDUnw,3510
+pythonxbox/authentication/xal.py,sha256=hucd4mCfg7_58PJ4rVH25X5RMEMhWU9ZFFFKK77lAgk,11563
+pythonxbox/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonxbox/common/exceptions.py,sha256=9ZliKLYYXxk-7Qn2Kzu7sDplSEFiJUF--9SaMcjD1No,1587
+pythonxbox/common/filetimes.py,sha256=bk27l4KUhBRJwnCF_p0wrJvKdBMMruXGf15g4lUNNUU,3334
+pythonxbox/common/models.py,sha256=wmLXnFlZ1YoyiM-c6dnwzSSulfTzuin0D72_sQ_jN6I,852
+pythonxbox/common/request_signer.py,sha256=5pQBGkXKIrxx89Au-sDOf3VqhntVyc2DGZvVjZpdwTc,5518
+pythonxbox/common/signed_session.py,sha256=TMnWAe7pX5z9Pa7A5oQNjnoI83PhNo0OpRk_hGwCD-s,1886
+pythonxbox/common/ratelimits/__init__.py,sha256=J7NHAfNbab7g_zsvD2cRrKpVzZAkHD6B7QH9iGwT9bc,10126
+pythonxbox/common/ratelimits/models.py,sha256=UmvQGtLd_J33Idx3OlR7QepvhhGSUnKVIg1CvswNCho,358
+pythonxbox/scripts/__init__.py,sha256=Cii7pu86DZq6bZjDFnztxz9Cz1UdNOOeveZf_XcQSbU,455
+pythonxbox/scripts/authenticate.py,sha256=OT5eFtZZ3dN-XWHtMo9ciMJG8NhJCgXVItLBpqNqn-U,5042
+pythonxbox/scripts/change_gamertag.py,sha256=zTvrCRGjUAjRls_9bIoc11UGlAfg9UVhYknqYQtvGRs,3319
+pythonxbox/scripts/friends.py,sha256=TmcpLJ3FJaNMCNc5gVyxabgnlFd2hS_tBYautx1xD6s,2139
+pythonxbox/scripts/search.py,sha256=DusjFE4q10sHVrbdE44kBw0xvv6i_muJqZLCcnO6zzc,1074
+pythonxbox/scripts/xal.py,sha256=G9_ABhUPPwEEroE2NVXmUb3Gx50wl9J2yNhTAKv4hI0,2960
+python_xbox-0.1.0.dist-info/METADATA,sha256=BgVizVDPfU8oWQBCpwRKdVezb11vSuDdT1M0iiOBnfg,7702
+python_xbox-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_xbox-0.1.0.dist-info/entry_points.txt,sha256=9k_ot4_yHrDQTbXDWZPCHtn7S_rJLLv5Sw1Vf__TY78,267
+python_xbox-0.1.0.dist-info/licenses/LICENSE,sha256=NylgC1sD9vQJ92ofyOI0lvDYOuvbTyWa-tCSU8KgeeI,1104
+python_xbox-0.1.0.dist-info/RECORD,,

python_xbox-0.1.0.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.0.dist-info/entry_points.txt

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

python_xbox-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2025 Manfred Dennerlein Rodelo
+Copyright (c) 2020 - 2025 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.

pythonxbox/__init__.py

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

pythonxbox/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 pythonxbox.api.language import DefaultXboxLiveLanguages, XboxLiveLanguage
+from pythonxbox.api.provider.account import AccountProvider
+from pythonxbox.api.provider.achievements import AchievementsProvider
+from pythonxbox.api.provider.catalog import CatalogProvider
+from pythonxbox.api.provider.cqs import CQSProvider
+from pythonxbox.api.provider.gameclips import GameclipProvider
+from pythonxbox.api.provider.lists import ListsProvider
+from pythonxbox.api.provider.mediahub import MediahubProvider
+from pythonxbox.api.provider.message import MessageProvider
+from pythonxbox.api.provider.people import PeopleProvider
+from pythonxbox.api.provider.presence import PresenceProvider
+from pythonxbox.api.provider.profile import ProfileProvider
+from pythonxbox.api.provider.screenshots import ScreenshotsProvider
+from pythonxbox.api.provider.smartglass import SmartglassProvider
+from pythonxbox.api.provider.titlehub import TitlehubProvider
+from pythonxbox.api.provider.usersearch import UserSearchProvider
+from pythonxbox.api.provider.userstats import UserStatsProvider
+from pythonxbox.authentication.manager import AuthenticationManager
+from pythonxbox.common.exceptions import RateLimitExceededException
+from pythonxbox.common.ratelimits import RateLimit
+
+log = logging.getLogger("xbox.api")
+
+
+class Session:
+    def __init__(self, auth_mgr: AuthenticationManager) -> None:
+        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,
+    ) -> None:
+        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

pythonxbox/api/language.py

@@ -0,0 +1,76 @@
+"""
+Language definitions
+"""
+
+
+class XboxLiveLanguage:
+    def __init__(
+        self,
+        name: str,
+        short_id: str,
+        identifier: str,
+        locale: str,
+    ) -> None:
+        """
+        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")

pythonxbox/api/provider/account/__init__.py

@@ -0,0 +1,73 @@
+from pythonxbox.api.provider.account.models import (
+    ChangeGamertagResult,
+    ClaimGamertagResult,
+)
+from pythonxbox.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: str, gamertag: str, **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: str, gamertag: str, preview: bool = 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()

pythonxbox/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