psnawp 3.0.0__tar.gz

psnawp-3.0.0/AUTHORS.md

@@ -0,0 +1,17 @@
+# Maintainers
+
+- Yoshikage Kira @isFakeAccount <8bit_yoshikage_kira@proton.me>
+
+# Source Contributors
+
+- kerdion @kerdion
+- andshrew @andshrew
+- Omar Mujtaba @omz1990
+- R @Dev-R
+- Jack Powell @jackjpowell
+- Manu @tr4nt0r
+
+# Documentation Contributors
+- andshrew @andshrew
+- Niccolò @NiccoloGranieri
+- R @Dev-R

psnawp-3.0.0/LICENSE.md

@@ -0,0 +1,10 @@
+# PlayStation API Python (PSNAWP)
+The MIT License (MIT)
+
+Copyright (c) 2021 isFakeAccount
+
+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.

psnawp-3.0.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.3
+Name: psnawp
+Version: 3.0.0
+Summary: Python API Wrapper for PlayStation Network API.
+License: # PlayStation API Python (PSNAWP)
+         The MIT License (MIT)
+         
+         Copyright (c) 2021 isFakeAccount
+         
+         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.
+Keywords: PSN,PlayStation
+Author: Yoshikage Kira
+Author-email: 8bit_yoshikage_kira@proton.me
+Requires-Python: >=3.10, <4.0
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: pycountry (>=24.6.1,<25.0.0)
+Requires-Dist: pyrate-limiter (>=3.7.0,<4.0.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
+Project-URL: Documentation, https://psnawp.readthedocs.io/en/latest/
+Project-URL: Homepage, https://github.com/isFakeAccount/psnawp
+Project-URL: Repository, https://github.com/isFakeAccount/psnawp
+Project-URL: changelog, https://github.com/isFakeAccount/psnawp/commits/master/
+Description-Content-Type: text/markdown
+
+# <img src="docs/_static/psn_logo.png" alt="PlayStation Logo" height="35px"> PlayStation Network API Wrapper Python (PSNAWP)
+
+Retrieve User Information, Trophies, Game and Store data from the PlayStation Network.
+
+[![PyPI version](https://badge.fury.io/py/PSNAWP.svg)](https://badge.fury.io/py/PSNAWP)
+[![Downloads](https://static.pepy.tech/badge/psnawp)](https://www.pepy.tech/projects/psnawp)
+[![python-logo](https://img.shields.io/badge/python-3.10_|_3.11_|_3.12_|_3.13-blue.svg)](https://www.python.org/)
+[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+[![Documentation Status](https://readthedocs.org/projects/psnawp/badge/?version=latest)](https://psnawp.readthedocs.io/en/latest/?badge=latest)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+[![pre-commit](https://github.com/isFakeAccount/psnawp/actions/workflows/pre-commit.yaml/badge.svg)](https://github.com/isFakeAccount/psnawp/actions/workflows/pre-commit.yaml)
+[![Pytest](https://github.com/isFakeAccount/psnawp/actions/workflows/pytest-entry.yaml/badge.svg)](https://github.com/isFakeAccount/psnawp/actions/workflows/pytest-entry.yaml)
+[![codecov](https://codecov.io/gh/isFakeAccount/psnawp/graph/badge.svg?token=W8755O8BQ9)](https://codecov.io/gh/isFakeAccount/psnawp)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/license/MIT)
+
+<!-- Pytest Coverage Comment:Begin -->
+<a href="https://github.com/isFakeAccount/psnawp/blob/master/README.md"><img alt="Coverage" src="https://img.shields.io/badge/Coverage-94%25-brightgreen.svg" /></a><details><summary>Coverage Report </summary><table><tr><th>File</th><th>Stmts</th><th>Miss</th><th>Cover</th><th>Missing</th></tr><tbody><tr><td colspan="5"><b>src/psnawp_api</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/psnawp.py">psnawp.py</a></td><td>47</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/core</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/__init__.py">__init__.py</a></td><td>4</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/authenticator.py">authenticator.py</a></td><td>131</td><td>17</td><td>17</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/authenticator.py#L 87%"> 87%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/psnawp_exceptions.py">psnawp_exceptions.py</a></td><td>12</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/request_builder.py">request_builder.py</a></td><td>80</td><td>9</td><td>9</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/request_builder.py#L 89%"> 89%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/__init__.py">__init__.py</a></td><td>5</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/client.py">client.py</a></td><td>85</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/game_entitlements.py">game_entitlements.py</a></td><td>68</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/game_title.py">game_title.py</a></td><td>45</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/title_stats.py">title_stats.py</a></td><td>72</td><td>1</td><td>1</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/title_stats.py#L 99%"> 99%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/user.py">user.py</a></td><td>87</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/models/group</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group.py">group.py</a></td><td>56</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group_datatypes.py">group_datatypes.py</a></td><td>42</td><td>42</td><td>42</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group_datatypes.py#L  0%">  0%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/listing</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/pagination_iterator.py">pagination_iterator.py</a></td><td>52</td><td>2</td><td>2</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/pagination_iterator.py#L 96%"> 96%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/search</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/__init__.py">__init__.py</a></td><td>4</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search.py">games_search.py</a></td><td>58</td><td>1</td><td>1</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search.py#L 98%"> 98%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search_datatypes.py">games_search_datatypes.py</a></td><td>95</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/universal_search.py">universal_search.py</a></td><td>13</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_result_datatypes.py">users_result_datatypes.py</a></td><td>57</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_search.py">users_search.py</a></td><td>56</td><td>2</td><td>2</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_search.py#L 96%"> 96%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/trophies</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/__init__.py">__init__.py</a></td><td>6</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy.py">trophy.py</a></td><td>106</td><td>7</td><td>7</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy.py#L 93%"> 93%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_constants.py">trophy_constants.py</a></td><td>33</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_group.py">trophy_group.py</a></td><td>65</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_summary.py">trophy_summary.py</a></td><td>20</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_titles.py">trophy_titles.py</a></td><td>71</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_utils.py">trophy_utils.py</a></td><td>6</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/utils</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/__init__.py">__init__.py</a></td><td>3</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/endpoints.py">endpoints.py</a></td><td>3</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/misc.py">misc.py</a></td><td>42</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td><b>TOTAL</b></td><td><b>1430</b></td><td><b>81</b></td><td><b>94%</b></td><td>&nbsp;</td></tr></tbody></table></details>
+<!-- Pytest Coverage Comment:End -->
+
+## How to install
+
+### From PyPI
+
+```
+pip install PSNAWP
+```
+
+## Important Links
+> PyPI: https://pypi.org/project/PSNAWP/
+>
+> Read the Docs: https://psnawp.readthedocs.io
+
+## Getting Started
+
+> [!CAUTION]
+> This library is an unofficial and reverse-engineered API wrapper for the PlayStation Network (PSN). It has been developed based on the reverse engineering of the PSN Android app. The API wrapper (>= v2.1.0) will self rate limit at 300 requests per 15 minutes. However, it is still important that you don't send bulk requests using this API. Excessive use of API may lead to your PSN account being temporarily or permanently banned.
+>
+> You can also create a dedicated account to use this library so that in the worst-case scenario you do not lose access to your primary account, along with your video games and progress.
+
+To get started you need to obtain npsso <64 character code>. You need to follow the following steps
+
+1. Login into your [My PlayStation](https://my.playstation.com/) account.
+2. In another tab, go to `https://ca.account.sony.com/api/v1/ssocookie`
+3. If you are logged in you should see a text similar to this
+
+```json
+{"npsso":"<64 character npsso code>"}
+```
+This npsso code will be used in the api for authentication purposes. The refresh token that is generated from npsso lasts about 2 months. After that you have to get a new npsso token. The bot will print a warning if there are less than 3 days left in refresh token expiration.
+
+Following is the quick example on how to use this library
+
+```py
+from psnawp_api import PSNAWP
+from psnawp_api.models import SearchDomain
+from psnawp_api.models.trophies import PlatformType
+
+psnawp = PSNAWP("<64 character npsso code>")
+
+# Your Personal Account Info
+client = psnawp.me()
+print(f"Online ID: {client.online_id}")
+print(f"Account ID: {client.account_id}")
+print(f"Region: {client.get_region()}")
+print(f"Profile: {client.get_profile_legacy()} \n")
+
+# Your Registered Devices
+devices = client.get_account_devices()
+for device in devices:
+    print(f"Device: {device} \n")
+
+# Your Friends List
+friends_list = client.friends_list()
+for friend in friends_list:
+    print(f"Friend: {friend} \n")
+
+# Your Players Blocked List
+blocked_list = client.blocked_list()
+for blocked_user in blocked_list:
+    print(f"Blocked User: {blocked_user} \n")
+
+# Your Friends in "Notify when available" List
+available_to_play = client.available_to_play()
+for user in available_to_play:
+    print(f"Available to Play: {user} \n")
+
+# Your trophies (PS4)
+for trophy in client.trophies("NPWR22810_00", PlatformType.PS4):
+    print(trophy)
+
+# Your Chat Groups
+groups = client.get_groups()
+first_group_id = None  # This will be used later to test group methods
+for id, group in enumerate(groups):
+    if id == 0:  # Get the first group ID
+        first_group_id = group.group_id
+
+    group_info = group.get_group_information()
+    print(f"Group {id}: {group_info} \n")
+
+# Your Playing time (PS4, PS5 above only)
+titles_with_stats = client.title_stats()
+for title in titles_with_stats:
+    print(
+        f" \
+        Game: {title.name} - \
+        Play Count: {title.play_count} - \
+        Play Duration: {title.play_duration} \n"
+    )
+
+
+# Other User's
+example_user_1 = psnawp.user(online_id="VaultTec-Co")  # Get a PSN player by their Online ID
+print(f"User 1 Online ID: {example_user_1.online_id}")
+print(f"User 1 Account ID: {example_user_1.account_id}")
+print(f"User 1 Region: {example_user_1.get_region()}")
+
+print(example_user_1.profile())
+print(example_user_1.prev_online_id)
+print(example_user_1.get_presence())
+print(example_user_1.friendship())
+print(example_user_1.is_blocked())
+
+# Example of getting a user by their account ID
+user_account_id = psnawp.user(account_id="9122947611907501295")
+print(f"User Account ID: {user_account_id.online_id}")
+
+
+# Messaging and Groups Interaction
+group = psnawp.group(group_id=first_group_id)  # This is the first group ID we got earlier - i.e. the first group in your groups list
+print(group.get_group_information())
+print(group.get_conversation(10))  # Get the last 10 messages in the group
+print(group.send_message("Hello World"))
+print(group.change_name("API Testing 3"))
+# print(group.leave_group()) # Uncomment to leave the group
+
+# Create a new group with other users - i.e. 'VaultTec-Co' and 'test'
+example_user_2 = psnawp.user(online_id="test")
+new_group = psnawp.group(users_list=[example_user_1, example_user_2])
+print(new_group.get_group_information())
+# You can use the same above methods to interact with the new group - i.e. send messages, change name, etc.
+
+# Searching for Game Titles
+search = psnawp.search(search_query="GTA 5", search_domain=SearchDomain.FULL_GAMES)
+for search_result in search:
+    print(search_result["result"]["invariantName"])
+
+ ```
+
+**Note: If you want to create multiple instances of psnawp you need to get npsso code from separate PSN accounts. If you generate a new npsso with same account your previous npsso will expire immediately.**
+
+## Contribution
+
+All bug reposts and features requests are welcomed, although I am new at making python libraries, so it may take me a while to implement some features. Suggestions are welcomes if I am doing something that is an unconventional way of doing it.
+
+## Disclaimer
+
+This project was not intended to be used for spam, abuse, or anything of the sort. Any use of this project for those purposes is not endorsed. Please keep this in mind when creating applications using this API wrapper.
+
+## Credit
+
+This project contains code from PlayStationNetwork::API and PSN-PHP Wrapper that was translated to Python. Also, special thanks @andshrew for documenting the PlayStation Trophy endpoints. All licenses are included in this repository.
+

psnawp-3.0.0/README.md

@@ -0,0 +1,163 @@
+# <img src="docs/_static/psn_logo.png" alt="PlayStation Logo" height="35px"> PlayStation Network API Wrapper Python (PSNAWP)
+
+Retrieve User Information, Trophies, Game and Store data from the PlayStation Network.
+
+[![PyPI version](https://badge.fury.io/py/PSNAWP.svg)](https://badge.fury.io/py/PSNAWP)
+[![Downloads](https://static.pepy.tech/badge/psnawp)](https://www.pepy.tech/projects/psnawp)
+[![python-logo](https://img.shields.io/badge/python-3.10_|_3.11_|_3.12_|_3.13-blue.svg)](https://www.python.org/)
+[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+[![Documentation Status](https://readthedocs.org/projects/psnawp/badge/?version=latest)](https://psnawp.readthedocs.io/en/latest/?badge=latest)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+[![pre-commit](https://github.com/isFakeAccount/psnawp/actions/workflows/pre-commit.yaml/badge.svg)](https://github.com/isFakeAccount/psnawp/actions/workflows/pre-commit.yaml)
+[![Pytest](https://github.com/isFakeAccount/psnawp/actions/workflows/pytest-entry.yaml/badge.svg)](https://github.com/isFakeAccount/psnawp/actions/workflows/pytest-entry.yaml)
+[![codecov](https://codecov.io/gh/isFakeAccount/psnawp/graph/badge.svg?token=W8755O8BQ9)](https://codecov.io/gh/isFakeAccount/psnawp)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/license/MIT)
+
+<!-- Pytest Coverage Comment:Begin -->
+<a href="https://github.com/isFakeAccount/psnawp/blob/master/README.md"><img alt="Coverage" src="https://img.shields.io/badge/Coverage-94%25-brightgreen.svg" /></a><details><summary>Coverage Report </summary><table><tr><th>File</th><th>Stmts</th><th>Miss</th><th>Cover</th><th>Missing</th></tr><tbody><tr><td colspan="5"><b>src/psnawp_api</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/psnawp.py">psnawp.py</a></td><td>47</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/core</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/__init__.py">__init__.py</a></td><td>4</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/authenticator.py">authenticator.py</a></td><td>131</td><td>17</td><td>17</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/authenticator.py#L 87%"> 87%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/psnawp_exceptions.py">psnawp_exceptions.py</a></td><td>12</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/request_builder.py">request_builder.py</a></td><td>80</td><td>9</td><td>9</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/core/request_builder.py#L 89%"> 89%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/__init__.py">__init__.py</a></td><td>5</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/client.py">client.py</a></td><td>85</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/game_entitlements.py">game_entitlements.py</a></td><td>68</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/game_title.py">game_title.py</a></td><td>45</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/title_stats.py">title_stats.py</a></td><td>72</td><td>1</td><td>1</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/title_stats.py#L 99%"> 99%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/user.py">user.py</a></td><td>87</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/models/group</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group.py">group.py</a></td><td>56</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group_datatypes.py">group_datatypes.py</a></td><td>42</td><td>42</td><td>42</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/group/group_datatypes.py#L  0%">  0%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/listing</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/__init__.py">__init__.py</a></td><td>2</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/pagination_iterator.py">pagination_iterator.py</a></td><td>52</td><td>2</td><td>2</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/listing/pagination_iterator.py#L 96%"> 96%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/search</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/__init__.py">__init__.py</a></td><td>4</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search.py">games_search.py</a></td><td>58</td><td>1</td><td>1</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search.py#L 98%"> 98%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/games_search_datatypes.py">games_search_datatypes.py</a></td><td>95</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/universal_search.py">universal_search.py</a></td><td>13</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_result_datatypes.py">users_result_datatypes.py</a></td><td>57</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_search.py">users_search.py</a></td><td>56</td><td>2</td><td>2</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/search/users_search.py#L 96%"> 96%</a></td></tr><tr><td colspan="5"><b>src/psnawp_api/models/trophies</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/__init__.py">__init__.py</a></td><td>6</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy.py">trophy.py</a></td><td>106</td><td>7</td><td>7</td><td><a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy.py#L 93%"> 93%</a></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_constants.py">trophy_constants.py</a></td><td>33</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_group.py">trophy_group.py</a></td><td>65</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_summary.py">trophy_summary.py</a></td><td>20</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_titles.py">trophy_titles.py</a></td><td>71</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/models/trophies/trophy_utils.py">trophy_utils.py</a></td><td>6</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td colspan="5"><b>src/psnawp_api/utils</b></td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/__init__.py">__init__.py</a></td><td>3</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/endpoints.py">endpoints.py</a></td><td>3</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td>&nbsp; &nbsp;<a href="https://github.com/isFakeAccount/psnawp/blob/master/src/psnawp_api/utils/misc.py">misc.py</a></td><td>42</td><td>0</td><td>100%</td><td>&nbsp;</td></tr><tr><td><b>TOTAL</b></td><td><b>1430</b></td><td><b>81</b></td><td><b>94%</b></td><td>&nbsp;</td></tr></tbody></table></details>
+<!-- Pytest Coverage Comment:End -->
+
+## How to install
+
+### From PyPI
+
+```
+pip install PSNAWP
+```
+
+## Important Links
+> PyPI: https://pypi.org/project/PSNAWP/
+>
+> Read the Docs: https://psnawp.readthedocs.io
+
+## Getting Started
+
+> [!CAUTION]
+> This library is an unofficial and reverse-engineered API wrapper for the PlayStation Network (PSN). It has been developed based on the reverse engineering of the PSN Android app. The API wrapper (>= v2.1.0) will self rate limit at 300 requests per 15 minutes. However, it is still important that you don't send bulk requests using this API. Excessive use of API may lead to your PSN account being temporarily or permanently banned.
+>
+> You can also create a dedicated account to use this library so that in the worst-case scenario you do not lose access to your primary account, along with your video games and progress.
+
+To get started you need to obtain npsso <64 character code>. You need to follow the following steps
+
+1. Login into your [My PlayStation](https://my.playstation.com/) account.
+2. In another tab, go to `https://ca.account.sony.com/api/v1/ssocookie`
+3. If you are logged in you should see a text similar to this
+
+```json
+{"npsso":"<64 character npsso code>"}
+```
+This npsso code will be used in the api for authentication purposes. The refresh token that is generated from npsso lasts about 2 months. After that you have to get a new npsso token. The bot will print a warning if there are less than 3 days left in refresh token expiration.
+
+Following is the quick example on how to use this library
+
+```py
+from psnawp_api import PSNAWP
+from psnawp_api.models import SearchDomain
+from psnawp_api.models.trophies import PlatformType
+
+psnawp = PSNAWP("<64 character npsso code>")
+
+# Your Personal Account Info
+client = psnawp.me()
+print(f"Online ID: {client.online_id}")
+print(f"Account ID: {client.account_id}")
+print(f"Region: {client.get_region()}")
+print(f"Profile: {client.get_profile_legacy()} \n")
+
+# Your Registered Devices
+devices = client.get_account_devices()
+for device in devices:
+    print(f"Device: {device} \n")
+
+# Your Friends List
+friends_list = client.friends_list()
+for friend in friends_list:
+    print(f"Friend: {friend} \n")
+
+# Your Players Blocked List
+blocked_list = client.blocked_list()
+for blocked_user in blocked_list:
+    print(f"Blocked User: {blocked_user} \n")
+
+# Your Friends in "Notify when available" List
+available_to_play = client.available_to_play()
+for user in available_to_play:
+    print(f"Available to Play: {user} \n")
+
+# Your trophies (PS4)
+for trophy in client.trophies("NPWR22810_00", PlatformType.PS4):
+    print(trophy)
+
+# Your Chat Groups
+groups = client.get_groups()
+first_group_id = None  # This will be used later to test group methods
+for id, group in enumerate(groups):
+    if id == 0:  # Get the first group ID
+        first_group_id = group.group_id
+
+    group_info = group.get_group_information()
+    print(f"Group {id}: {group_info} \n")
+
+# Your Playing time (PS4, PS5 above only)
+titles_with_stats = client.title_stats()
+for title in titles_with_stats:
+    print(
+        f" \
+        Game: {title.name} - \
+        Play Count: {title.play_count} - \
+        Play Duration: {title.play_duration} \n"
+    )
+
+
+# Other User's
+example_user_1 = psnawp.user(online_id="VaultTec-Co")  # Get a PSN player by their Online ID
+print(f"User 1 Online ID: {example_user_1.online_id}")
+print(f"User 1 Account ID: {example_user_1.account_id}")
+print(f"User 1 Region: {example_user_1.get_region()}")
+
+print(example_user_1.profile())
+print(example_user_1.prev_online_id)
+print(example_user_1.get_presence())
+print(example_user_1.friendship())
+print(example_user_1.is_blocked())
+
+# Example of getting a user by their account ID
+user_account_id = psnawp.user(account_id="9122947611907501295")
+print(f"User Account ID: {user_account_id.online_id}")
+
+
+# Messaging and Groups Interaction
+group = psnawp.group(group_id=first_group_id)  # This is the first group ID we got earlier - i.e. the first group in your groups list
+print(group.get_group_information())
+print(group.get_conversation(10))  # Get the last 10 messages in the group
+print(group.send_message("Hello World"))
+print(group.change_name("API Testing 3"))
+# print(group.leave_group()) # Uncomment to leave the group
+
+# Create a new group with other users - i.e. 'VaultTec-Co' and 'test'
+example_user_2 = psnawp.user(online_id="test")
+new_group = psnawp.group(users_list=[example_user_1, example_user_2])
+print(new_group.get_group_information())
+# You can use the same above methods to interact with the new group - i.e. send messages, change name, etc.
+
+# Searching for Game Titles
+search = psnawp.search(search_query="GTA 5", search_domain=SearchDomain.FULL_GAMES)
+for search_result in search:
+    print(search_result["result"]["invariantName"])
+
+ ```
+
+**Note: If you want to create multiple instances of psnawp you need to get npsso code from separate PSN accounts. If you generate a new npsso with same account your previous npsso will expire immediately.**
+
+## Contribution
+
+All bug reposts and features requests are welcomed, although I am new at making python libraries, so it may take me a while to implement some features. Suggestions are welcomes if I am doing something that is an unconventional way of doing it.
+
+## Disclaimer
+
+This project was not intended to be used for spam, abuse, or anything of the sort. Any use of this project for those purposes is not endorsed. Please keep this in mind when creating applications using this API wrapper.
+
+## Credit
+
+This project contains code from PlayStationNetwork::API and PSN-PHP Wrapper that was translated to Python. Also, special thanks @andshrew for documenting the PlayStation Trophy endpoints. All licenses are included in this repository.

psnawp-3.0.0/pyproject.toml

@@ -0,0 +1,129 @@
+[project]
+authors = [{ name = "Yoshikage Kira", email = "8bit_yoshikage_kira@proton.me" }]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pycountry (>=24.6.1,<25.0.0)",
+    "pyrate-limiter (>=3.7.0,<4.0.0)",
+    "requests (>=2.32.3,<3.0.0)",
+    "typing-extensions (>=4.12.2,<5.0.0)",
+]
+description = "Python API Wrapper for PlayStation Network API."
+keywords = ["PSN", "PlayStation"]
+license = { file = "LICENSE.md" }
+name = "psnawp"
+readme = "README.md"
+requires-python = ">=3.10, <4.0"
+version = "3.0.0"
+
+[tool.poetry.group.typing.dependencies]
+mypy           = { version = "^1.15.0", python = ">=3.11,<4.0.0" }
+pyright        = { version = "^1.1.398", python = ">=3.11,<4.0.0" }
+types-requests = { version = "^2.31.0", python = ">=3.11,<4.0.0" }
+
+[tool.poetry.group.docs.dependencies]
+myst-parser       = { extras = ["linkify"], version = "^4.0.1", python = ">=3.11,<4.0.0" }
+sphinx            = { version = "^8.2.3", python = ">=3.11,<4.0.0" }
+sphinx-book-theme = { version = "^1.1.4", python = ">=3.11,<4.0.0" }
+sphinx-copybutton = { version = "^0.5.2", python = ">=3.11,<4.0.0" }
+
+[tool.poetry.group.linting.dependencies]
+docstrfmt  = { version = "^1.10.0", python = ">=3.11,<4.0.0" }
+pre-commit = { version = "^4.2.0", python = ">=3.11,<4.0.0" }
+ruff       = { version = "^0.11.2", python = ">=3.11,<4.0.0" }
+
+[tool.poetry.group.tests.dependencies]
+jsonschema    = { version = "^4.23.0", python = ">=3.10,<4.0.0" }
+pytest        = { version = "^8.3.5", python = ">=3.10,<4.0.0" }
+pytest-cov    = { version = "^6.0.0", python = ">=3.10,<4.0.0" }
+pytest-vcr    = { version = "^1.0.2", python = ">=3.10,<4.0.0" }
+python-dotenv = { version = "^1.1.0", python = ">=3.10,<4.0.0" }
+vcrpy         = { version = "^7.0.0", python = ">=3.10,<4.0.0" }
+
+[project.urls]
+changelog     = "https://github.com/isFakeAccount/psnawp/commits/master/"
+documentation = "https://psnawp.readthedocs.io/en/latest/"
+homepage      = "https://github.com/isFakeAccount/psnawp"
+repository    = "https://github.com/isFakeAccount/psnawp"
+
+[build-system]
+build-backend = "poetry.core.masonry.api"
+requires      = ["poetry-core>=2.0.0,<3.0.0"]
+
+[tool.poetry]
+packages = [{ include = "psnawp_api", from = "src" }]
+
+[tool.pytest.ini_options]
+addopts   = "--cov=psnawp_api --cov-report html --cov-report term --cov-report xml --junitxml=pytest.xml"
+testpaths = ["tests"]
+
+[tool.coverage.report]
+exclude_also = [
+    "@overload",
+    "__repr__",
+    "__str__",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]
+
+[tool.mypy]
+check_untyped_defs     = true
+disallow_any_generics  = true
+exclude                = [".venv", "venv"]
+ignore_missing_imports = true
+no_implicit_optional   = true
+no_implicit_reexport   = true
+show_error_codes       = true
+strict                 = true
+strict_equality        = true
+warn_redundant_casts   = true
+warn_return_any        = true
+warn_unreachable       = true
+warn_unused_configs    = true
+
+[tool.pyright]
+exclude            = [".venv", "venv"]
+pythonVersion      = "3.10"
+reportPrivateUsage = false
+typeCheckingMode   = "strict"
+
+[tool.ruff]
+line-length = 160
+
+[tool.ruff.format]
+docstring-code-format      = true
+docstring-code-line-length = 88
+
+[tool.ruff.lint]
+ignore = [
+    "COM812", # Allow missing trailing comma. (handled by ruff format)
+    "D203",   # Allow class doc strings without requiring a blank line before them (conflicts with D211).
+    "D213",   # Allow multi-line docstring summaries to end on the first line (conflicts with D212).
+    "D401",   # Allow docstring summaries that are not in imperative mood.
+    "EM",     # Allow exception messages that do not follow specific formatting rules.
+    "FBT",    # Allow functions to take boolean positional arguments.
+    "S311",   # Allow use of Standard pseudo-random generators.
+    "S603",   # Allow `subprocess` calls without enforcing `shell=False` (potential security risk).
+    "T201",   # Allow usage of `print()` instead of enforcing logging.
+    "TRY003", # Allow specifying long error messages inside the exception class instead of outside.
+]
+select = ["ALL"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*.py" = ["D", "S101", "SIM117"]
+
+[tool.ruff.lint.pylint]
+max-args = 15
+
+[tool.docstrfmt]
+line-length = 120

psnawp-3.0.0/src/psnawp_api/__init__.py

@@ -0,0 +1,5 @@
+"""PlayStation Network API Wrapper Python (PSNAWP) Retrieve User Information, Trophies, Game and Store data from the PlayStation Network."""
+
+from psnawp_api.psnawp import PSNAWP
+
+__all__ = ["PSNAWP"]

psnawp-3.0.0/src/psnawp_api/core/__init__.py

@@ -0,0 +1,50 @@
+"""Core package for the PlayStation API wrapper.
+
+This package contains the foundational modules responsible for handling core functionalities such as authentication,
+request management, and exception handling.
+
+Modules in this package include:
+
+- Authentication setup and token refresh.
+- HTTP session and request logic.
+- Custom exception classes and error handling utilities.
+
+"""
+
+from psnawp_api.core.authenticator import Authenticator
+from psnawp_api.core.psnawp_exceptions import (
+    PSNAWPAuthenticationError,
+    PSNAWPBadRequestError,
+    PSNAWPClientError,
+    PSNAWPError,
+    PSNAWPForbiddenError,
+    PSNAWPIllegalArgumentError,
+    PSNAWPNotAllowedError,
+    PSNAWPNotFoundError,
+    PSNAWPServerError,
+    PSNAWPTooManyRequestsError,
+    PSNAWPUnauthorizedError,
+)
+from psnawp_api.core.request_builder import (
+    RequestBuilder,
+    RequestBuilderHeaders,
+    RequestOptions,
+)
+
+__all__ = [
+    "Authenticator",
+    "PSNAWPAuthenticationError",
+    "PSNAWPBadRequestError",
+    "PSNAWPClientError",
+    "PSNAWPError",
+    "PSNAWPForbiddenError",
+    "PSNAWPIllegalArgumentError",
+    "PSNAWPNotAllowedError",
+    "PSNAWPNotFoundError",
+    "PSNAWPServerError",
+    "PSNAWPTooManyRequestsError",
+    "PSNAWPUnauthorizedError",
+    "RequestBuilder",
+    "RequestBuilderHeaders",
+    "RequestOptions",
+]