Refactor project files to replace Paket with NuGet for package management and update documentation accordingly

TheAngryByrd · TheAngryByrd · commit 8fac2a5772a3 · 2025-09-02T08:45:36.000-04:00
diff --git a/Content/Console/Directory.Build.targets b/Content/Console/Directory.Build.targets
@@ -1,26 +1,35 @@
 <!--
 This file allows overriding of properties for all projects in the directory.
-See https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
+See
+https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
 -->
 <Project>
 
   <PropertyGroup>
     <_BuildProjBaseIntermediateOutputPath>$(MSBuildThisFileDirectory)build/obj/</_BuildProjBaseIntermediateOutputPath>
     <_DotnetToolManifestFile>$(MSBuildThisFileDirectory).config/dotnet-tools.json</_DotnetToolManifestFile>
-    <_DotnetToolRestoreOutputFile>$(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
-    <_DotnetFantomasOutputFile>$(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
+    <_DotnetToolRestoreOutputFile>
+      $(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
+    <_DotnetFantomasOutputFile>
+      $(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
   </PropertyGroup>
 
-  <!-- Make sure that dotnet tools (including paket) are restored before restoring any project -->
-  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences;PaketRestore" Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
-    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" />
-    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)"/>
+  <!-- Make sure that dotnet tools are restored before restoring any project -->
+  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences"
+    Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
+    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      StandardOutputImportance="High" StandardErrorImportance="High" />
+    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)" />
     <Touch Files="$(_DotnetToolRestoreOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
   <!-- Make sure that files are formatted before building -->
-  <Target Name="Format" Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' " BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)" >
-    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)" ContinueOnError="WarnAndContinue" />
+  <Target Name="Format"
+    Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' "
+    BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)">
+    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High"
+      StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      ContinueOnError="WarnAndContinue" />
     <Touch Files="$(_DotnetFantomasOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
diff --git a/Content/Library/Directory.Build.targets b/Content/Library/Directory.Build.targets
@@ -1,26 +1,35 @@
 <!--
 This file allows overriding of properties for all projects in the directory.
-See https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
+See
+https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
 -->
 <Project>
 
   <PropertyGroup>
     <_BuildProjBaseIntermediateOutputPath>$(MSBuildThisFileDirectory)build/obj/</_BuildProjBaseIntermediateOutputPath>
     <_DotnetToolManifestFile>$(MSBuildThisFileDirectory).config/dotnet-tools.json</_DotnetToolManifestFile>
-    <_DotnetToolRestoreOutputFile>$(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
-    <_DotnetFantomasOutputFile>$(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
+    <_DotnetToolRestoreOutputFile>
+      $(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
+    <_DotnetFantomasOutputFile>
+      $(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
   </PropertyGroup>
 
-  <!-- Make sure that dotnet tools (including paket) are restored before restoring any project -->
-  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences;PaketRestore" Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
-    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" />
-    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)"/>
+  <!-- Make sure that dotnet tools are restored before restoring any project -->
+  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences"
+    Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
+    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      StandardOutputImportance="High" StandardErrorImportance="High" />
+    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)" />
     <Touch Files="$(_DotnetToolRestoreOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
   <!-- Make sure that files are formatted before building -->
-  <Target Name="Format" Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' " BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)" >
-    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)" ContinueOnError="WarnAndContinue" />
+  <Target Name="Format"
+    Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' "
+    BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)">
+    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High"
+      StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      ContinueOnError="WarnAndContinue" />
     <Touch Files="$(_DotnetFantomasOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
