Skip to content

Add .readthedocs.yml to the template#37

Merged
ahms5 merged 3 commits intomainfrom
add-readthedocs-file
Feb 23, 2026
Merged

Add .readthedocs.yml to the template#37
ahms5 merged 3 commits intomainfrom
add-readthedocs-file

Conversation

@h-chmeruk
Copy link
Contributor

Which issue(s) are closed by this pull request?

Closes #36

Changes proposed in this pull request:

  • Added the .readthedocs.yml file according to the reference.
  • Added new parameter default_python_version to the copier.yml file. The parameter takes the last version from the python_versions parameter as its default value.
  • Added a new test function test_content_readthedocs(), extended test_generated_file_exists().

@h-chmeruk h-chmeruk added documentation Improvements or additions to documentation enhancement New feature or request labels Feb 9, 2026
@h-chmeruk h-chmeruk added this to the v0.1.0 milestone Feb 9, 2026

# Set the OS, Python version and other tools you might need
build:
os: ubuntu-24.04
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure which version we want to use as the default. The old cookiecutter template had ubuntu-22.04, but maybe it's time to update the version.

"license": "MIT",
"copyright_statement": "2025, The pyfar developers",
"project_short_description": "my_project_short_description",
"python_versions": "['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']",
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have also added this line to the standard test configuration, since we will be updating the python_versions parameter in the copier.yml in the future. So that the tests do not fail and we do not have to adjust them, I added a default value for the python_versions parameter.

{{ python_versions[min_index:] }}

default_python_version:
when: false
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently, because of the when: False attribute, this parameter is not included in the questionnaires and always takes the default value. Please let me know if you think this parameter should be displayed to the user when creating/updating a project.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe you can discuss this point in the weekly, both options would work for me.
advatange of always using the latest version is that we dont need to worry about it.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, thank you, I could bring it up in the meeting today :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have decided to leave the parameter unchanged so that the latest python version is always used as the parameter value

@h-chmeruk h-chmeruk requested a review from ahms5 February 9, 2026 10:08
Copy link
Member

@ahms5 ahms5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool thanks.

copier.yml Outdated
{% set min_index = python_versions.index(minimum_python_version) %}
{{ python_versions[min_index:] }}

default_python_version:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, I would vote for latest_python_version

copier.yml Outdated
default: "numpy,scipy"
spaces between them. These dependencies will be included in the pyproject.toml
and in the .readthedocs.yml files.
default: "numpy,scipy,libsndfile1"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new dependency is not a Python package, it is a systems package and is installed via apt get on eg Linux. We can remove it here and add an other dependency list, eg apt_packages, this will also be used in cicleci config.

@h-chmeruk h-chmeruk force-pushed the add-readthedocs-file branch from 2b6e2ce to 4337713 Compare February 13, 2026 10:17
@h-chmeruk h-chmeruk requested a review from ahms5 February 13, 2026 10:18
@github-project-automation github-project-automation bot moved this from Agenda to Require review in Weekly Planning Feb 13, 2026
@ahms5 ahms5 moved this to Agenda in Weekly Planning Feb 13, 2026
Copy link
Member

@ahms5 ahms5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, maybe you can discuss weather we want to always use the lastest version by as a python defualt version in the meeting today. Ive shifted it to agenda. I wouldnt be able to make it today.

copier.yml Outdated
Comment on lines +99 to +100
Enter the APT packages of this project, separate them with commas and do not leave any
spaces between them.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Enter the APT packages of this project, separate them with commas and do not leave any
spaces between them.
Enter the required apt packages for this project, separate them with commas and do not leave any
spaces between them. The dependencies are installed before each CI/CD workflow and readthedocs build via apt-get on a Linux system.

@ahms5 ahms5 requested review from a team, ahms5 and hoyer-a and removed request for ahms5 February 13, 2026 10:26
@h-chmeruk h-chmeruk moved this from Require review to Agenda in Weekly Planning Feb 13, 2026
@mberz mberz moved this from Agenda to Require review in Weekly Planning Feb 13, 2026
@h-chmeruk h-chmeruk requested a review from ahms5 February 13, 2026 14:37
@github-project-automation github-project-automation bot moved this from Require review to Reviewer Approved in Weekly Planning Feb 13, 2026
@f-brinkmann f-brinkmann moved this from Reviewer Approved to Require review in Weekly Planning Feb 19, 2026
@ahms5 ahms5 requested review from a team and removed request for a team February 23, 2026 11:40
@ahms5 ahms5 merged commit 18e5e60 into main Feb 23, 2026
11 checks passed
@github-project-automation github-project-automation bot moved this from Require review to Done in Weekly Planning Feb 23, 2026
@ahms5 ahms5 deleted the add-readthedocs-file branch February 23, 2026 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

add .readthedocs.yml config to template

4 participants