def url(self, country: str, lang: str = "en") -> str:
"""
Given a valid `country` code and an optional language it
will provide a url that will redirect to this game's eShop page.
Parameters
----------
country: str
Valid country code.
lang: str (default: "en")
Valid iso-code for language.
Returns
-------
str
URL for the eShop of the game.
Raises
-------
nintendeals.exceptions.InvalidAlpha2Code
The `country` wasn't a valid alpha-2 code.
"""
if not self.nsuid:
return None
validate.alpha_2(country)
return ESHOP_URL.format(country=country, lang=lang, nsuid=self.nsuid)
def get_price(country: str, game: "Game") -> Price:
"""
Given a valid `country` code and a `game` (with an nsuid) it will
retrieve the current pricing of that game for that country.
Parameters
----------
country: str
Valid alpha-2 code of the country.
game
Game to get its pricing.
Returns
-------
nintendeals.classes.prices.Price
Pricing of the game in the indicated country.
Raises
-------
nintendeals.exceptions.InvalidAlpha2Code
The `country` wasn't a valid alpha-2 code.
nintendeals.exceptions.InvalidNsuidFormat
The nsuid of the `game` was either none or invalid.
"""
validate.alpha_2(country)
validate.nsuid_format(game.nsuid)
return _fetch_prices(country, [game.nsuid]).get(game.nsuid)
def test_alpha_2(self, string, is_valid):
if is_valid:
validate.alpha_2(string)
return
with self.assertRaises(exceptions.InvalidAlpha2Code):
validate.alpha_2(string)
def _fetch_prices(country: str, nsuids: List[str]) -> Dict[str, Price]:
if not 51 > len(nsuids) > 0:
raise ValueError("The amount of nsuids must between 1 and 50.")
validate.alpha_2(country)
list(map(validate.nsuid_format, nsuids))
url = PRICE_API.format(country=country, ids=','.join(nsuids))
response = requests.get(url)
json = response.json()
prices = {}
found = 0
sales = 0
for data in json['prices']:
nsuid = str(data["title_id"])
regular_price = data.get("regular_price")
if not regular_price:
prices[nsuid] = None
continue
found += 1
price = Price(
nsuid=nsuid,
country=country,
currency=regular_price["currency"],
value=float(regular_price["raw_value"]),
)
discount_price = data.get("discount_price")
if discount_price:
price.sale_value = float(discount_price["raw_value"])
price.sale_start = date_parser(
discount_price['start_datetime']).replace(tzinfo=None)
price.sale_end = date_parser(
discount_price['end_datetime']).replace(tzinfo=None)
sales += 1
prices[price.nsuid] = price
return prices
def get_prices(country: str,
games: Iterable["Game"]) -> Iterator[Tuple[str, Price]]:
"""
Given a valid `country` code and a list of `games` (each with a nsuid)
it will retrieve the current pricing of those games for that country.
Parameters
----------
country: str
Valid alpha-2 code of the country.
games: List[nintendeals.classes.games.Game]
Games to get their pricing.
Yields
-------
Tuple[str, nintendeals.classes.prices.Price]
Dictionary containing the nsuids as keys and each pricing as value.
Raises
-------
nintendeals.exceptions.InvalidAlpha2Code
The `country` wasn't a valid alpha-2 code.
nintendeals.exceptions.InvalidNsuidFormat
Any of the `games` had an nsuid that was either none or invalid.
"""
validate.alpha_2(country)
games = filter(lambda g: g.nsuid, games)
prices = {}
chunk = []
for game in games:
chunk.append(game)
if len(chunk) == 50:
nsuids = [game.nsuid for game in chunk if game.nsuid]
prices.update(_fetch_prices(country, nsuids))
chunk = []
if chunk:
nsuids = [game.nsuid for game in chunk if game.nsuid]
prices.update(_fetch_prices(country, nsuids))
yield from prices.items()