[lnkForumImage]
TotalShareware - Download Free Software
Confronta i prezzi di migliaia di prodotti.
Asp Forum
 Home | Login | Register | Search 


 

Forums >

comp.lang.ruby

[ANN] RWEB 0.1.0

Michael T. Richter

8/4/2007 11:36:00 PM

RWEB is a literate programming tool for Ruby patterned after Donald
Knuth's WEB system. It will, eventually, feature:

* self-tangling executable scripts
* an external, manual tangling utility
* an external, manual weaving utility with multiple back-end
formats supported


Version 0.1.0 of RWEB has all three of these, but only one
back-end--plain text--is currently provided. The next release will add
XHTML support to the back-end and future releases past that will add
other formats and the ability to easily plug in formats not natively
supported.

The current status of the code is fluid. The core syntax is in place
and unlikely to change. The tangling code is in place and unlikely to
change much. The weaving code is going to change to support plug-ins.
Testing is sporadic at best but will be improved through test cases with
each version. Documentation is in place and reasonably complete
(http://rubylit.rub...) at the library level, but utilities are
currently undocumented.

I'd appreciate any feedback on the library and utility suite as things
stand now.

--
Michael T. Richter <ttmrichter@gmail.com> (GoogleTalk:
ttmrichter@gmail.com)
I'm not schooled in the science of human factors, but I suspect surprise
is not an element of a robust user interface. (Chip Rosenthal)
2 Answers

M. Edward (Ed) Borasky

8/4/2007 11:57:00 PM

0

Michael T. Richter wrote:
> RWEB is a literate programming tool for Ruby patterned after Donald
> Knuth's WEB system. It will, eventually, feature:
>
> * self-tangling executable scripts
> * an external, manual tangling utility
> * an external, manual weaving utility with multiple back-end
> formats supported
>
>
> Version 0.1.0 of RWEB has all three of these, but only one
> back-end--plain text--is currently provided. The next release will add
> XHTML support to the back-end and future releases past that will add
> other formats and the ability to easily plug in formats not natively
> supported.
>
> The current status of the code is fluid. The core syntax is in place
> and unlikely to change. The tangling code is in place and unlikely to
> change much. The weaving code is going to change to support plug-ins.
> Testing is sporadic at best but will be improved through test cases with
> each version. Documentation is in place and reasonably complete
> (http://rubylit.rub...) at the library level, but utilities are
> currently undocumented.
>
> I'd appreciate any feedback on the library and utility suite as things
> stand now.
>

1. Are you using "Web" itself, "noweb", something else, neither, etc.?
2. Have you looked at the way the R language does it? If not, check out
http://www.ci.tuwien.ac.at/~leisch/Sweav... and
http://www.ci.tuwien.ac.at/~leisch/Sweave/Sweave-manual-20...

I'm extremely interested in Literate Ruby (and other langauge)
programming ... I'm planning to check your code out this weekend. Thanks!!

Michael T. Richter

8/5/2007 5:19:00 AM

0

On Sun, 2007-05-08 at 08:57 +0900, M. Edward (Ed) Borasky wrote:

> 1. Are you using "Web" itself, "noweb", something else, neither, etc.?


RWEB is an all-Ruby package.


> 2. Have you looked at the way the R language does it?


Nope. Never had R cross my path yet. I'll check it out. Thanks for
the links.

--
Michael T. Richter <ttmrichter@gmail.com> (GoogleTalk:
ttmrichter@gmail.com)
In his errors a man is true to type. Observe the errors and you will
know the man. (???)