Skip to content
A collection of packages for data science with F#
Branch: master
Clone or download
dsyme Merge pull request #141 from dsyme/upd4
[WIP] Ensure consistency of nuget packages and add "dotnet new" templates
Latest commit a41d5e3 Aug 6, 2018

README.md

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:

  • Run git clean -xfd to make sure that there are only source files around
  • Run .paket/paket.exe update to update the dependencies
  • Run build to build and test everything
  • Add new line with version information to RELEASE_NOTES.md!
  • Run publish from command line to upload NuGet package (if you have the rights)

Releasing

set APIKEY=...
.nuget\NuGet.exe push bin\*.nupkg  %APIKEY% -Source https://www.nuget.org
You can’t perform that action at this time.