/ 
Task-MojoLearningEnvironment-20180917.001
River stage one • 1 direct dependent • 1 total dependent
/ README

The Task::MojoLearningEnvironment module

This is the README for the Task::MojoLearningEnvironment Perl module. This is a fancy way to install the Perl stuff that I want for a Mojolicious class.

You're probably looking at this because you don't know where else to find what you're looking for. Read this once and you might never have to read one again for any Perl module.

Quickstart

Install Vagrant, available for Linux, Windows, and Mac OS X.

Add an Ubuntu image. Other distros may work, but the provisioning script assumes Ubuntu.

% vagrant box add ubuntu/trusty64 https://atlas.hashicorp.com/ubuntu/boxes/trusty64

Install the vagrant-vbox-snapshot plugin. This allows you to take snapshots of your vagrant box. With a snapshot, you can mess up everything with no worries since you can go back to any point.

% vagrant plugin install vagrant-vbox-snapshot

Start vagrant. It reads the VagrantFile in the current directory, and should provision the box following the vagrant-provision.sh script. This will take awhile the first time:

% vagrant up

Before you do anything, take a snapshot with the beginning state. I like to name this snapshot "first":

% vagrant snapshot take first

If you like what you have, take another snapshot.

% vagrant snapshot take provisioned

Once up, you can ssh into the box:

% vagrant ssh

When you want to take the box down:

% vagrant down

Without vagrant

You might try the vagrant-provision.sh program as a normal shell script. On Ubuntu it should setup everything.

Documentation

To read about Task::MojoLearningEnvironment, look at the embedded documentation in the module itself. Inside the distribution, you can format it with perldoc:

% perldoc lib/Task/MojoLearningEnvironment.pm

If you have already installed the module, you can specify the module name instead of the file location:

% perldoc Task::MojoLearningEnvironment

You can read the documentation and inspect the meta data at MetaCPAN.

The standard module documentation has example uses in the SYNOPSIS section, but you can also look in the examples/ directory (if it's there), or look at the test files in t/.

Installation

You can install this module with a CPAN client, which will resolve and install the dependencies:

% cpan Task::MojoLearningEnvironment
% cpanm Task::MojoLearningEnvironment

You can also install directly from the distribution directory, which will also install the dependencies:

% cpan .
% cpanm .

You could install just this module manually:

% perl Makefile.PL
% make
% make test
% make install

You probably don't want to do that unless you're fiddling with the module and only want to run the tests without installing anything.

Source location

The meta data, such as the source repository and bug tracker, is in Makefile.PL or the META.* files it creates. You can find that on those CPAN web interfaces, but you can also look at files directly in the source repository:

If you find a problem, file a ticket in the issue tracker:

Getting help

Although I'm happy to hear from module users in private email, that's the best way for me to forget to do something.

Besides the issue trackers, you can find help at Perlmonks or Stackoverflow, both of which have many competent Perlers who can answer your question, almost in real time. They might not know the particulars of this module, but they can help you diagnose your problem.

You might like to read brian's Guide to Solving Any Perl Problem.

You should have received a LICENSE file, but the license is also noted in the module files. About the only thing you can't do is pretend that you wrote code that you didn't.

Good luck!

Enjoy,

brian d foy, bdfoy@cpan.org