fitzRoy 1.7.0

New Features

• Added a fetch_outofcontract function (with fetch_outofcontract_footywire) to fetch AFL out-of-contract players for a given year (2025 onwards), enabling team list analysis and end-of-season contract reviews.
• Added a new set of functions to fetch AFL Supercoach and AFL Fantasy (Dream Team) scores from Footywire. The main wrapper function fetch_scores() allows users to specify the scoring system ("supercoach" or "dream_team") along with year and round inputs. This addition includes helper functions fetch_supercoach_scores() and fetch_fantasy_scores(), which retrieve round-level performance metrics such as player rankings, salary, scores, and value.
• Added fetch_awards() function with support for three AFL awards:
  • brownlow (player and team vote tallies from Footywire)
  • allaustralian (final team and full squad)
  • risingstar (nominations and round-level stats)
• Added a new wrapper function fetch_team_stats() for retrieving team-level statistics from multiple sources.
• Improved code clarity and consistency with better error handling (cli), safer scoping (.data$), and modern dplyr syntax.
• Enhanced compatibility with other functions by ensuring consistent team naming and structure in outputs.

Bug Fixes

• Fix duplicates for most recent game in fetch_player_stats_afltables() (#250)
• Fix issues for fetch_player_details when indigenous names are used (#262), (#261)
• Addresses new afl.com.au spelling of Wallitj Marawar in replace_teams() (#259)
• Fixed issue with fetch_player_footywire_stats not working with new season

fitzRoy 1.6.0

New Features

• New functions to plot match score worms plot_score_worm and plot_score_worm_totals
• Include date of birth for each player in fetch_player_stats_afltables

Bug Fixes

• Fix age for players playing on birthday in fetch_player_stats_afltables() (#240)
• Remove dupes for players drafted twice in fetch_player_details_footywire() (#242)
• Fixed bug where round 25 was returning NA in fetch_results_afltables
• Fixed a bug where certain games weren't getting rescraped automatically in fetch_player_stats_afltables (#243)
• Removed Fryzigg tests that were failing

fitzRoy 1.5.0

New Features

• Include Extra-Time scores in fetch_player_stats_afltables for any games that went to extra-time (HQET and AQET) (#155)
• Include afltables url, Age, and Career.Games as at that game for each player in fetch_player_stats_afltables
• Include Coach and Home.Away for each team for each game in fetch_player_stats_afltables

Bug Fixes

• Corrected date parsing issues for AFL tables data, ensuring accurate date formats. (#136)
• Change way of fetching umpire names to avoid occasionally grabbing the wrong field from AFL tables (#170)
• Fix substitute column - now contains on and off for all available games
• Fixes for players with incorrect AFL tables player ids - mainly due to player name changes.
• Fixed an issue where find_season_id was only returning the last 10 seasons (#225)
• Updating some deprecated CLI messaging functions
• Updated replace_venues to handle different data source naming conventions (#164)

fitzRoy 1.4.0

New Features

• Updated the Squiggle API code to be more flexible
• Updated replace_teams to handle for indigenous round team names and made it more robust to handle random team name variations (#215)

Bug Fixes

• Fixed a bug where fetch_footywire_stats was breaking due to an 'unused sub' in game this year (#201)
• Fixed a bug where fetch_player_details was failing
• Removed a test for fetch_lineup due to the response being unreliable depending on the time of year
• Fixed a bug where fetch_fixture_footywire wasn't working for season 2024 due to Opening round (#209)
• Fixed a bug where fetch_results_footywire wasn't working for season 2024 due to Opening round (#211)

fitzRoy 1.3.0

• Fixed a bug where fetch_footywire_stats was breaking due to changes in the footywire site
• Fixed a bug with new debut players receiving an ID of 0 in fetch_player_stats_afltables (#189)
• Fixed a bug with fetch_player_stats_afl where it was throwing an error if trying to get AFL stats for a new season. It now returns NULL instead of an error (#190)
• Fixed a minor bug with the rendering of messages in fetch_player_stats_afl (#185)
• Fixed a range of warnings that were either unhelpful or not being adequately captured in unit tests
• Added proper lifecycle deprecation to the old get_ functions. These will be formally removed in the next release

fitzRoy 1.2.0

Breaking changes

• Fixed a bug in fetch_player_stats_afltables where NULL date was defaulting to 1897 instead of current season like other fetch_* functions (#175). This is breaking behaviour to previous versions so will bump the version number but it should be an expected change to make the argument consistent with others

Second 2022 AFLW Season is now returned

• Having two seasons from the same year was preventing users from accessing the 2nd season. * This release fixes this issue. Any AFLW related function should now return both seasons, which is not ideal but the best I can think of without moving towards named seasons (#184)

Non-AFL data

• There are now more competitions that the AFL source can download using the comp argument such as (#173)

Bug Fixes

• Fixed bug that was preventing Fremantle player details from being returned in fetch_player_details_footwire (#169)

• Fixed bug that was causing an error if a round didn't have full lineups

• Fixed issue in the cached data where some dates were missing, depending on when the data was scraped (#181)

• Fixed issue where specific players were getting ID's assigned incorrectly. I've partially fixed that issue but will only be useful for bugs found in 2021 onwards. I'll have to manually fix older issues (#168)

fitzRoy 1.1.0

New features

• Added new set of functions for fetching player details - fetch_player_details and associated helper functions fetch_player_details_afl, fetch_player_details_footywire and fetch_player_details_afltables will return the player details for a particular team and season

• Added function fetch_coaches_votes to retrieve AFLCA coaches votes for any given match @jlholden26

• Added function calculate_coaches_vote_possibilities to return all possible breakdowns of AFLCA coaches votes between two coaches @jlholden26

Minor improvements and fixes

• Fixed an a bug in fetch_fixture_footywire for older versions of R #146

• Fixed type mismatch in fetch_player_stats_afltables and handling blank seasons in fetch_ladder_afl (#149, @cfranklin11)

• Updated error message in check_source which is used in various functions #147

• Fixed issue with fetch_results_afltabeles caused by a readr update

fitzRoy 1.0.0

New Features

• Added a new group of fetch_* functions to provide a common API to various data sources. Each function has common arguments and provides consistent behaviour
• fetch_fixture and associated helper functions fetch_fixture_afl, fetch_fixture_footywire and fetch_fixture_squiggle will return the fixture for a particular season and round
• fetch_results and associated helper functions fetch_results_afl, fetch_results_footywire, fetch_results_sqiggle and fetch_results_afltables will return the results for a particular season and round
• fetch_ladder and associated helper functions fetch_ladder_afl, fetch_ladder_sqiggle and fetch_ladder_afltables will return the ladder for a particular season and round.
• fetch_player_stats and associated helper functions fetch_player_stats_footywire, fetch_player_stats_afltables and fetch_player_stats_fryzigg will return the match stats for a particular season and round.
• fetch_lineup and associated helper function fetch_lineup_afl will return the lineup for a particular season and round, including upcoming matches if teams have been announced

Deprecated functions

The following have all been soft deprecated. They will still work but likely be removed in a future version.

• Deprecated get_afl_fixture - please use fetch_fixture_afl
• Deprecated get_fixture - use fetch_fixture_footywire
• Deprecated get_match_results - use fetch_results_afltables
• Deprecated get_footywire_match_results - use fetch_results_footywire
• Deprecated return_ladder - use fetch_ladder_afltables
• Deprecated get_footywire_stats - use fetch_footywire_stats
• Deprecated get_fryzigg_stats - use fetch_player_stats_fryzigg
• Deprecated get_afltables_stats - use fetch_player_stats_afltables
• Deprecated update_footywire_stats - use fetch_player_stats_footywire
• Deprecated get_footywire_betting_odds - use fetch_betting_odds_footywire
• Deprecated get_score_progression_raw - no replacement
• Deprecated get_footywire_match_ids - use fetch_footywire_match_ids
• Deprecated get_aflw_cookie - use get_afl_cookie
• Deprecated get_aflw_match_data - use fetch_results_afl
• Deprecated get_aflw_player_stats - use fetch_player_stats_fryzigg

Minor changes and bug fixes

• Fixed issue with master branch being renamed to main
• Fixed issue with fetch_betting_odds not working in new season
• Fixed issue with fetch_ladder where it was returning only latest season #145
• Various fixes to data sources have been made on the data repo

fitzRoy 0.3.3

Breaking changes

• Changed how round numbers are calculated for Footywire data sets (from calendar weeks to using round labels in the HTML) @cfranklin11

New features

• Added AFL stats @fryzigg
• Added team colours @fryzigg
• Added AFLW stats @fryzigg
• Added new function get_footywire_match_results to return results from recent games, in the case where afltables hasn't updated
• Added new function get_afl_fixture to return fixture from afl.com.au
• Added new function fetch_ladder_afl to return data function from AFL.com.au
• Added new fetch_ladder generic function to return ladder data

Minor improvements and fixes

• Fixed a bug with get_afl_fixture that was returning the wrong season if season was before 2012
• Removes all instances of rvest::pluck in preparation for it being depreciated in rvest 1.0.0 see changelog, @hadley
• Fixed get_footywire_betting_odds to handle duplicate date/venue combination in the 2020 season without raising error (#123, @cfranklin11)
• Fixed round calculations for get_fixture to handle the compressed 2020 fixture (#125, #128, #132, @cfranklin11)

fitzRoy 0.3.2

General changes

• The Updated AFLW API URL has been updated to reflect changes to the afl.com.au website. This should now be working for the new season.

Bug Fixes

• Fixed get_footywire_betting_odds to return an empty data frame when only future seasons are requested rather than raising an error (#112, @cfranklin11)
• Fixed issue with afltables data that caused issues with home/away team in drawn finals matches #116
• Fixed issue with duplate rows in footywire data #115