fslaborg / zzarchive-FsLab

A collection of packages for data science with F#
http://fslab.org
Other
158 stars 42 forks source link

FsLab

FsLab is a curated set of templates, libraries and scripts-as-journals support for doing data science with F#.

See https://fslab.org for getting started. One way is as follows:

dotnet new -i FsLab.Templates
dotnet new fslab-journal -lang F# -n Experiment1

then

cd Experiment1
build html
build show
build run  (watches for changes)
edit Experiment1.fsx or open Experiment1.fsproj

Developer notes

Project structure

The project produces three things:

  1. FsLab A NuGet package containing the FsLab.fsx load script for a consistent set of packages, plus some extra formatters
  2. FsLab.Templates Templates for 'dotnet new' and Visual Studio. Each template includes an FsLab build script and F5 launcher for processing the literate scripts into reports.
  3. fsx2html Used by FsLab build scripts to process F# literate scripts into HTML and LaTex

The source files in the repository are organized as follows:

Directory or file Comment
misc Icons and other non-source-code things
src/fsx2html Source for the DLL in the fsx2html NuGet package
src/Html HTML formatters for literate scripts not included in other packages
src/Text Text formatters for literate scripts not included in other packages
src/Shared Styling and server support for literate scripts not included in other packages
src/experiments Item templates
src/journal Journal project template
src/dotnet-templates Extra files for 'dotnet new' template support
src/vs-templates Extra files for Visual Studio template support
src/FsLab.fsx Script included in the FsLab NuGet package
src/*.nuspec NuGet files for building the packages
build.fsx FAKE script that does all the magic (below)

Building FsLab

If you want to be able to build FsLab Journal template, you'll need Visual Studio 2017 SDK. To update one or more dependencies, use the following steps:

Releasing

set APIKEY=...
.nuget\NuGet.exe push bin\*.nupkg  %APIKEY% -Source https://www.nuget.org