nba_api 1.7__0-py3-none-any.whl

nba_api/__init__.py

@@ -0,0 +1 @@
+name = "nba_api"

nba_api/library/_enum_base.py

@@ -0,0 +1,48 @@
+from enum import Enum, EnumMeta
+
+
+class OnAccess(EnumMeta):
+    """
+    runs a user-specified function whenever member is accessed
+    """
+
+    def __getattribute__(cls, name):
+        obj = super().__getattribute__(name)
+        if isinstance(obj, Enum) and obj._on_access:
+            obj._on_access()
+        return obj
+
+    def __getitem__(cls, name):
+        member = super().__getitem__(name)
+        if member._on_access:
+            member._on_access()
+        return member
+
+    def __call__(
+        cls, value, names=None, *, module=None, qualname=None, type=None, start=1
+    ):
+        obj = super().__call__(
+            value, names, module=module, qualname=qualname, type=type, start=start
+        )
+        if isinstance(obj, Enum) and obj._on_access:
+            obj._on_access()
+        return obj
+
+
+class DeprecatedEnum(Enum, metaclass=OnAccess):
+    def __new__(cls, value, *args):
+        member = object.__new__(cls)
+        member._value_ = value
+        member._args = args
+        member._on_access = member.deprecate if args else None
+        return member
+
+    def deprecate(self):
+        args = self._args
+        import warnings
+
+        warnings.warn(
+            "%s" % args,
+            DeprecationWarning,
+            stacklevel=3,
+        )

nba_api/library/debug/debug.py

@@ -0,0 +1,8 @@
+DEBUG = False
+
+# Saving and loading responses from text files so that you do not have to do multiple requests when debugging.
+DEBUG_STORAGE = False
+
+# PROXY = ''
+
+# STATS_HEADERS = {}

nba_api/library/http.py

@@ -0,0 +1,183 @@
+import os
+import json
+import random
+import requests
+
+from urllib.parse import quote_plus
+
+try:
+    from nba_api.library.debug.debug import DEBUG
+except ImportError:
+    DEBUG = False
+
+
+try:
+    from nba_api.library.debug.debug import DEBUG_STORAGE
+except ImportError:
+    DEBUG_STORAGE = False
+
+
+try:
+    from nba_api.library.debug.debug import PROXY
+except ImportError:
+    PROXY = ""
+
+
+if DEBUG:
+    from hashlib import md5
+
+    print("DEBUG MODE")
+
+
+class NBAResponse:
+    def __init__(self, response, status_code, url):
+        self._response = response
+        self._status_code = status_code
+        self._url = url
+
+    def get_response(self):
+        return self._response
+
+    def get_dict(self):
+        return json.loads(self._response)
+
+    def get_json(self):
+        return json.dumps(self.get_dict())
+
+    def valid_json(self):
+        try:
+            self.get_dict()
+        except ValueError:
+            return False
+        return True
+
+    def get_url(self):
+        return self._url
+
+
+class NBAHTTP:
+    nba_response = NBAResponse
+
+    base_url = None
+
+    parameters = None
+
+    headers = None
+
+    _session = None
+
+    @classmethod
+    def get_session(cls):
+        session = cls._session
+        if session is None:
+            session = requests.Session()
+            cls._session = session
+        return session
+
+    @classmethod
+    def set_session(cls, session) -> None:
+        cls._session = session
+
+    def clean_contents(self, contents):
+        return contents
+
+    def send_api_request(
+        self,
+        endpoint,
+        parameters,
+        referer=None,
+        proxy=None,
+        headers=None,
+        timeout=None,
+        raise_exception_on_error=False,
+    ):
+        if not self.base_url:
+            raise Exception("Cannot use send_api_request from _HTTP class.")
+        base_url = self.base_url.format(endpoint=endpoint)
+        endpoint = endpoint.lower()
+        self.parameters = parameters
+
+        if headers is None:
+            request_headers = self.headers
+        else:
+            request_headers = headers
+
+        if referer:
+            request_headers["Referer"] = referer
+
+        if proxy is None:
+            request_proxy = PROXY
+        elif not proxy:
+            request_proxy = None
+        else:
+            request_proxy = proxy
+
+        if isinstance(request_proxy, list):
+            request_proxy = random.choice(request_proxy)
+            if DEBUG:
+                print(request_proxy)
+
+        proxies = None
+        if request_proxy:
+            proxies = {
+                "http": request_proxy,
+                "https": request_proxy,
+            }
+
+        url = None
+        status_code = None
+        contents = None
+
+        # Sort parameters by key... for some reason this matters for some requests...
+        parameters = sorted(parameters.items(), key=lambda kv: kv[0])
+
+        if DEBUG and DEBUG_STORAGE:
+            print(endpoint, parameters)
+            directory_name = "debug_storage"
+            parameter_string = "&".join(
+                "{}={}".format(key, "" if val is None else quote_plus(str(val)))
+                for key, val in parameters
+            )
+            url = "{}?{}".format(base_url, parameter_string)
+            print(url)
+            file_name = "{}-{}.txt".format(
+                endpoint, md5(parameter_string.encode("utf-8")).hexdigest()
+            )
+            file_path = os.path.join(
+                os.path.dirname(os.path.abspath(__file__)), "debug", directory_name
+            )
+            if not os.path.exists(file_path):
+                os.makedirs(file_path)
+            file_path = os.path.join(file_path, file_name)
+            print(file_name, os.path.isfile(file_path))
+            if os.path.isfile(file_path):
+                f = open(file_path, "r")
+                contents = f.read()
+                f.close()
+                print("loading from file...")
+
+        if not contents:
+            response = self.get_session().get(
+                url=base_url,
+                params=parameters,
+                headers=request_headers,
+                proxies=proxies,
+                timeout=timeout,
+            )
+            url = response.url
+            status_code = response.status_code
+            contents = response.text
+
+        contents = self.clean_contents(contents)
+        if DEBUG and DEBUG_STORAGE:
+            f = open(file_path, "w")
+            f.write(contents)
+            f.close()
+            print(url)
+
+        data = self.nba_response(response=contents, status_code=status_code, url=url)
+
+        if raise_exception_on_error and not data.valid_json():
+            raise Exception("InvalidResponse: Response is not in a valid JSON format.")
+
+        return data

