About this package

Description

This package provides utility classes and methods useful when programming in R and developing R packages.

Warning: The Application Programming Interface (API) of the classes and methods in this package may change. Classes and methods are considered either to be stable, or to be in beta or alpha (pre-beta) stage. See list below for details.

The main reason for publishing this package on CRAN although it lacks a stable API, is that its methods and classes are used internally by other packages on CRAN that the author has published.

For package history, see showHistory(R.utils).

Requirements

This package requires the R.oo package [1].

Installation and updates

To install this package do

install.packages("R.utils")

Required packages are installed in the same way. To update, do update.packages(). To get the "devel" version, add argument contriburl="http://www.braju.com/R/" to the above commands.

To get started

Arguments
[alpha] Methods for common argument processing.
Assert
[alpha] Methods for assertion of values and states.
GString
[alpha] A character string class with methods for simple substitution.
Java
[beta] Reads and writes Java streams.
Options
[alpha] Tree-structured options queried in a file-system like manner.
Settings
[alpha] An Options class for reading and writing package settings.
ProgressBar
[beta] Text-based progress bar.
FileProgressBar
[beta] A ProgressBar that reports progess as file size.
System
[alpha] Methods for access to system.
SmartComments, VComments, LComments
[alpha] Methods for preprocessing source code comments of certain formats into R code.

In addition to the above, there is a large set of function for file handling such as support for reading/following Windows Shortcut links, but also other standalone utility functions. See package index for a list of these. These should also be considered to be in alpha or beta stage.

How to cite this package

Whenever using this package, please cite [1] as

@INPROCEEDINGS{BengtssonH_2003,
 author       = {Henrik Bengtsson},
 title        = {The {R.oo} package - Object-Oriented Programming
                 with References Using Standard {R} Code},
 booktitle    = {Proceedings of the 3rd International Workshop on
                 Distributed Statistical Computing (DSC 2003)},
 year         = {2003},
 editor       = {Kurt Hornik and Friedrich Leisch and Achim Zeileis},
 address      = {Vienna, Austria},
 month        = {March},
 issn         = {1609-395X},
 howpublished = {http://www.ci.tuwien.ac.at/Conferences/DSC-2003/},
}

Wishlist

Here is a list of features that would be useful, but which I have too little time to add myself. Contributions are appreciated.

• Write a TclTkProgressBar class.
• Improve/stabalize the GString class.
• Mature the SmartComments classes, but also add AComments and PComments for assertion and progress/status comments.

If you consider implement some of the above, make sure it is not already implemented by downloading the latest "devel" version!

License

The releases of this package is licensed under LGPL version 2.1 or newer.

The development code of the packages is under a private licence (where applicable) and patches sent to the author fall under the latter license, but will be, if incorporated, released under the "release" license above.

References

[1] Henrik Bengtsson, The R.oo package - Object-Oriented Programming with References Using Standard R Code, In Kurt Hornik, Friedrich Leisch and Achim Zeileis, editors, Proceedings of the 3rd International Workshop on Distributed Statistical Computing (DSC 2003), March 20-22, Vienna, Austria. http://www.ci.tuwien.ac.at/Conferences/DSC-2003/Proceedings/

Author(s)

Henrik Bengtsson http://www.braju.com/R/