[Caml-list] [ANN] IOCaml v0.3

[Caml-list] [ANN] IOCaml v0.3

[Andy Ray]

[-- Attachment #1: Type: text/plain, Size: 1987 bytes --]

*** I announced this to the list through google groups a few days ago but I
don't think it worked properly so hopefully this time ... ***

https://github.com/andrewray/iocaml

IOCaml is an OCaml kernel for the IPython notebook (
http://ipython.org/notebook.html).  This provides a REPL within a web
browser with a nice user interface including markdown based
comments/documentation, mathjax formula and the possibility of generating
all manner of HTML based output media from your code.  Here are a few
features I think are particularly interesting;

* Uses ocp-index.lib to provide code completion and types (includes
documentation if .cmt files exist).  Only works with installed libraries at
the moment.  Very new, a wee bit buggy, but I love it.

* I copy/pasted the OCaml core language documentation page into a notebook.
 Now you can learn interactively! [1]

* Play with TyXML in the notebook and render typed HTML interactively.

Installation is reasonably painless through opam, though you currently need
to add my remote repository [2] and require a >=4.00.1 compiler.
 Installation of IPython is a touch more involved as you will have to
update (using 'pip') some python components [3].  Instructions for Ubuntu
13.10 are on the github page and I have also tested Fedora 20 which was,
apart from some slightly different package names, very similar.

Cheers,
Andy


[1] I am not sure if, according to the license terms, I should be providing
this.  The documentation has not been changed in any way apart from one
inserted paragraph at the start explaining the difference between a normal
toplevel and the notebook interface.  I hope it's OK to provide this.

[2] I'd love to push this to opam proper but require ocaml-zmq >=3.2.
 There was a recent discussion on the list about this (indeed reading about
ZeroMQ led me to IPython) so hopefully this will happen before too long.

[3] I haven't tested this release with 0.13.2 which the distros provide.
 Maybe it works anyway.

[-- Attachment #2: Type: text/html, Size: 2449 bytes --]

Re: [Caml-list] [ANN] IOCaml v0.3

[Anil Madhavapeddy]

[-- Attachment #1: Type: text/plain, Size: 2591 bytes --]

Ive merged a slightly updated release of this in OPAM stable (as iocaml 0.3.1).  I also have instructions for getting this up and running on MacOS+Homebrew here: https://gist.github.com/avsm/9041133

Thanks very much for releasing this Andy; I hadn't realized what an incredible tool IPython is for teaching until I played with the OCaml backend here.  I'm taking a shot a porting the Real World OCaml guided tour over to a notebook as well...

cheers,
Anil

On 14 Feb 2014, at 00:34, Andy Ray <andy.ray@ujamjar.com> wrote:

> *** I announced this to the list through google groups a few days ago but I don't think it worked properly so hopefully this time ... ***
> 
> https://github.com/andrewray/iocaml
> 
> IOCaml is an OCaml kernel for the IPython notebook (http://ipython.org/notebook.html).  This provides a REPL within a web browser with a nice user interface including markdown based comments/documentation, mathjax formula and the possibility of generating all manner of HTML based output media from your code.  Here are a few features I think are particularly interesting;
> 
> * Uses ocp-index.lib to provide code completion and types (includes documentation if .cmt files exist).  Only works with installed libraries at the moment.  Very new, a wee bit buggy, but I love it.
> 
> * I copy/pasted the OCaml core language documentation page into a notebook.  Now you can learn interactively! [1]
> 
> * Play with TyXML in the notebook and render typed HTML interactively.
> 
> Installation is reasonably painless through opam, though you currently need to add my remote repository [2] and require a >=4.00.1 compiler.  Installation of IPython is a touch more involved as you will have to update (using 'pip') some python components [3].  Instructions for Ubuntu 13.10 are on the github page and I have also tested Fedora 20 which was, apart from some slightly different package names, very similar.
> 
> Cheers,
> Andy
> 
> 
> [1] I am not sure if, according to the license terms, I should be providing this.  The documentation has not been changed in any way apart from one inserted paragraph at the start explaining the difference between a normal toplevel and the notebook interface.  I hope it's OK to provide this.
> 
> [2] I'd love to push this to opam proper but require ocaml-zmq >=3.2.  There was a recent discussion on the list about this (indeed reading about ZeroMQ led me to IPython) so hopefully this will happen before too long.
> 
> [3] I haven't tested this release with 0.13.2 which the distros provide.  Maybe it works anyway.


[-- Attachment #2: Type: text/html, Size: 3506 bytes --]