Configuration Extension

As for all nmk projects config items, nmk-github ones are all overridable by other plug-ins and project files. But the ones described on this page are specifically designed to be extended.

Actions

Plugins and/or project may want to configure the generated Github workflow file. The following items may be extended for this purpose:

  • ${githubPythonVersions}: List of python versions on which to parallelize Github action jobs. Example:

    githubPythonVersions:
        - 3.10
    
  • ${githubBuildSteps}: List of extra build steps to be performed on branch push, after standard nmk build. Example:

    githubBuildSteps:
        - name: Sample step
          run: echo hello world
    
  • ${githubPublishSteps}: List of extra build steps to be performed on tag push, after standard nmk build. Example:

    githubPublishSteps:
        - name: Sample step
          run: echo hello world
    

Badges

Badges generated by nmk-github plugin can be configured with the following items:

  • ${githubLicense}: License for current project Example:

    githubLicense: GPL
    
  • ${githubIssuesRepo}: Github repository (of the same Github user) holding the issues for the current project. This can be usefull when you want to centralize your Github issues in a single repository rather than letting each project holding them. Example:

    githubIssuesRepo: another-project
    
  • ${githubIssuesLabel}: Extra label for issues query badge Example:

    githubIssuesLabel: "component:${githubRepo}"