# metacpan-web

**Repository Path**: mirrors_shlomif/metacpan-web

## Basic Information

- **Project Name**: metacpan-web
- **Description**: Web interface for MetaCPAN
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Build Status](https://travis-ci.org/metacpan/metacpan-web.png?branch=master)](https://travis-ci.org/metacpan/metacpan-web)
[![Coverage Status](https://coveralls.io/repos/metacpan/metacpan-web/badge.png)](https://coveralls.io/r/metacpan/metacpan-web)

## GETTING STARTED

We strongly recommend using [metacpan-developer](https://github.com/metacpan/metacpan-developer),
this will give you a virtual machine already configured and ready to start developing on.

    $ vagrant ssh
    $ cd $HOME/metacpan-web
    $ sudo service starman_metacpan-web restart

You'll find some log files in var/logs.

## Installing manually

If you prefer not to use the VM, the following commands will get you started:
commands can be converted to:

    $ carton install
    $ ./bin/prove t
    $ carton exec plackup -p 5001 -r

## Local configuration changes

The backend defaults to `fastapi.metacpan.org`. Running a local API server is
optional and not required to hack on the front-end.  The address to the API
user can be changed in the `metacpan_web.conf` file.  Ideally you would create a
new file called `metacpan_web_local.conf` that contains

    api                 http://127.0.0.1:5000
    api_secure          http://127.0.0.1:5000
    api_external_secure http://127.0.0.1:5000

which will be loaded on top of the existing config file.


## COMPATIBILITY NOTES

On Win32 (and possibly also on other platforms) when using Perl < 5.12, the
server started with plackup will generate warnings relating to date parsing.
These are caused by Plack due to a bug in the gmtime implementation and can be
removed by upgrading to Perl 5.12.