Purge recorder database at night

[amelchio]

Breaking change

• The recorder configuration purge_interval has been deprecated. The recorder database is now purged every night. This can be disabled with the new auto_purge configuration though that is usually not recommended.

Proposed change

This updates the recorder purge schedule as discussed in home-assistant/architecture#358.

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing integration)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Example entry for configuration.yaml:

# Example configuration.yaml
recorder:
    auto_purge: false

Additional information

• This PR fixes or closes issue: fixes Recorder purge schedule architecture#358
• This PR is related to issue:
• Link to documentation pull request: Introduce recorder auto_purge, remove purge_interval home-assistant.io#12690

Checklist

• The code change is tested and works locally.
• Local tests pass. Your PR cannot be merged unless tests pass
• There is no commented out code in this PR.
• I have followed the development checklist
• The code has been formatted using Black (black --fast homeassistant tests)
• Tests have been added to verify that the new code works.

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

• The manifest file has all fields filled out correctly.
  Updated and included derived files by running: python3 -m script.hassfest.
• New or updated dependencies have been added to requirements_all.txt.
  Updated by running python3 -m script.gen_requirements_all.
• Untested files have been added to .coveragerc.

The integration reached or maintains the following Integration Quality Scale:

• No score or internal
• 🥈 Silver
• 🥇 Gold
• 🏆 Platinum

[bdraco]

4:12 is a great choice. 👍 Should we document this?

[amelchio]

I couldn't quite decide that. I kept it out of the documentation for now to give us some leeway for tweaks but I will go with whatever people want.

[pvizeli]

@BudBundi use auto_purge: false and create ou own purge automation.

[bdraco]

@amelchio I put some suggested language in the docs PR.

[balloob]

Let's drop the invalidation_version. Let it be a warning and we can drop it at some point in the future. No reason to break things if we can keep it as a warning and it's not impacting operation.

[amelchio]

Done. Thank you for reviewing!

[MartinHjelmare]

Should we label this a breaking change?

[amelchio]

Yeah, sorry. I put the text in but I always forget about the label 🙄