Gist

class github.Gist.Gist

This class represents Gists.

The reference can be found here https://docs.github.com/en/rest/reference/gists

The OpenAPI schema can be found at

  • /components/schemas/base-gist

  • /components/schemas/gist-simple

  • /components/schemas/gist-simple/properties/fork_of

  • /components/schemas/gist-simple/properties/forks/items

A CompletableGithubObject can be partially initialised (completed=False). Accessing attributes that are not initialized will then trigger a request to complete all attributes.

A partially initialized CompletableGithubObject (completed=False) can be completed via complete(). This requires the url to be given via parameter url or attributes.

With a requester where Requester.is_lazy == True, this CompletableGithubObjects is partially initialized. This requires the url to be given via parameter url or attributes. Any CompletableGithubObject created from this lazy object will be lazy itself if created with parameter url or attributes.

Parameters:

  • requester – requester

  • headers – response headers

  • attributes – attributes to initialize

  • completed – do not update non-initialized attributes when True

  • url – url of this instance, overrides attributes[‘url’]

  • accept – use this accept header when completing this instance

create_comment(body: str) → GistComment
Calls:

POST /gists/{gist_id}/comments

create_fork() → Gist
Calls:

POST /gists/{gist_id}/forks

delete() → None
Calls:

DELETE /gists/{gist_id}

edit(description: Opt[str] = NotSet, files: Opt[dict[str, InputFileContent | None]] = NotSet) → None
Calls:

PATCH /gists/{gist_id}

get_comment(id: int) → GistComment
Calls:

GET /gists/{gist_id}/comments/{comment_id}

get_comments() → PaginatedList[GistComment]
Calls:

GET /gists/{gist_id}/comments

is_starred() → bool
Calls:

GET /gists/{gist_id}/star

reset_starred() → None
Calls:

DELETE /gists/{gist_id}/star

set_starred() → None
Calls:

PUT /gists/{gist_id}/star