CHANGELOG

v5.2.1 2026-06-01

• Increased robustness and backward compatibility or ghub--token and ghub--username.

v5.2.0 2026-05-01

• Fixed username lookup to work as documented.

v5.1.0 2026-04-01

• Loading ghub no longer loads ghub-legacy and the functions defined in the latter are now declared obsolete. a81e83c
• Callbacks and errorbacks no longer have to accept four mandatory arguments, they can also just accept one. 42ebf09
• The debugger no longer falsely assumes all GraphQL queries come with a payload/variables. f1cd5be
• GraphQL errors can now be ignored, which allows processing the data received for the subqueries that succeeded. 3866c82

v5.0.4 2026-03-01

• Thoughts and whitespace.

v5.0.3 2026-01-01

• Various build improvements.

v5.0.2 2025-11-01

• Thoughts and whitespace.

v5.0.1 2025-10-06

• Fixed two token cache invalidation failures. #180

v5.0.0 2025-09-09

• Added new GraphQL query function ghub-query, replacing ghub--graphql-vacuum, ghub-graphql and ghub--graphql (which for the time being are still provided by the new ghub-legacy library), and ghub--graphql-synchronous (which was removed). 9790607, 3a3d209, 508e763
• Deprecated ghub-fetch-repository, ghub-fetch-repository-discussion, ghub-fetch-repository-issue, ghub-fetch-repository-pullreq and ghub-fetch-repository-review-threads. For the time being these functions are still defined in the new ghub-legacy library, but a future release will remove that. Such high-level and opinionated (i.e., optimized for the Forge package) functions are now considered to be beyond the scope of this package. d9d6559
• Removed the libraries buck, glab, gogs and gtea, defining the functions {buck,glab,gogs,gtea}-{VERB,repository-id}. For now these libraries are available as new, transitional packages buck, glab, gogs and gtea. I recommend you stop using these wrapper functions and instead use (ghub-VERB ... :forge FORGE), where FORGE is one of bitbucket, gitlab, gogs and gitea.
• Added very rudimentary support for Forgejo. #177
• Fixed and improved host and username lookup. 6997e47
• Fixed bugs in getting the value of Git variables. d0576a1

v4.3.2 2025-06-01

• It’s now possible to wrap ghub--read-json-payload to depart from how it encodes json by default. #172

v4.3.1 2025-04-28

• Fixed following paging links for Forgejo. #170
• Deprecated {buck,gogs,gtea}-{VERB} functions.

v4.3.0 2025-04-01

• Use the built-in native JSON support added in Emacs 30. In Emacs 29 the built-in support used the jansson library, but only if it was built with --with-json. We already required Emacs 29 before, now we require “Emacs 29 with --with-json, or Emacs 30”. Support for the old json.el interface is dropped.

  Decoding should work as before. When it comes to encoding we inherit a backward incompatible change. Lists, or more accurately “JSON arrays”, now have to be specified using Lisp vectors, not Lisp lists. #168

• ghub-fetch-repository now also fetches discussions and discussion categories. 26d5da1, a57baff
• Display more debugging information; some of it only if ghub-debug is non-nil.

v4.2.2 2025-03-01

Thoughts and whitespace.

v4.2.1 2025-02-01

• Added new variable ghub-graphql-message-progress. magit/forge#633

Bug fix:

• When ghub--token does not find a token for host/path, it now falls back to host. See magit/forge#720.

v4.2.0 2024-12-08

• At least Emacs 29.1 is required now.

Bug fix:

• Revert timeout changes from previous two releases. Url.el is such a pain. See magit/forge#709.

v4.1.1 2024-10-01

Bug fix:

• Fix the timeout handling from the previous release.

v4.1.0 2024-09-01

• Updated tooling.

Bug fix:

• Timeouts are now handled properly. 03d7161

v4.0.0 2024-08-08

