Missing UserKey.expires_at in doc and inplementation #3245

Hi! The confusing bit here is that the docs you linked are for GPG keys, while get_keys() returns SSH authentication keys. Re-fetching key.url will still give you the SSH key, so it won't have the GPG expires_at field.

If it's your GPG keys you're after, you can call /user/gpg_keys through PyGithub's public requester property. For example:

import os
from github import Auth, Github

with Github(auth=Auth.Token(os.environ["GH_TOKEN"])) as g:
    page = 1
    while True:
        _, keys = g.requester.requestJsonAndCheck(
            "GET", "/user/gpg_keys", parameters={"per_page": 100, "page": page}
        )
        for key in keys:
            print(key["key_id"], key["expires_at"])
        if len(keys) < 100:
            break
        page += 1

This assumes your token is in the GH_TOKEN environment variable and has the GPG-key read permission listed in the API docs. The loop handles pagination in case there are more than 100 keys.

One other detail in your proposed workaround: requestJsonAndCheck() already parses the JSON for you, so you don't need json.loads(). Here, keys is a list of dictionaries, and a null expiry comes through as Python None. If you also need the expiry dates for GPG subkeys, those are in each key's subkeys list.

I checked the snippet on PyGithub 2.10.0 with mocked HTTP responses, including pagination, empty results and null expiry values.