NEWS.md
httr::RETRY instead - this adds some robustness for server-side issues. As suggested by Maelle Salmon’s blog post on not reinventing the wheel. (v1.2.1.1)The main goal of ffscrapr 1.2.0 is to add a full set of methods for Fleaflicker. This release also adds improved caching options, including writing to your filesystem for persistent caching (see the vignette!), and one hotfix for sleeper_getendpoint.
sleeper_getendpoint() now behaves more like the other getendpoint functions - first argument is the endpoint and any further args are passed as query parameters.All functions now have Fleaflicker methods! Here are notes about what isn’t the same:
fleaflicker_players() requires a connection/leagueID by default - acts a little oddly on game days as of right now.ff_playerscores() - Fleaflicker’s API returns season level data easily, week-level is not readily available yet without some workarounds. Everything else seems to be okay.The main goal of ffscrapr 1.1.0 is to add a full set of methods for Sleeper. Also adds two new generics: ff_userleagues() and ff_starters().
Here is a list of new functions available at the top level (ie for all platforms)
ff_userleagues() returns a list of user leagues. This is deployed slightly differently for MFL and Sleeper - MFL requires authentication to access user’s leagues, while Sleeper doesn’t have authentication so you can look up any user you like.ff_starters() returns a list of players started/not-started each week. MFL will return the actual score of each player each week and calculate whether they were optimal, while Sleeper just returns the player themselves.Almost all functions now have Sleeper methods - implemented in what hopes to be relatively familiar manner to MFL. Outlining the specifics of what isn’t the same:
sleeper_userleagues() is a wrapper on ff_userleagues() that makes it easier to look up user leagues without first creating a connection object.ff_playerscores() is not available for Sleeper because Sleeper removed the player stats endpoint - it will generate a warning (rather than an error). Thinking about creating some functions to calculate scoring based on nflfastr.sleeper_getendpoint() is a little more simple than MFL’s equivalent - just pass a string url (minus api.sleeper.app/v1) or pass in chunks of code, the function will automatically paste them together with “/”.ff_userleagues() - Sleeper league IDs are more annoying than MFL to handle, so the more intuitive way is to look up the user’s league_ids by username first. MFL does have a parallel feature even if used for different purposes.ff_userleagues()
ff_standings() (#69, nice.)ff_starters() as requested by #76 (thanks, Mike!)httr::handle_reset() call to fix login-caching bug.This is the first (major) version of ffscrapr and it is intended to build out the full set of functions for the first API platform: MFL.
Future versions will add more platforms via methods mapped to the same functions.
Functions include:
ff_connect (and sibling mfl_connect) to establish connection parameters and ratelimitingmfl_getendpoint as a low-level function for making GET requests from MFLff_draft gets draft resultsff_draftpicks gets current and future draft picks that have not yet been selectedff_franchises gets franchise-level identifiers and divisionsff_league gets league-level summaries of rules, players, and franchisesff_playerscores gets playerweek-level scoresff_rosters gets franchise-level rosters complete with namingff_schedule gets weekly fantasy schedulesff_scoring gets scoring rulesff_standings gets league-level season summariesff_transactions gets a list of all transactions and cleans them into a data frame.