Method to delete a specific set of cookies

[Lonami]

Currently if one wants to delete some cookies, the way to do it is not really obvious:

new_cookies = []

for c in session.cookie_jar:
    if check(c):
        c['max-age'] = -1
        new_cookies.append((c.key, c))

session.cookie_jar.update_cookies(new_cookies)

It would be nice to have a method to do this cleanly.

Use case: one may want to clear the cookies from a session before trying again the same operation but not wishing to recreate the session (or being unable to do so).

[WolframAlph]

Hi @Lonami there is clear method in https://github.com/aio-libs/aiohttp/blob/master/aiohttp/cookiejar.py#L71 . Is this something you missed? You can directly call session.cookie_jar.clear() .

[Lonami]

I don't recall if I saw it, but that seems to delete all the cookies of the session. I was looking for something that deletes only some of the cookies. I'd expect a method where I can provide a list of cookies to delete.

[Lonami]

I have updated the original post and title to clarify.

[WolframAlph]

This makes sense now. @webknjaz can I start working on it?

[myusko]

Someone is working on the issue? cc @webknjaz

[webknjaz]

@WolframAlph @myusko feel free to implement this.

[asvetlov]

CookieJar is for client cookies.
The cookie lifespan is controlled by a server usually, the jar is just client-side storage.
I'm curious what is your use-case?

[Lonami]

I am using a single ClientSession to access multiple different sites, and at times I need to clear a specific cookie to have the specific site send me a fresh value while not altering the cookies in the rest of sites. Much like Firefox lets you clear the "site data", including cookies, of just one site and not the entire browser.

[asvetlov]

Okay, I can imagine the clear_domain() method that deletes all cookies for the passed domain AND all subdomains regardless of cookie path and expiration dates.
Another alternative is extending the clear() method to accept an optional domain argument, delete all cookies if domain is None (the default behavior).

I unlikely can find time for the feature soon but open to review/merge a PR if somebody wants to propose it.

[Lonami]

What about a filter parameter that accepts a callable with the cookie as input parameter and the boolean it returns determines whether to clear it or not? This gives the largest flexibility, and would also support the "delete domain" use case quite easily:

session.cookie_jar.clear(filter=lambda cookie: cookie.domain == 'example.com')

[asvetlov]

My guts feel that filter can be a secondary solution, but people need something easier to understand in the first place.
BTW, are filtered records removed from the jar or kept in?

Maybe I'm wrong and good documentation with a couple of examples: one for a site with subdomains and another for something else -- can teach users comprehensively.

[Lonami]

I was thinking something along the lines of:

def clear(self,
          domain: Optional[str]=None,
          filter: Optional[Callable[[SimpleCookie], bool]]=None) -> None:
    """
    Clears the cookies from this jar.

    If the ``domain`` parameter is specified, only the cookies belonging
    to that specific domain will be cleared.

    If the ``filter`` parameter is specified, only those cookies for which
    the filter returns `True` will be cleared. If any of the calls to the
    filter fail, no changes will be made to the jar.

    A `ValueError` is raised if both ``domain`` and ``filter`` are
    specified at the same time.
    """

People don't need to use filter if they don't need to, but when they do need it, it will be useful to have.