NLeSC · fdiblen · Aug 21, 2024 · Aug 20, 2024 · Aug 20, 2024 · Aug 20, 2024
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,7 @@
 
 ### Added
 
+* Make citation optional [#471](/~https://github.com/NLeSC/python-template/pull/471)
 * Make online documentation optional [#476](/~https://github.com/NLeSC/python-template/pull/476)
 * Added Python 3.12 support [#356](/~https://github.com/NLeSC/python-template/issues/356)
 * Template unit tests for documentation generation, linting and version bumping

diff --git a/copier.yml b/copier.yml
@@ -83,6 +83,12 @@ AddGitHubActions:
   default: "{{ template_profile != 'minimum' }}"
   help: GitHub actions to test the package and the documentation
 
+AddCitation:
+  when: "{{ template_profile == 'ask' }}"
+  type: bool
+  default: "{{ template_profile != 'minimum' }}"
+  help: Citation file and cffconvert workflow which validates the citation file
+
 AddOnlineDocumentation:
   when: "{{ template_profile == 'ask' }}"
   type: bool

diff --git a/profiles.md b/profiles.md
@@ -14,9 +14,9 @@
 
 ## Questions
 - licence (exist)
-- github action (exist) #451
+- github action (added by #451)
 - Pre-commit
-- cffconvert workflow and citation file
+- cffconvert workflow and citation file (added by #458)
 - markdown link checker workflow
 - static analysis
 - next steps workflow

diff --git a/...e/.github/next_steps/02_citation.md.jinja → ...itation %}02_citation.md{% endif %}.jinja b/...e/.github/next_steps/02_citation.md.jinja → ...itation %}02_citation.md{% endif %}.jinja
diff --git a/template/.github/workflows/next_steps.yml b/template/.github/workflows/next_steps.yml
@@ -11,39 +11,30 @@ jobs:
       - name: Create Sonarcloud integration issue
         uses: JasonEtco/create-an-issue@v2
         env:
-          GITHUB_TOKEN: ${{ '{{ ' -}} secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           filename: .github/next_steps/01_sonarcloud_integration.md
         id: sonarcloud
-
-      - name: Create citation data issue
-        uses: JasonEtco/create-an-issue@v2
-        env:
-          GITHUB_TOKEN: ${{ '{{ ' -}} secrets.GITHUB_TOKEN }}
-        with:
-          filename: .github/next_steps/02_citation.md
-        id: citation
       - name: Create Zenodo integration issue
         uses: JasonEtco/create-an-issue@v2
         env:
-          GITHUB_TOKEN: ${{ '{{ ' -}} secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           filename: .github/next_steps/04_zenodo_integration.md
         id: zenodo
       - name: Create linting issue
         uses: JasonEtco/create-an-issue@v2
         env:
-          GITHUB_TOKEN: ${{ '{{ ' -}} secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           filename: .github/next_steps/05_linting.md
         id: linting
       - name: List created issues
         run: |
           echo 'Created issues that must be completed to have fully working Python package:
-          * Sonarcloud integration ${{ '{{ ' -}} steps.sonarcloud.outputs.url }}
-          * Zenodo integration ${{ '{{ ' -}} steps.zenodo.outputs.url }}
-          * Citation data ${{ '{{ ' -}} steps.citation.outputs.url }}
-          * Linting fixes ${{ '{{ ' -}} steps.linting.outputs.url }}'
+          * Sonarcloud integration ${{ steps.sonarcloud.outputs.url }}
+          * Zenodo integration ${{ steps.zenodo.outputs.url }}
+          * Linting fixes ${{ steps.linting.outputs.url }}'
       - name: Cleanup files needed to create next steps issues
         run: |
           git config --global user.name 'NLeSC Python template'

diff --git a/template/.github/workflows/cffconvert.yml → ...f AddCitation %}cffconvert.yml{% endif %} b/template/.github/workflows/cffconvert.yml → ...f AddCitation %}cffconvert.yml{% endif %}
diff --git a/template/.github/workflows/{% if AddCitation %}next_steps_citation.yml{% endif %} b/template/.github/workflows/{% if AddCitation %}next_steps_citation.yml{% endif %}
@@ -0,0 +1,29 @@
+on: [push]
+permissions:
+  contents: write
+  issues: write
+name: Create an issue for citation
+jobs:
+  next_steps:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Create citation data issue
+        uses: JasonEtco/create-an-issue@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          filename: .github/next_steps/02_citation.md
+        id: citation
+      - name: List created issues
+        run: |
+          echo 'Created issues that must be completed to have fully working Python package:
+          * Citation data ${{ steps.citation.outputs.url }}'
+      - name: Cleanup files needed to create next steps issues
+        run: |
+          git config --global user.name 'NLeSC Python template'
+          git config --global user.email 'nlesc-python-template@users.noreply.github.com'
+          git rm .github/workflows/next_steps_citation.yml
+          git rm -r .github/next_steps
+          git commit -am "Cleanup automated next steps issue generator"
+          git push
diff --git a/template/CONTRIBUTING.md.jinja b/template/CONTRIBUTING.md.jinja
@@ -45,8 +45,8 @@ In case you feel like you've made a valuable contribution, but you don't know ho
 
 To create a release you need write permission on the repository.
 
