async def get_item(self, membership_type, membership_id, item_instance_id, components):
"""Retrieve the details of an instanced Destiny Item. An instanced Destiny
item is one with an ItemInstanceId. Non-instanced items, such as materials,
have no useful instance-specific details and thus are not queryable here.
Args:
membership_type (int):
A valid non-BungieNet membership type (BungieMembershipType)
membership_id (int):
Destiny membership ID
item_instance_id (int):
The instance ID of the item
components (list):
A list containing the components to include in the response
(see Destiny.Responses.DestinyItemResponse). At least one
component is required to receive results. Can use either ints
or strings.
Returns:
json (dict)
"""
check_alphanumeric(membership_type, membership_id, item_instance_id)
url = BASE_URL + '{}/Profile/{}/Item/{}/?components={}'
url = url.format(membership_type, membership_id, item_instance_id, ','.join([str(i) for i in components]))
return await self._get_request(url)
async def get_public_milestone_content(self, milestone_hash):
"""Gets custom localized content for the milestone of
the given hash, if it exists.
Returns:
json (dict)
"""
check_alphanumeric(milestone_hash)
url = BASE_URL + 'Milestones/{}/Content/'
url = url.format(milestone_hash)
return await self._get_request(url)
async def get_post_game_carnage_report(self, activity_id):
"""Gets the available post game carnage report for the activity ID
Args:
activity_id (int):
The ID of the activity whose PGCR is requested
Returns:
json (dict)
"""
check_alphanumeric(activity_id)
url = BASE_URL + 'Stats/PostGameCarnageReport/{}/'
url = url.format(activity_id)
return await self._get_request(url)
async def get_clan_weekly_reward_state(self, group_id):
"""Returns information on the weekly clan rewards and if the clan has earned
them or not. Note that this will always report rewards as not redeemed.
Args:
group_id (int):
A valid group ID of a clan
Returns:
json (dict)
"""
check_alphanumeric(group_id)
url = BASE_URL + 'Clan/{}/WeeklyRewardState/'
url = url.format(group_id)
return await self._get_request(url)
async def search_destiny_player(self, membership_type, display_name):
"""Returns a list of Destiny memberships given a full Gamertag or PSN ID
Args:
membership_type (int):
A valid non-BungieNet membership type (BungieMembershipType)
display_name (str):
The full gamertag or PSN id of the player. Spaces and case are ignored.
Returns:
json (dict)
"""
check_alphanumeric(membership_type, display_name)
url = BASE_URL + 'SearchDestinyPlayer/{}/{}/'
url = url.format(membership_type, display_name)
return await self._get_request(url)
async def get_profile(self, membership_type, membership_id, components):
"""Returns Destiny Profile information for the supplied membership
Args:
membership_type (int):
A valid non-BungieNet membership type (BungieMembershipType)
membership_id (int):
Destiny membership ID
components (list):
A list containing the components to include in the response.
(see Destiny.Responses.DestinyProfileResponse). At least one
component is required to receive results. Can use either ints
or strings.
Returns:
json (dict)
"""
check_alphanumeric(membership_type, membership_id)
url = BASE_URL + '{}/Profile/{}/?components={}'
url = url.format(membership_type, membership_id, ','.join([str(i) for i in components]))
print(url)
return await self._get_request(url)
def test_alphabets(self):
check_alphanumeric('abc')
def test_alphabets_numbers(self):
check_alphanumeric('a7b3c1')