dancer::fileutils(3pm) [debian man page]

Dancer::FileUtils(3pm)					User Contributed Perl Documentation				    Dancer::FileUtils(3pm)

NAME

       Dancer::FileUtils - helper providing file utilities

SYNOPSIS

	   use Dancer::FileUtils qw/dirname path/;

	   # for 'path/to/file'
	   my $dir  = dirname($path); # returns 'path/to'
	   my $path = path($path);    # returns '/abs/path/to/file'

	   use Dancer::FileUtils qw/path read_file_content/;

	   my $content = read_file_content( path( 'folder', 'folder', 'file' ) );
	   my @content = read_file_content( path( 'folder', 'folder', 'file' ) );

	   use Dancer::FileUtils qw/read_glob_content set_file_mode/;

	   open my $fh, '<', $file or die "$!
";
	   set_file_mode($fh);
	   my @content = read_file_content($fh);
	   my $content = read_file_content($fh);

DESCRIPTION

       Dancer::FileUtils includes a few file related utilities related that Dancer uses internally. Developers may use it instead of writing their
       own file reading subroutines or using additional modules.

SUBROUTINES
/METHODS
   dirname
	   use Dancer::FileUtils 'dirname';

	   my $dir = dirname($path);

       Exposes File::Basename's dirname, to allow fetching a directory name from a path. On most OS, returns all but last level of file path. See
       File::Basename for details.

   open_file
	   use Dancer::FileUtils 'open_file';
	   my $fh = open_file('<', $file) or die $message;

       Calls open and returns a filehandle. Takes in account the 'charset' setting from Dancer's configuration to open the file in the proper
       encoding (or defaults to utf-8 if setting not present).

   path
	   use Dancer::FileUtils 'path';

	   my $path = path( 'folder', 'folder', 'filename');

       Provides comfortable path resolving, internally using File::Spec.

   read_file_content
	   use Dancer::FileUtils 'read_file_content';

	   my @content = read_file_content($file);
	   my $content = read_file_content($file);

       Returns either the content of a file (whose filename is the input), undef if the file could not be opened.

       In array context it returns each line (as defined by $/) as a separate element; in scalar context returns the entire contents of the file.

   read_glob_content
	   use Dancer::FileUtils 'read_glob_content';

	   open my $fh, '<', $file or die "$!
";
	   my @content = read_glob_content($fh);
	   my $content = read_glob_content($fh);

       Same as read_file_content, only it accepts a file handle. Returns the content and closes the file handle.

   set_file_mode
	   use Dancer::FileUtils 'set_file_mode';

	   set_file_mode($fh);

       Applies charset setting from Dancer's configuration. Defaults to utf-8 if no charset setting.

EXPORT

       Nothing by default. You can provide a list of subroutines to import.

AUTHOR

       Alexis Sukrieh

LICENSE AND COPYRIGHT

       Copyright 2009-2011 Alexis Sukrieh.

       This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as
       published by the Free Software Foundation; or the Artistic License.

       See http://dev.perl.org/licenses/ for more information.

perl v5.14.2							    2012-01-27						    Dancer::FileUtils(3pm)

Check Out this Related Man Page

Dancer::Cookie(3pm)					User Contributed Perl Documentation				       Dancer::Cookie(3pm)

NAME

       Dancer::Cookie - class representing cookies

SYNOPSIS

	   use Dancer::Cookie;

	   my $cookie = Dancer::Cookie->new(
	       name => $cookie_name, value => $cookie_value
	   );

DESCRIPTION

       Dancer::Cookie provides a HTTP cookie object to work with cookies.

ATTRIBUTES

   name
       The cookie's name.

   value
       The cookie's value.

   expires
       The cookie's expiration date.  There are several formats.

       Unix epoch time like 1288817656 to mean "Wed, 03-Nov-2010 20:54:16 GMT"

       A human readable offset from the current time such as "2 hours".  It currently understands...

	   s second seconds sec secs
	   m minute minutes min mins
	   h hr hour hours
	   d day days
	   w week weeks
	   M month months
	   y year years

       Months and years are currently fixed at 30 and 365 days.  This may change.

       Anything else is used verbatim.

   domain
       The cookie's domain.

   path
       The cookie's path.

   secure
       If true, it instructs the client to only serve the cookie over secure connections such as https.

   http_only
       By default, cookies are created with a property, named "HttpOnly", that can be used for security, forcing the cookie to be used only by the
       server (via HTTP) and not by any JavaScript code.

       If your cookie is meant to be used by some JavaScript code, set this attribute to 0.

METHODS
/SUBROUTINES
   new
       Create a new Dancer::Cookie object.

       You can set any attribute described in the ATTRIBUTES section above.

   init
       Runs an expiration test and sets a default path if not set.

   to_header
       Creates a proper HTTP cookie header from the content.

AUTHOR

       Alexis Sukrieh

LICENSE AND COPYRIGHT

       Copyright 2009-2010 Alexis Sukrieh.

       This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as
       published by the Free Software Foundation; or the Artistic License.

       See http://dev.perl.org/licenses/ for more information.

perl v5.14.2							    2011-11-30						       Dancer::Cookie(3pm)

Linux and UNIX Man Pages

dancer::fileutils(3pm) [debian man page]

Check Out this Related Man Page