v1.2.1

Bug Fixes 🐛

• remove file.open() to prevent encoding issues while testing on windows by @pjsharpe07 in #175
• Update stadia endpoint to stadium by @pjsharpe07 in #177

New Contributors 👷

• @pjsharpe07 made their first contribution in #175

Full Changelog: v1.2.0...v1.2.1

v1.2.0

What's new ✨

• Lazy load entities on client initialization by @rbarman in #173

Documentation 📚

• docs: convert docstrings to Google-style by @bgrnwd in #170
• fix: logo on docs site by @bgrnwd in #160
• Add documentation by @bgrnwd in #156

Dependencies 📦

• Bump mypy from 1.4.1 to 1.5.1 by @dependabot in #151
• Bump rapidfuzz from 3.1.2 to 3.2.0 by @dependabot in #149
• Bump pandas from 2.0.3 to 2.1.0 by @dependabot in #150
• Bump actions/checkout from 3 to 4 by @dependabot in #155
• Bump actions/setup-python from 4 to 5 by @dependabot in #159
• ci: switch to use PyPI trusted publisher by @bgrnwd in #167
• Switch to pytest instead of behave by @bgrnwd in #172

New Contributors 👷

• @rbarman made their first contribution in #173

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's new ✨

• Cached data now expires after 1 day #145
• Various dependency updates

itscalledsoccer v1.0.0

Deprecations 🌆

• Removed support for Python 3.7

Bug Fixes 🐛

• Fixed an issue (#133) where newer versions of pandas were incompatible

itscalledsoccer v0.2.0

What's new ✨

• MLS Next Pro data is now available #26

itscalledsoccer v0.1.4

Bug Fixes 🐛

• Fixed an issue (#23) where players were missing from the when calling get_players #24
  • Root cause was the get_entities function was not making use of _execute_query which handles the API limit so only the first 1000 players were being returned for leagues with more than 1000 players. There was also an incorrect function call in _execute_query which made it accidentally recursive.

itscalledsoccer v0.1.3

Bug Fixes 🐛

• Fixed an issue (#20) where functions that depended on get_stats were only returning 1 row of data when multiple IDs (games, teams, players, etc.) were passed as arguments #21

itscalledsoccer v0.1.2

Bug Fixes 🐛

• Fixed an issue (#18) where the Python library didn't have its dependencies defined in setup.py #19

Documentation 📚

• Added templates for bugs, feature requests, and pull requests #17

itscalledsoccer v0.1.1

Bug Fixes 🐛

• Fixed an issue (#15) where the itscalledsoccer module wasn't included in the wheel and couldn't be imported #16

Documentation 📚

• Updated the link to the package logo in the Python README so it would display properly on PyPi and GitHub pages #16

itscalledsoccer v0.1.0

Introducing itscalledsoccer ⚽ 🎉

This is the first release of itscalledsoccer, a Python wrapper around the same API that powers the American Soccer Analysis app. It enables Python users to programmatically retrieve advanced analytics for their favorite MLS, NWSL, and USL players and teams. We at ASA, have been working on this for the better part of 6 months and are super excited to release it. We hope it makes interacting with our data easier and allows people to build new and informative things.

What's new ✨

Technically everything in the package is new, but we'll highlight all the functions that are currently available and provide a brief description of what data they return. The package does take a couple seconds to initialize because we do cache some data at the start.

• get_stadia: Gets data about stadiums, things like location, name and capacity.
• get_referees: Gets data about referees, things like name, birth date and nationality.
• get_managers: Gets data about managers, things like name and nationality.
• get_teams: Gets data about teams, things like abbreviation and name.
• get_players: Gets data about players, things like height, weight and nationality.
• get_games: Gets data about games, things like score, attendance and matchday.
• get_player_xgoals: Gets a player(s) xGoals for a season or range of dates.
• get_player_xpass: Gets a player(s) xPass for a season or range of dates.
• get_player_goals_added: Gets a player(s) g+ for a season or range of dates.
• get_player_salaries: Gets a player(s) salary for a season or range of dates, only available for MLS.
• get_goalkeeper_xgoals: Gets a goalkeepers(s) xGoals for a season or range of dates.
• get_goalkeeper_goals_added: Gets a goalkeepers(s) g+ for a season or range of dates.
• get_team_xgoals: Gets a team(s) xGoals for a season or range of dates.
• get_team_xpass: Gets a team(s) xPass for a season or range of dates.
• get_team_goals_added: Gets a team(s) xPass for a season or range of dates.
• get_team_salaries: Gets a team(s) salary for a season or range of dates, only available for MLS.
• get_game_xgoals: Gets a game(s) xGoals for a season or range of dates.

For more info on xGoals, xPass and g+, check out these articles:

• xGoals Explanation
• An Updated Expected Passing Model
• What Are Goals Added

Bug fixes 🐛

None, but if you do find a bug while using the package, please submit an issue.

Documentation 📚

We know our documentation is a bit sparse at the moment, but we plan on building it up and adding more examples over time. In the meantime, the API documentation should be a sufficient stop gap for specific functions.

Happy soccering!