\name{NEWS}
\title{NEWS}

\section{Changes in version 4.6.0}{
\itemize{
\item Added \code{convert_umlauts_to_utf8()}.
\item Added \code{convert_to_power_of_ten()} and \code{convert_from_power_of_ten()},
\code{df_to_powers_of_ten()} and \code{df_from_powers_of_ten()}.
\item \code{split_code_file()} now also keeps headers.
}
}

\section{Changes in version 4.5.0}{
\itemize{
\item Added \code{escape_non_ascii()}.
\item Added \code{is_scalar()}.
\item Added \code{is_convertible2numeric()}.
\item Added \code{is_true()}.
\item Added \code{file_string()}.
}
}

\section{Changes in version 4.4.0}{
\itemize{
\item Added \code{char2factor()}.
\item Added \code{rownames2col()}.
\item Added \code{pause()}
\item Added \code{string2words()}.
\item Added \code{get_session_string()}.
\item Added \code{runsed()}.
\item Added tests for \code{relative_difference()}.
\item Harden testing for FVA against upper case user names.
}
}

\section{Changes in version 4.3.0}{
\itemize{
\item Added \code{get_german_umlauts()}.
}
}

\section{Changes in version 4.2.0}{
\itemize{
\item Added Sloboda's growth function: \code{sloboda()}.
}
}

\section{Changes in version 4.1.1}{
\itemize{
\item Fixed CRAN notes on Escaped LaTeX specials.
}
}

\section{Changes in version 4.1.0}{
\itemize{
\item Renamed the package to \code{fritools}.
\item Add \code{rename_package()}.
\item We do not check on the number of columns anymore since \code{utils::read.table()}
seems do get the columns right anyways. However it manages.
\item \emph{\code{find_files()}: changed default to argument \code{pattern}
from \code{".*\\\\.[RrSs]$|.*\\\\.[RrSs]nw$"} to \code{NULL}}.
\item Hardened \code{find_files()} against failing \code{pattern}s on windows.
\item \code{is_running_on_fvafrcu_machines()} now has value \code{bwi} for argument \code{type}.
This is \code{TRUE} for the nfi notebook only.
\item Add function \code{grep_file()}.
}
}

