lpdb_python.defs

   1"""
   2Data type wrappers for data from LPDB queries.
   3"""
   4
   5import datetime
   6import json
   7
   8from enum import StrEnum
   9from functools import lru_cache
  10from typing import Any, Optional, Union
  11
  12type Number = Union[int, float]
  13
  14__all__ = [
  15    "OpponentType",
  16    "Broadcasters",
  17    "Company",
  18    "Datapoint",
  19    "ExternalMediaLink",
  20    "Match",
  21    "MatchGame",
  22    "MatchOpponent",
  23    "Placement",
  24    "Player",
  25    "Series",
  26    "SquadPlayer",
  27    "StandingsEntry",
  28    "StandingsTable",
  29    "Team",
  30    "Tournament",
  31    "Transfer",
  32    "TeamTemplate",
  33]
  34
  35
  36@lru_cache
  37def _parseIsoDate(date_str: str) -> Optional[datetime.date]:
  38    try:
  39        return datetime.date.fromisoformat(date_str)
  40    except ValueError:
  41        return None
  42
  43
  44@lru_cache
  45def _parseIsoDateTime(datetime_str: str) -> Optional[datetime.datetime]:
  46    try:
  47        return datetime.datetime.fromisoformat(datetime_str).replace(
  48            tzinfo=datetime.UTC
  49        )
  50    except ValueError:
  51        return None
  52
  53
  54class OpponentType(StrEnum):
  55    """
  56    Enum that defines all valid opponent types in LPDB.
  57    """
  58
  59    team = "team"
  60    solo = "solo"
  61    duo = "duo"
  62    trio = "trio"
  63    quad = "quad"
  64    literal = "literal"
  65
  66
  67class LpdbBaseData:
  68    """
  69    Base class of all LPDB data
  70    """
  71
  72    __raw: dict[str, Any]
  73    """
  74    Raw data from LPDB in Python dict form
  75    """
  76
  77    def __init__(self, raw: dict[str, Any]):
  78        self.__raw = raw.copy()
  79
  80    def _rawGet(self, key: str):
  81        """
  82        Gets the value from LPDB data.
  83
  84        :param key: the key
  85
  86        :return: the value associated with the key, returns `None` if the key does not exist or the value is an empty string
  87        """
  88        value = self.__raw.get(key)
  89        if value == "":
  90            return None
  91        return value
  92
  93    def __repr__(self):
  94        return repr(self.__raw)
  95
  96
  97class LpdbBaseResponseData(LpdbBaseData):
  98    """
  99    Base class of all LPDB response data
 100    """
 101
 102    @property
 103    def pageid(self) -> int:
 104        return self._rawGet("pageid")
 105
 106    @property
 107    def pagename(self) -> str:
 108        return self._rawGet("pagename")
 109
 110    @property
 111    def namespace(self) -> int:
 112        return self._rawGet("namespace")
 113
 114    @property
 115    def objectname(self) -> str:
 116        return self._rawGet("objectname")
 117
 118    @property
 119    def extradata(self) -> Optional[dict[str, Any]]:
 120        return self._rawGet("extradata")
 121
 122    @property
 123    def wiki(self) -> str:
 124        return self._rawGet("wiki")
 125
 126
 127class Broadcasters(LpdbBaseResponseData):
 128    """
 129    Broadcaster data from LPDB.
 130    """
 131
 132    @property
 133    def id(self) -> str:
 134        return self._rawGet("id")
 135
 136    @property
 137    def name(self) -> str:
 138        return self._rawGet("name")
 139
 140    @property
 141    def page(self) -> str:
 142        return self._rawGet("page")
 143
 144    @property
 145    def position(self) -> str:
 146        return self._rawGet("position")
 147
 148    @property
 149    def language(self) -> str:
 150        return self._rawGet("language")
 151
 152    @property
 153    def flag(self) -> str:
 154        return self._rawGet("flag")
 155
 156    @property
 157    def weight(self) -> float:
 158        return self._rawGet("weight")
 159
 160    @property
 161    def date(self) -> Optional[datetime.date]:
 162        return _parseIsoDate(self._rawGet("date"))
 163
 164    @property
 165    def parent(self) -> str:
 166        return self._rawGet("parent")
 167
 168
 169class Company(LpdbBaseResponseData):
 170    """
 171    Company data from LPDB.
 172    """
 173
 174    @property
 175    def name(self) -> str:
 176        return self._rawGet("name")
 177
 178    @property
 179    def image(self) -> str:
 180        return self._rawGet("image")
 181
 182    @property
 183    def imageurl(self) -> str:
 184        return self._rawGet("imageurl")
 185
 186    @property
 187    def imagedark(self) -> str:
 188        return self._rawGet("imagedark")
 189
 190    @property
 191    def imagedarkurl(self) -> str:
 192        return self._rawGet("imagedarkurl")
 193
 194    @property
 195    def locations(self) -> list:
 196        return self._rawGet("locations")
 197
 198    @property
 199    def parentcompany(self) -> str:
 200        return self._rawGet("parentcompany")
 201
 202    @property
 203    def sistercompany(self) -> str:
 204        return self._rawGet("sistercompany")
 205
 206    @property
 207    def industry(self) -> str:
 208        return self._rawGet("industry")
 209
 210    @property
 211    def foundeddate(self) -> Optional[datetime.datetime]:
 212        return _parseIsoDateTime(self._rawGet("foundeddate"))
 213
 214    @property
 215    def defunctdate(self) -> Optional[datetime.datetime]:
 216        return _parseIsoDateTime(self._rawGet("defunctdate"))
 217
 218    @property
 219    def defunctfate(self) -> str:
 220        return self._rawGet("defunctfate")
 221
 222    @property
 223    def links(self) -> dict[str, Any]:
 224        return self._rawGet("links")
 225
 226
 227class Datapoint(LpdbBaseResponseData):
 228    """
 229    Generic datapoint from LPDB.
 230    """
 231
 232    @property
 233    def type(self) -> str:
 234        return self._rawGet("type")
 235
 236    @property
 237    def name(self) -> str:
 238        return self._rawGet("name")
 239
 240    @property
 241    def information(self) -> str:
 242        return self._rawGet("information")
 243
 244    @property
 245    def imageurl(self) -> str:
 246        return self._rawGet("imageurl")
 247
 248    @property
 249    def imagedark(self) -> str:
 250        return self._rawGet("imagedark")
 251
 252    @property
 253    def imagedarkurl(self) -> str:
 254        return self._rawGet("imagedarkurl")
 255
 256    @property
 257    def date(self) -> Optional[datetime.datetime]:
 258        return _parseIsoDateTime(self._rawGet("date"))
 259
 260
 261class ExternalMediaLink(LpdbBaseResponseData):
 262    """
 263    External media link from LPDB.
 264    """
 265
 266    @property
 267    def title(self) -> str:
 268        return self._rawGet("title")
 269
 270    @property
 271    def translatedtitle(self) -> str:
 272        return self._rawGet("translatedtitle")
 273
 274    @property
 275    def link(self) -> str:
 276        return self._rawGet("link")
 277
 278    @property
 279    def date(self) -> Optional[datetime.date]:
 280        return _parseIsoDate(self._rawGet("date"))
 281
 282    @property
 283    def authors(self) -> dict[str, str]:
 284        return self._rawGet("authors")
 285
 286    @property
 287    def language(self) -> str:
 288        return self._rawGet("language")
 289
 290    @property
 291    def publisher(self) -> str:
 292        return self._rawGet("publisher")
 293
 294    @property
 295    def type(self) -> str:
 296        return self._rawGet("type")
 297
 298
 299class Match(LpdbBaseResponseData):
 300    """
 301    Match data from LPDB.
 302    """
 303
 304    @property
 305    def match2id(self) -> str:
 306        return self._rawGet("match2id")
 307
 308    @property
 309    def match2bracketid(self) -> str:
 310        return self._rawGet("match2bracketid")
 311
 312    @property
 313    def status(self) -> str:
 314        return self._rawGet("status")
 315
 316    @property
 317    def winner(self) -> str:
 318        return self._rawGet("winner")
 319
 320    @property
 321    def walkover(self) -> str:
 322        return self._rawGet("walkover")
 323
 324    @property
 325    def resulttype(self) -> str:
 326        return self._rawGet("resulttype")
 327
 328    @property
 329    def finished(self) -> bool:
 330        return bool(self._rawGet("finished"))
 331
 332    @property
 333    def mode(self) -> str:
 334        return self._rawGet("mode")
 335
 336    @property
 337    def type(self) -> str:
 338        return self._rawGet("type")
 339
 340    @property
 341    def section(self) -> str:
 342        return self._rawGet("section")
 343
 344    @property
 345    def game(self) -> str:
 346        return self._rawGet("game")
 347
 348    @property
 349    def patch(self) -> str:
 350        return self._rawGet("patch")
 351
 352    @property
 353    def links(self) -> dict[str, Any]:
 354        return self._rawGet("links")
 355
 356    @property
 357    def bestof(self) -> Optional[int]:
 358        return self._rawGet("bestof")
 359
 360    @property
 361    def date(self) -> Optional[datetime.datetime]:
 362        parsed = _parseIsoDateTime(self._rawGet("date"))
 363        if not self.dateexact:
 364            return parsed
 365        elif self.timezone is not None:
 366            return parsed.astimezone(tz=self.timezone)
 367        return parsed
 368
 369    @property
 370    def dateexact(self) -> bool:
 371        return bool(self._rawGet("dateexact"))
 372
 373    @property
 374    def timezone(self) -> Optional[datetime.timezone]:
 375        """
 376        Timezone information stored in this match.
 377
 378        The `timezone` property from this property does not support IANA time zones.
 379        """
 380        if not self.dateexact:
 381            return None
 382        elif self.extradata is None:
 383            return None
 384        offset: str = self.extradata.get("timezoneoffset")
 385        if offset is None:
 386            return None
 387        sliced_offset = offset.split(":")
 388        offset_delta = datetime.timedelta(
 389            hours=int(sliced_offset[0]), minutes=int(sliced_offset[1])
 390        )
 391        return datetime.timezone(offset_delta, name=self.extradata.get("timezoneid"))
 392
 393    @property
 394    def stream(self) -> dict[str, Any]:
 395        return self._rawGet("stream")
 396
 397    @property
 398    def vod(self) -> str:
 399        return self._rawGet("vod")
 400
 401    @property
 402    def tournament(self) -> str:
 403        return self._rawGet("tournament")
 404
 405    @property
 406    def parent(self) -> str:
 407        return self._rawGet("parent")
 408
 409    @property
 410    def tickername(self) -> str:
 411        return self._rawGet("tickername")
 412
 413    @property
 414    def shortname(self) -> str:
 415        return self._rawGet("shortname")
 416
 417    @property
 418    def series(self) -> str:
 419        return self._rawGet("series")
 420
 421    @property
 422    def icon(self) -> str:
 423        return self._rawGet("icon")
 424
 425    @property
 426    def iconurl(self) -> str:
 427        return self._rawGet("iconurl")
 428
 429    @property
 430    def icondark(self) -> str:
 431        return self._rawGet("icondark")
 432
 433    @property
 434    def icondarkurl(self) -> str:
 435        return self._rawGet("icondarkurl")
 436
 437    @property
 438    def liquipediatier(self) -> str:
 439        return self._rawGet("liquipediatier")
 440
 441    @property
 442    def liquipediatiertype(self) -> str:
 443        return self._rawGet("liquipediatiertype")
 444
 445    @property
 446    def publishertier(self) -> str:
 447        return self._rawGet("publishertier")
 448
 449    @property
 450    def match2bracketdata(self) -> dict:
 451        return self._rawGet("match2bracketdata")
 452
 453    @property
 454    def match2games(self) -> list["MatchGame"]:
 455        return [
 456            MatchGame(self, match2game) for match2game in self._rawGet("match2games")
 457        ]
 458
 459    @property
 460    def match2opponents(self) -> list["MatchOpponent"]:
 461        return [
 462            MatchOpponent(match2opponent)
 463            for match2opponent in self._rawGet("match2opponents")
 464        ]
 465
 466
 467class MatchGame(LpdbBaseData):
 468    """
 469    Game data stored in a match.
 470    """
 471
 472    _parent: "Match"
 473
 474    def __init__(self, parent: "Match", raw: dict[str, Any]):
 475        super().__init__(raw)
 476        self._parent = parent
 477
 478    @property
 479    def map(self) -> str:
 480        return self._rawGet("map")
 481
 482    @property
 483    def subgroup(self) -> str:
 484        return self._rawGet("subgroup")
 485
 486    @property
 487    def match2gameid(self) -> int:
 488        return self._rawGet("match2gameid")
 489
 490    @property
 491    def scores(self) -> list[Number]:
 492        return self._rawGet("scores")
 493
 494    @property
 495    def opponents(self) -> list[dict]:
 496        return self._rawGet("opponents")
 497
 498    @property
 499    def status(self) -> str:
 500        return self._rawGet("status")
 501
 502    @property
 503    def winner(self) -> str:
 504        return self._rawGet("winner")
 505
 506    @property
 507    def walkover(self):
 508        return self._rawGet("walkover")
 509
 510    @property
 511    def resulttype(self) -> str:
 512        return self._rawGet("resulttype")
 513
 514    @property
 515    def date(self) -> datetime.datetime:
 516        parsed = _parseIsoDateTime(self._rawGet("date"))
 517        if not self.dateexact:
 518            return parsed
 519        return parsed.astimezone(self._parent.timezone)
 520
 521    @property
 522    def dateexact(self) -> bool:
 523        return self.extradata.get("dateexact")
 524
 525    @property
 526    def mode(self) -> str:
 527        return self._rawGet("mode")
 528
 529    @property
 530    def type(self) -> str:
 531        return self._rawGet("type")
 532
 533    @property
 534    def game(self) -> str:
 535        return self._rawGet("game")
 536
 537    @property
 538    def patch(self) -> str:
 539        return self._rawGet("patch")
 540
 541    @property
 542    def vod(self) -> str:
 543        return self._rawGet("vod")
 544
 545    @property
 546    def length(self) -> str:
 547        return self._rawGet("length")
 548
 549    @property
 550    def extradata(self) -> Optional[dict[str, Any]]:
 551        return self._rawGet("extradata")
 552
 553
 554class MatchOpponent(LpdbBaseData):
 555    """
 556    Opponent data stored in a match.
 557    """
 558
 559    @property
 560    def id(self) -> int:
 561        return self._rawGet("id")
 562
 563    @property
 564    def type(self) -> OpponentType:
 565        return OpponentType(self._rawGet("type"))
 566
 567    @property
 568    def name(self) -> str:
 569        return self._rawGet("name")
 570
 571    @property
 572    def template(self) -> Optional[str]:
 573        return self._rawGet("template")
 574
 575    @property
 576    def icon(self) -> str:
 577        return self._rawGet("icon")
 578
 579    @property
 580    def score(self) -> Number:
 581        return self._rawGet("score")
 582
 583    @property
 584    def status(self) -> str:
 585        return self._rawGet("status")
 586
 587    @property
 588    def placement(self) -> int:
 589        return self._rawGet("placement")
 590
 591    @property
 592    def match2players(self) -> list[dict]:
 593        return self._rawGet("match2players")
 594
 595    @property
 596    def teamtemplate(self) -> Optional["TeamTemplate"]:
 597        if self.template is None:
 598            return None
 599        return TeamTemplate(self._rawGet("teamtemplate"))
 600
 601    @property
 602    def extradata(self) -> Optional[dict[str, Any]]:
 603        return self._rawGet("extradata")
 604
 605
 606class Placement(LpdbBaseResponseData):
 607    """
 608    Placement data from LPDB.
 609    """
 610
 611    @property
 612    def tournament(self) -> str:
 613        return self._rawGet("tournament")
 614
 615    @property
 616    def series(self) -> str:
 617        return self._rawGet("series")
 618
 619    @property
 620    def parent(self) -> str:
 621        return self._rawGet("parent")
 622
 623    @property
 624    def imageurl(self) -> str:
 625        return self._rawGet("imageurl")
 626
 627    @property
 628    def imagedarkurl(self) -> str:
 629        return self._rawGet("imagedarkurl")
 630
 631    @property
 632    def startdate(self) -> Optional[datetime.datetime]:
 633        return _parseIsoDateTime(self._rawGet("startdate"))
 634
 635    @property
 636    def date(self) -> Optional[datetime.datetime]:
 637        return _parseIsoDateTime(self._rawGet("date"))
 638
 639    @property
 640    def prizemoney(self) -> Number:
 641        return self._rawGet("placement")
 642
 643    @property
 644    def weight(self) -> Number:
 645        return self._rawGet("weight")
 646
 647    @property
 648    def mode(self) -> str:
 649        return self._rawGet("mode")
 650
 651    @property
 652    def type(self) -> str:
 653        return self._rawGet("type")
 654
 655    @property
 656    def liquipediatier(self) -> str:
 657        return self._rawGet("liquipediatier")
 658
 659    @property
 660    def liquipediatiertype(self) -> str:
 661        return self._rawGet("liquipediatiertype")
 662
 663    @property
 664    def publishertier(self) -> str:
 665        return self._rawGet("publishertier")
 666
 667    @property
 668    def icon(self) -> str:
 669        return self._rawGet("icon")
 670
 671    @property
 672    def iconurl(self) -> str:
 673        return self._rawGet("iconurl")
 674
 675    @property
 676    def icondark(self) -> str:
 677        return self._rawGet("icondark")
 678
 679    @property
 680    def icondarkurl(self) -> str:
 681        return self._rawGet("icondarkurl")
 682
 683    @property
 684    def game(self) -> str:
 685        return self._rawGet("game")
 686
 687    @property
 688    def lastvsdata(self) -> dict:
 689        return self._rawGet("lastvsdata")
 690
 691    @property
 692    def opponentname(self) -> str:
 693        return self._rawGet("opponentname")
 694
 695    @property
 696    def opponenttemplate(self) -> Optional[str]:
 697        return self._rawGet("opponenttemplate")
 698
 699    @property
 700    def opponenttype(self) -> OpponentType:
 701        return OpponentType(self._rawGet("opponenttype"))
 702
 703    @property
 704    def opponentplayers(self) -> dict:
 705        return self._rawGet("opponentplayers")
 706
 707    @property
 708    def qualifier(self) -> str:
 709        return self._rawGet("qualifier")
 710
 711    @property
 712    def qualifierpage(self) -> str:
 713        return self._rawGet("qualifierpage")
 714
 715    @property
 716    def qualifierurl(self) -> str:
 717        return self._rawGet("qualifierurl")
 718
 719
 720class Player(LpdbBaseResponseData):
 721    """
 722    Player data from LPDB.
 723    """
 724
 725    @property
 726    def id(self) -> str:
 727        return self._rawGet("id")
 728
 729    @property
 730    def alternateid(self) -> str:
 731        return self._rawGet("alternateid")
 732
 733    @property
 734    def name(self) -> str:
 735        return self._rawGet("name")
 736
 737    @property
 738    def localizedname(self) -> str:
 739        return self._rawGet("localizedname")
 740
 741    @property
 742    def type(self) -> str:
 743        return self._rawGet("type")
 744
 745    @property
 746    def nationality(self) -> str:
 747        return self._rawGet("nationality")
 748
 749    @property
 750    def nationality2(self) -> str:
 751        return self._rawGet("nationality2")
 752
 753    @property
 754    def nationality3(self) -> str:
 755        return self._rawGet("nationality3")
 756
 757    @property
 758    def region(self) -> str:
 759        return self._rawGet("region")
 760
 761    @property
 762    def birthdate(self) -> Optional[datetime.date]:
 763        return _parseIsoDate(self._rawGet("birthdate"))
 764
 765    @property
 766    def deathdate(self) -> Optional[datetime.date]:
 767        return _parseIsoDate(self._rawGet("deathdate"))
 768
 769    @property
 770    def teampagename(self) -> str:
 771        return self._rawGet("teampagename")
 772
 773    @property
 774    def teamtemplate(self) -> str:
 775        return self._rawGet("teamtemplate")
 776
 777    @property
 778    def links(self) -> dict:
 779        return self._rawGet("links")
 780
 781    @property
 782    def status(self) -> str:
 783        return self._rawGet("status")
 784
 785    @property
 786    def earnings(self) -> Number:
 787        return self._rawGet("earnings")
 788
 789    @property
 790    def earningsbyyear(self) -> dict[str, Number]:
 791        return self._rawGet("earningsbyyear")
 792
 793
 794class Series(LpdbBaseResponseData):
 795    """
 796    Tournament series data from LPDB.
 797    """
 798
 799    @property
 800    def name(self) -> str:
 801        return self._rawGet("name")
 802
 803    @property
 804    def abbreviation(self) -> str:
 805        return self._rawGet("abbreviation")
 806
 807    @property
 808    def image(self) -> str:
 809        return self._rawGet("image")
 810
 811    @property
 812    def imageurl(self) -> str:
 813        return self._rawGet("imageurl")
 814
 815    @property
 816    def imagedark(self) -> str:
 817        return self._rawGet("imagedark")
 818
 819    @property
 820    def imagedarkurl(self) -> str:
 821        return self._rawGet("imagedarkurl")
 822
 823    @property
 824    def icon(self) -> str:
 825        return self._rawGet("icon")
 826
 827    @property
 828    def iconurl(self) -> str:
 829        return self._rawGet("iconurl")
 830
 831    @property
 832    def icondark(self) -> str:
 833        return self._rawGet("icondark")
 834
 835    @property
 836    def icondarkurl(self) -> str:
 837        return self._rawGet("icondarkurl")
 838
 839    @property
 840    def game(self) -> str:
 841        return self._rawGet("game")
 842
 843    @property
 844    def type(self) -> str:
 845        return self._rawGet("type")
 846
 847    @property
 848    def organizers(self) -> dict:
 849        return self._rawGet("organizers")
 850
 851    @property
 852    def locations(self) -> dict:
 853        return self._rawGet("locations")
 854
 855    @property
 856    def prizepool(self) -> Number:
 857        return self._rawGet("prizepool")
 858
 859    @property
 860    def liquipediatier(self) -> str:
 861        return self._rawGet("liquipediatier")
 862
 863    @property
 864    def liquipediatiertype(self) -> str:
 865        return self._rawGet("liquipediatiertype")
 866
 867    @property
 868    def publishertier(self) -> str:
 869        return self._rawGet("publishertier")
 870
 871    @property
 872    def launcheddate(self) -> datetime.date:
 873        return _parseIsoDate(self._rawGet("launcheddate"))
 874
 875    @property
 876    def defunctdate(self) -> datetime.date:
 877        return _parseIsoDate(self._rawGet("defunctdate"))
 878
 879    @property
 880    def defunctfate(self) -> str:
 881        return self._rawGet("defunctfate")
 882
 883    @property
 884    def links(self) -> dict:
 885        return self._rawGet("links")
 886
 887
 888class SquadPlayer(LpdbBaseResponseData):
 889    """
 890    Squad player data from LPDB.
 891    """
 892
 893    @property
 894    def id(self) -> str:
 895        return self._rawGet("id")
 896
 897    @property
 898    def link(self) -> str:
 899        return self._rawGet("link")
 900
 901    @property
 902    def name(self) -> str:
 903        return self._rawGet("name")
 904
 905    @property
 906    def nationality(self) -> str:
 907        return self._rawGet("nationality")
 908
 909    @property
 910    def position(self) -> str:
 911        return self._rawGet("position")
 912
 913    @property
 914    def role(self) -> str:
 915        return self._rawGet("role")
 916
 917    @property
 918    def type(self) -> str:
 919        return self._rawGet("type")
 920
 921    @property
 922    def newteam(self) -> str:
 923        return self._rawGet("newteam")
 924
 925    @property
 926    def teamtemplate(self) -> str:
 927        return self._rawGet("teamtemplate")
 928
 929    @property
 930    def newteamtemplate(self) -> str:
 931        return self._rawGet("newteamtemplate")
 932
 933    @property
 934    def status(self) -> str:
 935        return self._rawGet("status")
 936
 937    @property
 938    def joindate(self) -> datetime.date:
 939        return _parseIsoDate(self._rawGet("joindate"))
 940
 941    @property
 942    def joindateref(self) -> dict:
 943        return self._rawGet("joindateref")
 944
 945    @property
 946    def leavedate(self) -> datetime.date:
 947        return _parseIsoDate(self._rawGet("leavedate"))
 948
 949    @property
 950    def leavedateref(self) -> dict:
 951        return self._rawGet("leavedateref")
 952
 953    @property
 954    def inactivedate(self) -> datetime.date:
 955        return _parseIsoDate(self._rawGet("inactivedate"))
 956
 957    @property
 958    def inactivedateref(self) -> dict:
 959        return self._rawGet("inactivedateref")
 960
 961
 962class StandingsEntry(LpdbBaseResponseData):
 963    """
 964    Standings entry from LPDB.
 965    """
 966
 967    @property
 968    def parent(self) -> str:
 969        return self._rawGet("parent")
 970
 971    @property
 972    def standingsindex(self) -> int:
 973        return self._rawGet("standingsindex")
 974
 975    @property
 976    def opponenttype(self) -> OpponentType:
 977        return OpponentType(self._rawGet("opponenttype"))
 978
 979    @property
 980    def opponentname(self) -> str:
 981        return self._rawGet("opponentname")
 982
 983    @property
 984    def opponenttemplate(self) -> str:
 985        return self._rawGet("opponenttemplate")
 986
 987    @property
 988    def opponentplayers(self) -> dict:
 989        return self._rawGet("opponentplayers")
 990
 991    @property
 992    def placement(self) -> int:
 993        return self._rawGet("placement")
 994
 995    @property
 996    def definitestatus(self) -> str:
 997        return self._rawGet("definitestatus")
 998
 999    @property
