Tatsuhiko Miyagawa > File-Spotlight-0.05 > File::Spotlight

Download:
File-Spotlight-0.05.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.05   Source  

NAME ^

File::Spotlight - List files from Smart Folder by reading .savedSearch files

SYNOPSIS ^

  use File::Spotlight;

  my $path = "$ENV{HOME}/Library/Saved Searches/New Smart Folder.savedSearch";

  my $folder = File::Spotlight->new($path);
  my @found  = $folder->list();

DESCRIPTION ^

File::Spotlight is a simple module to parse .savedSearch Smart Folder definition, run the query and get the results with OS X Spotlight binding via Mac::Spotlight.

This is a low-level module to open and execute the saved search plist files. In your application you might better wrap or integrate this module with higher-level file system abstraction like IO::Dir, Path::Class::Dir or Filesys::Virtual.

METHODS ^

new
  $folder = File::Spotlight->new("/path/to/foo.savedSearch");

Creates a new File::Spotlight object with the .savedSearch file path usually in ~/Library/Saved Searches folder.

list
  @files = $folder->list;

Executes the saved Spotlight query and returns the list of files found in the smart folder.

AUTHOR ^

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

LICENSE ^

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

SEE ALSO ^

Mac::Spotlight::MDQuery http://www.macosxhints.com/dlfiles/spotlightls.txt

syntax highlighting: