brlib 0.0.2__tar.gz → 0.1.0__tar.gz

{brlib-0.0.2 → brlib-0.1.0}/.github/workflows/test.yml

@@ -1,11 +1,12 @@
-name: Run Tests
+name: Tests
 
 on: 
   push:
     branches: '**'
   schedule:
-    # run daily tests after the previous day's scores have hopefully been added
-    - cron: '0 12 * * *'
+    # run at 12 UTC, hopefully after BR's daily in-season updates
+    # run weekly because any more would be overkill
+    - cron: '0 12 * * 6'
 
 jobs:
   pytest:

{brlib-0.0.2 → brlib-0.1.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: brlib
-Version: 0.0.2
+Version: 0.1.0
 Summary: A library for collecting baseball statistics from Baseball Reference
 Project-URL: Homepage, https://github.com/john-bieren/brlib
-Project-URL: Documentation, https://github.com/john-bieren/brlib/tree/master/docs
+Project-URL: Documentation, https://github.com/john-bieren/brlib/wiki
 Project-URL: Repository, https://github.com/john-bieren/brlib.git
 Project-URL: Issues, https://github.com/john-bieren/brlib/issues
 Author-email: John Bieren <jbieren64@gmail.com>
@@ -32,10 +32,10 @@ Description-Content-Type: text/markdown
 
 # brlib
 
-![Tests](https://github.com/john-bieren/brlib/actions/workflows/test.yml/badge.svg)
-[![PyPI Latest Release](https://img.shields.io/pypi/v/brlib.svg)](https://pypi.org/project/brlib)
+[![Tests](https://github.com/john-bieren/brlib/actions/workflows/test.yml/badge.svg)](https://github.com/john-bieren/brlib/actions/workflows/test.yml)
+[![PyPI Latest Release](https://img.shields.io/pypi/v/brlib?label=PyPI&logo=pypi&logoColor=ffe873&color=0073b7)](https://pypi.org/project/brlib)
 
-A Python library for collecting baseball statistics from [Baseball Reference](https://www.baseball-reference.com).
+A library for collecting baseball statistics from [Baseball Reference](https://www.baseball-reference.com).
 
 > [!IMPORTANT]
 > brlib is in beta, breaking changes are possible until the release of version 1.
@@ -43,8 +43,8 @@ A Python library for collecting baseball statistics from [Baseball Reference](ht
 ## Key Features
 
 * `Game`, `Player`, and `Team` classes give you easy access to all associated data in one place, with attributes for stats tables, information, and more.
-* Aggregate these into `Games`, `Players`, or `Teams` classes, which contain similar attributes, for easy analysis of larger samples.
-* Quickly search for games, players, and teams of interest, and gather their stats without violating the [rate limit](https://www.sports-reference.com/bot-traffic.html).
+* Aggregate these into `GameSet`, `PlayerSet`, or `TeamSet` classes, which have similar attributes, for easy analysis of larger samples.
+* Quickly search for games, players, and teams of interest, and gather their stats without violating the [rate limit](https://www.sports-reference.com/429.html).
 
 Learn more by reading the documentation on the [wiki](https://github.com/john-bieren/brlib/wiki).
 
@@ -69,3 +69,7 @@ Once installed, you can import brlib into your Python scripts:
 ```python
 import brlib as br
 ```
+
+## Data Use
+
+Since brlib gathers data from Baseball Reference, your use of this data is subject to their [data use policy](https://www.sports-reference.com/data_use.html).

{brlib-0.0.2 → brlib-0.1.0}/README.md

@@ -1,9 +1,9 @@
 # brlib
 
-![Tests](https://github.com/john-bieren/brlib/actions/workflows/test.yml/badge.svg)
-[![PyPI Latest Release](https://img.shields.io/pypi/v/brlib.svg)](https://pypi.org/project/brlib)
+[![Tests](https://github.com/john-bieren/brlib/actions/workflows/test.yml/badge.svg)](https://github.com/john-bieren/brlib/actions/workflows/test.yml)
+[![PyPI Latest Release](https://img.shields.io/pypi/v/brlib?label=PyPI&logo=pypi&logoColor=ffe873&color=0073b7)](https://pypi.org/project/brlib)
 
-A Python library for collecting baseball statistics from [Baseball Reference](https://www.baseball-reference.com).
+A library for collecting baseball statistics from [Baseball Reference](https://www.baseball-reference.com).
 
 > [!IMPORTANT]
 > brlib is in beta, breaking changes are possible until the release of version 1.
@@ -11,8 +11,8 @@ A Python library for collecting baseball statistics from [Baseball Reference](ht
 ## Key Features
 
 * `Game`, `Player`, and `Team` classes give you easy access to all associated data in one place, with attributes for stats tables, information, and more.
-* Aggregate these into `Games`, `Players`, or `Teams` classes, which contain similar attributes, for easy analysis of larger samples.
-* Quickly search for games, players, and teams of interest, and gather their stats without violating the [rate limit](https://www.sports-reference.com/bot-traffic.html).
+* Aggregate these into `GameSet`, `PlayerSet`, or `TeamSet` classes, which have similar attributes, for easy analysis of larger samples.
+* Quickly search for games, players, and teams of interest, and gather their stats without violating the [rate limit](https://www.sports-reference.com/429.html).
 
 Learn more by reading the documentation on the [wiki](https://github.com/john-bieren/brlib/wiki).
 
@@ -37,3 +37,7 @@ Once installed, you can import brlib into your Python scripts:
 ```python
 import brlib as br
 ```
+
+## Data Use
+
+Since brlib gathers data from Baseball Reference, your use of this data is subject to their [data use policy](https://www.sports-reference.com/data_use.html).

{brlib-0.0.2 → brlib-0.1.0}/pyproject.toml

@@ -37,7 +37,7 @@ dev = ["pytest>=9.0.0"]
 
 [project.urls]
 Homepage = "https://github.com/john-bieren/brlib"
-Documentation = "https://github.com/john-bieren/brlib/tree/master/docs"
+Documentation = "https://github.com/john-bieren/brlib/wiki"
 Repository = "https://github.com/john-bieren/brlib.git"
 Issues = "https://github.com/john-bieren/brlib/issues"
 

brlib-0.1.0/src/brlib/__init__.py

@@ -0,0 +1,33 @@
+from .all_major_leaguers import all_major_leaguers
+from .find_asg import find_asg
+from .find_games import find_games
+from .find_teams import find_teams
+from .game import Game
+from .game_set import GameSet
+from .get_games import get_games
+from .get_players import get_players
+from .get_teams import get_teams
+from .options import options
+from .player import Player
+from .player_set import PlayerSet
+from .team import Team
+from .team_set import TeamSet
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "all_major_leaguers",
+    "find_asg",
+    "find_games",
+    "find_teams",
+    "Game",
+    "GameSet",
+    "get_games",
+    "get_players",
+    "get_teams",
+    "options",
+    "Player",
+    "PlayerSet",
+    "Team",
+    "TeamSet"
+]

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/_helpers/abbreviations_manager.py

@@ -58,8 +58,7 @@ class AbbreviationsManager(Singleton):
     def _load(self) -> None:
         """Loads abbreviations data from cache."""
         self.df = pd.read_csv(self._cache_file)
-        self.df["Alias"] = self.df["Alias"].astype(str)
-        self.df.loc[self.df["Alias"] == "nan", "Alias"] = ""
+        self.df.loc[self.df["Alias"].isna(), "Alias"] = ""
 
     def _get(self) -> None:
         """Gets abbreviations data from Baseball Reference."""

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/_helpers/constants.py

@@ -49,6 +49,7 @@ else:
 CACHE_TIMEZONE = pytz.timezone("US/Aleutian")
 
 # pre-compiled regular expressions
+MULTI_TEAM_REGEX = re.compile("^[1-9]TM$")
 SEASON_REGEX = re.compile("^[1-2][0-9]{3}$")
 SEASON_RANGE_REGEX = re.compile("^[1-2][0-9]{3}-[1-2][0-9]{3}$")
 GAME_DATE_REGEX = re.compile("^[0-9]{4}[0-1][0-9][0-3][0-9]$")
@@ -510,9 +511,9 @@ PLAYER_INFO_COLS = (
     "Draft Pick",
     "Draft Year",
     "Draft Type",
-    "High School",
+    "High Schools",
     "Schools",
-    "Debut",
+    "Debut Date",
     "Debut Game ID",
     "Debut Age",
     "Debut Age (Days)",
@@ -521,11 +522,11 @@ PLAYER_INFO_COLS = (
     "Last Game ID",
     "Last Game Age",
     "Last Game Age (Days)",
-    "Exceeded Rookie Limits",
-    "Full Name",
     "HOF Year",
     "HOF Type",
     "HOF %",
+    "Exceeded Rookie Limits",
+    "Full Name",
     "bWAR",
     "Years Played",
     "Minimum Career Earnings",
@@ -799,7 +800,7 @@ TEAM_INFO_COLS = (
     "Pythagorean Losses",
     "Team Gold Glove",
     "Pennant",
-    "Championship"
+    "World Series"
 )
 
 TEAM_BATTING_COLS = (

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/_helpers/no_hitter_dicts.py

@@ -114,16 +114,19 @@ class NoHitterDicts(Singleton):
         records = []
         for row in individual_table.find_all("tr"):
             record = [ele.text.strip("*") for ele in row.find_all(["th", "td"])]
-            records.append(record[:8])
+            records.append(record[:9])
         individual_df = pd.DataFrame(
             records,
-            columns=("Rk", "Name", "Perfect", "Gcar", "Gtm", "Year", "Date", "Team")
+            columns=("Rk", "Name", "Perfect", "Gcar", "Gtm", "Year", "Date", "Team", "Home/Away")
         )
         # remove the header rows which appear every 25 rows
         individual_df = individual_df.loc[individual_df["Name"] != "Name"].reset_index(drop=True)
         individual_df["Game Type"] = "R"
         postseason_mask = ((individual_df["Gcar"] == "") &
-                           (individual_df["Year"].astype(int) > FIRST_GAMES_YEAR))
+                           # before FIRST_GAMES_YEAR, Gcar is always blank
+                           (individual_df["Year"].astype(int) >= FIRST_GAMES_YEAR) &
+                           # Gcar is blank and Home/Away is "?" for regular season Negro League NHs
+                           (individual_df["Home/Away"] != "?"))
         individual_df.loc[postseason_mask, "Game Type"] = "P"
         individual_df.loc[individual_df["Perfect"] == "", "Perfect"] = "N"
         individual_df = individual_df.reindex(
@@ -142,7 +145,11 @@ class NoHitterDicts(Singleton):
                 game_id_column.append(game_id)
 
         individual_df["Player ID"] = player_id_column
+        # fix the only exception to postseason_mask
+        individual_df.loc[individual_df["Player ID"] == "griercl01", "Game Type"] = "P"
+
         individual_df["Game ID"] = individual_df["Game ID"].astype("object")
+        # filter out games without box scores and IDs
         individual_df.loc[
             (~individual_df["Team"].isin(BML_TEAM_ABVS)) &
             (individual_df["Year"].astype(int) >= FIRST_GAMES_YEAR),
@@ -156,16 +163,17 @@ class NoHitterDicts(Singleton):
         records = []
         for row in combined_table.find_all("tr"):
             record = [ele.text.strip("*") for ele in row.find_all(["th", "td"])]
-            records.append(record[:11])
+            records.append(record[:9])
         combined_df = pd.DataFrame(
             records,
-            columns=("Rk", "Year", "Date", "Team", "Home/Away", "Opp", "Rslt", "Name", "Gcar", "Gtm", "Inngs")
+            columns=("Rk", "Year", "Date", "Team", "Home/Away", "Opp", "Rslt", "Name", "Gcar")
         )
         # remove the header rows which appear every 25 rows
         combined_df = combined_df.loc[combined_df["Name"] != "Name"].reset_index(drop=True)
         combined_df["Game Type"] = "R"
         postseason_mask = ((combined_df["Gcar"] == "") &
-                           (combined_df["Inngs"] != ""))
+                           # Gcar is blank and Home/Away is "?" for regular season Negro League NHs
+                           (combined_df["Home/Away"] != "?"))
         combined_df.loc[postseason_mask, "Game Type"] = "P"
         combined_df = combined_df.reindex(
             columns=["Player ID", "Perfect", "Combined", "Year", "Team", "Game ID", "Game Type"]

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/_helpers/utils.py

@@ -120,10 +120,14 @@ def str_remove(string: str, *substrings: str) -> str:
         string = string.replace(substring, "")
     return string
 
+def clean_spaces(string: str) -> str:
+    """Removes consecutive, leading, and trailing spaces from `string`."""
+    return " ".join(string.split()).strip()
+
 def reformat_date(string_date: str) -> str:
     """
     Converts `string_date` of "MM DD, YYYY" to "YY-MM-DD" for formatting consistency.
-    If `string_date` does not match this format, and empty string will be returned.
+    If `string_date` does not match this format, an empty string will be returned.
     """
     try:
         date = datetime.strptime(string_date, "%B %d, %Y")

brlib-0.1.0/src/brlib/all_major_leaguers.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+
+"""Defines all_major_leaguers function."""
+
+from io import StringIO
+
+import pandas as pd
+
+from ._helpers.requests_manager import req_man
+from .options import print_page
+
+
+def all_major_leaguers() -> pd.DataFrame:
+    """
+    Returns a DataFrame of basic information about all players in major league history.
+
+    ## Parameters
+
+    None.
+
+    ## Returns
+
+    `pandas.DataFrame`
+
+    ## Examples
+
+    The output (as of 2025-26 offseason):
+
+    ```
+    >>> br.all_major_leaguers()
+        Player ID             Name  Career Start  Career End  Active
+    0      aardsda01    David Aardsma          2004        2015   False
+    1      aaronha01      Henry Aaron          1954        1976   False
+    2      aaronto01     Tommie Aaron          1962        1971   False
+    3       aasedo01         Don Aase          1977        1990   False
+    4       abadan01        Andy Abad          2001        2006   False
+    ...          ...              ...           ...         ...     ...
+    23610   zupofr01       Frank Zupo          1957        1961   False
+    23611  zuvelpa01     Paul Zuvella          1982        1991   False
+    23612  zuverge01  George Zuverink          1951        1959   False
+    23613  zwilldu01   Dutch Zwilling          1910        1916   False
+    23614   zychto01        Tony Zych          2015        2017   False
+
+    [23615 rows x 5 columns]
+    ```
+
+    You can filter results and convert them into a `get_players` input:
+
+    ```
+    >>> aml = br.all_major_leaguers()
+    >>> mask = aml["Player ID"].str.startswith("q")
+    >>> aml = aml.loc[mask]
+    >>> aml["Player ID"].values.tolist()
+    ['quackke01', 'quallch01', 'quallji01', ...]
+    ```
+    """
+    page = req_man.get_page("/short/inc/players_search_list.csv")
+    print_page("All MLB Players")
+    csv_lines = str(page.content, "UTF-8").strip()
+    # add column names, which are not included in the payload
+    columns = "Player ID,Name,Career Span,Active,1,2,3,4,5\n"
+    players_df = pd.read_csv(StringIO(columns + csv_lines))
+
+    # split career span into start and end (if span is one year, only year is listed, no range)
+    players_df["Career Start"] = players_df["Career Span"].str.split("-", n=1).str[0].astype(int)
+    players_df["Career End"] = players_df["Career Span"].str.split("-", n=1).str[-1].astype(int)
+    # convert active column from 0/1 to boolean
+    players_df["Active"] = players_df["Active"].astype(bool)
+
+    columns=["Player ID", "Name", "Career Start", "Career End", "Active"]
+    players_df = players_df.reindex(columns=columns)
+    return players_df

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/find_asg.py

@@ -12,7 +12,36 @@ from .options import write
 
 
 @runtime_typecheck
-def find_asg(seasons: str | list[str] = "ALL") -> list[tuple[str, str, str]]:
+def find_asg(seasons: str | list[str] = "all") -> list[tuple[str, str, str]]:
+    """
+    Returns a list of All-Star Game tuples which can be an input to `get_games`.
+
+    ## Parameters
+
+    * `seasons`: `str` or `list[str]`, default `"all"`
+
+        A year, inclusive range of years (e.g. `"2017-2019"`), `"all"`, or a list of multiple such inputs which specify the seasons from which to find All-Star Games.
+
+    ## Returns
+
+    `list[tuple[str, str, str]]`
+
+    ## Examples
+
+    Seasons which did not have All-Star Games are taken into account:
+
+    ```
+    >>> br.find_asg("2019-2022")
+    [('allstar', '2019', '0'), ('allstar', '2021', '0'), ('allstar', '2022', '0')]
+    ```
+
+    Seasons with two All-Star Games are also accounted for:
+
+    ```
+    >>> br.find_asg("1962")
+    [('allstar', '1962', '1'), ('allstar', '1962', '2')]
+    ```
+    """
     # process input
     seasons = [seasons] if not isinstance(seasons, list) else seasons
     seasons = [s.upper() for s in seasons]
@@ -43,11 +72,9 @@ def find_asg(seasons: str | list[str] = "ALL") -> list[tuple[str, str, str]]:
                 continue
             year_set.add(seasons_input)
 
-    len_before = len(year_set)
     year_list = [y for y in year_set if y in all_asg_years]
-    if len_before != len(year_list):
-        write(f"All-Star Game box scores are only available from {FIRST_ASG_YEAR} through {year_range_end - 1}")
-    # remove years which had no All-Star Game (silently, so that nothing prints if seasons="ALL")
+    if len(year_list) == 0:
+        write(f"All-Star Games have only been held from {FIRST_ASG_YEAR} through {year_range_end - 1}")
     year_list = [y for y in year_list if y not in NO_ASG_YEARS]
     year_list.sort()
 

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/find_games.py

@@ -22,13 +22,69 @@ from .options import options, print_page, write
 
 @runtime_typecheck
 def find_games(
-        teams: str | list[str] = "ALL",
-        seasons: str | list[str] = "ALL",
-        opponents: str | list[str] = "ALL",
-        dates: str | list[str] = "ALL",
-        home_away: str = "ALL",
-        game_type: str = "ALL"
+        teams: str | list[str] = "all",
+        seasons: str | list[str] = "all",
+        opponents: str | list[str] = "all",
+        dates: str | list[str] = "all",
+        home_away: str = "all",
+        game_type: str = "all"
         ) -> list[tuple[str, str, str]]:
+    """
+    Returns a list of game tuples which can be an input to `get_games`.
+
+    ## Parameters
+
+    * `teams`: `str` or `list[str]`, default `"all"`
+
+        A team abbreviation (e.g. `"sea"`), `"all"`, or a list of team abbreviations to specify which teams' games should be found. Abbreviations are subject to era adjustment, and aliases are not accepted. [Read more about team abbreviation handling](https://github.com/john-bieren/brlib/wiki/Team-Abbreviation-Handling).
+
+    * `seasons`: `str` or `list[str]`, default `"all"`
+
+        A year, inclusive range of years (e.g. `"2017-2019"`), `"all"`, or a list of multiple such inputs which specify the seasons from which to find games.
+
+    * `opponents`: `str` or `list[str]`, default `"all"`
+
+        A valid `teams` input specifying the opponents which `teams` must be facing in returned games.
+
+    * `dates`: `str` or `list[str]`, default `"all"`
+
+        A string representing a date in MMDD format as a number (e.g. `"0704"`), an inclusive range of such numbers (e.g. `"0314-0325"`), `"all"`, or a list of multiple such inputs which specify the dates from which games should be found.
+
+    * `home_away`: `str`, default `"all"`
+
+        `"home"`, `"away"`, or `"all"` to specify the role which `teams` should have in returned games.
+
+    * `game_type`: `str`, default `"all"`
+
+        `"reg"`, `"post"`, or `"all"` to specify whether to find regular season and/or postseason games.
+
+    ## Returns
+
+    `list[tuple[str, str, str]]`
+
+    ## Examples
+
+    Find all games from a team's season:
+
+    ```
+    >>> br.find_games("SEA", "2020")
+    [('HOU', '20200724', '0'), ('HOU', '20200725', '0'), ...]
+    ```
+
+    Find matchups between teams:
+
+    ```
+    >>> br.find_games("SEA", "2019", "STL")
+    [('SEA', '20190702', '0'), ('SEA', '20190703', '0'), ('SEA', '20190704', '0')]
+    ```
+
+    Abbreviations can match multiple teams due to era adjustment:
+
+    ```
+    >>> br.find_games(teams="BAL", seasons="1915", dates="825-826", home_away="home")
+    [('BAL', '19150825', '1'), ('BAL', '19150825', '2'), ('SLB', '19150825', '0'), ('BAL', '19150826', '0'), ('SLB', '19150826', '0')]
+    ```
+    """
     # make sure all possible list inputs are lists
     teams = [teams] if not isinstance(teams, list) else teams
     seasons = [seasons] if not isinstance(seasons, list) else seasons
@@ -151,18 +207,15 @@ def _find_year_list(
                 continue
             year_set.add(seasons_input)
 
-    len_before = len(year_set)
     year_set = {y for y in year_set if y in all_game_years}
-    if len_before != len(year_set):
+    if len(year_set) == 0:
         write(f"box scores are only available from {FIRST_GAMES_YEAR} through {year_range_end - 1}")
-
     if game_type == "POST":
-        # remove years which had no postseason (silently, so that nothing prints if seasons="ALL")
         year_set = {y for y in year_set if y not in NO_POSTSEASON_YEARS}
 
     # filter years to those which could possibly contain a matchup of the teams and opponents
-    if teams != ["ALL"] and opponents != ["ALL"]:
-        valid_years = set(range(FIRST_GAMES_YEAR, year_range_end))
+    if teams != ["ALL"] or opponents != ["ALL"]:
+        valid_years = set(all_game_years)
         if teams != ["ALL"]:
             valid_years.intersection_update(_all_franchise_seasons(teams))
         if opponents != ["ALL"]:

{brlib-0.0.2 → brlib-0.1.0}/src/brlib/find_teams.py

@@ -17,9 +17,49 @@ from .options import write
 
 @runtime_typecheck
 def find_teams(
-    teams: str | list[str] = "ALL",
-    seasons: str | list[str] = "ALL"
+    teams: str | list[str] = "all",
+    seasons: str | list[str] = "all"
     ) -> list[tuple[str, str]]:
+    """
+    Returns a list of team tuples which can be an input to `get_teams`.
+
+    ## Parameters
+
+    * `teams`: `str` or `list[str]`, default `"all"`
+
+        A team abbreviation (e.g. `"sea"`), segregation-era league identifier (i.e. `"bml"` for Black major league teams or `"wml"` for White major league teams), `"all"`, or a list of multiple such inputs to specify which teams' games should be found. Abbreviations are subject to era adjustment, and aliases are not accepted. [Read more about team abbreviation handling](https://github.com/john-bieren/brlib/wiki/Team-Abbreviation-Handling).
+
+    * `seasons`: `str` or `list[str]`, default `"all"`
+
+        A year, inclusive range of years (e.g. `"2017-2019"`), `"all"`, or a list of multiple such inputs which specify the years from which to find games.
+
+    ## Returns
+
+    `list[tuple[str, str]]`
+
+    ## Examples
+
+    Find teams from a range of seasons without worrying about abbreviation changes:
+
+    ```
+    >>> br.find_teams("OAK", "2022-2025")
+    [('OAK', '2022'), ('OAK', '2023'), ('OAK', '2024'), ('ATH', '2025')]
+    ```
+
+    Survey entire seasons:
+
+    ```
+    >>> br.find_teams("BML", "1948")
+    [('BBB', '1948'), ('BEG', '1948'), ('CAG', '1948'), ('CBE', '1948'), ...]
+    ```
+
+    Abbreviations can match multiple teams due to era adjustment:
+
+    ```
+    >>> br.find_teams("BAL", "1914")
+    [('SLB', '1914'), ('BAL', '1914')]
+    ```
+    """
     # make sure all possible list inputs are lists
     teams = [teams] if not isinstance(teams, list) else teams
     seasons = [seasons] if not isinstance(seasons, list) else seasons
@@ -104,10 +144,9 @@ def _make_year_list(seasons: list[str]) -> list[int]:
                 continue
             year_set.add(int(seasons_input))
 
-    len_before = len(year_set)
     year_list = [y for y in year_set if y in all_team_years]
-    if len_before != len(year_list):
-        write(f"teams are only available from {FIRST_TEAMS_YEAR} through {year_range_end - 1}")
+    if len(year_list) == 0:
+        write(f"team stats are only available from {FIRST_TEAMS_YEAR} through {year_range_end - 1}")
     year_list.sort()
     return year_list