- RUNNING THE APPLICATION
- TECHNOLOGIES USED
- SEE ALSO
- SOURCE REPOSITORY
- COPYRIGHT AND LICENSE
Wcpancover - Web-Interface to cpancover.com
<a href="https://travis-ci.org/wollmers/Wcpancover"><img src="https://travis-ci.org/wollmers/Wcpancover.png" alt="Wcpancover" /></a> <a href='https://coveralls.io/r/wollmers/Wcpancover?branch=master'><img src='https://coveralls.io/repos/wollmers/Wcpancover/badge.png?branch=master' alt='Coverage Status' /></a> <a href='http://cpants.cpanauthors.org/dist/Wcpancover'><img src='http://cpants.cpanauthors.org/dist/Wcpancover.png' alt='Kwalitee Score' /></a> <a href="http://badge.fury.io/pl/Wcpancover"><img src="https://badge.fury.io/pl/Wcpancover.svg" alt="latest CPAN version" height="18"></a>
$ wcpancover setup $ wcpancover daemon
Wcpancover is a Perl web apllication.
Wcpancover uses well-tested and widely-used CPAN modules, so installation should be as simple as
$ cpanm Wcpancover
Although most of Wcpancover is controlled by a configuration file, a few properties must be set before that file can be read. These properties are controlled by the following environment variables.
This is the directory where WCpanCover expects additional files. These include the configuration file and log files. The default value is the current working directory (
This is the full path to a configuration file. The default is a file named wcpancover.conf in the
WCPANCOVER_HOMEpath, however this file need not actually exist, defaults may be used instead. This file need not be written by hand, it may be generated by the
$ wcpancover config [options]
This command writes a configuration file in your
WCPANCOVER_HOME path. It uses the preset defaults for all values, except that it prompts for a secret. This can be any string, however stronger is better. You do not need to memorize it or remember it. This secret protects the cookies employed by Wcpancover from being tampered with on the client side.
WCpanCover does not need to be configured, however it is recommended to do so to set your application's secret.
--force option may be passed to overwrite any configuration file in the current working directory. The default is to die if such a configuration file is found.
$ wcpancover setup
This step is required. Run
wcpancover setup to setup a database. It will use the default DBI settings (SQLite) or whatever is setup in the
WCPANCOVER_CONFIG configuration file.
$ wcpancover daemon
After the database is has been setup, you can run
wcpancover daemon to start the server.
You may also use morbo (Mojolicious' development server) or hypnotoad (Mojolicious' production server). You may even use any other server that Mojolicious supports, however for full functionality it must support websockets. When doing so you will need to know the full path to the
wcpancover application. A useful recipe might be
$ hypnotoad `which wcpancover`
where you may replace
hypnotoad with your server of choice.
Logging in WCpanCover is the same as in Mojolicious. Messages will be printed to
STDERR unless a directory named log exists in the
WCPANCOVER_HOME path, in which case messages will be logged to a file in that directory.
Mojolicious - a next generation web framework for the Perl programming language
DBIx::Class - an extensible and flexible Object/Relational Mapper written in Perl
Bootstrap - the CSS/JS library from Twitter
jQuery - jQuery
Helmut Wollmersdorfer, <firstname.lastname@example.org>
Copyright (C) 2015 by Helmut Wollmersdorfer
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.