\section{Changes in version 4.0.0}{
\itemize{
\item Got rid of suggested packages \code{packager} and \code{rasciidoc}.
\item Switched from RUnit to tinytest. Excluded RUnit tests from tarball due to CRAN
requirement. I can still find them in
\href{https://gitlab.com/fvafrcu/fritools/-/tree/master/inst/runit_tests}{(https://gitlab.com/fvafrcu/fritools/-/tree/master/inst/runit_tests)}.
}
}

\section{Changes in version 3.7.0}{
\itemize{
\item Changed argument order for \code{find_files()} from \verb{names, path, pattern} to
\verb{path, pattern, names} for convenience.
\item Added \code{relative_difference()},  a convenience wrapper to \code{base::all.equal()}
\item Added \code{column_sums()}, a convenience wrapper to \code{base::colSums()}.
}
}

\section{Changes in version 3.6.0}{
\itemize{
\item \code{split_code_file()} now works with files with hidden functions (i.e. function
whose names start with a period).
\item Under unix, \code{clipboard_path()} now prints the path as \code{file.path} to the console.
\item Added \code{count_groups()}, a specialized wrapper to \code{stats::aggregate()}, gives
results similar to \code{dplyr::count()}.
}
}

\section{Changes in version 3.5.1}{
\itemize{
\item \code{view()} now normalizes the path first in order to deal with blanks in the
path.
\item Added example to vignette.
\item Linted exhaustively.
}
}

\section{Changes in version 3.5.0}{
\itemize{
\item Added \code{delete_trailing_blank_lines()}.
\item \code{view()} now uses \code{base::shQuote()} under Unix.
}
}

\section{Changes in version 3.4.0}{
\itemize{
\item Made \code{vim()} warn instead of throw when called non-interactively.
\item \code{touch()} now digests paths to several files.
Replaced argument \code{path} by \code{...} but the ui did not change.
\item \code{vim()} now digests paths to several files.
Replaced argument \code{file} by \code{...} but the ui did not change.
\item \code{file_save()} now digests paths to several files.
Replaced argument \code{x} by \code{...} but the ui did not change.
\item \code{file_copy()} now digests paths to several files.
\item Added \code{delete_trailing_whitespace()}.
\item Added \code{develop_test()}.
\item Added \code{wipe_tempdir()}.
\item Added 'clipboard_path()` to help me with paths under Windows.
\item \code{view()} now tries to use \code{program} only if it is installed.
\item \code{is_files_current()} now warns, if any file is newer than \code{Sys.time()}.
}
}

\section{Changes in version 3.3.0}{
\itemize{
\item Added \code{view()} as an unix equivalent to \code{shell.exec()}.
\item Added \code{vim()} as a wrapper to \code{file.edit()}.
\item Added \code{file_copy()} to force copying while backing up.
\item Added \code{file_save()} to create backup copies for files.
\item Added appropriate error messages to \code{fromto()} and allowing for NA in its
arguments \code{from} and \code{to} to read from first item and to last item.
}
}

\section{Changes in version 3.2.0}{
\itemize{
\item Added function \code{round_half_away_from_zero()} that implements commercial
rounding.
\item Added function \code{str2num()} to convert string representations of (potentially
German) numbers.
}
}

\section{Changes in version 3.1.0}{
\itemize{
\item Added a global option to pass \code{.GlobalEnv} as default environment to
\code{wipe_clean()}.
\item Added calls to \code{Sys.sleep(1)} to unit testing to ensure that the files' time
stamps are correct.
}
}

\section{Changes in version 3.0.0}{
\subsection{Major changes}{
\itemize{
\item Added function \code{check_ascii_file()} to check for number of lines and fields of
an ascii file.
This is used to now check whether files read via \code{read_csv()} are read
completely. Otherwise an error is thrown.
\code{bulk_read_csv()} now knows an argument \code{stop_on_error} to stop reading if one
of the files in the bulk fails to be read.
}
}

\subsection{Minor changes}{
\itemize{
\item \code{set_path()} now adds reading and writing times to the path. So we can compare
reading times with modification times on disk.
\item Added argument \code{force} to \code{get_path()} to enable unit testing.
}
}
}

\section{Changes in version 2.5.0}{
\itemize{
\item Added argument \code{differences_only} to function \code{compare_vectors()}.
\item Added function \code{is_path}.
\item Added function \code{fromto}.
\item Added function \code{find_missing_see_also} and \code{find_missing_family}.
\item Function \code{set_path} now sets a path attribute which itself has a file time
modification date attribute.
}
}

\section{Changes in version 2.4.0}{
\itemize{
\item Added argument \code{select} to function \code{find_files()}. This allows us to select
files by their attributes, like file size.
\item Changed argument default for \code{recursive} for \code{find_files()} from \code{TRUE} to
\code{FALSE}.
}
}

\section{Changes in version 2.3.0}{
\itemize{
\item Added functions \code{is_files_current()} and \code{is_difftime_less()}.
\item Added function \code{is_valid_primary_key()} from \code{wehamr}.
\item Function \code{convert_umlauts_to_ascii()} now converts \code{rownames}, too.
}
}

\section{Changes in version 2.2.1}{
\itemize{
\item Fixed function \code{convert_umlauts_to_tex()}.
\item Fixed unit test that threw an error when running unit test on CRAN M1mac.
}
}

\section{Changes in version 2.2.0}{
\itemize{
\item Added functions to read an write (bulks of) CSV files.
\item Added \code{csv2csv()}, which converts German to standard CSV.
}
}

\section{Changes in version 2.1.0}{
\itemize{
\item Added \code{convert_umlauts_to_ascii()}.
\item Added \code{file_last_modified()}.
\item Added \code{is_cran()}, a copy of \code{fda::CRAN()}.
\item \code{touch()} now creates directories as needed.
\item \code{get_path()} and \code{set_path()} now throw errors, if a path to get is not set or
if a path to set is already set and argument \code{overwrite} is not \code{TRUE}.
}
}

\section{Changes in version 2.0.0}{
\subsection{Major changes}{
\itemize{
\item \code{search_files()} now throws an error if no matches are found.
}
}

\subsection{Minor changes}{
\itemize{
\item Added function \code{search_rows()}.
\item Added function \code{is_success()}.
\item Added function \code{convert_umlauts_to_tex()}.
}
}
}

\section{Changes in version 1.4.0}{
\itemize{
\item Added function \code{split_code_file()}.
\item Added function \code{weighted_variance()}.
\item Added function \code{tapply()} to fix the base version which will not digest
\code{data.frame}s as input.
}
}

\section{Changes in version 1.3.0}{
\itemize{
\item Extended \code{is_running_on_fvafrcu_machines()} to catch a new machine.
\item Added function \code{with_dir()} as this is often the only function I import from
package \code{withr} making \code{withr} a dependency.
\item Added function \code{get_boolean_envvar()}, \code{get_run_r_tests()} is
now a wrapper to that.
\item Added function \code{is_of_length_zero()}.
\item Added function \code{get_unique_string()}.
\item Added function \code{is_r_cmd_check()}.
\item Added function \code{run_r_tests_for_known_hosts()}.
\item Added functions \code{get_path()} and \code{set_path()}.
\item The \code{matrix} returned by \code{compare_vectors} now has named rows.
}
}

\section{Changes in version 1.2.0}{
\itemize{
\item Skipping tests for \code{search_files()} if R has not at least version 4.0.0.
\item Added function \code{r_cmd_install()} as a quick alternative to \code{devtools::install()}.
\code{devtools} calling \code{callr}, calling \code{processx::run} seemed too bloated for
such a simple task.
\item Added function \code{compare_vectors()} which returns a side-by-side comparison of
two vectors.
\item Updated test_helper to recognize machines running at the Forest Research
Institute of the state of Baden-Wuerttemberg.
}
}

\section{Changes in version 1.1.0}{
\itemize{
\item Fixed buggy regular expression in \code{is_running_on_gitlab_com()}
\item Added \code{get_options}, \code{set_options}, \code{is_force};
\code{call_conditionally}, \code{call_safe};
\code{is_installed}, \code{is_r_package_installed};
\code{is_false}, \code{is_null_or_true};
\code{search_files}, \code{find_files}, \code{summary.filesearch} and
\code{strip_off_attributes}
from package \code{packager}.
}
}

\section{Changes in version 1.0.0}{
\itemize{
\item Got the compilation of utilities from
\itemize{
\item rasciidoc/R/utils.R: *
\item packager/R/is_version_sufficient.R: *
\item rasciidoc/R/is_version_sufficient.R: *
\item document/R/test_helpers.R: *
\item fakemake/R/tools.R: *
\item cleanr/R/utils.R: *
\item bundeswaldinventur/R/utils.R: golden_ratio()
\item cuutils/R/utils.R: *
\item cuutils/R/?.R: ?
\item packager/R/package_version.R
}
}
}

