OrePAN2::Server - DarkPAN Server
#launch orepan2 standalone server http://localhost:5888/ % orepan2-server.pl -p 5888 #upload git managed module to my orepan2 by curl curl --data-urlencode 'module=git@github.com:Songmu/p5-App-RunCron.git' --data-urlencode 'author=SONGMU' http://localhost:5888/ curl --data-urlencode 'module=git+ssh://git@mygit/home/git/repos/MyModule.git' --data-urlencode 'author=SONGMU' http://localhost:5888/ curl --data-urlencode 'module=git+file:///home/hirobanex/project/MyModule.git' --data-urlencode 'author=SONGMU' http://localhost:5888/ #install by cpanm cpanm --mirror=http://localhost:5888/orepan Your::Module #install by carton install PERL_CARTON_MIRROR=http://localhost:5888/orepan carton install
OrePAN2::Server is DarkPAN server, or OrePAN2 Uploader that use API provided by OrePAN2.
Like uploading to cpan, you can upload to your DarkPAN by http post request.
If you set your DarkPAN url in options(cpanm --mirror, carton PERL_CARTON_MIRROR), you can easily install and manage your modules in your project.
You should set up DarkPAN in private space. If you upload your modules to DarkPAN on public space, you consider to upload your modules to cpan.
See orepan2-server.pl
use Plack::Builder; use OrePAN2::Server::CLI; use Your::App; my $orepan = OrePAN2::Server::CLI->new_with_options( delivery_dir => "orepan", delivery_path => "/", authenquery_path => "/authenquery", compress_index => 1, ); builder { mount '/' => Your::App->to_app(); mount '/orepan' => $orepan->app; };
If your need only DarkPAN Uploader and add Basic Auth with Plack::Middleware::Auth::Basic, you code this.
Plack::Middleware::Auth::Basic
use Plack::Builder; use OrePAN2::Server; use Your::App; my $orepan_uploader = OrePAN2::Server->uploader( directory => "orepan", compress_index => 1, ); builder { mount '/' => Your::App->to_app(); mount '/authenquery' => builder { enable "Auth::Basic", authenticator => sub { return ($_[0] eq 'userid' && $_[1] eq 'password') }; $orepan_uploader; } };
There is three step.
[release] pause_config="/path/to/your-module/.pause"
If you want to know other options, See Minilla.
upload_uri http://orepan2-server/authenquery user hirobanex password password
If you want to know other options, See CPAN::Uploader.
You must pay attention to set your DarkPAN uri as upload_uri.If you don't, you will upload to cpan!
minil release
orepan2-server.pl, OrePAN2, Minilla
Copyright (C) Hiroyuki Akabane.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Hiroyuki Akabane <hirobanex@gmail.com>
Songmu <y.songmu@gmail.com>
To install OrePAN2::Server, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OrePAN2::Server
CPAN shell
perl -MCPAN -e shell install OrePAN2::Server
For more information on module installation, please visit the detailed CPAN module installation guide.