One extremely useful tool to use with F# is Paket. Paket is a package manager that provides a super clean way to manage your dependencies. Paket can handle everything from Nuget dependencies to git or file dependencies. It really opens up your project capabilities to easily pull in and handle dependencies, whereever they are located.
I cloned the Paket Project first, since I would like to have the very latest and help out if anything came up. For more information on Paket check out the about page.
git clone email@example.com:fsprojects/Paket.git
I built that project with the respective ./build.sh script and all went well.
NOTE – Get That Command Line Action
One thing I didn’t notice immediately in the docs (I’m putting in a PR right after this blog entry) was anyway to actually get Paket setup for the command line. On bash, Windows, or whatever, it seemed a pretty fundamental missing piece so I’m going to doc that right here but also submit a PR based on the issue I added here). It could be I just missed it, but either way, here’s the next step that will get you setup the rest of the way.
Yeah, that’s all it was. Kind of silly eh? Maybe that’s why it isn’t documented that I could see? After the installation script is run, just execute paket and you’ll get the list of the various commands, as shown below.
Paket version 18.104.22.168
add: Adds a new package to your paket.dependencies file.
config: Allows to store global configuration values like NuGet credentials.
convert-from-nuget: Converts from using NuGet to Paket.
find-refs: Finds all project files that have the given NuGet packages installed.
init: Creates an empty paket.dependencies file in the working directory.
auto-restore: Enables or disables automatic Package Restore in Visual Studio during the build process.
install: Download the dependencies specified by the paket.dependencies or paket.lock file into the `packages/` directory and update projects.
outdated: Lists all dependencies that have newer versions available.
remove: Removes a package from your paket.dependencies file and all paket.references files.
restore: Download the dependencies specified by the paket.lock file into the `packages/` directory.
simplify: Simplifies your paket.dependencies file by removing transitive dependencies.
update: Update one or all dependencies to their latest version and update projects.
find-packages: EXPERIMENTAL: Allows to search for packages.
find-package-versions: EXPERIMENTAL: Allows to search for package versions.
show-installed-packages: EXPERIMENTAL: Shows all installed top-level packages.
pack: Packs all paket.template files within this repository
push: Pushes all `.nupkg` files from the given directory.
–help [-h|/h|/help|/?]: display this list of options.
Paket Elsewhere && Atom
If you’re interested in Paket with Visual Studio I’ll let you dig into that on your own. Some resources are Paket Visual Studio on Github and Paket for Visual Studio. What I was curious though was Paket integration with either Atom or Visual Studio Code.
Krzysztof Cieślak (@k_cieslak) and Stephen Forkmann (@sforkmann) maintain the Paket.Atom Project and Krzysztof Cieślak also handles the atom-fsharp project for Atom. Watch this gif for some of the awesome goodies that Atom gets with the Paket.Atom Plugin.
Getting Started and Adding Dependencies
I’m hacking along and want to add some libraries, how do I do that with Paket? Let’s take a look. This is actually super easy, and doesn’t make the project dependentant on peripheral tooling like Visual Studio when using Paket.
The first thing to do, is inside the directory or project where I need the dependency I’ll intialize the it for paket.
[sourcecode language=”bash”]paket init[/sourcecode]
The next step is to add the dependency or dependencies that I’ll need. I’ll add a Nuget package that I’ll need shortly. The first package I want to grab for this project is FsUnit, a testing framework project managed and maintained by Dan Mohl @dmohl and Sergey Tihon @sergey_tihon.
[sourcecode language=”bash”]paket add nuget FsUnit[/sourcecode]
When executing this dependency addition the results displayed show what other dependencies were installed and which versions were pegged for this particular dependency.
15:33 $ paket add nuget FsUnit
Paket version 22.214.171.124
Adding FsUnit to /Users/halla/Codez/sharpPaketsExample/paket.dependencies
– FsUnit 1.3.1
– NUnit 2.6.4
Locked version resolution written to /Users/halla/Codez/sharpPaketsExample/paket.lock
Dependencies files saved to /Users/halla/Codez/sharpPaketsExample/paket.dependencies
Downloading FsUnit 1.3.1 to /Users/halla/.local/share/NuGet/Cache/FsUnit.1.3.1.nupkg
NUnit 2.6.4 unzipped to /Users/halla/Codez/sharpPaketsExample/packages/NUnit
FsUnit 1.3.1 unzipped to /Users/halla/Codez/sharpPaketsExample/packages/FsUnit
3 seconds – ready.
I took a look in the packet.dependencies and packet.lock file to see what were added for me with the paket add nuget command. The packet.dependencies file looked like this now.
[sourcecode language=”bash”]source https://nuget.org/api/v2
The packet.lock file looked like this.
There are a few more dependencies that I want, so I went to work adding those. First of this batch that I added was FAKE (more on this in a subsequent blog entry), which is a build tool based off of RAKE.
[sourcecode language=”bash”]paket add nuget FAKE[/sourcecode]
Next up was FsCheck.
[sourcecode language=”bash”]paket add nuget FsCheck[/sourcecode]
The paket.dependencies file now had the following content.
The paket.lock file had the following items added.
FSharp.Core (>= 126.96.36.199)
Well, that got me started. The code repository at this state is located on this branch here of the sharpSystemExamples repository. So on to some coding and the next topic. Keep reading, subsribe, or hit me up on twitter @adron.
- Paket Project on Github
- Paket for Visual Studio on Github and Plugin for Visual Studio
- Paket.Atom Project and atom-fsharp project for Atom