From d33090fa3861da948f241cb4656adadbf48e877a Mon Sep 17 00:00:00 2001 From: Jessica Scheick Date: Thu, 28 Mar 2024 16:01:33 -0400 Subject: [PATCH] updates to the sync-template action (#159) * fix errors * update .templatesyncignore * add note to readme about tokens * add force deletion true to catch deleted files --- .github/actions/README.md | 3 +++ .github/workflows/template-sync.yaml | 14 +++++++------- .templatesyncignore | 16 +++++++++------- team/README.md | 2 +- 4 files changed, 20 insertions(+), 15 deletions(-) diff --git a/.github/actions/README.md b/.github/actions/README.md index fc6d1fe..d8f4b09 100644 --- a/.github/actions/README.md +++ b/.github/actions/README.md @@ -43,6 +43,9 @@ Open a PR to update the templated repo to incorporate changes made to the [template repo](https://github.com/uwhackweek/jupyterbook-template). Template users should fill out the [.templatesyncignore](../../../.templatesyncignore) to specify which files they do not want updated from the template. +Note that if you want the GitHub action and workflow files to be updated, +you will need to [create a personal access token(PAT)](https://github.com/AndreasAugustin/actions-template-sync?tab=readme-ov-file#troubleshooting). +Alternatively, you must add ".github/**" to your `.templatesyncignore` file, and your actions will not be updated. ## Security diff --git a/.github/workflows/template-sync.yaml b/.github/workflows/template-sync.yaml index 6a6f9b9..96a424e 100644 --- a/.github/workflows/template-sync.yaml +++ b/.github/workflows/template-sync.yaml @@ -1,5 +1,4 @@ name: 'Sync to Template' -description: 'Get updates to the Jupyterbook from the template repo' on: # cronjob trigger (minute, hour, day, month, day-of-week; here 1st of month) @@ -20,14 +19,15 @@ jobs: # To use this repository's private action, you must check out the repository - name: Checkout uses: actions/checkout@v4 - # https://github.com/actions/checkout#usage - # uncomment if you use submodules within the source repository - # with: - # submodules: true + # comment token (and add .github path to .templatesyncignore) + # if you do not want actions and workflows updated + with: + token: ${{ secrets.GITHUB_TOKEN }} - name: actions-template-sync - uses: AndreasAugustin/actions-template-sync@v1 + uses: AndreasAugustin/actions-template-sync@v2 with: github_token: ${{ secrets.GITHUB_TOKEN }} source_repo_path: uwhackweek/jupyterbook-template - upstream_branch: main # defaults to main \ No newline at end of file + upstream_branch: main # defaults to main + is_force_deletion: True \ No newline at end of file diff --git a/.templatesyncignore b/.templatesyncignore index b34136d..ddb9ac7 100644 --- a/.templatesyncignore +++ b/.templatesyncignore @@ -1,15 +1,17 @@ # THIS FILE CANNOT BE SYNCED # use glob patterns as in .gitignore # recommend listing non-basics tutorial directories here - +### # configuration files cookiecutter.yaml - +### # environment lock files -./conda/*lock.yml - +conda/*lock.yml +### +# team member files +team/*-* +### # book files (configuration, usage-specific) -./book/_config.yml -./book/team.yaml - +book/_config.yml +### # event-specific tutorials diff --git a/team/README.md b/team/README.md index 4a42168..39cb9db 100644 --- a/team/README.md +++ b/team/README.md @@ -8,7 +8,7 @@ Follow these steps to add yourself: * Use the provided 'template.yaml' file and copy the file. * Create a copy of the 'template.yaml' file and rename the file to your name ``` - cp template.yaml FirstName_LastName.yaml + cp template.yaml FirstName-LastName.yaml ``` * Open the new file you just created in your favorite editor and fill out the details, replacing the placeholder text.