NAME

Alien::Dojo - downloading and installing the Dojo Javascript toolkit

SYNOPSIS

use Alien::Dojo;

my $dojo = new Alien::Dojo;
warn "Using Dojo version " . $dojo->version;
my $path    = Alien::Dojo->path;

DESCRIPTION

This is Alien::Dojo, a wrapper module around the Dojo Javascript toolkit. Dojo is a visually sexy and well thought-out library for AJAX programming (aka "Web 2.0"), which is a trendy way of causing smart browsers to do smart things through Javascript. See http://dojotoolkit.org/ for details.

Like all modules in the Alien namespace, this package does nothing per se; its only purpose is to automatically download, package and make available a piece of third-party software. See Alien for details.

Global variable

$VERSION

This is the version of the Perl module itself, which is useless to anybody but the CPAN bots. See "version" instead.

Constructor and methods

new()

new($minversion)

Creates and returns a Perl object that encapsulates a particular version of the Dojo toolkit. The optional version string $minversion indicates a minimal version requirement: if Alien::Dojo cannot provide a version of Dojo at or above $minversion, the call to new will fail by throwing an exception.

version

Returns the version number for this version of Dojo, as a string.

path()

Returns a filesystem-level path (as a string) that points at the root of an unpacked copy of this version of Dojo.

list_files

list_files(@globs)

Returns the list of all files in this Dojo object, as relative paths to "path". Directories are not listed, nor are by default the README and LICENSE files at the top level; however, by stipulating a list of @globs relative to "path", one can alter that. For example,

list_files("*")

returns all files, including the legalese.

install($dest_dir)

Copies the whole file hierarchy rooted at "path" into $dest_dir. This requires File::Basename, File::Copy and File::Path (which are bundled with modern versions of Perl).

AUTHORS

Dominique Quatravaux <dom@idealx.com>, maintainer

Heavily inspired from similar code in Alien::Selenium, by Mattia Barbon <mbarbon@cpan.org>

LICENSE

Copyright (c) 2006 IDEALX SA <webmaster@idealx.com>

Copyright (c) 2005-2006 Mattia Barbon <mbarbon@cpan.org>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself

Please notice that Dojo comes with its own licence.