Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/magit/ghub
Client libraries for the APIs of various Git forges
https://github.com/magit/ghub
Last synced: 3 months ago
JSON representation
Client libraries for the APIs of various Git forges
- Host: GitHub
- URL: https://github.com/magit/ghub
- Owner: magit
- License: gpl-3.0
- Created: 2016-04-20T20:50:21.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-04-08T14:35:04.000Z (7 months ago)
- Last Synced: 2024-04-08T18:07:57.982Z (7 months ago)
- Language: Emacs Lisp
- Homepage:
- Size: 663 KB
- Stars: 155
- Watchers: 11
- Forks: 62
- Open Issues: 1
-
Metadata Files:
- Readme: README.org
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
** Ghub — Client libraries for the APIs of various Git forges
Ghub provides basic support for using the APIs of various Git forges
from Emacs packages. Originally it only supported the Github REST
API, but now it also supports the Github GraphQL API as well as the
REST APIs of Gitlab, Gitea, Gogs and Bitbucket.Ghub abstracts access to API resources using only a handful of basic
functions such as ~ghub-get~. These are convenience wrappers around
~ghub-request~. Additional forge-specific wrappers like ~glab-put~,
~gtea-put~, ~gogs-post~ and ~buck-delete~ are also available. Ghub
does not provide any resource-specific functions, with the exception
of ~FORGE-repository-id~.When accessing Github, then Ghub handles the creation and storage of
access tokens using a setup wizard to make it easier for users to get
started. The tokens for other forges have to be created manually.Ghub is intentionally limited to only provide these two essential
features — basic request functions and guided setup — to avoid being
too opinionated, which would hinder wide adoption. It is assumed that
wide adoption would make life easier for users and maintainers alike,
because then all packages that talk to forge APIs could be configured
the same way.Please consult the [[https://magit.vc/manual/ghub][manual]] for more information.