NAME

fortune_import.pl - import fortune data into the fortune database.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

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, USA.

DETAILS

        MANIFEST: fortune_import.pl
        PROJECT: meta
        VERSION: 0.02

SYNOPSIS

        fortune_import.pl [options]

DESCRIPTION

This program will import fortune data into the fortune database. The program has various options to control it's activity. Please consult this manual for the specifics.

How does it do it ? It will read all files in the specified directory which do not match the user provided filter (don't worry about the values - the defaults will do). It the proceeds to parse each file looking for the \n%\n delimiter. If you don't know what I'm talking about take a look at the fortune plain text data files. It them proceeds to put them into the database under the category which is named after the file name that is being parsed. All categories are connected to a root category which is created.

The system has been tested on RedHat. Since file layout is different in different systems you may need ot tweek the paramters to get this script to work.

I'll try and get some numbers here regarding how long does it take to import the full fortune database.

OPTIONS

help (type: bool, default: 0)

display help message

pod (type: bool, default: 0)

display pod options snipplet

man (type: bool, default: 0)

display manual page

quit (type: bool, default: 0)

quit without doing anything

gtk (type: bool, default: 0)

run a gtk ui to get the parameters

license (type: bool, default: 0)

show license and exit

copyright (type: bool, default: 0)

show copyright and exit

description (type: bool, default: 0)

show description and exit

history (type: bool, default: 0)

show history and exit

connections_file (type: modu, default: xmlx/connections/connections.xml)

what connections XML file to use ?

con_name (type: stri, default: )

what connection name ?

name (type: stri, default: fortune)

what database name ?

clean (type: bool, default: 1)

should I clean the database before ?

directory (type: dire, default: /usr/share/games/fortunes)

where are the fortune files ?

filter (type: stri, default: ^.*\.dat$)

what pattern to filter ?

verbose (type: bool, default: 0)

should I speak ?

no free arguments are allowed

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV finish papers
        0.01 MV teachers project
        0.02 MV md5 issues

SEE ALSO

Meta::Class::DBI(3), Meta::Db::Connections(3), Meta::Db::Dbi(3), Meta::Db::Ops(3), Meta::IO::File(3), Meta::Projects::Fortune::Edge(3), Meta::Projects::Fortune::Item(3), Meta::Projects::Fortune::Link(3), Meta::Projects::Fortune::Node(3), Meta::Utils::File::Iterator(3), Meta::Utils::Opts::Opts(3), Meta::Utils::Output(3), Meta::Utils::System(3), strict(3)

TODO

-once Meta::Utils::File::Iter supports filters use that and not do the matching here.