1000    def currentstatus(self) -> str:
1001        return self._rawGet("currentstatus")
1002
1003    @property
1004    def placementchange(self) -> int:
1005        return self._rawGet("placementchange")
1006
1007    @property
1008    def scoreboard(self) -> dict:
1009        return self._rawGet("scoreboard")
1010
1011    @property
1012    def roundindex(self) -> int:
1013        return self._rawGet("roundindex")
1014
1015    @property
1016    def slotindex(self) -> dict:
1017        return self._rawGet("slotindex")
1018
1019
1020class StandingsTable(LpdbBaseResponseData):
1021    """
1022    Standings table from LPDB.
1023    """
1024
1025    @property
1026    def parent(self) -> str:
1027        return self._rawGet("parent")
1028
1029    @property
1030    def standingsindex(self) -> int:
1031        return self._rawGet("standingsindex")
1032
1033    @property
1034    def title(self) -> str:
1035        return self._rawGet("title")
1036
1037    @property
1038    def tournament(self) -> str:
1039        return self._rawGet("tournament")
1040
1041    @property
1042    def section(self) -> dict:
1043        return self._rawGet("section")
1044
1045    @property
1046    def type(self) -> int:
1047        return self._rawGet("type")
1048
1049    @property
1050    def matches(self) -> list[str]:
1051        return self._rawGet("matches")
1052
1053    @property
1054    def config(self) -> dict:
1055        return self._rawGet("config")
1056
1057
1058class Team(LpdbBaseResponseData):
1059    """
1060    Team data from LPDB.
1061    """
1062
1063    @property
1064    def name(self) -> str:
1065        return self._rawGet("name")
1066
1067    @property
1068    def locations(self) -> dict:
1069        return self._rawGet("locations")
1070
1071    @property
1072    def region(self) -> str:
1073        return self._rawGet("region")
1074
1075    @property
1076    def logo(self) -> str:
1077        return self._rawGet("logo")
1078
1079    @property
1080    def logourl(self) -> str:
1081        return self._rawGet("logourl")
1082
1083    @property
1084    def logodark(self) -> str:
1085        return self._rawGet("logodark")
1086
1087    @property
1088    def logodarkurl(self) -> str:
1089        return self._rawGet("logodarkurl")
1090
1091    @property
1092    def textlesslogourl(self) -> str:
1093        return self._rawGet("textlesslogourl")
1094
1095    @property
1096    def textlesslogodarkurl(self) -> str:
1097        return self._rawGet("textlesslogodarkurl")
1098
1099    @property
1100    def status(self) -> str:
1101        return self._rawGet("status")
1102
1103    @property
1104    def createdate(self) -> Optional[datetime.date]:
1105        return _parseIsoDate(self._rawGet("createdate"))
1106
1107    @property
1108    def disbanddate(self) -> Optional[datetime.date]:
1109        return _parseIsoDate(self._rawGet("disbanddate"))
1110
1111    @property
1112    def earnings(self) -> Number:
1113        return self._rawGet("earnings")
1114
1115    @property
1116    def earningsbyyear(self) -> dict[str, Number]:
1117        return self._rawGet("earningsbyyear")
1118
1119    @property
1120    def template(self) -> str:
1121        return self._rawGet("template")
1122
1123    @property
1124    def links(self) -> dict:
1125        return self._rawGet("links")
1126
1127
1128class Tournament(LpdbBaseResponseData):
1129    """
1130    Tournament data from LPDB.
1131    """
1132
1133    @property
1134    def name(self) -> str:
1135        return self._rawGet("name")
1136
1137    @property
1138    def shortname(self) -> str:
1139        return self._rawGet("shortname")
1140
1141    @property
1142    def tickername(self) -> str:
1143        return self._rawGet("tickername")
1144
1145    @property
1146    def banner(self) -> str:
1147        return self._rawGet("banner")
1148
1149    @property
1150    def bannerurl(self) -> str:
1151        return self._rawGet("bannerurl")
1152
1153    @property
1154    def bannerdark(self) -> str:
1155        return self._rawGet("bannerdark")
1156
1157    @property
1158    def bannerdarkurl(self) -> str:
1159        return self._rawGet("bannerdarkurl")
1160
1161    @property
1162    def icon(self) -> str:
1163        return self._rawGet("icon")
1164
1165    @property
1166    def iconurl(self) -> str:
1167        return self._rawGet("iconurl")
1168
1169    @property
1170    def icondark(self) -> str:
1171        return self._rawGet("icondark")
1172
1173    @property
1174    def icondarkurl(self) -> str:
1175        return self._rawGet("icondarkurl")
1176
1177    @property
1178    def seriespage(self) -> str:
1179        return self._rawGet("seriespage")
1180
1181    @property
1182    def serieslist(self) -> dict:
1183        return self._rawGet("serieslist")
1184
1185    @property
1186    def previous(self) -> str:
1187        return self._rawGet("previous")
1188
1189    @property
1190    def previous2(self) -> str:
1191        return self._rawGet("previous2")
1192
1193    @property
1194    def next(self) -> str:
1195        return self._rawGet("next")
1196
1197    @property
1198    def next2(self) -> str:
1199        return self._rawGet("next2")
1200
1201    @property
1202    def game(self) -> str:
1203        return self._rawGet("game")
1204
1205    @property
1206    def mode(self) -> str:
1207        return self._rawGet("mode")
1208
1209    @property
1210    def patch(self) -> str:
1211        return self._rawGet("patch")
1212
1213    @property
1214    def endpatch(self) -> str:
1215        return self._rawGet("endpatch")
1216
1217    @property
1218    def type(self) -> str:
1219        return self._rawGet("type")
1220
1221    @property
1222    def organizers(self) -> dict:
1223        return self._rawGet("organizers")
1224
1225    @property
1226    def startdate(self) -> datetime.date:
1227        return _parseIsoDate(self._rawGet("startdate"))
1228
1229    @property
1230    def enddate(self) -> datetime.date:
1231        return _parseIsoDate(self._rawGet("enddate"))
1232
1233    @property
1234    def sortdate(self) -> datetime.date:
1235        return _parseIsoDate(self._rawGet("sortdate"))
1236
1237    @property
1238    def locations(self) -> dict:
1239        return self._rawGet("locations")
1240
1241    @property
1242    def prizepool(self) -> Number:
1243        return self._rawGet("prizepool")
1244
1245    @property
1246    def participantsnumber(self) -> int:
1247        return self._rawGet("participantsnumber")
1248
1249    @property
1250    def liquipediatier(self) -> str:
1251        return self._rawGet("liquipediatier")
1252
1253    @property
1254    def liquipediatiertype(self) -> str:
1255        return self._rawGet("liquipediatiertype")
1256
1257    @property
1258    def publishertier(self) -> str:
1259        return self._rawGet("publishertier")
1260
1261    @property
1262    def status(self) -> dict:
1263        return self._rawGet("status")
1264
1265    @property
1266    def maps(self) -> list[str]:
1267        map_data: Optional[str] = self._rawGet("maps")
1268        if map_data is None:
1269            return None
1270        return map_data.split(";")
1271
1272    @property
1273    def format(self) -> str:
1274        return self._rawGet("format")
1275
1276    @property
1277    def sponsors(self) -> dict:
1278        return json.loads(self._rawGet("sponsors"))
1279
1280
1281class Transfer(LpdbBaseResponseData):
1282    """
1283    Transfer data from LPDB.
1284    """
1285
1286    @property
1287    def player(self) -> str:
1288        return self._rawGet("player")
1289
1290    @property
1291    def nationality(self) -> str:
1292        return self._rawGet("nationality")
1293
1294    @property
1295    def fromteam(self) -> str:
1296        return self._rawGet("fromteam")
1297
1298    @property
1299    def toteam(self) -> str:
1300        return self._rawGet("toteam")
1301
1302    @property
1303    def fromteamtemplate(self) -> str:
1304        return self._rawGet("fromteamtemplate")
1305
1306    @property
1307    def toteamtemplate(self) -> str:
1308        return self._rawGet("toteamtemplate")
1309
1310    @property
1311    def role1(self) -> str:
1312        return self._rawGet("role1")
1313
1314    @property
1315    def role2(self) -> str:
1316        return self._rawGet("role2")
1317
1318    @property
1319    def reference(self) -> dict:
1320        return self._rawGet("reference")
1321
1322    @property
1323    def date(self) -> Optional[datetime.datetime]:
1324        return _parseIsoDateTime(self._rawGet("date"))
1325
1326    @property
1327    def wholeteam(self) -> bool:
1328        return bool(self._rawGet("wholeteam"))
1329
1330
1331class TeamTemplate(LpdbBaseData):
1332    """
1333    Team template from LPDB.
1334    """
1335
1336    @property
1337    def template(self) -> str:
1338        return self._rawGet("template")
1339
1340    @property
1341    def page(self) -> str:
1342        return self._rawGet("page")
1343
1344    @property
1345    def name(self) -> str:
1346        return self._rawGet("name")
1347
1348    @property
1349    def shortname(self) -> str:
1350        return self._rawGet("shortname")
1351
1352    @property
1353    def bracketname(self) -> str:
1354        return self._rawGet("bracketname")
1355
1356    @property
1357    def image(self) -> str:
1358        return self._rawGet("image")
1359
1360    @property
1361    def imageurl(self) -> str:
1362        return self._rawGet("imageurl")
1363
1364    @property
1365    def imagedark(self) -> str:
1366        return self._rawGet("imagedark")
1367
1368    @property
1369    def imagedarkurl(self) -> str:
1370        return self._rawGet("imagedarkurl")
1371
1372    @property
1373    def legacyimage(self) -> str:
1374        return self._rawGet("legacyimage")
1375
1376    @property
1377    def legacyimageurl(self) -> str:
1378        return self._rawGet("legacyimageurl")
1379
1380    @property
1381    def legacyimagedark(self) -> str:
1382        return self._rawGet("legacyimagedark")
1383
1384    @property
1385    def legacyimagedarkurl(self) -> str:
1386        return self._rawGet("legacyimagedarkurl")