The pkg_diff
function is used to compare two different versions of
a package. The function returns an object that contains the differences.
Differences include any functions added or removed. The object may
be printed directly, or stored in a variable and examined programmatically.
pkg_diff(pkg, v1 = "current", v2 = "latest")
The package name.
The earlier package version. Pass the version value as a quoted string. Default is "current", which means the function will look up the currently installed version.
The later package version. Pass the version value as a quoted string. The default is "latest", which is the latest version of the package available on CRAN.
An object of class "pdiff", which contains information regarding the differences between two versions of a package. The object includes a list of functions that were added, a list of function parameters that were added, a list of functions removed, and a list of function parameters that were removed. The object also contains some general information like the package versions examined, and a TRUE or FALSE flag indicating whether there were any breaking changes.
The difference operation only compares functions that are exported from the package. It does not compare internal functions or function documentation. Exported functions are identified in the package namespace.
The pkg_diff
function can compare any two versions of a package.
They do not need to be consecutive. They must, however, exist in the CRAN
archive.
If the package versions are included in the pkgdiff cache, the function will pull them from there. Otherwise, they will be pulled from the CRAN mirror. The function does not access any packages on the local system.
Other pdiff:
pkg_cache()
,
pkg_info()
,
pkg_stability()
,
pkg_versions()
,
print.pcache()
,
print.pdiff()
,
print.pdiff_score()
,
print.pinfo()
# View package stability
pkg_stability("rsample")
# # A stability score: rsample package
# - Age: 7.58 years
# - Score: 80.3
# - Assessment: Somewhat Unstable
# - Version Range: 0.0.1/1.2.1
# - Release Range: 2017-07-08/2024-03-25
# - Release Count: 16
# - Breaking Releases: 6
# - Data:
# Package Version FileName Release Size AF AP RF RP BC TF
# 1 rsample 1.2.1 rsample_1.2.1.tar.gz 2024-03-25 320.9K 1 0 0 0 0 401
# 2 rsample 1.2.0 rsample_1.2.0.tar.gz 2023-08-23 321K 43 6 1 3 1 400
# 3 rsample 1.1.1 rsample_1.1.1.tar.gz 2022-12-07 318K 37 5 0 0 0 358
# 4 rsample 1.1.0 rsample_1.1.0.tar.gz 2022-08-08 306K 72 1 0 0 0 321
# 5 rsample 1.0.0 rsample_1.0.0.tar.gz 2022-06-24 268K 1 0 1 0 1 249
# 6 rsample 0.1.1 rsample_0.1.1.tar.gz 2021-11-08 274K 4 1 0 1 1 249
# 7 rsample 0.1.0 rsample_0.1.0.tar.gz 2021-05-08 274K 0 5 0 0 0 245
# 8 rsample 0.0.9 rsample_0.0.9.tar.gz 2021-02-17 269K 19 0 6 0 1 245
# 9 rsample 0.0.8 rsample_0.0.8.tar.gz 2020-09-23 261K 59 0 0 0 0 232
# 10 rsample 0.0.7 rsample_0.0.7.tar.gz 2020-06-04 248K 101 1 0 0 0 173
# 11 rsample 0.0.6 rsample_0.0.6.tar.gz 2020-03-31 299K 7 2 0 0 0 72
# 12 rsample 0.0.5 rsample_0.0.5.tar.gz 2019-07-13 297K 4 5 0 0 0 65
# 13 rsample 0.0.4 rsample_0.0.4.tar.gz 2019-01-07 254K 0 0 4 0 1 61
# 14 rsample 0.0.3 rsample_0.0.3.tar.gz 2018-11-20 254K 7 0 1 0 1 65
# 15 rsample 0.0.2 rsample_0.0.2.tar.gz 2017-11-12 339K 24 0 0 0 0 59
# 16 rsample 0.0.1 rsample_0.0.1.tar.gz 2017-07-08 180K 35 35 0 0 0 35
# Examine differences between versions
pkg_diff("rsample", "1.1.1", "1.2.0")
# # A difference object: rsample package
# - Comparing: v1.1.1/v1.2.0
# - Breaking Changes: TRUE
# - Added Functions:
# - analysis.default()
# - analysis.initial_validation_split()
# - analysis.rsplit()
# - analysis.val_split()
# - assessment.default()
# - assessment.initial_validation_split()
# - assessment.rsplit()
# - assessment.val_split()
# - dim.initial_validation_split()
# - group_initial_validation_split()
# - initial_validation_split()
# - initial_validation_time_split()
# - int_bca.bootstraps()
# - int_pctl.bootstraps()
# - int_t.bootstraps()
# - print.initial_validation_split()
# - testing.default()
# - testing.initial_validation_split()
# - testing.rsplit()
# - testing.val_split()
# - training.default()
# - training.initial_validation_split()
# - training.rsplit()
# - training.val_split()
# - validation()
# - validation.default()
# - validation.initial_validation_split()
# - validation.val_split()
# - validation_set()
# - vec_cast.data.frame.validation_set()
# - vec_cast.tbl_df.validation_set()
# - vec_cast.validation_set.data.frame()
# - vec_cast.validation_set.tbl_df()
# - vec_cast.validation_set.validation_set()
# - vec_ptype_abbr.group_initial_validation_split()
# - vec_ptype_abbr.initial_validation_split()
# - vec_ptype_abbr.validation_set()
# - vec_ptype2.data.frame.validation_set()
# - vec_ptype2.tbl_df.validation_set()
# - vec_ptype2.validation_set.data.frame()
# - vec_ptype2.validation_set.tbl_df()
# - vec_ptype2.validation_set.validation_set()
# - vec_restore.validation_set()
# - Added Parameters:
# - int_pctl(): ...
# - int_t(): ...
# - testing(): ...
# - tidy.nested_cv(): unique_ind
# - tidy.rset(): unique_ind
# - training(): ...
# - Removed Functions:
# - gather()
# - Removed Parameters:
# - int_bca(): statistics, alpha, .fn
# - int_pctl(): statistics, alpha
# - int_t(): statistics, alpha