R.rsp (version 0.6.5)

R.rsp-package: Package R.rsp

Description

An RSP document is a text-based document containing an R-embedded template of the final document. An RSP document is preprocessed, parsed and translated into an R script, which when sourced generates the final document. This way it is possible to dynamically generate reports in plain text, HTML, TeX etc. It can also be used to enhance other literate programming languanges such as Sweave. In addition to RSP, this package also provides an internal cross-platform web server and built-in dynamic RSP-embedded HTML help pages, which can be launched by browseRsp(). If other packages provide RSP help pages, these are automatically linked to as well.

Arguments

Requirements

This is a cross-platform package implemented in plain R. This package depends on the packages R.oo [1] and R.utils. Note that no webserver is required to process RSP documents.

Installation

To install this package, do install.packages("R.rsp").

To get started

To get started, see:
  1. rsp() - To compiles any RSP-embedded document.
  2. browseRsp() - Luanches a locally running RSP website powered by an internal web server and RSP-embedded HTML pages. From this page you access not only help pages and demos on how to use RSP, but also other package RSP pages.

Wishlist

Here is a list of features that would be useful, but which I have too little time to add myself. Contributions are appreciated.
  • Extract the HTTP daemon part of this package and create a standalone package named R.httpd or similar. It should provide a method to register simple modules, such as an RSP module. The R.rsp package should then only be a simple module.
  • Write "plugins" to common web servers, e.g. modules to the Apache webserver.
  • Add support for multiple default files; needs Tcl coding.
  • Create a root ServletRequest class to support not only HTTP requests, but also other types of request, e.g. FileRequest etc. This requires some thinking of user cases and design.
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.

How to cite this package

Not available.

References

[1] H. 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/