gh-148663: Document that IllegalMonthError inherits from both ValueError and IndexError

[EoinTrial]

The documentation for calendar.IllegalMonthError describes it only as "a subclass of ValueError", but the source code defines it as:

class IllegalMonthError(ValueError, IndexError):

The IndexError base class is intentional for backwards compatibility (see the source comment in Lib/calendar.py), but this is not mentioned in the docs. Users catching IndexError for bad month numbers won't know their code still works after Python 3.13.

• Issue: calendar.IllegalMonthError docs omit IndexError base class #148663

---

📚 Documentation preview 📚: https://cpython-previews--148664.org.readthedocs.build/

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[picnixz]

1. Can you add a versionchanged directive indicating that this is now inheriting ValuerError and IndexError since 3.13 (I did not check when it was changed so pick the correct version).
2. Reword the NEWS entry
3. Add a test to ensure that we do not remove that double inheritance.

[EoinTrial]

@picnixz Thanks for taking a look! I've added the versionchanged:: 3.12 directive, rewritten the NEWS entry, and added test_illegal_month_error_bases to verify the dual inheritance.

[EoinTrial]

@picnixz Thanks very much for reviewing! What's the next step towards getting this merged? :)

[picnixz]

I need to come back home so a week or so. In general, once it is approved by one core dev, if the change is minimal, it will be merged when they have time. On your side there is nothing to do (we will ourselves update the branch if necessary/

[picnixz]

There are however some lint issues so could you fix them please?

[StanFromIreland]

LGTM

[miss-islington-app]

Thanks @EoinTrial for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

[bedevere-app]

GH-148917 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-148918 is a backport of this pull request to the 3.13 branch.

[StanFromIreland]

Merged, GRMA!

[EoinTrial]

@StanFromIreland Tá fáilte mhór romhat, a chara ;)