-1. Check the author list in [`CITATION.cff`](CITATION.cff)
-1. Bump the version using `bump-my-version bump <major|minor|patch>`. For example, `bump-my-version bump major` will increase major version numbers everywhere it's needed (code, meta, etc.) in the repo. Alternatively the version can be manually changed in {{ package_name }}/__init__.py, pyproject.toml, CITATION.cff and docs/conf.py (and other places it was possibly added).
+{% if AddCitation -%}1. Check the author list in [`CITATION.cff`](CITATION.cff){%- endif %}
+1. Bump the version using `bump-my-version bump <major|minor|patch>`. For example, `bump-my-version bump major` will increase major version numbers everywhere it's needed (code, meta, etc.) in the repo. Alternatively the version can be manually changed in {{ package_name }}/__init__.py, pyproject.toml, {% if AddCitation %}CITATION.cff{%- endif -%} and docs/conf.py (and other places it was possibly added).
 1. Update the `CHANGELOG.md` to include changes made
 1. Go to the [GitHub release page]({{ repository_url }}/releases)
 1. Press draft a new release button

diff --git a/template/MANIFEST.in b/template/MANIFEST.in
diff --git a/template/MANIFEST.in.jinja b/template/MANIFEST.in.jinja
@@ -0,0 +1,4 @@
+{% if AddCitation -%}include CITATION.cff{%- endif %}
+include LICENSE
+include NOTICE
+include README.md
diff --git a/template/README.dev.md.jinja b/template/README.dev.md.jinja
@@ -134,9 +134,9 @@ This section describes how to make a release in 3 parts:
 ### (1/3) Preparation
 
 1. Update the <CHANGELOG.md> (don't forget to update links at bottom of page)
-2. Verify that the information in [`CITATION.cff`](CITATION.cff) is correct.
-3. Make sure the [version has been updated](#versioning).
-4. Run the unit tests with `pytest -v`
+{% if AddCitation -%}1. Verify that the information in [`CITATION.cff`](CITATION.cff) is correct.{%- endif %}
+1. Make sure the [version has been updated](#versioning).
+1. Run the unit tests with `pytest -v`
 
 ### (2/3) PyPI
 

diff --git a/template/README.md.jinja b/template/README.md.jinja
@@ -18,7 +18,9 @@
 {%- endif -%}
 | **GitHub Actions**                 | &nbsp; |
 | Build                              | [![build]({{repository_url}}/actions/workflows/build.yml/badge.svg)]({{repository_url}}/actions/workflows/build.yml) |
+{% if AddCitation -%}
 | Citation data consistency          | [![cffconvert]({{repository_url}}/actions/workflows/cffconvert.yml/badge.svg)]({{repository_url}}/actions/workflows/cffconvert.yml) |
+{%- endif -%}
 | SonarCloud                         | [![sonarcloud]({{repository_url}}/actions/workflows/sonarcloud.yml/badge.svg)]({{repository_url}}/actions/workflows/sonarcloud.yml) |
 | MarkDown link checker              | [![markdown-link-check]({{repository_url}}/actions/workflows/markdown-link-check.yml/badge.svg)]({{repository_url}}/actions/workflows/markdown-link-check.yml) |
 

diff --git a/template/project_setup.md.jinja b/template/project_setup.md.jinja
@@ -90,11 +90,13 @@ help you decide which tool to use for packaging.
 - Document changes to your software package
 - [Relevant section in the guide](https://guide.esciencecenter.nl/#/best_practices/releases?id=changelogmd)
 
+{% if AddCitation -%}
 ## CITATION.cff
 
 - To allow others to cite your software, add a `CITATION.cff` file
 - It only makes sense to do this once there is something to cite (e.g., a software release with a DOI).
 - Follow the [making software citable](https://guide.esciencecenter.nl/#/citable_software/making_software_citable) section in the guide.
+{%- endif -%}
 
 ## CODE_OF_CONDUCT.md
 

diff --git a/template/pyproject.toml.jinja b/template/pyproject.toml.jinja
@@ -149,8 +149,10 @@ filename = "src/{{ package_name }}/__init__.py"
 [[tool.bumpversion.files]]
 filename = "pyproject.toml"
 
+{% if AddCitation -%}
 [[tool.bumpversion.files]]
 filename = "CITATION.cff"
+{%- endif %}
 
 [[tool.bumpversion.files]]
 filename = "docs/conf.py"
diff --git a/template/CITATION.cff.jinja → ...dCitation %}CITATION.cff{% endif %}.jinja b/template/CITATION.cff.jinja → ...dCitation %}CITATION.cff{% endif %}.jinja