NEWS.md
sp_get_dataset() no longer unzips the downloaded archive. It therefore returns the path to the downloaded zip file, not to the unzipped files. This is needed to support a more modular workflow (see below and vignette("workflow", package = "statnipokladna")).year param in sp_get_table() and sp_get_dataset() now has no default. This is more sensible when there is no easy way to determine the latest available table/dataset and in any case better for reproducibility. The new sp_get_dataset_url() also has this updated behaviour.sp_get_table() have been renamed for more clarity and consistency:
period_vykaz to vykaz_date
per_m to vykaz_month
per_yr to vykaz_year
sp_add_codelist() no longer creates messy column names in the form of [codelist name]_nazev_nazev
sp_get_dataset() (see above).vignette("workflow", package = "statnipokladna")
sp_get_codelist() to handle inconsistent date formats in some codelistsrozprog (programme spend ID) as well as nastroj and nastrojanal codelists are now recogniseddest_dir in sp_get_*() functions, files are now put into the right directory even if dest_dir does not contain a trailing slashsp_get_dataset_doc() now creates dest_dir if it does not exist, as advertised in the documentationsp_get_*() functions can now be set in the option statnipokladna.dest_dir. Set this at the beginning of your script or once per session, or in your .Rprofile (e.g. setOption(statnipokladna.dest_dir = "~/sp_data") for cross-session storage or setOption(statnipokladna.dest_dir = "sp_data") for storing all data downloaded by statnipokladna in an sp_data subfolder of the current project.)statnipokladna directory inside dest_dir.sp_get_dataset() and sp_get_dataset_doc() now return their outputs invisibly and provide better messagessp_get_table() to a new structure of some data dumps on the part of the data providersp_get_codelist() no longer issues a tibble-related warningsp_get_codelist() now parses all dates correctly*_date columns now work in sp_add_codelist(), fixes #66sp_add_codelist() returns a message if joining by multiple columnssp_add_codelist() gains a by parameterusethis::
sp_get_dataset()
sp_get_dataset_doc() now checks that dataset exists before pointing/downloading.sp_* to avoid conflicts with other packages and for better discoverability via autocomplete; original functions are soft-deprecated.get_table() now provides access to changes-in-equity data (přehled o změnách vlastního kapitálu, use "changes-in-equity" table id) and cash flow statements (přehled o peněžních tocích, use "cash-flow" id)get_table() now fully documents the columns in its output, see help("get_table")
get_codelist() did not create the right temp directoryget_table()
get_table() when ico is set*_codelist() are now stored in tempdirico parameter in get_table() now directly follows the key parameters; this will break cases where the function was called with unnamed parameters but will make use more straighforward.table_id parameter in get_table() is now a human-readable alphanumeric code, not a meaningless number. This will break all uses of get_table but make future use more sensible.add_codelist() function for joining codelists to core financial dataget_codelist() gains n parameter, allowing only a limited number of rows of a codelist to be retrieved (to save time)get_codelist() has a new paramater which opens the online codelist viewerico parameter in get_table() now worksget_codelist() now returns a codelist df ready to join to core dataget_codelist()
get_dataset() function for retrieving filesget_table() function for loading data - only experimental
get_dataset_doc() function for accessing/downloading official documentation for each datasetget_codelist()