Missing support for passing multiple filters of the same type

[LewisGaul]

Filtering can be performed when listing objects or pruning objects. In some components a TypedDict is used to indicate the supported filter types, while in other components a plain Dict[str,str] is used. In either case, this does not support something like docker ps --filter label=foo=1 --filter label=bar.

This was originally brought up in #590, which specifically attempts to address the case of filtering by multiple labels, but the problem is wider than that (see discussion thread #590 (comment)).

This issue tracks fully resolving the root of the issue, which involves needing to change the APIs, as well as adding better typing to all components' filters.

[LewisGaul]

My proposal for the new API is:

docker.container.list(filters=[
    ("label", "foo"),
    ("label", "bar=1"),
    ("status", "created"),
    ("status", "running"),
    ("name", "prefix-*"),
])

This is implemented at master...LewisGaul:python-on-whales:filters-rework.

@gabrieldemarmiesse how should we handle the backwards incompatible change? Do we need to continue to accept Dict[str,str] on all these APIs and emit deprecation warnings?

[gabrieldemarmiesse]

The new API looks good! Though I believe we shouldn't pull the rug on our users if we can avoid it, so as you say backward compatibility + depreciation warning seems the way to go here.

[xcvbn23]

Any updates on this? Thanks.

[LewisGaul]

@xcvbn23 It's implemented in #635, I've just added some tests so just needs to go through review.