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