From 88962f4cf7feb7517183e03491e926d8f4723a46 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Thu, 21 May 2026 20:52:33 +0200 Subject: [PATCH 1/4] =?UTF-8?q?refactor:=20=F0=9F=9A=9A=20moved=20file=20e?= =?UTF-8?q?xplanation=20into=20CONTRIBUTING,=20not=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- template/CONTRIBUTING.md.jinja | 68 ++++++++++++++++++++++++-- template/README.qmd | 87 ++++++++++++---------------------- 2 files changed, 95 insertions(+), 60 deletions(-) diff --git a/template/CONTRIBUTING.md.jinja b/template/CONTRIBUTING.md.jinja index ae4a2bf..b9dbf72 100644 --- a/template/CONTRIBUTING.md.jinja +++ b/template/CONTRIBUTING.md.jinja @@ -19,7 +19,7 @@ so is at various states of completion. To contribute to `{{ github_repo }}`, you first need to install [uv](https://docs.astral.sh/uv/) and [justfile](https://just.systems/man/en/packages.html). We use uv and -justfile to manage our project, such as to run checks and test the +justfile to manage our package, such as to run checks and test the template. Both the uv and justfile websites have a more detailed guide on using uv, but below are some simple instructions to get you started. @@ -40,7 +40,7 @@ just ``` As you contribute, make sure your changes will pass our tests by opening -a terminal so that the working directory is the root of this project's +a terminal so that the working directory is the root of this package's repository and running: ``` bash @@ -53,7 +53,67 @@ as Git messages. Using this convention allows us to be able to automatically create a release based on the commit message by using [Commitizen](https://decisions.seedcase-project.org/why-semantic-release-with-commitizen/). If you don't use Conventional Commits when making a commit, we will -revise the pull request title to follow that format, as we use [squash -merges](https://git-scm.com/docs/git-merge) when merging pull requests, +revise the pull request title to follow that format, as we use squash +merges when merging pull requests, so all other commits in the pull request will be squashed into one commit. + +## :file_folder: Explanation of files and folders + +This list describes the default files that are included in the template +as well as explains a bit more about them and what they are used for. + +- `.github/`: Contains GitHub-specific files, such as issue and pull + request templates, workflows, + [dependabot](https://docs.github.com/en/code-security/tutorials/secure-your-dependencies/dependabot-quickstart-guide) + configuration, pull request templates, and a + [CODEOWNERS](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners) + file. +- `tools/vulture-allowlist.py`: List of variables that shouldn't be + flagged by [Vulture](https://github.com/jendrikseipp/vulture) as + unused. +- `tools/get-contributors.sh`: Script to get list of package + contributors. +- `tests/`: Test files for the package. +- `src/`: Source code for the package. +- `docs/`: Documentation about using and developing the Python package. +- `.config/`: Contains configuration files for various tools used in the package, + such as: + - `quartodoc.py`: Custom + [`quartodoc`](https://machow.github.io/quartodoc/) renderer. + - `mypy.ini`: [`mypy`](https://mypy.readthedocs.io/en/stable/) + configuration file for type checking Python code. + - `ruff.toml`: [Ruff](https://docs.astral.sh/ruff/) configuration file + for linting and formatting Python code. + - `rumdl.toml`: [rumdl](https://rumdl.dev/) configuration file for + formatting Markdown files so that they are standardized and consistent + {%- if for_seedcase %} + - `cog.toml`: [Cocogitto](https://docs.cocogitto.io) configuration file + for managing versions. + - `cliff.toml`: [git-cliff](https://git-cliff.org) configuration file for + creating the changelog. + {%- endif %} +- `.copier-answers.yml`: Contains the answers you gave when copying the + package from the template. + **You should not modify this file directly.** +- `.pre-commit-config.yaml`: [Pre-commit](https://pre-commit.com/) + configuration file for managing and running checks before each commit. +- `.typos.toml`: [typos](https://github.com/crate-ci/typos) spell + checker configuration file. +- `justfile`: [`just`](https://just.systems/man/en/) configuration file + for scripting package tasks. +- `.editorconfig`: Editor configuration file for + [EditorConfig](https://editorconfig.org/) to maintain consistent + coding styles across different editors and IDEs. +- `CHANGELOG.md`: Changelog file for tracking changes in the package. +- `CITATION.cff`: Structured citation metadata for your package. +- `CONTRIBUTING.md`: Guidelines for contributing to the package. +- `_metadata.yml`: Quarto metadata file for the website, including + information about the package, such as the titles and GitHub names. +- `_quarto.yml`: Quarto configuration file for the website, including + settings for the website, such as the theme, navigation, and other + options. +- `pyproject.toml`: Main Python package configuration file defining + metadata and dependencies. +- `uv.lock`: Lockfile used by [`uv`](https://docs.astral.sh/uv/) to + record exact versions of installed dependencies. diff --git a/template/README.qmd b/template/README.qmd index ee40fe8..c886666 100644 --- a/template/README.qmd +++ b/template/README.qmd @@ -1,74 +1,28 @@ --- format: gfm +execute: + echo: false metadata-files: - _metadata.yml --- -# {{< meta gh.repo >}}: TODO add more to title +# {{< meta tagline >}} {{< include /docs/includes/_badges.qmd >}} - + + +Check out our [website]({{< meta links.site >}}) for more information, +such as the features it provides and a +[guide]({{< meta links.site >}}/docs/guide) to using the package. For a +list of changes, see our [changelog](CHANGELOG.md) page. ::: callout-tip This Python package was generated from the -[`template-python-package`](https://github.com/seedcase-project/template-python-package) +[Template Python Package](https://github.com/seedcase-project/template-python-package) Seedcase template :tada: ::: -## Project files and folders - -- `.github/`: Contains GitHub-specific files, such as issue and pull - request templates, workflows, - [dependabot](https://docs.github.com/en/code-security/tutorials/secure-your-dependencies/dependabot-quickstart-guide) - configuration, pull request templates, and a - [CODEOWNERS](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners) - file. -- `tools/vulture-allowlist.py`: List of variables that shouldn't be - flagged by [Vulture](https://github.com/jendrikseipp/vulture) as - unused. -- `tools/get-contributors.sh`: Script to get list of project - contributors. -- `tests/`: Test files for the package. -- `src/`: Source code for the package. -- `docs/`: Documentation about using and developing the Python package. -- `_renderer.py`: Custom - [`quartodoc`](https://machow.github.io/quartodoc/) renderer. -- `pytest.ini`: Pytest configuration file. -- `mypy.ini`: [`mypy`](https://mypy.readthedocs.io/en/stable/) - configuration file for type checking Python code. -- `.copier-answers.yml`: Contains the answers you gave when copying the - project from the template. - **You should not modify this file directly.** -- `.cz.toml`: - [Commitizen](https://commitizen-tools.github.io/commitizen/) - configuration file for managing versions and changelogs. -- `.pre-commit-config.yaml`: [Pre-commit](https://pre-commit.com/) - configuration file for managing and running checks before each commit. -- `.typos.toml`: [typos](https://github.com/crate-ci/typos) spell - checker configuration file. -- `justfile`: [`just`](https://just.systems/man/en/) configuration file - for scripting project tasks. -- `.editorconfig`: Editor configuration file for - [EditorConfig](https://editorconfig.org/) to maintain consistent - coding styles across different editors and IDEs. -- `CHANGELOG.md`: Changelog file for tracking changes in the project. -- `CITATION.cff`: Structured citation metadata for your project. -- `CONTRIBUTING.md`: Guidelines for contributing to the project. -- `_metadata.yml`: Quarto metadata file for the website, including - information about the project, such as the titles and GitHub names. -- `pyproject.toml`: Main Python project configuration file defining - metadata and dependencies. -- `_quarto.yml`: Quarto configuration file for the website, including - settings for the website, such as the theme, navigation, and other - options. -- `ruff.toml`: [Ruff](https://docs.astral.sh/ruff/) configuration file - for linting and formatting Python code. -- `uv.lock`: Lockfile used by [`uv`](https://docs.astral.sh/uv/) to - record exact versions of installed dependencies. -- `.rumdl.toml`: [rumdl](https://rumdl.dev/) configuration file for - formatting Markdown files so that they are standardized and consistent - ## Contributing Check out our [contributing document](CONTRIBUTING.md) for information @@ -79,6 +33,12 @@ Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms. +::: content-hidden +### Contributors + +{{< include /docs/includes/_contributors.qmd >}} +::: + ## Licensing This project is licensed under the [MIT License](LICENSE.md). @@ -86,3 +46,18 @@ This project is licensed under the [MIT License](LICENSE.md). ## Changelog For a list of changes, see our [changelog](CHANGELOG.md) page. + +## Citing + +If you use this package in your work, please cite it as follows: + +```{python} +#| output: asis +!uvx --quiet cffconvert --format apalike +``` + +Or as a BibTeX entry: + +```{python} +!uvx --quiet cffconvert --format bibtex +``` From a906bd531d55c96b2c5120a06238486abf8f36f5 Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 22 May 2026 12:32:02 +0200 Subject: [PATCH 2/4] refactor: :pencil2: edits from review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Signe Kirk Brødbæk <40836345+signekb@users.noreply.github.com> --- template/CONTRIBUTING.md.jinja | 2 -- template/README.qmd | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/template/CONTRIBUTING.md.jinja b/template/CONTRIBUTING.md.jinja index b9dbf72..be13f3a 100644 --- a/template/CONTRIBUTING.md.jinja +++ b/template/CONTRIBUTING.md.jinja @@ -60,8 +60,6 @@ commit. ## :file_folder: Explanation of files and folders -This list describes the default files that are included in the template -as well as explains a bit more about them and what they are used for. - `.github/`: Contains GitHub-specific files, such as issue and pull request templates, workflows, diff --git a/template/README.qmd b/template/README.qmd index c886666..9e33e76 100644 --- a/template/README.qmd +++ b/template/README.qmd @@ -15,7 +15,7 @@ metadata-files: Check out our [website]({{< meta links.site >}}) for more information, such as the features it provides and a [guide]({{< meta links.site >}}/docs/guide) to using the package. For a -list of changes, see our [changelog](CHANGELOG.md) page. +list of changes, see our [changelog](CHANGELOG.md). ::: callout-tip This Python package was generated from the From 5227e6fca9c942661f69d1051d0ccdb34c53f551 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 10:32:10 +0000 Subject: [PATCH 3/4] =?UTF-8?q?chore:=20=E2=9C=8F=EF=B8=8F=20automatic=20p?= =?UTF-8?q?re-commit=20hook=20fixes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- template/README.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/template/README.qmd b/template/README.qmd index 9e33e76..44d9ea4 100644 --- a/template/README.qmd +++ b/template/README.qmd @@ -15,7 +15,7 @@ metadata-files: Check out our [website]({{< meta links.site >}}) for more information, such as the features it provides and a [guide]({{< meta links.site >}}/docs/guide) to using the package. For a -list of changes, see our [changelog](CHANGELOG.md). +list of changes, see our [changelog](CHANGELOG.md). ::: callout-tip This Python package was generated from the From aeb8cd4d4497a28aa5cd4b20e57d364c1bbd06ef Mon Sep 17 00:00:00 2001 From: "Luke W. Johnston" Date: Fri, 22 May 2026 12:32:19 +0200 Subject: [PATCH 4/4] refactor: :pencil2: small edit to clarify sentence --- template/README.qmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/template/README.qmd b/template/README.qmd index 44d9ea4..35ff771 100644 --- a/template/README.qmd +++ b/template/README.qmd @@ -6,7 +6,7 @@ metadata-files: - _metadata.yml --- -# {{< meta tagline >}} +# {{< meta gh.repo >}}: {{< meta tagline >}} {{< include /docs/includes/_badges.qmd >}}