Chatbot::Alpha::Sort - Alphabetic sorting for Chatbot::Alpha documents.
use Chatbot::Alpha::Sort; # Create a new sorter. my $sort = new Chatbot::Alpha::Sort(); # Sort your files. $sort->start ( dir => './before', out => './after', ext => 'cba', );
Chatbot::Alpha::Sort can take your numerous unsorted Alpha documents, and create nicely formatted documents from A.cba to Z.cba with triggers sorted alphabetically within each document.
Creates a new Chatbot::Alpha::Sort object. You should only need one object, since each sort request creates its own Chatbot::Alpha, unless you intend to run multiple sorts at the same time.
Returns a Chatbot::Alpha::Sort instance.
Returns the version number of the module.
Starts the sorting process. ARGUMENTS is a hash that you must pass in to tell the module how to do things. The arguments are as follows:
dir => DIRECTORY The directory at which your original Alpha documents can be found. Defaults to CWD. out => DIRECTORY Another directory for which your newly formatted Alpha documents will be written to. Defaults to CWD. ext => EXTENSION The file extension of your Alpha documents. Defaults to cba files => SORT_TYPE The sorting method for which your new files will be sorted. See below for the sort types.
alpha Sorts the files alphabetically. Will create files "A.cba" through "Z.cba", as well as "star.cba" and "other.cba", and a "topics.cba" to keep all topics together. Triggers within each file are sorted alphabetically.
intact Keeps your original filename structure intact; only sorts triggers alphabetically within each file (topics go to the top of the file's contents).
single Takes ALL your Alpha documents and merges them into one single file. Will write the finished file to "sorted.cba" in the OUT directory. Topics are written first.
Version 0.2 - Added sorting with "keep filenames intact" as well as "single filename" Version 0.1 - Initial release.
Chatbot::Alpha
No bugs have been discovered at this time.
Cerone J. Kirsle, cjkirsle "@" aichaos.com
Chatbot::Alpha - A simple chatterbot brain. Copyright (C) 2005 Cerone J. Kirsle This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
To install Chatbot::Alpha, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Chatbot::Alpha
CPAN shell
perl -MCPAN -e shell install Chatbot::Alpha
For more information on module installation, please visit the detailed CPAN module installation guide.