feat(commit): add retry_after_failure config option and --no-retry flag

[crai0]

Description

This pull request resolves #732 by implementing the requested feature.

Checklist

• Add test cases to all the changes you introduce
• Run ./scripts/format and ./scripts/test locally to ensure this change passes linter check and test
• Test the changes on the local machine manually
• Update the documentation for the changes

Expected behavior

See #732 (comment).

Steps to Test This Pull Request

1. Set up a git repository with a git hook that always fails

git init test
cd test
echo '#!/usr/bin/env bash\necho "pre-commit fail"\nfalse' > .git/hooks/pre-commit 
chmod +x .git/hooks/pre-commit

2. Enable retry_after_failure

echo '[tool.commitizen]\nretry_after_failure=true' > .cz.toml

3. Try to create a commit (should fail)

git add .
cz commit

4. Retry (still fails but reuses the previous message)

cz commit

5. Force new message prompt (still fails but uses new message)

cz commit --no-retry

Additional context

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.48%. Comparing base (120d514) to head (888606b).
Report is 231 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1027      +/-   ##
==========================================
+ Coverage   97.33%   97.48%   +0.15%     
==========================================
  Files          42       55      +13     
  Lines        2104     2429     +325     
==========================================
+ Hits         2048     2368     +320     
- Misses         56       61       +5     

Flag	Coverage Δ
unittests	97.48% <100.00%> (+0.15%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

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

[noirbizarre]

Great ! Thanks (I was going to take a loook at this, so perfect timing 👌🏼)

[Lee-W]

Suggested change

	def read_backup_message(self) -> Optional[str]:
	def read_backup_message(self) -> str | None:

[Lee-W]

Suggested change

from typing import Optional

[Lee-W]

Suggested change

	print("could not import commitizen:")
	print(error)
	print(f"could not import commitizen:\n{error}")

[Lee-W]

Suggested change

	return os.path.join(
	tempfile.gettempdir(),
	"cz.commit%{user}%{project}.backup".format(
	user=os.environ.get("USER", ""),
	project=project,
	),
	)
	user = os.environ.get("USER", "")
	return os.path.join(
	tempfile.gettempdir(),
	f"cz.commit%{user}%{project}.backup"
	)

[Lee-W]

Thanks so much for finishing this feature! I just fixed a few style-related nitpicks. Will merge this one once CI passes.

[Lee-W]

Closes: #732

[crai0]

@Lee-W awesome, thanks a lot.