# -*- mode: org -*- * 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 https://github.com/magit/forge/issues/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 https://github.com/magit/forge/issues/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. [[https://github.com/magit/forge/issues/293][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~. [[https://github.com/tarsius/ghub/issues/67][#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. [[https://github.com/tarsius/ghub/issues/68][#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. [[https://github.com/tarsius/ghub/issues/64][#64]] - Deal with a chicken and egg problem concerning 2fa. [[https://github.com/tarsius/ghub/issues/65][#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.