File perl-Perinci-CmdLine-Server.spec of Package perl-Perinci-CmdLine-Server

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Perinci-CmdLine-Server.spec of Package perl-Perinci-CmdLine-Server (Revision 1cd79d6dbe0b1e60b61461479a83f0a2)

Currently displaying revision 1cd79d6dbe0b1e60b61461479a83f0a2 , Show latest

#
# spec file for package perl-Perinci-CmdLine-Server
#
# Copyright (c) 2015 SUSE LINUX Products 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:           perl-Perinci-CmdLine-Server
Version:        0.04
Release:        0
%define cpan_name Perinci-CmdLine-Server
Summary:        Create CLI application instance and functions to access it
License:        Artistic-1.0 or GPL-1.0+
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/Perinci-CmdLine-Server/
Source:         http://www.cpan.org/authors/id/P/PE/PERLANCAR/%{cpan_name}-%{version}.tar.gz
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
BuildRequires:  perl(Perinci::CmdLine) >= 1.17
BuildRequires:  perl(Rinci) >= v1.1.41
#BuildRequires: perl(Pod::Coverage::TrustPod)
#BuildRequires: perl(Test::Pod) >= 1.41
#BuildRequires: perl(Test::Pod::Coverage) >= 1.08
Requires:       perl(Perinci::CmdLine) >= 1.17
Requires:       perl(Rinci) >= v1.1.41
%{perl_requires}

%description
Currently, the Perinci::CmdLine manpage-based CLI applications have a
perceptible startup overhead (between 0.15-0.35s or even more, depending on
your hardware, those numbers are for 2011-2013 PC/laptop hardware). Some of
the cause of the overhead is subroutine wrapping (see the
Perinci::Sub::Wrapper manpage) which also involves compilation of the Sah
manpage schemas (see the Data::Sah manpage), all of which are necessary for
the convenience of using the Rinci manpage metadata to specify aspects of
your functions.

This level of overhead is a bit annoying when we are doing shell tab
completion (Perinci::CmdLine-based applications call themselves for doing
tab completion, e.g. through bash's 'complete -C progname progname'
mechanism). Ideally, tab completion should take no longer than 0.05-0.1s to
feel instantaneous.

One (temporary?) solution to this annoyance is to start a daemon that
listens to the Riap manpage requests (either through Unix domain sockets or
TCP/IP). This way, the completion external command can just be a
lightweight HTTP client which asks the server for the completion and
displays the result to STDOUT for bash (this only requires, e.g. the
HTTP::Tiny::Unix manpage + the Complete::Bash manpage).

In the future, other functionalities aside from completion can also be
"off-loaded" to the server side to make the CLI program lighter and quicker
to start. This might require a refactoring of Perinci::CmdLine codebase so
it's more "stateless" and reusable/safer for multiple requests (perhaps
will be made non-OO in the core so it's clear what states are being
passed?)

In the future, Perinci::CmdLine can also be configured to automatically
start a daemon after the first run (and retire/kill the daemon after being
idle for, say, 30 minute or an hour).

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

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Changes LICENSE README weaver.ini

%changelog

Places

File perl-Perinci-CmdLine-Server.spec of Package perl-Perinci-CmdLine-Server (Revision 1cd79d6dbe0b1e60b61461479a83f0a2)

Places