NAME

wdsinstallfiles - helper script to create new Web::DataService applications

SYNOPSIS

wdsinstallfiles [options] [files]

OPTIONS

    -h, --help            : print what you are currently reading
    -f, --force           : force installation
    -p, --path            : the path where application will be created
                              (current directory if not specified)
    -x, --no-check        : don't check for the latest version of Web::DataService
                              (checking version implies internet connection)
    -v, --version         : print the version of Web::DataService being used

If you name one or more files or file paths, i.e. "doc" or "bin/dataservice.pl", then only that file or files will be installed. Otherwise, all files necessary for the example application will be installed.

DESCRIPTION

This script is designed to be run inside the main directory of a newly-created Dancer application. It adds the files necessary for the Web::DataService example application (see Web::DataService::Tutorial) which you can then use as a basis for your own project.

EXAMPLE

Here is an application created using dancer and wdsinstallfiles:

    $ dancer -a dstest
    + dstest
    + dstest/bin
    + dstest/bin/app.pl
    + dstest/config.yml
    + dstest/environments
    + dstest/environments/development.yml
    + dstest/environments/production.yml
    + dstest/views
    + dstest/views/index.tt
    + dstest/views/layouts
    + dstest/views/layouts/main.tt
    + dstest/lib
    + dstest/lib/dstest.pm
    + dstest/public
    + dstest/public/css
    + dstest/public/css/style.css
    + dstest/public/css/error.css
    + dstest/public/images
    + dstest/public/500.html
    + dstest/public/404.html
    + dstest/public/dispatch.fcgi
    + dstest/public/dispatch.cgi
    + dstest/public/javascripts
    + dstest/public/javascripts/jquery.js
    + dstest/Makefile.PL
    + dstest/t
    + dstest/t/002_index_route.t
    + dstest/t/001_base.t
    
    $ cd dstest
    $ wdsinstallfiles
    + ./config.yml
      ./bin
    + bin/dataservice.pl
      ./public
      public/css
    + public/css/dsdoc.css
      ./lib
    + lib/PopulationData.pm
    + lib/Example.pm
      ./doc
    + doc/doc_footer.tt
    + doc/doc_not_found.tt
    + doc/index.tt
    + doc/doc_header.tt
      doc/formats
    + doc/formats/index.tt
    + doc/formats/json_doc.tt
    + doc/formats/text_doc.tt
    + doc/doc_defs.tt
    + doc/special_doc.tt
    + doc/operation.tt
    + doc/doc_strings.tt
      ./data
    + data/population_data.txt

The application is ready to serve:

    $ bin/dataservice.pl
    >> Listening on 0.0.0.0:3000
    == Entering the development dance floor ...

AUTHOR

This script has been written by Michael McClennen <mmcclenn@cpan.org>, based on the "dancer" script from the Dancer distribution.

SOURCE CODE

See Web::DataService for more information.

LICENSE

This module is free software and is published under the same terms as Perl itself.