NAME

Mojo::File::Role::Extension - Access Mojo::File filename extensions

SYNOPSIS

  $file = Mojo::File->new('/some/path.txt')->with_roles('+Extension');
  # .txt
  $file->extension;
  # /some/path.csv
  $file->switch_extension('.csv');

DESCRIPTION

Add file extension access and modifying behaviour to Mojo::File.

METHODS

The Mojo::File::Role::Extension role adds the following methods to a Mojo::File once composed.

extension

  # .txt
  $file->extension;

Readonly access to the file extension of the file or directory.

extension_parts

  # ['.tar', '.gz']
  $file->extension_parts;

Readonly access to the file extension(s) of the file or directory. The parts are returned as a Mojo::Collection of strings.

moniker

  # path
  $file->moniker;

Readonly access to the short name of the file, i.e. prior to the "extension".

switch_extension

  # /some/path.csv
  $file->switch_extension('.csv');

Change the extension of the Mojo::File, retaining the rest of the path and return a new Mojo::File object.

COPYRIGHT & LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

AUTHORS

Roy Storey - <kiwiroy@cpan.org>