ANN: Guile-Reader 0.3, A Reader Framework for Guile

ANN: Guile-Reader 0.3, A Reader Framework for Guile

[Ludovic Courtès]

Hello,

Version 0.3 of Guile-Reader for Guile 1.8.x is now available:

The SHA1 sums for these two files are:

  5770945a8e560b1d670115c1377de8a05fd2baaf  guile-reader-0.3.tar.gz
  9cd3aca8e1f102324f7c8c2c2e4b0f3fc9d3a62c  guile-reader-0.3.tar.gz.sig

Documentation is available at:

  http://www.nongnu.org/guile-reader/

Guile-Reader is a reader creation framework for Guile.  It can be
thought of as an alternative to Guile's built-in reader.  The purpose of
Guile-Reader is to allow for the creation of readers for different
variants of the Scheme/Lisp syntax.  Its design allows the re-use and
composition of various parts of a lexer called "token readers".  It
comes with a library of re-usable token readers that can be used to
build a Scheme reader with various extensions.  For instance, syntax
extensions for DSSSL keywords, SRFI-30 block comments, SRFI-62 S-exp
comments and R6RS square-bracket S-exps are provided and readily usable
through the `make-alternate-guile-reader' procedure.

Additionally, Guile-Reader aims to improve on Guile's reader sub-system
by allowing for the coexistence of several, potentially incompatible,
readers within a single Guile program.  In particular, it provides a
"confinement" mechanism that confines changes made via `read-set!' and
`read-hash-extend' to the calling module.

Although more flexible, Guile-Reader is between 5 and 10 times faster
than Guile's built-in `read' (see the file `tests/benchmark.scm').


New in Guile-Reader 0.3:

  * Various performance improvements (e.g., `make-reader' can now
    produce an inline version of `scm_getc ()', provided token readers
    allocate less memory from the heap).

  * Improved test suite and documentation.

  * Bug fixes.


Ludovic.



_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: ANN: Guile-Reader 0.3, A Reader Framework for Guile

[Ludovic Courtès]

Ooops, I forgot the URLs...  ;-)

> Version 0.3 of Guile-Reader for Guile 1.8.x is now available:

  http://download.savannah.nongnu.org/releases/guile-reader/guile-reader-0.3.tar.gz
  http://download.savannah.nongnu.org/releases/guile-reader/guile-reader-0.3.tar.gz.sig

> The SHA1 sums for these two files are:
>
>   5770945a8e560b1d670115c1377de8a05fd2baaf  guile-reader-0.3.tar.gz
>   9cd3aca8e1f102324f7c8c2c2e4b0f3fc9d3a62c  guile-reader-0.3.tar.gz.sig
>
> Documentation is available at:
>
>   http://www.nongnu.org/guile-reader/

Thanks,
Ludovic.



_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: ANN: Guile-Reader 0.3, A Reader Framework for Guile

[Mario Storti]

>>>>> On Sat, 24 Feb 2007 12:02:05 +0100, 
>>>>>      ludo@chbouib.org (Ludovic Courtès) said:

> Hello,

> Version 0.3 of Guile-Reader for Guile 1.8.x is now available:
...

I'm interested in the package for use of SRFI-30 block comments. I
tried some variations of

(receive (l1 l2)
    (alternate-guile-reader-token-readers '(srfi30-block-comments))
  (fluid-set! current-reader (make-reader l1)))

without success. What should be the correct `incantation'? I read the
manual, but (I shamelessly recognize) not very deeply. I suggest a
section in the manual "Guile reader for dummies" with instructions
like this.

Thanks in advance, Mario


_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: ANN: Guile-Reader 0.3, A Reader Framework for Guile

[Ludovic Courtès]

Hi,

Mario Storti <mstorti@intec.unl.edu.ar> writes:

> I'm interested in the package for use of SRFI-30 block comments. I
> tried some variations of
>
> (receive (l1 l2)
>     (alternate-guile-reader-token-readers '(srfi30-block-comments))
>   (fluid-set! current-reader (make-reader l1)))
>
> without success. What should be the correct `incantation'? I read the
> manual, but (I shamelessly recognize) not very deeply. I suggest a
> section in the manual "Guile reader for dummies" with instructions
> like this.

The following should work:

  guile> (use-modules (system reader library))
  guile> (define r (make-alternate-guile-reader '(srfi30-block-comments)))
  guile> r
  #<reader b7afcab0>
  guile> (fluid-set! current-reader r)
  guile> (r)
  (+ #| this is a comment |# 2 2)
  (+ 2 2)

First, you pass `make-alternate-guile-reader' a list of symbols
indicating which a list of symbols indicating the syntactic options you
want; it returns a reader, i.e., a procedure that can be used in lieu of
`read'.

Then you can install that procedure as the current reader using
`fluid-set!' as shown above.  You can also pass that procedure
explicitly as a second argument to `load' so that it is used during
loading, or you can use `primitive-load' which will honor
`current-reader' (note that `load' with no second argument falls back to
using the default `read').

Now, it would probably be a good idea to have a "quick start" section in
the manual...  ;-)

Thanks for your interest,
Ludovic.



_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: ANN: Guile-Reader 0.3, A Reader Framework for Guile

[Keith Wright]

> From: Mario Storti <mstorti@intec.unl.edu.ar>
>
> I suggest a section in the manual "Guile reader for
> dummies" with instructions like this.

Oh, please don't call it that.  "For dummies" may be a
registered trademark, and they can keep it.  I think
putting that in the title shows disrespect for your
readers, and I will not read a book with such a title.
(Partly from principle, but partly because every time I
have skimmed such a book it was obvious at a glance
that it was worthless.)

> From: ludo@chbouib.org (Ludovic =?iso-8859-1?Q?Court=E8s?=)
> 
> Now, it would probably be a good idea to have a
> "quick start" section in the manual...

That's not a bad name.  Or "Short Examples", or
"Executive Summary", or "Getting Started", or "For
Beginners".  That last one perhaps focuses too much on
the reader, when the focus should be on the content of
the chapter, but at least it is not a flagrant insult.

-- 
     -- Keith Wright

Programmer in Chief, Free Computer Shop
    <http://www.free-comp-shop.com>
 ---  Food, Shelter, Source code.  ---


_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user