File emacs-ghub.spec of Package emacs-ghub

Overview Repositories Revisions Requests Users Attributes Meta

File emacs-ghub.spec of Package emacs-ghub

#
# spec file for package emacs-magit
#
# Copyright (c) 2018 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

Name:           emacs-ghub
Version:        2.0.1
Release:        0
Summary:        Minuscule client libraries for the APIs of various Git forges
License:        GPL-3.0-or-later
Group:          Productivity/Editors/Emacs
Url:            https://github.com/magit/ghub/
Source0:        https://github.com/magit/ghub/archive/v%{version}.tar.gz
BuildRequires:  emacs-dash
BuildRequires:  emacs-nox
BuildRequires:  make
BuildRequires:  makeinfo
Requires:       emacs
Requires:       emacs-dash
Requires(post): %{install_info_prereq}
Requires(preun): %{install_info_prereq}
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildArch:      noarch

%define _lispdir %{_datadir}/emacs/site-lisp/
%define _magit_make make PREFIX=%{_prefix} DESTDIR=%{buildroot} lispdir=%{_lispdir} LOAD_PATH="-L %{_lispdir} -L ./lisp -L ."

%description
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.

%prep
%setup -q -n ghub-%{version}

%build
%{_magit_make} all

%install
mkdir -p %{buildroot}/%{_lispdir}
%__cp ghub.el* %{buildroot}/%{_lispdir}
%__cp ghub-autoloads.el* %{buildroot}/%{_lispdir}
%__cp glab.el* %{buildroot}/%{_lispdir}

%files
%defattr(-,root,root,-)
%doc README.md
%{_lispdir}/ghub.el*
%{_lispdir}/glab.el*
%{_lispdir}/ghub-autoloads.el

%changelog

Places

File emacs-ghub.spec of Package emacs-ghub

Places