diff --git a/Content/Library/README.md b/Content/Library/README.md
@@ -79,7 +79,7 @@ src/MyLib.1/bin/
 - `GenerateAssemblyInfo` - Generates [AssemblyInfo](https://docs.microsoft.com/en-us/dotnet/api/microsoft.visualbasic.applicationservices.assemblyinfo?view=netframework-4.8) for libraries.
 - `DotnetPack` - Runs [dotnet pack](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-pack). This includes running [Source Link](https://github.com/dotnet/sourcelink).
 - `SourceLinkTest` - Runs a Source Link test tool to verify Source Links were properly generated.
-- `PublishToNuGet` - Publishes the NuGet packages generated in `DotnetPack` to NuGet via [paket push](https://fsprojects.github.io/Paket/paket-push.html). Runs only from `Github Actions`.
+- `PublishToNuGet` - Publishes the NuGet packages generated in `DotnetPack` to NuGet via [nuget push](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-nuget-push). Runs only from `Github Actions`.
 - `GitRelease` - Creates a commit message with the [Release Notes](https://fake.build/apidocs/v5/fake-core-releasenotes.html) and a git tag via the version in the `Release Notes`.
 - `GitHubRelease` - Publishes a [GitHub Release](https://help.github.com/en/articles/creating-releases) with the Release Notes and any NuGet packages. Runs only from `Github Actions`.
 - `FormatCode` - Runs [Fantomas](https://github.com/fsprojects/fantomas) on the solution file.
diff --git a/Directory.Build.targets b/Directory.Build.targets
@@ -1,26 +1,35 @@
 <!--
 This file allows overriding of properties for all projects in the directory.
-See https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
+See
+https://learn.microsoft.com/en-us/visualstudio/msbuild/customize-by-directory?view=vs-2022#directorybuildprops-and-directorybuildtargets
 -->
 <Project>
 
   <PropertyGroup>
     <_BuildProjBaseIntermediateOutputPath>$(MSBuildThisFileDirectory)build/obj/</_BuildProjBaseIntermediateOutputPath>
     <_DotnetToolManifestFile>$(MSBuildThisFileDirectory).config/dotnet-tools.json</_DotnetToolManifestFile>
-    <_DotnetToolRestoreOutputFile>$(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
-    <_DotnetFantomasOutputFile>$(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
+    <_DotnetToolRestoreOutputFile>
+      $(_BuildProjBaseIntermediateOutputPath)/dotnet-tool-restore-$(NETCoreSdkVersion)-$(OS)</_DotnetToolRestoreOutputFile>
+    <_DotnetFantomasOutputFile>
+      $(BaseIntermediateOutputPath)dotnet-fantomas-msbuild-$(NETCoreSdkVersion)-$(OS)</_DotnetFantomasOutputFile>
   </PropertyGroup>
 
-  <!-- Make sure that dotnet tools (including paket) are restored before restoring any project -->
-  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences;PaketRestore" Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
-    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" />
-    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)"/>
+  <!-- Make sure that dotnet tools are restored before restoring any project -->
+  <Target Name="ToolRestore" BeforeTargets="Restore;CollectPackageReferences"
+    Inputs="$(_DotnetToolManifestFile)" Outputs="$(_DotnetToolRestoreOutputFile)">
+    <Exec Command="dotnet tool restore" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      StandardOutputImportance="High" StandardErrorImportance="High" />
+    <MakeDir Directories="$(_BuildProjBaseIntermediateOutputPath)" />
     <Touch Files="$(_DotnetToolRestoreOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
   <!-- Make sure that files are formatted before building -->
-  <Target Name="Format" Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' " BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)" >
-    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High" StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)" ContinueOnError="WarnAndContinue" />
+  <Target Name="Format"
+    Condition=" '$(MSBuildProjectExtension)' == '.fsproj' AND '$(DesignTimeBuild)' != 'true' "
+    BeforeTargets="BeforeBuild" Inputs="@(Compile)" Outputs="$(_DotnetFantomasOutputFile)">
+    <Exec Command="dotnet fantomas $(MSBuildProjectDirectory)" StandardOutputImportance="High"
+      StandardErrorImportance="High" WorkingDirectory="$(MSBuildThisFileDirectory)"
+      ContinueOnError="WarnAndContinue" />
     <Touch Files="$(_DotnetFantomasOutputFile)" AlwaysCreate="True" ForceTouch="True" />
   </Target>
 
diff --git a/README.md b/README.md
@@ -28,7 +28,7 @@ This takes away the ambiguity that developers face when creating an OSS project.
 
 - [Standard project structure](https://docs.microsoft.com/en-us/dotnet/core/porting/project-structure) for your dotnet application
 - [Build Automation](https://en.wikipedia.org/wiki/Build_automation) tool via [FAKE](https://fake.build/)
-- [Package management](https://en.wikipedia.org/wiki/Package_manager) tool via [Paket](https://fsprojects.github.io/Paket/)
+- [Package management](https://en.wikipedia.org/wiki/Package_manager) tool via [Nuget](https://learn.microsoft.com/en-us/nuget/)
 - [Unit Testing](https://en.wikipedia.org/wiki/Unit_testing) via [Expecto](https://github.com/haf/expecto)
 - [Code Coverage](https://en.wikipedia.org/wiki/Code_coverage) via [Altcover](https://github.com/SteveGilham/altcover)
     - Also builds an html report with [ReportGenerator](https://github.com/danielpalme/ReportGenerator)
@@ -148,7 +148,7 @@ Appveyor's conventions around generating URLs based on the project name has some
 
 #### This project uses the following projects:
 * Heavily inspired by [Project Scaffold](https://github.com/fsprojects/ProjectScaffold)
-* [Paket](https://fsprojects.github.io/Paket/)
+* [Nuget](https://learn.microsoft.com/en-us/nuget/)
 * [FAKE](https://fsharp.github.io/FAKE/)
 * [Expecto](https://github.com/haf/expecto)
 * [Buildstats.info](https://github.com/dustinmoris/CI-BuildStats)
diff --git a/docsSrc/Reference/Library_Output.md b/docsSrc/Reference/Library_Output.md
@@ -12,7 +12,6 @@ When you do an initial scaffold, your folder will be filled with this set of fil
     ├── build
     │   ├── build.fs
     │   ├── build.fsproj
-    │   └── paket.references
     ├── build.cmd
     ├── build.sh
     ├── docsSrc
@@ -42,7 +41,6 @@ When you do an initial scaffold, your folder will be filled with this set of fil
     │   ├── README.md
     │   ├── WebServer.fs
     │   ├── docsTool.fsproj
-    │   ├── paket.references
     │   └── templates
     │       ├── helpers.fs
     │       ├── master.fs
@@ -53,23 +51,19 @@ When you do an initial scaffold, your folder will be filled with this set of fil
     │       ├── partNested.fs
     │       └── types.fs
     ├── global.json
-    ├── paket.dependencies
-    ├── paket.lock
     ├── src
     │   ├── Directory.Build.props
     │   └── MyLib.1
     │       ├── AssemblyInfo.fs
     │       ├── Library.fs
     │       ├── MyLib.1.fsproj
-    │       └── paket.references
     └── tests
         ├── Directory.Build.props
         └── MyLib.1.Tests
             ├── AssemblyInfo.fs
             ├── Main.fs
             ├── MyLib.1.Tests.fsproj
             ├── Tests.fs
-            └── paket.references
 
 - `.config\dotnet-tools.json` - Holds [dotnet tools](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-tool-install) manifest.
 - `.devcontainer\` - Holds all files necessary for [VSCode Dev Container](https://code.visualstudio.com/docs/remote/containers) feature.
@@ -88,7 +82,5 @@ When you do an initial scaffold, your folder will be filled with this set of fil
 - `build\` - Build script for building the repository. See [FAKE Docs](https://fake.build/) for more info.
 - `docsSrc\` - Contains the source files for your [GitHub documentation](https://help.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site).
 - `docsTool\` - Contains the tool for generating your [GitHub documentation](https://help.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site).
-- `paket.dependencies` - File containing your repositories dependencies.  See [Paket Docs](https://fsprojects.github.io/Paket/dependencies-file.html) for more info.
-- `paket.lock` - File containing the full dependency graph of your repository.  See [Paket Docs](https://fsprojects.github.io/Paket/lock-file.html) for more info.
 - `src\` - Folder containing your repository's [project files](https://docs.microsoft.com/en-us/aspnet/web-forms/overview/deployment/web-deployment-in-the-enterprise/understanding-the-project-file) and code.
 - `tests\` - Folder containing tests running against your code in `src`.
diff --git a/docsSrc/Tutorials/Getting_Started_With_Libraries.md b/docsSrc/Tutorials/Getting_Started_With_Libraries.md
@@ -44,7 +44,6 @@ This will generate a structure similar to this
     │   ├── FsDocs.fs
     │   ├── build.fs
     │   ├── build.fsproj
-    │   └── paket.references
     ├── build.cmd
     ├── build.sh
     ├── docsSrc
@@ -68,22 +67,18 @@ This will generate a structure similar to this
     │   └── index.md
     ├── global.json
     ├── MyCoolNewLib.sln
-    ├── paket.dependencies
-    ├── paket.lock
     ├── src
     │   ├── Directory.Build.props
     │   └── MyCoolNewLib
     │       ├── AssemblyInfo.fs
     │       ├── Library.fs
     │       ├── MyCoolNewLib.fsproj
-    │       └── paket.references
     └── tests
         ├── Directory.Build.props
         └── MyCoolNewLib.Tests
             ├── Main.fs
             ├── Tests.fs
             ├── MyCoolNewLib.Tests.fsproj
-            └── paket.references
 
 This may look overwhelming, but we don't have to worry about all of these yet.  Let's just focus on the real important ones for this tutorial.
 
diff --git a/docsSrc/index.md b/docsSrc/index.md
@@ -32,7 +32,7 @@ This takes away the ambiguity that developers face when creating an OSS project.
 
 - [Standard project structure](https://docs.microsoft.com/en-us/dotnet/core/porting/project-structure) for your dotnet application
 - [Build Automation](https://en.wikipedia.org/wiki/Build_automation) tool via [FAKE](https://fake.build/)
-- [Package management](https://en.wikipedia.org/wiki/Package_manager) tool via [Paket](https://fsprojects.github.io/Paket/)
+- [Package management](https://en.wikipedia.org/wiki/Package_manager) tool via [Nuget](https://learn.microsoft.com/en-us/nuget/)
 - [Unit Testing](https://en.wikipedia.org/wiki/Unit_testing) via [Expecto](https://github.com/haf/expecto)
 - [Code Coverage](https://en.wikipedia.org/wiki/Code_coverage) via [Altcover](https://github.com/SteveGilham/altcover)
     - Also builds an html report with [ReportGenerator](https://github.com/danielpalme/ReportGenerator)