• When calling the callback for a REST request, the same buffer which was current when the request was made, is now temporarily made current. 2061136
• When calling the callback or errorback for a GraphQL request, the same buffer which was current when the request was made, is now temporarily made current. 2241135
• The default value of ghub-graphql-items-per-request had to be halved. We use deeply nested requests and Github’s default (and suggested) limit of 100, often leads to timeouts on the server side. b3dd176
• It is now possible to specify how many items to fetch for a specific GraphQL edge using :edges INTEGER. e6af790
• Added new paginate argument to ghub--graphql-vacuum and all its public callers (such as ghub-fetch-repository). 337b884, b9c1600
• Taught ghub--graphql-vacuum to respects forge.graphqlItemLimit. 11c31d1
• Added support for synchronous GraphQL queries, using the new ghub--graphql-synchronous function. a61da16
• Since there are now multiple ways to paginate results, make sure that the smallest value is used. ce7adcd
• Setting the new ghub--graphql-debug variable causes debug information to be inserted into the *gsexp-encode* buffer. 87321cd
• ghub-fetch-repository now also fetches the id of comments, the stateReason of issues, and isReadByViewer of issues and pullRequests 78a370f, 636a463, 13f3627, c59de91

Bug fixes:

• 0d7c81e ghub-response-link-relations: Fix for GitLab
• 2dc1cee ghub-graphql-error: Define missing error type
• 3647748 ghub–retrieve: Better error if buffer is nil

v3.6.0 2023-05-13

• Queries can now be passed to ghub-graphql in the gsexp format. f3a2654
• ghub-fetch-repository fetches more information about Issues and PullRequests. fb9d33b 2c6671e
• Gsexp now supports naming queries. 2c5ba23
• Added support for GitLab’s GraphQL API. 0e61c0b
• ghub--graphql-vacuum can now make synchronous requests. 142b0db
• Added variable ghub-graphql-items-per-request. 6a5de97

Bug fixes:

• 8c4d0ba ghub–encode-payload: Drop invalid arguments to json-serialize
• 0946102 ghub–url-encode-params: Handle lisp booleans
• 5eed205 Add kludge for debbugs#54989 and rework kludge for debbugs#34341
• 7beed8c ghub–graphql-vacuum: Fall back to pretty-printing response

Also contains various documentation updates, code clean-ups and build improvements.

v3.5.6 2022-03-25

• When encoding payloads, explicitly specify how to encode certain Lisp values in JSON.

v3.5.5 2022-02-16

• Define ghub--auth as a generic function.
• Also included are several other improvements, updated documentation and bugfixes.
• The experimental and unfinished support for the native json backend must not be used. It was merged prematurely.

v3.5.4 2021-10-02

• Add new sparse argument to ghub-fetch-repository, making it possible to fetch only information about the repository itself, excluding data such as issues and pull-requests.

v3.5.3 2021-05-26

• If the username isn’t set and the user decides to set it locally, then that resulted in an error. #124

v3.5.2 2021-04-27

• Add new function ghub-fetch-review-threads and make ghub-fetch-respository fetch baseRefOid and headRefOid. #110
• Add new headers argument to ghub-fetch-repository, ghub-fetch-issue and ghub-fetch-pullreq. #110

v3.5.1 2020-12-27

• Add new headers keyword argument to ghub-graphql.

v3.5.0 2020-11-21

• Add a kludge to work around a bug in Emacs that causes it to not respond correctly to http codes 401 and 409, causing the user to be asked for their username, which makes it very hard to debug the actual issue that caused to reject the provided information. forge/293
• Limit the kludge from v3.3.0 to Emacs releases that are affected. It was fixed in Emacs 27.1.

v3.4.2 2020-10-25

• Make sure base64 encoded credentials do not contain any newline characters. #118

v3.4.1 2020-08-01

• Fix a regression introduced in v3.4.0.

v3.4.0 2020-07-20

• Remove the token setup wizard because (a) it only ever supported Github, (b) Github is about to remove support for that on their end, (c) it did not always work, and (d) when it couldn’t be used, or failed, then it made things more complicated. #113
• Various minor fixes and improvements.

v3.3.0 2020-01-19

