NAME
Mac::Choose - make a choice with the choose command line util
SYNOPSIS
use Mac::Choose qw(choose);
my $color = choose qw(
red
orange
yellow
green
blue
indigo
violet
) or die "User canceled selection";
DESCRIPTION
"choose" is a commercial commandline utility for OS X from Tiny Robot
Software that shows a simple fuzzy-matching GUI for selecting from one
of several options.
http://tinyrobotsoftware.com/choose/
This module is a really really thin wrapper around it that handles
installing the command line utility and provides a function to do the
shelling out to "choose" via IPC::Open2.
While installing this module installs a copy of choose, if you continue
to use this code beyond the time unlimited trial you should purchase a
license from Tiny Robot Software
https://sites.fastspring.com/tinyrobotsoftware/instant/choose
Function
This module exports one function on request, or you can call it fully
qualified.
choose @possibilities
Shows the GUI allowing the user to pick from the possibilities.
Returns the selected option, or undef if the user canceled the
selection (by hitting ESC / clicking outside the dialog.)
Configuring
This module uses the copy of "choose" distributed with the module
distribution by default. If you've installed "choose" somewhere else and
you want to use that, you can use the $Mac::Choose: :executable_path to
override the path to the executable.
local $Mac::Choose::executable_path = "/stuff/bin/choose";
my $char = choose "Buffy","Willow","Xander","Tara","Oz";
BUGS
Bugs (and requests for new features) can be reported though the CPAN RT
system: <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Mac-Choose>
Alternatively, you can simply fork this project on github and send me
pull requests. Please see <http://github.com/2shortplanks/Mac-Choose>
AUTHOR
Written by Mark Fowler <mark@twoshortplanks.com>
COPYRIGHT
Copyright Mark Fowler 2014. All Rights Reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
The choose command line utility itself is copyright Tiny Robot Software.
Neither Mark Fowler nor this Perl library is associated with the choose
command line utility or Tiny Robot Software (though Tiny Robot Software
did give permission for choose to be distributed with this module when
asked.)
SEE ALSO
<http://tinyrobotsoftware.com/choose/>