NEWS.md
phone() now pre-processes values that are considered “not a number” to avoid running them through the Java parser. This massively speeds up phone number parsing for "", NA and similar values, and fixes an issue where Java would freeze after seeing a large amount of invalid phone number values (#27).
show_progress is now a function argument for phone() and get_timezone(). Previously progress bar visibility could only be set package wide using the dialr.show_progress option. Now it can be set locally using the show_progress function parameter (#25).
Move rJava initialisation to .onLoad() instead of .onAttach() (#16). Since dialr is a wrapper for a Java package, rJava has to initialise Java before it will work. Previously, users had to attach dialr with library(dialr) to properly initialise Java. Now rJava is initialised when the package is loaded/referenced, so dialr functions can now be used with the :: notation (e.g. dialr::phone()) without a preceding call to library().
Remove is_vector_s3() method at the pillar maintainer’s request (#19).
Bump minimum supported version following R 4.0.0 release.
Make tests for timezone, geocoder and carrier functions less dependant on existing values to avoid changes in libphonenumber data breaking tests (#14).
This release fixes a bug introduced by changes to the treatment of list based classes in tibble 3.0.0 that broke phone vectors in tibbles (#12). All phone vectors now also have the list class as recommended by the tibble changelog.
In the future dialr may use the vctrs package to implement the phone class once vctrs is a bit more stable.
The libphonenumber repo moved to https://github.com/google/libphonenumber/ a little while ago. Docs have been updated accordingly (#11).
Retrieve carrier name with get_carrier() (#6).
Add geocoding functions get_geocode() and get_timezone() (#5).
get_example() returns an empty phone number if the provided type is invalid for the provided region (#8).
phone() constructor now supports parsing phone numbers in international format without a default region by specifying NA or "" in the region argument (#4).
get_type() gets a strict argument. If TRUE, invalid phone numbers return NA instead of "UNKNOWN".
Rename “One shot methods” vignette to remove redundant “dialr”.
Code calling libphonenumber methods via rJava has been tweaked for performance, including using more efficient rJava acess methods and caching commonly used static values. Most operations are now approx. 10 times faster.
New introductory vignette("dialr").
New is_match() function supports proper phone equality checks. == and != now use is_match() for phone vectors. (#1)
More region and type functions implemented. See ?`dialr-region` or ?`dialr-type` for details.
New get_example() function generates example phone numbers for provided regions and types.
Improved function documentation.
dialrjars
To separate libphonenumber updates from structural package updates, the libphonenumber jars have been split into the new package dialrjars. This is a breaking change, and dialrjars will need to be installed for dialr to continue to work.
In addition to the one-shot phone processing functions, dialr now has a “phone” S3 class to reduce the processing load from re-parsing phone numbers for every operation. This is a fundamental package change with a full set of replacement functions, for details see ?phone.