ValidateFile(3) User Contributed Perl Documentation ValidateFile(3)NAME
XMLTV::ValidateFile
DESCRIPTION
Utility library that validates that a file is correct according to
http://membled.com/twiki/bin/view/Main/XmltvFileFormat.
EXPORTED FUNCTIONS
All these functions are exported on demand.
LoadDtd
Load the xmltv dtd. Takes a single parameter which is the name of
the xmltv dtd file.
LoadDtd must be called before ValidateFile can be called.
ValidateFile
Validate that a file is valid according to the XMLTV dtd and try to
check that it contains valid information. ValidateFile takes a
filename as parameter and optionally also a day and an offset and
prints error messages to STDERR.
ValidateFile returns a list of errors that it found with the file.
Each error takes the form of a keyword:
ValidateFile checks the following:
notwell
The file is not well-formed XML.
notdtd
The file does not follow the XMLTV DTD.
unknownid
No channel-entry found for a channelid that is used in a
programme-entry.
duplicatechannel
More than one channel-entry found for a channelid.
noprogrammes
No programme entries were found in the file.
channelnoprogramme
There are no programme entries for one of the channels listed
with a channel-entry.
invalidid
An xmltvid does not look like a proper id, i.e. it does not
match /^[-a-zA-Z0-9]+(\.[-a-zA-Z0-9]+)+$/.
noid
A programme-entry without an id was found.
emptytitle
A programme entry with an empty or missing title was found.
emptydescription
A programme entry with an empty desc-element was found. The
desc-element shall be omitted if there is no description.
badstart
A programme entry with an invalid start-time was found.
badstop
A programme entry with an invalid stop-time was found.
badepisode
A programme entry with an invalid episode number was found.
If no errors are found, an empty list is returned.
BUGS
It is currently necessary to specify the path to the xmltv dtd-file.
This should not be necessary.
COPYRIGHT
Copyright (C) 2006 Mattias Holmlund.
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.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
perl v5.10.1 2009-06-29 ValidateFile(3)