fsxc 0.5.9.10

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet tool install --global fsxc --version 0.5.9.10
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local fsxc --version 0.5.9.10
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=fsxc&version=0.5.9.10
nuke :add-package fsxc --version 0.5.9.10

FSX

PUBLIC SERVICE ANNOUNCEMENT

THIS REPO IS FACING A COMPLETE OVERHAUL/REVAMP/RENOVATION IN ORDER TO SUPPORT .NET6.

Unfinished tasks so far:

Motivation

FSX is the ideal tool for people that use F# for their scripting needs.

The best way to describe it is to start first with some questions:

  • Have you found yourself waiting many seconds until your big script is parsed by FSI and run? This is unacceptable when doing many small changes and expecting a quick feedback loop to test them.
  • Do you have long-running F# scripts that cause too much memory usage in your server?
  • Have you found that your scripts could bitrot over time (i.e. not compile anymore) especially when using helper functions in .fs files loaded by them?

These are the main annoyances when working with F# scripting. Granted, F#+FSI is already much better than the alternatives (as many more errors are thrown much earlier than at runtime, and as strongly-typed functional languages are generally faster). However, we can do better.

To the above three questions we could even follow-up with new ones:

  • Couldn't we make FSI only compile what's changed, and reuse binaries from a previous run, to speed this up?
  • Couldn't we run our script without FSI given that FSI eats a lot of memory (for REPL features, which scripts don't need)?
  • Couldn't we have a CI approach that takes care of our scripts in a similar way as we do with (msbuild-ed) C#/F# code?

FSX answers all of these latter questions with a categorical YES!

The creation of FSX was inspired by several facts:

  • FSI is slower than the F# compiler (obviously).
  • There should be an easy and programatic way to compile an F# script without trying to run it (see https://stackoverflow.com/questions/33468298/f-how-can-i-compile-and-then-release-a-file-fsx ).
  • FSI (or the components required to run it) suffers from bugs frequently. Examples:
  • FSI stands for F Sharp Interactive, which means that it's not really suited for scripting but more for debugging:
    • It doesn't treat warnings as errors by default (you would need to remember to use the flag --warnaserror when calling fsharpi, which is not handy).
    • Because of the previous point above about warnings, it can even cancel the advantage of the promise of "statically-compiled scripts" altogether, because what should be a compilation error could be translated to a runtime error when using currified arguments, due to FSI defaulting to "interactive" needs. (More info: https://stackoverflow.com/questions/38202685/fsx-script-ignoring-a-function-call-when-i-add-a-parameter-to-it )
    • AFAIK there's no way to use flags in a shebang (so can't use #!/usr/bin/env fsharpi --warnaserror as the flag gets ignored). Note that using fsx in shebang, however, will treat warnings as errors.
    • It can consume a lot of memory, just compare it this way:
echo $'#!/usr/bin/env fsharpi\nSystem.Threading.Thread.Sleep(999999999)'>testfsi.fsx
echo $'#!/usr/bin/env fsx\nSystem.Threading.Thread.Sleep(999999999)'>testfsx.fsx
chmod u+x test*.fsx
nohup ./testfsi.fsx >/dev/null 2>&1 &
nohup ./testfsx.fsx >/dev/null 2>&1 &
ps aux | grep testfs

In my machine, the above prints:

andres   23596 16.6  0.9 254504 148268 pts/24  Sl   03:38   0:01 cli /usr/lib/cli/fsharp/fsi.exe --exename:fsharpi ./testfsi.fsx
andres   23600  0.0  0.0 129332 15936 pts/24   Sl   03:38   0:00 mono bin/./testfsx.fsx.exe

Which is a huge difference in memory footprint.

How to install/use?

Installation

In Linux/macOS, the old-fashioned way by cloning and compiling it yourself:

./configure.sh --prefix=/usr/local
make
sudo make install

(If you're using Windows, just build with "make.bat" and install with "make install".)

Usage

Execution

After installing, you can already use the #!/usr/bin/env fsx shebang in your scripts.

If you want to use fsx without having to change the shebang of all your scripts, just run fsx yourscript.fsx every time.

Compilation

For your CI needs (to compile all scripts in your repo without executing them), you could call fsxc using find in your CI step.

An example of how to do this with GitHub Actions, is this YML fragment that you could add to your workflow existing in your .github/workflows/ folder:

    - name: compile F# scripts
      shell: bash
      run: |
        dotnet new tool-manifest
        dotnet tool install fsxc
        find . -type f -name "*.fsx" | xargs -t -I {} dotnet fsxc {}
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
0.6.0--date20240508-0331... 61 5/8/2024
0.6.0--date20240412-0839... 43 4/12/2024
0.6.0--date20240412-0731... 38 4/12/2024
0.6.0--date20240306-1035... 44 3/6/2024
0.6.0--date20240219-0203... 45 2/19/2024
0.6.0--date20240219-0120... 41 2/19/2024
0.6.0--date20231213-0703... 60 12/13/2023
0.6.0--date20231031-0834... 57 10/31/2023
0.6.0--date20230826-0914... 62 8/26/2023
0.6.0--date20230826-0557... 58 8/26/2023
0.6.0--date20230823-0555... 60 8/23/2023
0.6.0--date20230823-0541... 62 8/23/2023
0.6.0--date20230823-0528... 62 8/23/2023
0.6.0--date20230823-0404... 63 8/23/2023
0.6.0--date20230822-0935... 63 8/22/2023
0.6.0--date20230822-0807... 63 8/22/2023
0.6.0--date20230822-0700... 59 8/22/2023
0.6.0--date20230821-0702... 58 8/21/2023
0.6.0--date20230821-0554... 61 8/21/2023
0.6.0--date20230821-0454... 59 8/21/2023
0.6.0--date20230820-0145... 63 8/20/2023
0.6.0--date20230818-1152... 56 8/18/2023
0.6.0--date20230818-0746... 54 8/18/2023
0.6.0--date20230818-0454... 55 8/18/2023
0.6.0--date20230818-0412... 58 8/18/2023
0.6.0--date20230818-0132... 54 8/18/2023
0.6.0--date20230816-0545... 63 8/16/2023
0.6.0--date20230812-0646... 61 8/12/2023
0.6.0--date20230705-0933... 63 7/5/2023
0.6.0--date20230611-0542... 66 6/11/2023
0.6.0--date20230611-0251... 60 6/11/2023
0.6.0--date20230610-0604... 63 6/10/2023
0.6.0--date20230610-0601... 63 6/10/2023
0.6.0--date20230610-0526... 57 6/10/2023
0.6.0--date20230605-0900... 65 6/5/2023
0.6.0--date20230605-0423... 59 6/5/2023
0.6.0--date20230604-0409... 69 6/4/2023
0.6.0--date20230602-0434... 75 6/2/2023
0.6.0--date20230530-1155... 60 5/30/2023
0.6.0--date20230530-0939... 58 5/30/2023
0.6.0--date20230530-0914... 59 5/30/2023
0.6.0--date20230502-0946... 62 5/2/2023
0.6.0--date20230502-0348... 75 5/2/2023
0.6.0--date20230326-0544... 89 3/26/2023
0.6.0--date20230319-0624... 95 3/19/2023
0.6.0--date20230318-0921... 97 3/18/2023
0.6.0--date20230318-0620... 92 3/18/2023
0.6.0--date20230318-0342... 93 3/18/2023
0.6.0--date20230318-0146... 92 3/18/2023
0.6.0--date20230316-0344... 97 3/16/2023
0.6.0--date20230316-0338... 93 3/16/2023
0.6.0--date20230316-0327... 94 3/16/2023
0.6.0--date20230307-0314... 95 3/7/2023
0.6.0--date20230306-0835... 88 3/6/2023
0.6.0--date20230214-0422... 90 2/14/2023
0.6.0--date20230214-0358... 85 2/14/2023
0.6.0--date20230128-0944... 111 1/28/2023
0.6.0--date20230126-1011... 114 1/26/2023
0.6.0--date20230126-0934... 124 1/26/2023
0.6.0--date20230126-0611... 115 1/26/2023
0.6.0--date20230121-0757... 115 1/21/2023
0.6.0--date20230119-0904... 122 1/19/2023
0.6.0--date20230118-0634... 121 1/18/2023
0.6.0--date20230117-0524... 119 1/17/2023
0.6.0--date20230116-0113... 113 1/16/2023
0.6.0--date20230115-0201... 118 1/15/2023
0.6.0--date20230107-0635... 116 1/7/2023
0.6.0--date20230104-0738... 123 1/4/2023
0.6.0--date20230104-0650... 129 1/4/2023
0.6.0--date20230104-0521... 130 1/4/2023
0.6.0--date20230104-0455... 127 1/4/2023
0.6.0--date20230103-0439... 126 1/3/2023
0.6.0--date20230103-0438... 128 1/3/2023
0.6.0--date20230101-0431... 117 1/1/2023
0.6.0--date20230101-0119... 120 1/1/2023
0.6.0--date20221230-0239... 111 12/30/2022
0.5.9.10 217 3/26/2023
0.5.9.8 196 3/19/2023
0.5.9.7 216 3/18/2023
0.5.9.6 197 3/18/2023
0.5.9.5 202 3/18/2023
0.5.9.1 21,546 1/4/2023