/ 
App-PAUSE-TimeMachine-0.05
River stage zero No dependents
/ pausetm

NAME

pausetm - Web Server and CLI script to display PAUSE 02package data in previous time

SYNOPSIS

# initialize PAUSE-git repository if it's not synced yet
# WARNING: it will take a lot of time to do the first sync
> pausetm init

# pulls PAUSE-git repository
> paysetm sync

# use your custom PAUSE-git repository
> export PAUSETM_GIT_DIR=~/git/PAUSE-git

# show 02packages.details.txt in 2015/01/01
> pausetm cat 2015-01-01
File:         02packages.details.txt
URL:          http://www.perl.com/CPAN/modules/02packages.details.txt
Description:  Package names found in directory $CPAN/authors/id/
Columns:      package name, version, path
Intended-For: Automated fetch routines, namespace documentation.
Written-By:   PAUSE version 1.005
Line-Count:   151580
Last-Updated: Thu, 01 Jan 2015 10:41:02 GMT
...

# runs httpd that works as a mirror!
# use this URL as: cpanm -M http://localhost:5000/<yyyy>-<mm>-<dd> module...
> pausetm server

DESCRIPTION

pausetm is a frontend script to get 02packages.details.txt data provided by PAUSE-git repository at https://github.com/batchpause/PAUSE-git which has a history of package list since March 31st, 2012.

Note that this tool is just a frontend tool, and cpanm can utilize a local 02packages.details.txt with its --mirror-index option without running a web server. Read more details about it at http://weblog.bulknews.net/post/48794875384/freeze-cpan-deps-with-pause-git

COMMANDS

sync
> pausetm sync

Initializes and synchronizes PAUSE-git. It is just a wrapper for git clone and git pull. git checkout location can be configured using PAUSETM_GIT_DIR environment variable, which is set to ~/.pausetm/PAUSE-git by default.

cat
> pausetm cat 2014-02-01

shos the content of 02packages.details.txt file on a given date. The date format accepts whatever git rev-list --before accepts, such as Sep 1 2012 or 2012-09-01.

server
> pausetm server

Runs an httpd that serves as a CPAN mirror. To specify options such as listen port, see plackup man page.

You can access http://localhost:5000/<yyyy>-<mm>-<dd> for example, to make it work as a CPAN mirror in CPAN clients such as cpanm.

AUTHOR

Tatsuhiko Miyagawa

SEE ALSO

App::PAUSE::TimeMachine