"""
``LivePossessionLoader`` 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 LivePossessionLoader
possession_loader = LivePossessionLoader("0021900001", "file", "/data")
print(possession_loader.items[0].data) # prints dict with the first possession of the game
"""
from pbpstats.data_loader.live.enhanced_pbp_loader import LiveEnhancedPbpLoader
from pbpstats.data_loader.nba_possession_loader import NbaPossessionLoader
from pbpstats.resources.possessions.possession import Possession
[docs]class LivePossessionLoader(NbaPossessionLoader):
"""
Loads live data 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 `live_<game_id>.json` in the `/pbp` subdirectory.
If not provided response data will not be saved on disk.
"""
data_provider = "live"
resource = "Possessions"
parent_object = "Game"
def __init__(self, game_id, source, file_directory=None):
pbp_events = LiveEnhancedPbpLoader(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()