@elliottcable/bs-gen

bs-gen

This is c-cube's Gen iterator library for OCaml, cross-compiled to JavaScript via BuckleScript (an OCaml-to-JavaScript compiler) for Reason (an alternative OCaml syntax targeting that compiler.)

You can safely ignore the installation instructions below when compiling to JS. Instead:

1. Install this fork through npm:

    npm install --save @elliottcable/bs-gen
   

2. Manually add bs-gen to your bsconfig.json's bs-dependencies:

    "bs-dependencies": [
      ...
      "@elliottcable/bs-gen"
    ],
   

3. Use Gen.t!

Of note, I ran into some type errors when trying to compile with GenLabels API enabled; thus, the npm version of this library omits that entirly. All of the other modules are included, though.

Original README follows:

Gen

Iterators for OCaml, both restartable and consumable. The implementation keeps a good balance between simplicity and performance.

The library is extensively tested using qtest. If you find a bug, please report!

The documentation can be found here; the main module is Gen and should suffice for 95% of use cases.

Install

$ opam install gen

or, manually, by building the library and running make install. Opam is recommended, for it keeps the library up-to-date.

Use

You can either build and install the library (see "Build"), or just copy files to your own project. The last solution has the benefits that you don't have additional dependencies nor build complications (and it may enable more inlining).

If you have comments, requests, or bugfixes, please share them! :-)

Build

There are no dependencies. This should work with OCaml>=3.12.

$ make

To build and run tests (requires oUnit and qtest):

$ opam install oUnit qtest
$ ./configure --enable-tests
$ make test

License

This code is free, under the BSD license.

Changelog

0.5.1

• refactor to use match-with-exception from OCaml 4.02
• transition to jbuilder

0.5

• fix small problem with safe-string
• move to safe-string, for compatibility with 4.06.0
• add optimize() flag to _tags
• rename parameter of int_range from by to step
• add ?(by=1) to int_range

0.4

• update GenLabels with missing functions
• add Gen.peek_n
• add Gen.peek
• add first draft of GenM, an overlay for iterating over monadic values. this module is experimental as of now.
• cleanup:
  • more tests
  • move all tests to gen.ml using qtest
  • merge benchmarks into a single file
  • add ocp-indent file, update header, reindent files
  • move code to src/

0.3

• add Gen.return
• fix overflow in Gen.flat_map; add regression test
• opam: depend on ocamlbuild
• add functions Gen.{lines,unlines}
• add Gen.Restart.of_gen as a convenient alias to persistent_lazy
• add Gen.IO.{with_lines, write_lines}
• update benchmarks to use Benchmark.Tree