peri-sockserve - Serve Perl modules using the Riap::Simple protocol over sockets
This document describes version 0.20 of peri-sockserve (from Perl distribution Perinci-Access-Simple-Server), released on 2014-12-11.
# serve modules % peri-sockserve -p 127.0.0.1:5678 -s /path/to/unix/sock Foo::Bar Baz::* # access the server % perl -MPerinci::Access -e' my $pa = Perinci::Access->new; my $res = $pa->request(call=>"riap+tcp://localhost:5678/Foo/Bar/func1", {args=>{a1=>1, a2=>2}});' my $res = $pa->request(meta=>"riap+tcp:path/to/unix/sock//Baz/Qux/func2");' # see more options % peri-sockserve --help
Riap::Simple, Riap, Rinci
Perinci::Access::Simple::Client, Perinci::Access
This script has shell tab completion capability with support for several shells.
To activate bash completion for this script, put:
complete -C peri-sockserve peri-sockserve
in your bash startup (e.g. ~/.bashrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.
~/.bashrc
You can also install App::BashCompletionProg which makes it easy to add completion for Getopt::Long::Complete-based scripts. After you install the module and put . ~/.bash-complete-prog (or . /etc/bash-complete-prog), you can just run bash-completion-prog and the complete command will be added to your ~/.bash-completion-prog. Your next shell session will then recognize tab completion for the command.
. ~/.bash-complete-prog
. /etc/bash-complete-prog
bash-completion-prog
complete
~/.bash-completion-prog
To activate fish completion for this script, execute:
begin; set -lx COMP_SHELL fish; set -lx COMP_MODE gen_command; peri-sockserve; end > $HOME/.config/fish/completions/peri-sockserve.fish
Or if you want to install globally, you can instead write the generated script to /etc/fish/completions/peri-sockserve.fish or /usr/share/fish/completions/peri-sockserve.fish. The exact path might be different on your system. Please check your fish_complete_path variable.
/etc/fish/completions/peri-sockserve.fish
/usr/share/fish/completions/peri-sockserve.fish
fish_complete_path
To activate tcsh completion for this script, put:
complete peri-sockserve 'p/*/`peri-sockserve`/'
in your tcsh startup (e.g. ~/.tcshrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.
~/.tcshrc
To activate zsh completion for this script, put:
_peri_sockserve() { read -l; local cl="$REPLY"; read -ln; local cp="$REPLY"; reply=(`COMP_SHELL=zsh COMP_LINE="$cl" COMP_POINT="$cp" peri-sockserve`) } compctl -K _peri_sockserve peri-sockserve
in your zsh startup (e.g. ~/.zshrc). Your next shell session will then recognize tab completion for the command. Or, you can also directly execute the line above in your shell to activate immediately.
~/.zshrc
Please visit the project's homepage at https://metacpan.org/release/Perinci-Access-Simple-Server.
Source repository is at https://github.com/perlancar/perl-Perinci-Access-Simple-Server.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Perinci-Access-Simple-Server
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2014 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Perinci::Access::Simple::Server, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perinci::Access::Simple::Server
CPAN shell
perl -MCPAN -e shell install Perinci::Access::Simple::Server
For more information on module installation, please visit the detailed CPAN module installation guide.