• Add a kludge to work around a bug in Emacs versions before 26.3 that often but not always causes network connections to fail when using TLS1.3. On macOS use the workaround regardless of the Emacs version because the supposed bug fix does not appear to work there. Add a variable ghub-use-workaround-for-emacs-bug to allow users to opt in or out of using the kludge. #81
• Add a new library gsexp.el to encode S-expressions as GraphQl documents. Previously we used the third-party library graphql.el but using our own library gives us more flexibility. Currently it is rather incomplete and only intended for use by ghub-graphql but I might fill the gaps and add documentation eventually. I am not in a hurry though. #90
• No longer depend on dash.
• Handle some undocumented Bitbucket behavior. #97
• Add new option ghub-insecure-hosts to allow users to connect to insecure forges. #9
• Support Github instances that use an undocumented url-schema, which users report to have sighted in the wild.
• ghub-fetch-repository now also fetches reviewRequests.
• Various bug fixes and improvements.

v3.2.0 2018-12-27

• Work around bug in Emacs versions before 26.1 that prevented newly created tokens from being used without the user invalidating auth-source’s cache first.
• Teach glab-repository-id about subgroups.

v3.1.0 2018-12-20

• Support GraphQL aliases.
• Show number of GraphQL page currently being fetched in mode-line.
• Add a default errorback for asynchronous REST requests, which shows the same information as would be shown for a failed synchronous request.
• Signal an error if ghub-repository-id fails.
• ghub-fetch-repository fetches a few more fields.

v3.0.0 2018-10-31

• Add support for Gitea, Gogs and Bitbucket. ghub.el supports these forges directly, but also add new libraries gtea.el, gogs.el and buck.el, which provide convenience wrappers just like the existing glab.el. #67
• No longer split the repository into multiple Melpa packages. I.e. the glab.el library is now part of the ghub package.
• Add support for automatic GraphQL unpagination. #68

  GraphQL was designed around the idea that you should be able to “ask for what you need and get exactly that”. Unfortunately this does not cover the “look, if I persist, then you are going to hand me over all the data anyway, so just cough it up already”, which is what Forge needs.

  ghub--graphql-vacuum provides a way to unpaginate all cursors in the returned data without having to write a lot of boilerplate. Callers have to provide the query as an s-expression that corresponds to the root request. The queries needed to follow cursors in arbitrary locations within the returned data, are automatically derived from that query.

  ghub-fetch-repository fetches information about a repository. If also serves as an example for how to use ghub--graphql-vacuum.

  The initial queries used by ghub-fetch-issue and ghub-fetch-pullreq are pre-narrowed variants of the initial query of ghub-fetch-repository. Pre-narrowing is somewhat similar to the use of fragments, but unlike that, it doesn’t result in lots of duplicated boilerplate and/or lots of variables.

  There is very little documentation and everything is still very much subject to change.

• Bind url-show-message to nil so that the more useful messages displayed by the callers of this package are visible to the user instead of the less useful “Contacting host: api.github.com:443”.
• Sometimes Github returns an HTML document instead of the promised JSON when an error occurs. Try harder to extract some meaningful information from that document.
• Work around a bug in older Emacsen that prevented auth-source from retrieving saved secrets. #64
• Deal with a chicken and egg problem concerning 2fa. #65
• Add new ghub-clear-caches command because if things go wonky it is nice to know it isn’t the cache.
• Add new ghub-repository-id function. This function works for all supported forges and always returns a string, even for less successful forges that can still get away with using integers as ids.
• Add new ghub-graphql-rate-limit function.

v2.0.1 2018-04-19

(For this an earlier releases only the most important changes are mentioned.)

• Various bug fixes.

v2.0.0 2018-03-20

• Support two-factor authentication.
• Support asynchronous requests.
• Support GraphQL.
• Support Gitlab.

v1.3.0 2017-11-30

• Support basic authentication.
• Fix various encoding issues.

v1.2.0 2017-04-26

• Support unauthenticated requests.
• Support Github Enterprise instances.

v1.1.0 2016-08-07

• Bind json-false to nil instead of :json-false.

v1.0.0 2016-04-20

• First release.