--  Copyright (2008-2011) Cédric Coussinet (cedric.coussinet@nomoseed.net)
--
--  This program is free software: you can redistribute it and/or modify
--  it under the terms of the GNU Affero General Public License as published
--  by the Free Software Foundation, either version 3 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 Affero General Public License for more details.

--  You should have received a copy of the GNU Affero General Public License
--  along with this program. If not, see <http://www.gnu.org/licenses/>

--  Ce composant permet d'analyser entièrement un fichier xml
--  avec un seul analyseur.

package Basic_Sax.File_Parser is

   type Reader is tagged limited null record;

   procedure Start_Element (Handler : in out Reader;
                            Name    : in String;
                            A       : in Attributes) is null;
   --  Procédure à surcharger.
   --  Appellée à chaque balise ouvrante rencontrée
   --  ainsi que pour chaque balise singluière.

   procedure End_Element (Handler : in out Reader;
                          Name    : in String) is null;
   --  Procédure à surcharger.
   --  Appellée à chaque balise fermante rencontrée.

   procedure Characters (Handler : in out Reader;
                         Data    : in String) is null;
   --  Procédure à surcharger.
   --  Appellée lorque des charactères entre balises sont rencontrées.

   procedure Parse (Handler   : in out Reader'Class;
                    File_Name : in String);
   --  Analyse tout le fichier. "File_Name" doit inclure son extension.
   --  Lève "FILE_NAME_ERROR" si le fichier n'est pas trouvé.

   FILE_NAME_ERROR : exception;

end Basic_Sax.File_Parser;
