✨ Publish NuGet

GitHub action to build, pack & publish nuget packages automatically when a project version is updated

Usage

Create new .github/workflows/publish.yml file:

name: publish to nuget
on:
  push:
    branches:
      - master # Default release branch
jobs:
  publish:
    name: build, pack & publish
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      # - name: Setup dotnet
      #   uses: actions/setup-dotnet@v1
      #   with:
      #     dotnet-version: 6.0.0

      # Publish
      - name: publish on version change
        id: publish_nuget
        uses: GerardSmit/[email protected]
        with:
          # Filepath of the project to be packaged, relative to root of repository
          PROJECT_FILE_PATH: |
            src/Project.Abstractions/Project.Abstractions.csproj
            src/Project/Project.csproj
          
          # Filepath with version info, relative to root of repository & defaults to PROJECT_FILE_PATH
          # VERSION_FILE_PATH: Directory.Build.props

          # Regex pattern to extract version info in a capturing group
          # VERSION_REGEX: ^\s*<Version>(.*)<\/Version>\s*$
          
          # Useful with external providers like Nerdbank.GitVersioning, ignores VERSION_FILE_PATH & VERSION_REGEX
          # VERSION_STATIC: 1.0.0

          # Flag to toggle git tagging, enabled by default
          # TAG_COMMIT: true

          # Format of the git tag, [*] gets replaced with actual version
          # TAG_FORMAT: v*

          # API key to authenticate with NuGet server
          # NUGET_KEY: ${{secrets.NUGET_API_KEY}}

          # NuGet server uri hosting the packages, defaults to https://api.nuget.org
          # NUGET_SOURCE: https://api.nuget.org

          # Flag to toggle pushing symbols along with nuget package to the server, disabled by default
          # INCLUDE_SYMBOLS: false

          # Flag to toggle not building the project and letting pack command handle restoring & building, disabled by default
          # NO_BUILD: false

• Project gets published only if there's a NUGET_KEY configured in the repository

Inputs

Input	Default Value	Description
PROJECT_FILE_PATH		Filepaths of the projects to be packaged, relative to root of repository. Must be seperated by newline
VERSION_FILE_PATH	[PROJECT_FILE_PATH]	Filepath with version info, relative to root of repository & defaults to PROJECT_FILE_PATH
VERSION_REGEX	^\s*<Version>(.*)<\/Version>\s*$	Regex pattern to extract version info in a capturing group
VERSION_STATIC		Useful with external providers like Nerdbank.GitVersioning, ignores VERSION_FILE_PATH & VERSION_REGEX
TAG_COMMIT	true	Flag to toggle git tagging, enabled by default
TAG_FORMAT	v*	Format of the git tag, [*] gets replaced with actual version
NUGET_KEY		API key to authenticate with NuGet server
NUGET_SOURCE	https://api.nuget.org	NuGet server uri hosting the packages, defaults to https://api.nuget.org
INCLUDE_SYMBOLS	false	Flag to toggle pushing symbols along with nuget package to the server, disabled by default
NO_BUILD	false	Flag to toggle not building the project and letting pack command handle restoring & building, disabled by default

Outputs

Output	Description
VERSION	Version of the associated git tag

FYI:

• Outputs may or may not be set depending on the action inputs or if the action failed
• NUGET_SOURCE must support /v3-flatcontainer/PACKAGE_NAME/index.json for version change detection to work

License

MIT