bruxy70/Garbage-Collection 4.4.2

4.4: Simplification, beautification, great flexibility through Blueprints

on GitHub

!!! Please read - there are breaking changes !!!

Table of Content:

• Summary
• Breaking changes
• Other changes
• Bugfixes
  • 4.4.1: #342 bug when configuring frequency for every-n-days.
  • 4.4.2 #344 translation did not translate (so theat the state displayed in all lowercase)

Summary

Earlier this year, I have released version 4.0, which is changing the overall direction this integration is taking. In the past, I added a number of different options to configure the schedule. But as I kept adding more and more options, it started to make the whole thing hard to configure. People were confused. And it was also making it quite fragile - the configuration had to be right, and adding a new thing often broke other things. So I decided to stop adding more and more features and started rejecting them. But having the thing "frozen" was not really sustainable - there must be a better way!

So the theme for 4.0 is, to simplify the integration, but to allow it to configure more flavors at the same time. And the way this will work is, it will remove the exception from the integration, and move that to automations, supported by blueprints. First, I created a number of services, that would be called by automation triggered by an entity update event, and allow customizing the schedule. Then, I started creating blueprints to replace the earlier functionality and to address some of the feature requests you had in the past. Also, it allowed for anyone to contribute and share their blueprint with the others (and we already have the first one on the list).

And I am pleased to say this strategy works - the blueprints already have more flavors than the integration allowed before. There are 10 different blueprints, often allowing a slightly different treatment for the same situation - such as public holidays.

To allow going through the changes, I decided to stop the support of configuration in configuration.yaml. This will not only allow simplifying the configuration, but I also needed to have version management with automatic migration.

With all this prep work done, I am excited to finally introduce this release. As planned, it brings a major simplification of the configuration, as well as refactoring and code simplification. Before, the configuration had a different number of steps for each flavor, and it was quite confusing. Often, I got bug reports that some configuration options are missing, because people were confused. It is now much simpler - the configuration has 2 steps: in the first step, you configure the frequency and common parameters, in the second the parameters that depend on the frequency. The interface is has been cleaned up to be more clear, and the documentation has been updated.

Go and check out the new configuration experience. I hope you'll love it.

One of the downsides of moving the config into the GUI workflow was, that it was not so easy to share the configuration. Not anymore. This release supports the DOWNLOAD DIAGNOSTICS feature, that was introduced in HA in the February release. And I will ask you to add these diagnostics to all tickets you log from now on. Quite neat.

I think it goes in hand with the overall Home Assistant topic for this year - Streamlining Experiences. It is actually quite funny that we arrived at the same point at the same time. So here is what is coming:

Breaking change

• Removal of the obsolete parameters (see documentation - also shows as errors in the log file after the first start, if you still use them). This is for offset, include/exclude dates, and Public Holidays - that are now replaced by Blueprints.

Other changes

• Fix #342 (unable to configure frequency for every-n-days)
• Major simplification of the configuration. It is now (always) in two steps - in the first one you select the frequency and parameters that are always the same. In the second step, the parameters that depend on the frequency. I think I made the GUI crisper and cleaner.
• For the parameters requiring a list of values, I no longer require a comma-separated list but provide a checkbox-style list. I hope you'll appreciate it.
• Automatic migration of the configuration parameters (possible thanks to the move from YAML to Config Flow). Much simpler and more reliable.
• Major simplification of the configuration code (thanks to depreciation of the parameters, and YAML config).
• Registering it properly as a device
• Added DOWNLOAD DISGNOSTICS to the device page. This gives a nice overview of all configuration parameters and simplifies bug reporting. Please use it when reporting a bug.