p5-orepan2-server's Introduction

NAME

OrePAN2::Server - DarkPAN Server

SYNOPSIS

#launch orepan2 standalone server http://localhost:5888/
% orepan2-server.pl -p 5888

#upload git managed module to my orepan2 by curl 
curl --data-urlencode '[email protected]: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

DESCRIPTION

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.

USAGE

launch OrePAN2 server instantly

See orepan2-server.pl

attach your plack app.

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;
};

attach your plack with Basic Auth

If your need only DarkPAN Uploader and add Basic Auth with Plack::Middleware::Auth::Basic, you code this.

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;
    }
};

upload by minil release.

There is three step.

minil.toml

[release]
pause_config="/path/to/your-module/.pause"

If you want to know other options, See Minilla.

/path/to/your-module/.pause

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!

upload command

minil release

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Hiroyuki Akabane [email protected]

Songmu [email protected]

p5-orepan2-server's People

Contributors

Stargazers

Watchers

p5-orepan2-server's Issues

broken test script t/01_cpan-uploader-interface.t

The OrePAN2::Server test script t/01_cpan-uploader-interface.t is failing because of the following OrePAN2 change

416d29c - 2014-02-26 09:16:05 +0900 Injector#inject_* should not print the result. Return it!

plackup options orepan2-server.pl

It may be worth noting that plackup options needs to come after all orepan options on the CLI otherwise they wipe out the orepan options.

ie this does what you expect
orepan2-server.pl --delivery-dir=/some/path -p 6888

this does not
orepan2-server.pl -p 6888 --delivery-dir=/some/path

default delivery_path not as documented

Actual behaviour is to take the top path of delivery_dir

$opt{delivery_path}    = delete $opt{'delivery-path'}    || File::Basename::basename($opt{delivery_dir});

hirobanex / p5-orepan2-server Goto Github PK