EasyBuild.Tools 3.0.0

EasyBuild.Tools

Tool for generating changelog based on Git history based on Conventional Commits. It is using EasyBuild.CommitParser to parse commit messages check their documentation for more information about configuration.

Installation

dotnet add package EasyBuild.Tools

APIs

Git

<details> <summary> <code>Git.addAll</code>

• add all files to staging area </summary>

Parameters

None

Returns

unit

Example

open EasyBuild.Tools.Git

Git.addAll()

</details>

<details> <summary> <code>Git.commitRelease</code>

• commit staged files with release message using conventional commit </summary>

Parameters

Returns

unit

Example

open EasyBuild.Tools.Git

// Create a commit with message "chore: release 1.0.0"
Git.commitRelease "1.0.0"

</details>

<details> <summary> <code>Git.push</code>

• push changes to remote repository </summary>

Parameters

Returns

unit

Example

open EasyBuild.Tools.Git

Git.push()

</details>

DotNet

<details> <summary> <code>DotNet.changelogGen</code>

• generate changelog using <a href="https://github.com/easybuild-org/EasyBuild.ChangelogGen">EasyBuild.ChangelogGen</a> </code> </summary>

Parameters

Returns

string - new version generated based on the commits history

Example

open EasyBuild.Tools.DotNet

let newVersion = DotNet.changelogGen "CHANGELOG.md"

</details>

<details> <summary> <code>DotNet.pack</code>

• commit staged files with release message of format <code>chore: release {version}</code> </summary>

Parameters

Returns

FileInfo - file descriptor to the generated .nupkg file

Example

open EasyBuild.Tools.DotNet

let nupkgFile = DotNet.pack()

</details>

<details> <summary> <code>DotNet.nugetPush</code>

• commit staged files with release message using conventional commit </summary>

Parameters

<table> <thead> <tr> <th>name</th> <th>type</th> <th align="center">required</th> <th>default</th> <th>description</th> </tr> </thead> <tbody> <tr> <td><code>nupkgPath</code></td> <td><code>string</code></td> <td align="center">✅</td> <td></td> <td>Working directory path</td> </tr> <tr> <td><code>forceEnglishOutput</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>Forces the application to run using an invariant, English-based culture</td> </tr> <tr> <td><code>source</code></td> <td><code>string</code></td> <td align="center">❌</td> <td><code>https://api.nuget.org/v3/index.json</code></td> <td>Package source (URL, UNC/folder path or package source name) to use.</td> </tr> <tr> <td><code>symbolSource</code></td> <td><code>string</code></td> <td align="center">❌</td> <td></td> <td>Symbol server URL to use</td> </tr> <tr> <td><code>timeout</code></td> <td><code>int</code></td> <td align="center">❌</td> <td><code>300</code> (5 minutes)</td> <td>Timeout for pushing to a server in seconds</td> </tr> <tr> <td><code>apiKey</code></td> <td><code>string</code></td> <td align="center">❌</td> <td><code>NUGET_KEY</code> env variable</td> <td>The API key for the server</td> </tr> <tr> <td><code>symbolApiKey</code></td> <td><code>string</code></td> <td align="center">❌</td> <td><code>NUGET_SYMBOL_KEY</code> env variable if presents otherwise we don't provide the argument</td> <td>The API key for the symbol server</td> </tr> <tr> <td><code>disableBuffering</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>Disable buffering when pushing to an HTTP(S) server to decrease memory usage</td> </tr> <tr> <td><code>noSymbols</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>If a symbols package exists, it will not be pushed to a symbols server</td> </tr> <tr> <td><code>interactive</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>Allow the command to block and require manual action for operations like authentication</td> </tr> <tr> <td><code>skipDuplicate</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>If a package and version already exists, skip it and continue with the next package in the push, if any</td> </tr> <tr> <td><code>forceEcho</code></td> <td><code>bool</code></td> <td align="center">❌</td> <td><code>false</code></td> <td>Echo the command and command output</td> </tr> </tbody> </table>

Returns

unit

Example

open EasyBuild.Tools.DotNet

// In general, you will get the nupkg file from DotNet.pack
let nupkgFile = DotNet.pack()

DotNet.nugetPush nupkgFile

// Or you can customize it
let nugetKey = Environment.GetEnvironmentVariable "NUGET_KEY_CUSTOM"
DotNet.nugetPush (nupkgFile, nugetKey = nugetKey)

</details>

PackageJson

<details> <summary> <code>PackageJson.replaceVersion</code>

• replace version in NPM <code>package.json</code> file </code> </summary>

Parameters

Returns

unit

Example

open EasyBuild.Tools.PackageJson

let packageJsonFile = FileInfo "package.json"
PackageJson.replaceVersion packageJsonFile "1.0.0"

</details>

Changelog

<details> <summary> <code>PackageJson.tryFindLastVersion</code>

• try to find the last version in a CHANGELOG file </code> </summary>

Parameters

Returns

string option - Some with the last version or None if not found

Example

open EasyBuild.Tools.Changelog

let lastVersion =
    "CHANGELOG.md"
    |> FileInfo
    |> Changelog.tryFindLastVersion

</details>

<details> <summary> <code>PackageJson.findLastVersion</code>

• find the last version in a CHANGELOG file or throw an exception </code> </summary>

Parameters

Returns

string - the last version

If the version is not found, it will throw an exception of type NoVersionFound.

Example

open EasyBuild.Tools.Changelog

let lastVersion =
    "CHANGELOG.md"
    |> FileInfo
    |> Changelog.findLastVersion

</details>