nba_api/live/__init__.py

@@ -0,0 +1 @@
+

nba_api/live/nba/endpoints/__init__.py

@@ -0,0 +1,5 @@
+__all__ = ["playbyplay", "boxscore", "scoreboard"]
+
+from .playbyplay import PlayByPlay
+from .boxscore import BoxScore
+from .scoreboard import ScoreBoard

nba_api/live/nba/endpoints/_base.py

@@ -0,0 +1,28 @@
+import json
+
+
+class Endpoint:
+    class DataSet:
+        key = None
+        data = {}
+
+        def __init__(self, data={}):
+            self.data = data
+
+        def get_json(self):
+            return json.dumps(self.data)
+
+        def get_dict(self):
+            return self.data
+
+    def get_request_url(self):
+        return self.nba_response.get_url()
+
+    def get_response(self):
+        return self.nba_response.get_response()
+
+    def get_dict(self):
+        return self.nba_response.get_dict()
+
+    def get_json(self):
+        return self.nba_response.get_json()

nba_api/live/nba/endpoints/boxscore.py

@@ -0,0 +1,372 @@
+from nba_api.live.nba.endpoints._base import Endpoint
+from nba_api.live.nba.library.http import NBALiveHTTP
+
+
+class BoxScore(Endpoint):
+    endpoint_url = "boxscore/boxscore_{game_id}.json"
+    expected_data = {
+        "meta": {
+            "version": 1,
+            "code": 200,
+            "request": "http://nba.cloud/games/0022000180/boxscore?Format=json",
+            "time": "2021-01-15 23:51:25.282704",
+        },
+        "game": {
+            "gameId": "0022000180",
+            "gameTimeLocal": "2021-01-15T19:30:00-05:00",
+            "gameTimeUTC": "2021-01-16T00:30:00Z",
+            "gameTimeHome": "2021-01-15T19:30:00-05:00",
+            "gameTimeAway": "2021-01-15T19:30:00-05:00",
+            "gameEt": "2021-01-15T19:30:00-05:00",
+            "duration": 125,
+            "gameCode": "20210115/ORLBOS",
+            "gameStatusText": "Final",
+            "gameStatus": 3,
+            "regulationPeriods": 4,
+            "period": 4,
+            "gameClock": "PT00M00.00S",
+            "attendance": 0,
+            "sellout": "0",
+            "arena": {
+                "arenaId": 17,
+                "arenaName": "TD Garden",
+                "arenaCity": "Boston",
+                "arenaState": "MA",
+                "arenaCountry": "US",
+                "arenaTimezone": "America/New_York",
+            },
+            "officials": [
+                {
+                    "personId": 201638,
+                    "name": "Brent Barnaky",
+                    "nameI": "B. Barnaky",
+                    "firstName": "Brent",
+                    "familyName": "Barnaky",
+                    "jerseyNum": "36",
+                    "assignment": "OFFICIAL1",
+                }
+            ],
+            "homeTeam": {
+                "teamId": 1610612738,
+                "teamName": "Celtics",
+                "teamCity": "Boston",
+                "teamTricode": "BOS",
+                "score": 124,
+                "inBonus": "1",
+                "timeoutsRemaining": 2,
+                "periods": [{"period": 1, "periodType": "REGULAR", "score": 34}],
+                "players": [
+                    {
+                        "status": "ACTIVE",
+                        "order": 1,
+                        "personId": 1627759,
+                        "jerseyNum": "7",
+                        "position": "SF",
+                        "starter": "1",
+                        "oncourt": "0",
+                        "played": "1",
+                        "statistics": {
+                            "assists": 8,
+                            "blocks": 0,
+                            "blocksReceived": 0,
+                            "fieldGoalsAttempted": 12,
+                            "fieldGoalsMade": 6,
+                            "fieldGoalsPercentage": 0.5,
+                            "foulsOffensive": 0,
+                            "foulsDrawn": 4,
+                            "foulsPersonal": 1,
+                            "foulsTechnical": 0,
+                            "freeThrowsAttempted": 7,
+                            "freeThrowsMade": 7,
+                            "freeThrowsPercentage": 1.0,
+                            "minus": 50.0,
+                            "minutes": "PT25M01.00S",
+                            "minutesCalculated": "PT25M",
+                            "plus": 65.0,
+                            "plusMinusPoints": 15.0,
+                            "points": 21,
+                            "pointsFastBreak": 0,
+                            "pointsInThePaint": 6,
+                            "pointsSecondChance": 0,
+                            "reboundsDefensive": 2,
+                            "reboundsOffensive": 0,
+                            "reboundsTotal": 2,
+                            "steals": 1,
+                            "threePointersAttempted": 5,
+                            "threePointersMade": 2,
+                            "threePointersPercentage": 0.4,
+                            "turnovers": 2,
+                            "twoPointersAttempted": 7,
+                            "twoPointersMade": 4,
+                            "twoPointersPercentage": 0.5714285714285711,
+                        },
+                        "name": "Jaylen Brown",
+                        "nameI": "J. Brown",
+                        "firstName": "Jaylen",
+                        "familyName": "Brown",
+                    }
+                ],
+                "statistics": {
+                    "assists": 25,
+                    "assistsTurnoverRatio": 2.27272727272727,
+                    "benchPoints": 66,
+                    "biggestLead": 29,
+                    "biggestLeadScore": "72-101",
+                    "biggestScoringRun": 13,
+                    "biggestScoringRunScore": "72-101",
+                    "blocks": 4,
+                    "blocksReceived": 1,
+                    "fastBreakPointsAttempted": 9,
+                    "fastBreakPointsMade": 5,
+                    "fastBreakPointsPercentage": 0.555555555555556,
+                    "fieldGoalsAttempted": 88,
+                    "fieldGoalsEffectiveAdjusted": 0.607954545454545,
+                    "fieldGoalsMade": 45,
+                    "fieldGoalsPercentage": 0.511363636363636,
+                    "foulsOffensive": 0,
+                    "foulsDrawn": 16,
+                    "foulsPersonal": 18,
+                    "foulsTeam": 18,
+                    "foulsTechnical": 0,
+                    "foulsTeamTechnical": 0,
+                    "freeThrowsAttempted": 19,
+                    "freeThrowsMade": 17,
+                    "freeThrowsPercentage": 0.894736842105263,
+                    "leadChanges": 4,
+                    "minutes": "PT240M00.00S",
+                    "minutesCalculated": "PT240M",
+                    "points": 124,
+                    "pointsAgainst": 97,
+                    "pointsFastBreak": 13,
+                    "pointsFromTurnovers": 16,
+                    "pointsInThePaint": 48,
+                    "pointsInThePaintAttempted": 36,
+                    "pointsInThePaintMade": 24,
+                    "pointsInThePaintPercentage": 0.666666666666666,
+                    "pointsSecondChance": 11,
+                    "reboundsDefensive": 39,
+                    "reboundsOffensive": 6,
+                    "reboundsPersonal": 45,
+                    "reboundsTeam": 6,
+                    "reboundsTeamDefensive": 2,
+                    "reboundsTeamOffensive": 4,
+                    "reboundsTotal": 51,
+                    "secondChancePointsAttempted": 6,
+                    "secondChancePointsMade": 4,
+                    "secondChancePointsPercentage": 0.666666666666666,
+                    "steals": 7,
+                    "threePointersAttempted": 42,
+                    "threePointersMade": 17,
+                    "threePointersPercentage": 0.40476190476190504,
+                    "timeLeading": "PT47M16.00S",
+                    "timesTied": 0,
+                    "trueShootingAttempts": 96.36,
+                    "trueShootingPercentage": 0.6434205064342051,
+                    "turnovers": 10,
+                    "turnoversTeam": 1,
+                    "turnoversTotal": 11,
+                    "twoPointersAttempted": 46,
+                    "twoPointersMade": 28,
+                    "twoPointersPercentage": 0.608695652173913,
+                },
+            },
+            "awayTeam": {
+                "teamId": 1610612753,
+                "teamName": "Magic",
+                "teamCity": "Orlando",
+                "teamTricode": "ORL",
+                "score": 97,
+                "inBonus": "1",
+                "timeoutsRemaining": 2,
+                "periods": [{"period": 1, "periodType": "REGULAR", "score": 28}],
+                "players": [
+                    {
+                        "status": "ACTIVE",
+                        "order": 1,
+                        "personId": 203516,
+                        "jerseyNum": "11",
+                        "position": "SF",
+                        "starter": "1",
+                        "oncourt": "0",
+                        "played": "1",
+                        "statistics": {
+                            "assists": 0,
+                            "blocks": 0,
+                            "blocksReceived": 0,
+                            "fieldGoalsAttempted": 4,
+                            "fieldGoalsMade": 1,
+                            "fieldGoalsPercentage": 0.25,
+                            "foulsOffensive": 0,
+                            "foulsDrawn": 0,
+                            "foulsPersonal": 3,
+                            "foulsTechnical": 0,
+                            "freeThrowsAttempted": 0,
+                            "freeThrowsMade": 0,
+                            "freeThrowsPercentage": 0.0,
+                            "minus": 41.0,
+                            "minutes": "PT14M34.00S",
+                            "minutesCalculated": "PT14M",
+                            "plus": 36.0,
+                            "plusMinusPoints": -5.0,
+                            "points": 2,
+                            "pointsFastBreak": 0,
+                            "pointsInThePaint": 2,
+                            "pointsSecondChance": 0,
+                            "reboundsDefensive": 1,
+                            "reboundsOffensive": 0,
+                            "reboundsTotal": 1,
+                            "steals": 0,
+                            "threePointersAttempted": 2,
+                            "threePointersMade": 0,
+                            "threePointersPercentage": 0.0,
+                            "turnovers": 0,
+                            "twoPointersAttempted": 2,
+                            "twoPointersMade": 1,
+                            "twoPointersPercentage": 0.5,
+                        },
+                        "name": "James Ennis III",
+                        "nameI": "J. Ennis III",
+                        "firstName": "James",
+                        "familyName": "Ennis III",
+                    }
+                ],
+                "statistics": {
+                    "assists": 14,
+                    "assistsTurnoverRatio": 1.07692307692308,
+                    "benchPoints": 33,
+                    "biggestLead": 1,
+                    "biggestLeadScore": "4-3",
+                    "biggestScoringRun": 13,
+                    "biggestScoringRunScore": "72-101",
+                    "blocks": 1,
+                    "blocksReceived": 4,
+                    "fastBreakPointsAttempted": 7,
+                    "fastBreakPointsMade": 2,
+                    "fastBreakPointsPercentage": 0.28571428571428603,
+                    "fieldGoalsAttempted": 94,
+                    "fieldGoalsEffectiveAdjusted": 0.441489361702128,
+                    "fieldGoalsMade": 38,
+                    "fieldGoalsPercentage": 0.404255319148936,
+                    "foulsOffensive": 2,
+                    "foulsDrawn": 18,
+                    "foulsPersonal": 16,
+                    "foulsTeam": 14,
+                    "foulsTechnical": 1,
+                    "foulsTeamTechnical": 0,
+                    "freeThrowsAttempted": 22,
+                    "freeThrowsMade": 14,
+                    "freeThrowsPercentage": 0.636363636363636,
+                    "leadChanges": 4,
+                    "minutes": "PT240M00.00S",
+                    "minutesCalculated": "PT240M",
+                    "points": 97,
+                    "pointsAgainst": 124,
+                    "pointsFastBreak": 8,
+                    "pointsFromTurnovers": 10,
+                    "pointsInThePaint": 52,
+                    "pointsInThePaintAttempted": 47,
+                    "pointsInThePaintMade": 26,
+                    "pointsInThePaintPercentage": 0.553191489361702,
+                    "pointsSecondChance": 20,
+                    "reboundsDefensive": 31,
+                    "reboundsOffensive": 15,
+                    "reboundsPersonal": 46,
+                    "reboundsTeam": 12,
+                    "reboundsTeamDefensive": 4,
+                    "reboundsTeamOffensive": 8,
+                    "reboundsTotal": 58,
+                    "secondChancePointsAttempted": 16,
+                    "secondChancePointsMade": 9,
+                    "secondChancePointsPercentage": 0.5625,
+                    "steals": 5,
+                    "threePointersAttempted": 28,
+                    "threePointersMade": 7,
+                    "threePointersPercentage": 0.25,
+                    "timeLeading": "PT00M30.00S",
+                    "timesTied": 0,
+                    "trueShootingAttempts": 103.68,
+                    "trueShootingPercentage": 0.46778549382716,
+                    "turnovers": 11,
+                    "turnoversTeam": 2,
+                    "turnoversTotal": 13,
+                    "twoPointersAttempted": 66,
+                    "twoPointersMade": 31,
+                    "twoPointersPercentage": 0.46969696969696995,
+                },
+            },
+        },
+    }
+
+    arena = None
+    away_team = None
+    away_team_player_stats = None
+    away_team_stats = None
+    data_sets = None
+    headers = None
+    home_team = None
+    home_team_player_stats = None
+    home_team_stats = None
+    game = None
+    game_details = None
+    nba_response = None
+    officials = None
+
+    def __init__(self, game_id, proxy=None, headers=None, timeout=30, get_request=True):
+        self.game_id = game_id
+        self.proxy = proxy
+        if headers is not None:
+            self.headers = headers
+        self.timeout = timeout
+        if get_request:
+            self.get_request()
+
+    def get_request(self):
+        self.nba_response = NBALiveHTTP().send_api_request(
+            endpoint=self.endpoint_url.format(game_id=self.game_id),
+            parameters={},
+            proxy=self.proxy,
+            headers=self.headers,
+            timeout=self.timeout,
+        )
+        self.load_response()
+
+    def load_response(self):
+        data_sets = self.nba_response.get_dict()
+        if "game" in data_sets:
+            self.game = Endpoint.DataSet(data=data_sets["game"])
+            self.game_details = self.game.get_dict().copy()
+            if "arena" in self.game.get_dict():
+                self.arena = Endpoint.DataSet(data=data_sets["game"]["arena"])
+                self.game_details.pop("arena")
+            if "officials" in self.game.get_dict():
+                self.officials = Endpoint.DataSet(data=data_sets["game"]["officials"])
+                self.game_details.pop("officials")
+            if "homeTeam" in self.game.get_dict():
+                self.home_team = Endpoint.DataSet(data=data_sets["game"]["homeTeam"])
+
+                # Home Team Player Stats
+                self.home_team_player_stats = Endpoint.DataSet(
+                    data=data_sets["game"]["homeTeam"]["players"]
+                )
+
+                # Home Team Stats
+                home_team_stats = self.home_team.get_dict().copy()
+                home_team_stats.pop("players")
+                self.home_team_stats = Endpoint.DataSet(data=home_team_stats)
+
+                self.game_details.pop("homeTeam")
+            if "awayTeam" in self.game.get_dict():
+                self.away_team = Endpoint.DataSet(data=data_sets["game"]["awayTeam"])
+
+                # Away Team Player Stats
+                self.away_team_player_stats = Endpoint.DataSet(
+                    data=data_sets["game"]["awayTeam"]["players"]
+                )
+
+                # Away Team Stats
+                away_team_stats = self.away_team.get_dict().copy()
+                away_team_stats.pop("players")
+                self.away_team_stats = Endpoint.DataSet(data=away_team_stats)
+
+                self.game_details.pop("awayTeam")
+            self.game_details = Endpoint.DataSet(data=self.game_details)