Skip to content

Update CONTRIBUTING.md and dependencies after packaging modernization#2162

Merged
pydanny merged 7 commits intocookiecutter:mainfrom
Fred-si:update-contributing
Aug 30, 2025
Merged

Update CONTRIBUTING.md and dependencies after packaging modernization#2162
pydanny merged 7 commits intocookiecutter:mainfrom
Fred-si:update-contributing

Conversation

@Fred-si
Copy link
Copy Markdown
Contributor

@Fred-si Fred-si commented Aug 24, 2025

Hello

Since this commit that remove Tox from the project and introduce Just as task runner for replace make, some sections of CONTRIBUTING.md are outdated. Also, the commands provided by the contributing are no longer working.

This PR propose to

  • migrate make commands servedocs and coverage that are mentioned in CONTRIBUTING.md to justfile
  • add uv to dev group dependencies because it is needed by just tasks
  • add lint command to CONTRIBUTING.md, at "check that your changes pass the tests and lint check" step
  • remove Tox from CONTRIBUTING.md
  • pick sphinx-autobuild dependency from docs/requirements.txt to docs dependencies group in pyproject.toml

Please note that this PR adds two dev dependencies to pyprojet.toml, uv that are needed by justfile and sphinx-autobuild that are needed by just servedocs.

I'm not sure it's still necessary to keep the sphinx-autobuild dependency in docs/requirements.txt because it’s now only used in .readthedocs.yaml.

With this PR, setup the project and run tests/lint should work out of the box by executing commands listed in CONTRIBUTING.md.

Fred-si and others added 7 commits August 24, 2025 20:27
Justfile use Uv to run commands.
- pick sphinx-autodoc from docs/requirements.txt to pyproject.toml
- create servedocs command un justfile
- update CONTRIBUTING
Since bf173de Modernize packaging and CI/CD workflow (cookiecutter#2157)
tox have been removed from project dependencies and Uv is used
instead
@pydanny pydanny added the documentation This issue/PR relates to or includes documentation. label Aug 30, 2025
Copy link
Copy Markdown
Member

@pydanny pydanny left a comment

Choose a reason for hiding this comment

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

Thank you so much for submitting this PR, this really helps.

How would you feel about a follow-up PR that converts the project from using pip in the contributing file to uv? 😄 No worries if that's too much, just thought you might want to get that in. 😄

@pydanny pydanny merged commit 7fa122e into cookiecutter:main Aug 30, 2025
7 checks passed
@Fred-si
Copy link
Copy Markdown
Contributor Author

Fred-si commented Aug 30, 2025

Hi @pydanny, thanks for approval.

How would you feel about a follow-up PR that converts the project from using pip in the contributing file to uv?

I am not confortable with uv, I have never use this tool before this PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation This issue/PR relates to or includes documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants