"""
``DataNbaPossessionLoader`` loads possession data for a game and creates :obj:`~pbpstats.resources.possessions.possession.Possession` objects for each possession
The following code will load possession data for game id "0021900001" from a pbp file located in the ``/pbp`` subdirectory of the ``/data`` directory
.. code-block:: python
from pbpstats.data_loader import DataNbaPossessionLoader
possession_loader = DataNbaPossessionLoader("0021900001", "file", "/data")
print(possession_loader.items[0].data) # prints dict with the first possession of the game
"""
from pbpstats.data_loader.data_nba.enhanced_pbp_loader import DataNbaEnhancedPbpLoader
from pbpstats.data_loader.nba_possession_loader import NbaPossessionLoader
from pbpstats.resources.possessions.possession import Possession
[docs]class DataNbaPossessionLoader(NbaPossessionLoader):
"""
Loads data.nba.com source possession data for game.
Possessions are stored in items attribute as :obj:`~pbpstats.resources.possessions.possession.Possession` objects
:param str game_id: NBA Stats Game Id
:param str source: Where should data be loaded from. Options are 'web' or 'file'
:param str file_directory: (optional if source is 'web')
Directory in which data should be either stored (if source is web) or loaded from (if source is file).
The specific file location will be `data_<game_id>.json` in the `/pbp` subdirectory.
If not provided response data will not be saved on disk.
"""
data_provider = "data_nba"
resource = "Possessions"
parent_object = "Game"
def __init__(self, game_id, source, file_directory=None):
pbp_events = DataNbaEnhancedPbpLoader(game_id, source, file_directory)
self.events = pbp_events.items
events_by_possession = self._split_events_by_possession()
self.items = [
Possession(possession_events) for possession_events in events_by_possession
]
self._add_extra_attrs_to_all_possessions()