Update pre-commit to use pinned version of dvc and correct stage names

[mkdjr]

• ❗ I have followed the Contributing to DVC checklist.

• 📖 If this PR requires documentation updates, I have created a separate PR (or issue, at least) in dvc.org and linked it here.

1. Pin rev argument in pre-commit-config.yaml writer

The pre-commit package recommends against using mutable references such as main, as the version of the package pulled in the hook (in this case dvc), does not get updated after the first time pre-commit installs it. This PR addresses this by instead pinning the hooks to dvc v3.56.0. This change is made with the goal of:

• removing the pre-commit warning, and
• adding the ability to automatically update the dvc version that pre-commit refers to when dvc receives a new release.

As a reference, ruff, the python linter and formatter, keeps its pre-commit hooks in a separate repository. This repository has its own pre-commit hooks that automatically pull the latest version of ruff and updates the version pointer in the pre-commit-hooks.yaml file. Maybe dvc could do something like this in the future to automate the pre-commit-hooks.yaml update process.

2. Update stages keywords

Additionally, pre-commit has now deprecated the acceptable values for the stages keyword for hooks. I have updated the dvc install command and the pre-commit-hooks.yaml file to reflect this change.

As this change was made in pre-commit v3.2.0, the dvc hooks now require pre-commit to be updated to at least v3.2.0.

Closes #9897.

Associated documentation PR: iterative/dvc.org#5323.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.67%. Comparing base (2431ec6) to head (08d4f2f).
Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #10621      +/-   ##
==========================================
- Coverage   90.68%   90.67%   -0.01%     
==========================================
  Files         504      504              
  Lines       39795    39796       +1     
  Branches     3141     3141              
==========================================
- Hits        36087    36085       -2     
- Misses       3042     3045       +3     
  Partials      666      666              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[shcheklein]

thanks @mkdjr ! Is it still in draft, needs more testing?

[mkdjr]

Oh yeah, I forgot to take it out of its drafted state. I think it's good to go, but should probably be followed up with a future PR to automate updating the rev field as dvc gets new releases.

[skshetry]

Let's not hardcode version. That will break our release workflow.

Suggested change

	"rev": "3.56.0",
	"rev": ".".join(map(str, version_tuple[:3])),

You can import this from from dvc import version_tuple.