I've been orbiting around F# - but not really jumping in - for a while now. In fact, I looked at F# in 2008 almost 6 years ago and more recently talked to Richard Minerich and Phillip Trelford on Hanselminutes Podcast #311 "Why F#?"
Last week I looked at using ScriptCS, literally C# as a Scripting language, to drive browser automation. Today I'm exploring a make system called FAKE. It's F# Make, a build automation system similar to Make (which is 38 years old next month!) or Rake (which uses Ruby).
Fake is a Domain Specific Language that you can use without knowing F#, but if and when you outgrow it you can keep heading down the F# road. In all cases you've got all of .NET at your command.
Here's their Hello World example, a basic deploy script:
Note that Test depends on Deploy.
FAKE uses F# but you can use it go build whatever. These are some C# OSS projects that use FAKE to build themselves:
Octokit.NET by GitHub
Portable.Licensing
Machine.Fakes
NSubstitute (https://github.com/nsubstitute/NSubstitute/pull/138 WIP)
FAKE isn't new, it's actually been around for 4 years with 55 contributors so far! It works not only on .NET but also on Linux and Mac under Mono - it works everywhere. Because it's all .NET you can use it on your Continuous Integration Servers like TeamCity or Travis CI.
Getting Started with FAKE
Check out their Calculator sample, a .NET project you'll extend to build itself with FAKE. Just download the zip, unblock it, and unzip. Then run build.bat from a developer command prompt.
The build.net is a bootstrapper. It could be powershell or a shell script if you like, of course.
This batch file uses NuGet to get FAKE, just as npm install restores node_modules, or gem gets ruby libraries. Then it calls Fake on the build.fsx file. Follow their Getting Started instructions to slowly expand the responsibilities of the build.fsx file.
FAKE has a lot of Helpers in their API documentation. Hundreds, and there's a whole community making others that you can call upon. For example, the built in FileHelper has things like CleanDir to remove files and subdirs.
Here we Clean before we build by making Clean a dependency of Default. BuildDir here is a property that's shared.
Jumping to the end of the tutorial, the syntax gets a little more tricky, butu once you get the |> format, it makes sense.
Some cool things to note and file away as interesting at in the script below.
the use of !! to include files
the use of -- to exclude a file spec after a !! operator
Zip is built-in as a helper and zips up the results of the build.
the options passed into NUnit
The dependency chain
#r for referencing .NET DLLs
You can do virtually anything and there's a great community out there to help.
Here's a more complex dependency chain with an optional parameter:
There's a rich FAKE world out there with support for Octopus Deploy, all Unit Test systems, Xamarin's xpkg format and much more. Thanks to Steffan Forkmann for helping me explore this. ;)
Related Links
Integrate F# Make with TFS N Visual Studio
Migrating to FAKE - Why?
FAKE - F# Make - A DSL for build tasks
Sponsor: Big thanks to Red Gate for sponsoring the blog feed this week. Check out the Free Starter Edition of their release management tool! Deploy your SQL Server databases, .NET apps and services in a single, repeatable process with Red Gate’s Deployment Manager. Get started now with the free Starter Edition.
© 2014 Scott Hanselman. All rights reserved.