ahump20/basketball
Basketball fundamentals: rules, possessions, offensive and defensive rating, Four Factors and true shooting from real box scores for the NBA and college, and free data sources.
Measure and interpret basketball efficiency correctly — possessions, pace, offensive/defensive/net rating per 100, Dean Oliver's Four Factors, true shooting, effective field goal percentage, usage — for the NBA and college. Use when ranking teams, explaining why a team wins, comparing scorers, or converting per-game numbers into per-possession ones.
Pull NBA, men's college and women's college basketball data from free sources — sportsdataverse's ESPN box-score and schedule files, stats.nba.com via nba_api, and Basketball-Reference — with exact URLs, column names, season and game-type codes, rate limits and the traps that corrupt season totals. Use when you need real basketball numbers or are building a pipeline.
Explains and applies basketball playing rules for the NBA, WNBA, NCAA men's and women's, and FIBA, and settles rule disputes level by level. Use for shot clock resets, goaltending vs basket interference, traveling and the gather step, fouling out, the bonus and team-foul limits, flagrant/technical/clear-path/take fouls, backcourt and 8/10-second calls, timeouts and the advance rule, coach's challenges, the 0.3-second rule, and any "NBA vs college vs FIBA" difference.